金蝶K3-WISE对接打通黑湖MES物料查询接口与物料导入接口
接入系统:金蝶K3-WISE
在中国企业ERP市场,金蝶k/3产品连续九年市场占有率第一。近年来,金蝶k/3WISE创新管理平台聚焦企业信息化热点,经过2020年无缝整合线上、线下销售渠道,助理企业协同项目。
对接目标系统:黑湖MES
黑湖智造以“制造协同”为核心场景,利用实时数据打通工厂内、跨工厂、供应链的业务节点,驱动整体协作效率的提升。过去四年,随着行业场景和客户数量的激增,黑湖智造在“制造协同”的基础上沉淀了大量的用户增值需求,并启动了技术升级计划,在PaaS和SaaS之间构建一层应用级的平台,帮助工业企业深度挖掘数据利用价值和开发延展性应用,打造一个入口级的工业协同平台。
多系统对接方案配置
使用轻易云系统数据集成平台对应的模块:数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统:金蝶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 | |
| 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 | |
数据对接价值
将传统的统计分析转变为预测分析,从被动分析到主动分析,从非实时分析转变为实时分析,从结构化的数据变成多元化的数据。精准查询数据流同步状况,实时监管队列任务以及数据资产的有序管理。为业务赋能,降本增效,让企业能够更加合理的布局团队;结合业务需求实现与OA,CRM,WMS等系统之间的数据交流与同步,为企业定制自定义的数据管理方案,用技术拓展商业边界,为新业务、新部门提供成长空间。
系统数据对接方案元数据代码