黑湖MES和金蝶K3-WISE单据接口对接|轻易云数据集成平台

黑湖MES和金蝶K3-WISE单据接口对接

数据源系统:金蝶K3-WISE

在中国企业ERP市场，金蝶k/3产品连续九年市场占有率第一。近年来，金蝶k/3WISE创新管理平台聚焦企业信息化热点，经过2020年无缝整合线上、线下销售渠道，助理企业协同项目。

对接目标系统:黑湖MES

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

多系统对接方案配置

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

金蝶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
array	数组对象	string

系统对接总览

使用全界面可视化配置集成流，快速应对企业的集成需求使得金蝶K3-WISE与黑湖MES之间的数据接口一站式的快速集成能力，构建企业数据通道，解决数据孤岛问题。快速构建企业元数据标准、主数据标准、业财数据标准，完成数据的采集、统一、分发、清洗、归集等，帮助企业建立高质量的数据中台。目前轻易云平台已经支持300+系统，同时具备快速适配新系统的能力，集成海量接口数据。无论是对接ERP还是MES、OA、CRM、WMS、OMS等等系统，都可以通过接口相互集成。