金蝶K3-WISE对接打通黑湖MES物料查询接口与物料导入接口

数据源平台:金蝶K3-WISE

金蝶K/3WISE是智慧工厂ERP的首选品牌。金蝶K/3WISE推出了国内首个可落地的、可交付的智能制造解决方案，通过有步骤的制造体系改革，帮助中国中小型企业能够在短期内实现智能制造的转型与升级。

对接目标系统:黑湖MES

黑湖智造旗下的制造协同SaaS软件于2018年正式上线以来，在短短两年时间内，服务了中国大陆、港澳台、东南亚近2000家制造企业及其供应链，覆盖了近20个细分行业的全链路生产场景。为不同流程、不同目标的客户提供最贴合的解决方案，赋能了包括农夫山泉、蜜雪冰城、华润医药、三九药业、沃森生物、中国石化、欧莱雅、中国兵器、中信戴卡、特斯拉、小米等众多头部企业及其供应链。

多系统对接方案配置

通过数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶K3-WISE，并且选择对应的连接器（关于金蝶K3-WISE的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的物料查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为黑湖MES，并且选择对应连接器。选择对应的物料导入接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。

金蝶K3-WISE接口明细

接口：Material/GetList
接口名称：物料查询
接口方法：POST

请求参数

字段名称类型 FOutMachFeeProject委外加工费所属成本项目string FVersion版本号string FHelpCode助记码string FBeforeExpire失效提前期(天)string FPieceRate单位计件工资string FSPIDReady默认待检仓位string FTtermOfService保修期限（月）string FProductPrincipal生产负责人string FSLAcctID废品损失科目代码string FNumber代码string FSecUnitID辅助计量单位string FImpostTaxRate进口关税率%string FOrderUnitID采购计量单位string FPlanTrategy计划策略string FNote备注string FOrderTrategy订货策略string FDefaultWorkTypeID默认生产类型string FBackFlushStockID倒冲仓库string FSource来源string FIsEquipment是否为设备string FOILowLimit外购欠收比例(%)string FLowLimit最低存量string FIsSale是否销售string FNetWeight净重string FOutMachFee单位委外加工费string FCostAcctID销售成本科目代码string FLastCheckDate上次盘点日期string FStdPayRate标准工资率string FIsKeyItem是否关键件string FHighLimit最高存量string FIsSpecialTax是否农林计税string FProductDesigner产品设计员string FCBAppendRate附加费率(%)string FPriceDecimal单价精度string FDefaultLoc默认仓库string FIsFixedReOrder设置为固定再订货点string FBackFlushSPID倒冲仓位string FIsSNBanDing必须进行SN绑定string FDailyConsume日消耗量string FSecInv安全库存数量string FCubageDecimal体积精度string FISKFPeriod是否进行保质期管理string FPlanPrice计划单价string FCtrlType控制类型string FQtyMin最小订货量string FQtyDecimal数量精度string FPY拼音缩写string FWthDrwChkMde退货检验方式string FContainerName容器名称string FAdminAcctID代管物资科目string FPCVAcctID加工费差异科目代码string FStandardCost单位标准成本string FStandardManHour单位标准工时(小时)string Top当前记录数string FIsSNManage是否进行序列号管理string FBatChangeEconomy变动提前期批量string FWWChkMde委外加工检验方式string Filter过滤条件string FSize体积string FCheckCycle盘点周期string FUnitPackageNumber单位包装数量string FCAVAcctID标准成本调整差异科目代码string FPickLowLimit领料欠收比例(%)string FLeadTime变动提前期string FStartService启用服务string FDSManagerID默认仓管员string FAlias别名string FPOHighPrice采购最高价string FProChkMde产品检验方式string FIsSNRptSN物料汇报时必须有序列号string FSaleUnitID销售计量单位string FBarcodeQtyEachTime条码单位数量string PageIndex开始行索引string FIsSparePart是否为备件string FSecondUnitRateHS第二法定单位换算率string FSPID默认仓位string FName名称string FHSNumberHS编码string FChartNumber图号string FPinYin名称拼音string FFirstUnitHS第一法定单位string FDefaultRoutingID默认工艺路线string FMCVAcctID材料成本差异科目代码string FFullName物料全名string FSecondUnitHS第二法定单位string FManageType物料监管类型string FWWHghPrcMnyType委外加工最高价币别string FMakeFile生成产品档案string FFirstUnitRateHS第一法定单位换算率string FConsumeTaxRate进口消费税率%string FCBAppendProject附加费所属成本项目string PageSize每页条数string FUseState使用状态string FSOLowPrcMnyType销售最低价币别string FInspectionLevel采购检验方式string FPlanner计划员string FTotalTQQ累计提前期string FCostProject成本项目string FGoodSpec税目代码string FPutInteger投料自动取整string FKanBanCapability看板容量string FExportRate外销税率%string FOnlineShopPNo商家编码string FAuxClassID辅助属性类别string FOrderPrice采购单价string FIsCharSourceItem物料对应特性string FTtermOfUsefulTime使用寿命（月）string FIsFix维修件string FAPAcctID成本差异科目代码string FAuxInMrpCal辅助属性参与计划运算string FKFPeriod保质期(天)string FOnlineShopPName网店货品名string FMRPOrderMRP计算是否产生采购申请string FStdFixFeeRate单位标准固定制造费用金额string FMaund重量单位string FBatchSplit拆分批量string FDaysPer每周/月第()天string FTypeID物料分类string FInLowLimit完工欠收比例(%)string FRequirePoint需求时界(天)string FStkChkPrd库存检验周期(天)string FOIHighLimit外购超收比例(%)string FSalePrice销售单价string FGrossWeight毛重string FErpClsID物料属性string FCostBomID成本BOMstring FStkChkMde库存检验方式string FPlanPoint计划时界(天)string FModelEn英文规格string FPlanMode计划模式string FCubicMeasure长度单位string FTrack计价方法string FSOLowLimit销售欠交比例(%)string FSOChkMde发货检验方式string FCtrlStraregy控制策略string FBatchManager是否采用业务批次管理string FWidth宽度string FInspectionProject检验方案string F_102工艺简述string FIsManage是否保税监管string FStockTime是否需要库龄管理string FOrderPoint再订货点string FProductUnitID生产计量单位string FStdBatchQty标准加工批量string FSampStdSlight抽样标准(轻微)string FBatchAppendQty批量增量string FInHighLimit完工超收比例(%)string FLength长度string FSaleAcctID销售收入科目代码string FPOHghPrcMnyType采购最高价币别string FBatFixEconomy固定/经济批量string FUnitGroupID计量单位组string FApproveNo批准文号string FOrderRector采购负责人string FModel规格型号string FNameEn英文名称string FHeight高度string FProfitRate毛利率(%)string FSampStdCritical抽样标准(致命)string FQtyMax最大订货量string FTaxRate税率(%)string FIdentifier检验员string FPOVAcctID采购订单差异科目代码string F_103F_103string FMRPConMRP计算是否合并需求string FOrderDept采购部门string Fields需查询的字段key集合array FAcctID存货科目代码string FOrderInterVal订货间隔期(天)string FChgFeeRate变动制造费用分配率string FWWHghPrc委外加工最高价string FSOHighLimit销售超交比例(%)string FFixLeadTime固定提前期string FPickHighLimit领料超收比例(%)string FCharSourceItemID特性配置来源string FLenDecimal长度精度string FStoreUnitID库存计量单位string FIsBackFlush是否倒冲string FPIVAcctID采购发票差异科目代码string FStkChkAlrm库存周期检验预警提前期(天)string FOtherChkMde其他检验方式string FUnitID基本计量单位string FCBRestore参与结转式成本还原string FCBRouting成本工艺路线string FSOLowPrc销售最低价string FEquipmentNum设备编码string FBookPlan是否需要进行订补货计划的运算string FSecCoefficient辅助计量单位换算率string FForbbitBarcodeEdit严格进行二维码数量校验string FDefaultReadyLoc默认待检仓库string FBatchSplitDays批量拆分间隔天数string FSampStdStrict抽样标准(严重)string FWeightDecimal重量精度string FCheckCycUnit盘点周期单位string FItemIdFItemIdstring

响应参数

字段名称类型描述 FHelpCode助记码string FModel规格型号string FAuxClassID辅助属性类别string FErpClsID物料属性string FTypeID物料分类string FUnitGroupID计量单位组string FUnitID基本计量单位string FOrderUnitID采购计量单位string FSaleUnitID销售计量单位string FProductUnitID生产计量单位string FStoreUnitID库存计量单位string FSecUnitID辅助计量单位string FSecCoefficient辅助计量单位换算率string FDefaultLoc默认仓库string FSPID默认仓位string FSource来源string FQtyDecimal数量精度string FLowLimit最低存量string FHighLimit最高存量string FSecInv安全库存数量string FUseState使用状态string FIsEquipment是否为设备string FEquipmentNum设备编码string FIsSparePart是否为备件string FFullName物料全名string FApproveNo批准文号string FAlias别名string FOrderRector采购负责人string FPOHighPrice采购最高价string FPOHghPrcMnyType采购最高价币别string FWWHghPrc委外加工最高价string FWWHghPrcMnyType委外加工最高价币别string FSOLowPrc销售最低价string FSOLowPrcMnyType销售最低价币别string FIsSale是否销售string FProfitRate毛利率(%)string FOrderPrice采购单价string FSalePrice销售单价string FIsSpecialTax是否农林计税string FISKFPeriod是否进行保质期管理string FKFPeriod保质期(天)string FStockTime是否需要库龄管理string FBatchManager是否采用业务批次管理string FBookPlan是否需要进行订补货计划的运算string FBeforeExpire失效提前期(天)string FCheckCycUnit盘点周期单位string FCheckCycle盘点周期string FDaysPer每周/月第()天string FLastCheckDate上次盘点日期string FOIHighLimit外购超收比例(%)string FOILowLimit外购欠收比例(%)string FSOHighLimit销售超交比例(%)string FSOLowLimit销售欠交比例(%)string FInHighLimit完工超收比例(%)string FInLowLimit完工欠收比例(%)string FPickHighLimit领料超收比例(%)string FPickLowLimit领料欠收比例(%)string FTrack计价方法string FPlanPrice计划单价string FPriceDecimal单价精度string FAcctID存货科目代码string FSaleAcctID销售收入科目代码string FCostAcctID销售成本科目代码string FAPAcctID成本差异科目代码string FAdminAcctID代管物资科目string FGoodSpec税目代码string FTaxRate税率(%)string FCostProject成本项目string FIsSNManage是否进行序列号管理string F_102工艺简述string FCBRestore参与结转式成本还原string FNote备注string FPlanTrategy计划策略string FPlanMode计划模式string FOrderTrategy订货策略string FFixLeadTime固定提前期string FLeadTime变动提前期string FTotalTQQ累计提前期string FOrderInterVal订货间隔期(天)string FQtyMin最小订货量string FQtyMax最大订货量string FBatchAppendQty批量增量string FOrderPoint再订货点string FBatFixEconomy固定/经济批量string FBatChangeEconomy变动提前期批量string FRequirePoint需求时界(天)string FPlanPoint计划时界(天)string FDefaultRoutingID默认工艺路线string FDefaultWorkTypeID默认生产类型string FProductPrincipal生产负责人string FPlanner计划员string FIsBackFlush是否倒冲string FBackFlushStockID倒冲仓库string FBackFlushSPID倒冲仓位string FPutInteger投料自动取整string FDailyConsume日消耗量string FMRPConMRP计算是否合并需求string FMRPOrderMRP计算是否产生采购申请string FChartNumber图号string FIsKeyItem是否关键件string FGrossWeight毛重string FNetWeight净重string FMaund重量单位string FLength长度string FWidth宽度string FHeight高度string FSize体积string FCubicMeasure长度单位string FStandardCost单位标准成本string FCBAppendRate附加费率(%)string FCBAppendProject附加费所属成本项目string FCostBomID成本BOMstring FCBRouting成本工艺路线string FStdBatchQty标准加工批量string FStandardManHour单位标准工时(小时)string FStdPayRate标准工资率string FChgFeeRate变动制造费用分配率string FStdFixFeeRate单位标准固定制造费用金额string FOutMachFee单位委外加工费string FOutMachFeeProject委外加工费所属成本项目string FPieceRate单位计件工资string FPOVAcctID采购订单差异科目代码string FPIVAcctID采购发票差异科目代码string FMCVAcctID材料成本差异科目代码string FPCVAcctID加工费差异科目代码string FSLAcctID废品损失科目代码string FCAVAcctID标准成本调整差异科目代码string FInspectionLevel采购检验方式string FProChkMde产品检验方式string FWWChkMde委外加工检验方式string FSOChkMde发货检验方式string FWthDrwChkMde退货检验方式string FStkChkMde库存检验方式string FOtherChkMde其他检验方式string FSampStdCritical抽样标准(致命)string FSampStdStrict抽样标准(严重)string FSampStdSlight抽样标准(轻微)string FStkChkPrd库存检验周期(天)string FStkChkAlrm库存周期检验预警提前期(天)string FInspectionProject检验方案string FIdentifier检验员string FVersion版本号string FNameEn英文名称string FModelEn英文规格string FHSNumberHS编码string FExportRate外销税率%string FFirstUnitHS第一法定单位string FSecondUnitHS第二法定单位string FImpostTaxRate进口关税率%string FConsumeTaxRate进口消费税率%string FFirstUnitRateHS第一法定单位换算率string FSecondUnitRateHS第二法定单位换算率string FIsManage是否保税监管string FManageType物料监管类型string FLenDecimal长度精度string FCubageDecimal体积精度string FWeightDecimal重量精度string FCharSourceItemID特性配置来源string FIsCharSourceItem物料对应特性string FCtrlType控制类型string FCtrlStraregy控制策略string FContainerName容器名称string FKanBanCapability看板容量string FBatchSplitDays批量拆分间隔天数string FBatchSplit拆分批量string FDefaultReadyLoc默认待检仓库string FSPIDReady默认待检仓位string FStartService启用服务string FMakeFile生成产品档案string FIsFix维修件string FTtermOfService保修期限（月）string FTtermOfUsefulTime使用寿命（月）string FIsFixedReOrder设置为固定再订货点string FOnlineShopPNo商家编码string FOnlineShopPName网店货品名string FForbbitBarcodeEdit严格进行二维码数量校验string FDSManagerID默认仓管员string FUnitPackageNumber单位包装数量string FOrderDept采购部门string FAuxInMrpCal辅助属性参与计划运算string FProductDesigner产品设计员string FPinYin名称拼音string FPY拼音缩写string FBarcodeQtyEachTime条码单位数量string FIsSNBanDing必须进行SN绑定string FIsSNRptSN物料汇报时必须有序列号string FName名称string FNumber代码string FItemIdFItemIdstring F_103F_103string

黑湖MES接口明细

调用接口：openapi/v1/def/material/import
接口名称：物料导入
方法：POST

请求参数

字段字段名称类型配置值 code物料编码string{{FNumber}} name物料名称string{{FName}} unitName单位string{{FUnitID_FName}} needRequestMaterial请料方式string1 labelRegulation标签管理string_function CASE LEFT('{{FNumber}}',2) WHEN '08' THEN 1 WHEN '05' THEN 1 ELSE 0 END safeStorageAmount安全库存string1 materialProperty物料属性string自制 unitPrecision主单位精度位数string4 descdescstring{{FModel}} materialCustomFieldsmaterialCustomFieldsstring{{FNumber}} unitConversionsunitConversionsarray unitConversions.materialCodematerialCodestring{{FNumber}} unitConversions.masterUnitCountmasterUnitCountstring1 unitConversions.slaveUnitNameslaveUnitNamestring{{FOrderUnitID_FName}} unitConversions.slaveUnitCountslaveUnitCountstring1 unitConversions.slaveUnitPrecisionslaveUnitPrecisionstring4 unitConversions.inputFactoryUnitNameinputFactoryUnitNamestring{{FOrderUnitID_FName}} unitConversions.array数组对象stringmaterials

系统对接概况

全面支持数据集成操作可视化、拖拽流式开发，无代码完成多套异构系统集成，降低使用门槛，提升交付速度。特别是在面向金蝶K3-WISE、黑湖MES间API接口集成时，通过对API的设计、创建、测试、部署、集成、管理、运维、下线等全生命周期管理，帮助企业洞察运营状况，进一步优化流程，提高企业商业价值。基于Web图形界面，通过拖拽、连接、配置完成流程设计，数据整合和集成，高效打通业务系统，通过面向运营的统计报表，直观查看API各项指标，实现对全局和项目层级双维度的监控管理。再通过轻易云数据集成中台通过统一门户注册管理，将业务以API的方式对外开放，实现业务创新、能力输出。

金蝶K3-WISE对接打通黑湖MES物料查询接口与物料导入接口