从金蝶K3-WISE到黑湖MES通过接口配置打通数据|轻易云数据集成平台

从金蝶K3-WISE到黑湖MES通过接口配置打通数据

对接源平台:金蝶K3-WISE

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

对接目标平台:黑湖MES

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

配置集成方案

通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：金蝶K3-WISE，然后选择对应的连接器。选择对应的Material/GetList作为数据对接来源。然后再写入目标平台配置目标系统为黑湖MES，并且选择对应连接器（关于黑湖MES的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的openapi/v1/def/material/import接口作为数据写入动作完成第一步的接口配置。

金蝶K3-WISE接口明细

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

请求参数

字段	名称	类型	描述
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
FMRPCon	MRP计算是否合并需求	string
FMRPOrder	MRP计算是否产生采购申请	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	成本BOM	string
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
FHSNumber	HS编码	string
FExportRate	外销税率%	string
FFirstUnit	HS第一法定单位	string
FSecondUnit	HS第二法定单位	string
FImpostTaxRate	进口关税率%	string
FConsumeTaxRate	进口消费税率%	string
FFirstUnitRate	HS第一法定单位换算率	string
FSecondUnitRate	HS第二法定单位换算率	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
FIsSNRpt	SN物料汇报时必须有序列号	string
FName	名称	string
FNumber	代码	string
FItemId	FItemId	string
F_103	F_103	string
Top	当前记录数	string
PageSize	每页条数	string
PageIndex	开始行索引	string
Filter	过滤条件	string
Fields	需查询的字段key集合	array

响应参数

字段	名称	类型	描述
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
FMRPCon	MRP计算是否合并需求	string
FMRPOrder	MRP计算是否产生采购申请	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	成本BOM	string
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
FHSNumber	HS编码	string
FExportRate	外销税率%	string
FFirstUnit	HS第一法定单位	string
FSecondUnit	HS第二法定单位	string
FImpostTaxRate	进口关税率%	string
FConsumeTaxRate	进口消费税率%	string
FFirstUnitRate	HS第一法定单位换算率	string
FSecondUnitRate	HS第二法定单位换算率	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
FIsSNRpt	SN物料汇报时必须有序列号	string
FName	名称	string
FNumber	代码	string
FItemId	FItemId	string
F_103	F_103	string

黑湖MES接口明细

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

请求参数

字段	名称	类型	描述
code	物料编码	string
name	物料名称	string
unitName	单位	string
needRequestMaterial	请料方式	string
labelRegulation	标签管理	string
safeStorageAmount	安全库存	string
materialProperty	物料属性	string
unitPrecision	主单位精度位数	string
desc	desc	string
materialCustomFields	materialCustomFields	string
unitConversions	unitConversions	array
unitConversions.materialCode	materialCode	string
unitConversions.masterUnitCount	masterUnitCount	string
unitConversions.slaveUnitName	slaveUnitName	string
unitConversions.slaveUnitCount	slaveUnitCount	string
unitConversions.slaveUnitPrecision	slaveUnitPrecision	string
unitConversions.inputFactoryUnitName	inputFactoryUnitName	string
unitConversions.array	数组对象	string

数据对接效果

全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系。API低代码开发平台能够实现低代码或零代码一键发布API服务，很好地解决企业用户上面的问题。轻易云应用集成主要解决已有应用系统的无序蔓延现象，减少各业务系统间的维护成本，减少各应用系统的操作系统、开发语言、访问协议、通信技术多而杂、整合难度大的问题，将企业数据平滑对接，减少信息竖井。