金蝶K3-WISE和黑湖MES接口打通对接实战

源系统:金蝶K3-WISE

金蝶K/3WISE是一款面向成长型企业，适应企业在快速成长过程中业务与管理的不断变化的信息化平台，实现云服务、ERP、物联网的融合，帮助企业从信息化建设到构建企业工业互联网与数字化管理平台。

目标系统:黑湖MES

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

接口方案配置

通过轻易云系统数据集成平台新增创建集成方案，通过轻易云的方案市场可以一键复制，并且可以借鉴其他的方案配置完成方案制作，方案制作只需要两步，第一步先确定好对应的数据来源；源系统：金蝶K3-WISE接口：物料查询通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统：黑湖MES接口：物料导入，通过写入调度者匹配获取到的数据和写入的映射关系，即可自动生成符合目标系统：黑湖MES写入的数据自动产生写入队列，通过运行概况，系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况

金蝶K3-WISE接口明细

API：Material/GetList
NAME：物料查询
METHOD：POST

请求参数

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

响应参数

黑湖MES接口明细

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

请求参数

字段字段名称类型配置值 code物料编码string{{FNumber}} name物料名称string{{FName}} unitName单位string{{FOrderUnitID_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}} array数组对象stringmaterials

数据对接价值

通过无代码的数据集成与数据建模的智能数据管道技术，帮助企业将所有应用程序、数据库、事件和文件等数据信息提取到数据仓库中，并快速将分散的数据转化为数据集、API、自动化流程等开箱即用的数据服务。配置接口的模式对接金蝶K3-WISE和黑湖MES，使得单据无缝互通。打造企业内部数据一体化，让企业日常运营管理实现敏捷数据化运营。实现供应链业务信息流的互通，同时支持供应链数据分析流程自动化，结果推送，推进相关供应链问题优化。及时打通供应链孤岛，实现数据驱动供应链协同，进一步提升企业竞争力。

金蝶K3-WISE和黑湖MES接口打通对接实战