金蝶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 |
| FIsSNRpt | SN物料汇报时必须有序列号 | string |
| FSaleUnitID | 销售计量单位 | string |
| FBarcodeQtyEachTime | 条码单位数量 | string |
| PageIndex | 开始行索引 | string |
| FIsSparePart | 是否为备件 | string |
| FSecondUnitRate | HS第二法定单位换算率 | string |
| FSPID | 默认仓位 | string |
| FName | 名称 | string |
| FHSNumber | HS编码 | string |
| FChartNumber | 图号 | string |
| FPinYin | 名称拼音 | string |
| FFirstUnit | HS第一法定单位 | string |
| FDefaultRoutingID | 默认工艺路线 | string |
| FMCVAcctID | 材料成本差异科目代码 | string |
| FFullName | 物料全名 | string |
| FSecondUnit | HS第二法定单位 | string |
| FManageType | 物料监管类型 | string |
| FWWHghPrcMnyType | 委外加工最高价币别 | string |
| FMakeFile | 生成产品档案 | string |
| FFirstUnitRate | HS第一法定单位换算率 | 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 |
| FMRPOrder | MRP计算是否产生采购申请 | 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 | 成本BOM | string |
| 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_103 | F_103 | string |
| FMRPCon | MRP计算是否合并需求 | 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 |
| FItemId | FItemId | string |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| 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 | {{FNumber}} |
| name | 物料名称 | string | {{FName}} |
| unitName | 单位 | string | {{FUnitID_FName}} |
| needRequestMaterial | 请料方式 | string | 1 |
| labelRegulation | 标签管理 | string | _function CASE LEFT('{{FNumber}}',2) WHEN '08' THEN 1 WHEN '05' THEN 1 ELSE 0 END |
| safeStorageAmount | 安全库存 | string | 1 |
| materialProperty | 物料属性 | string | 自制 |
| unitPrecision | 主单位精度位数 | string | 4 |
| desc | desc | string | {{FModel}} |
| materialCustomFields | materialCustomFields | string | {{FNumber}} |
| unitConversions | unitConversions | array | |
| unitConversions.materialCode | materialCode | string | {{FNumber}} |
| unitConversions.masterUnitCount | masterUnitCount | string | 1 |
| unitConversions.slaveUnitName | slaveUnitName | string | {{FOrderUnitID_FName}} |
| unitConversions.slaveUnitCount | slaveUnitCount | string | 1 |
| unitConversions.slaveUnitPrecision | slaveUnitPrecision | string | 4 |
| unitConversions.inputFactoryUnitName | inputFactoryUnitName | string | {{FOrderUnitID_FName}} |
| unitConversions.array | 数组对象 | string | materials |
系统对接概况
全面支持数据集成操作可视化、拖拽流式开发，无代码完成多套异构系统集成，降低使用门槛，提升交付速度。特别是在面向金蝶K3-WISE、黑湖MES间API接口集成时，通过对API的设计、创建、测试、部署、集成、管理、运维、下线等全生命周期管理，帮助企业洞察运营状况，进一步优化流程，提高企业商业价值。基于Web图形界面，通过拖拽、连接、配置完成流程设计，数据整合和集成，高效打通业务系统，通过面向运营的统计报表，直观查看API各项指标，实现对全局和项目层级双维度的监控管理。再通过轻易云数据集成中台通过统一门户注册管理，将业务以API的方式对外开放，实现业务创新、能力输出。
