金蝶K3-WISE和黑湖MES接口打通对接实战
接通系统:金蝶K3-WISE
金蝶K/3WISE是一款面向成长型企业,适应企业在快速成长过程中业务与管理的不断变化的信息化平台,实现云服务、ERP、物联网的融合,帮助企业从信息化建设到构建企业工业互联网与数字化管理平台。
写入目标:黑湖MES
黑湖智造旗下的制造协同SaaS软件于2018年正式上线以来,在短短两年时间内,服务了中国大陆、港澳台、东南亚近2000家制造企业及其供应链,覆盖了近20个细分行业的全链路生产场景。为不同流程、不同目标的客户提供最贴合的解决方案,赋能了包括农夫山泉、蜜雪冰城、华润医药、三九药业、沃森生物、中国石化、欧莱雅、中国兵器、中信戴卡、特斯拉、小米等众多头部企业及其供应链。
系统对接接口配置
通过轻易云系统数据集成平台新增创建集成方案,通过轻易云的方案市场可以一键复制,并且可以借鉴其他的方案配置完成方案制作,方案制作只需要两步,第一步先确定好对应的数据来源;源系统:金蝶K3-WISE接口:物料查询通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统:黑湖MES接口:物料导入,通过写入调度者匹配获取到的数据和写入的映射关系,即可自动生成符合目标系统:黑湖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 |
系统对接概况
通过无代码的数据集成与数据建模的智能数据管道技术,帮助企业将所有应用程序、数据库、事件和文件等数据信息提取到数据仓库中,并快速将分散的数据转化为数据集、API、自动化流程等开箱即用的数据服务。配置接口的模式对接金蝶K3-WISE和黑湖MES,使得单据无缝互通。打造企业内部数据一体化,让企业日常运营管理实现敏捷数据化运营。实现供应链业务信息流的互通,同时支持供应链数据分析流程自动化,结果推送,推进相关供应链问题优化。及时打通供应链孤岛,实现数据驱动供应链协同,进一步提升企业竞争力。
系统数据对接方案元数据代码