金蝶K3-WISE和黑湖MES集成接口设计
对接系统：金蝶K3-WISE
金蝶K/3WISE是智慧工厂ERP的首选品牌。金蝶K/3WISE推出了国内首个可落地的、可交付的智能制造解决方案，通过有步骤的制造体系改革，帮助中国中小型企业能够在短期内实现智能制造的转型与升级。
对接目标系统:黑湖MES
黑湖智造旗下的制造协同SaaS软件于2018年正式上线以来，在短短两年时间内，服务了中国大陆、港澳台、东南亚近2000家制造企业及其供应链，覆盖了近20个细分行业的全链路生产场景。为不同流程、不同目标的客户提供最贴合的解决方案，赋能了包括农夫山泉、蜜雪冰城、华润医药、三九药业、沃森生物、中国石化、欧莱雅、中国兵器、中信戴卡、特斯拉、小米等众多头部企业及其供应链。
数据对接方案
数据集成平台对应的配置金蝶K3-WISE与黑湖MES的对接只要三步就能完成两个系统之间的数据对接。第一步根据金蝶K3-WISE的接口参数要求记录在轻易云集成平台。第二步配置金蝶K3-WISE与黑湖MES之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。
金蝶K3-WISE接口明细
- 接口：PD/GetList
- 接口名称：生产任务单查询
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 |
|---|
| PageIndex | 开始行索引 | string |
| FOrderInterID | 销售订单号 | string |
| FAuxQtyLost | 遗失数量 | string |
| Fauxqty | 计划生产数量 | string |
| FCloseDate | 结案日期 | string |
| FReadyTime | 机台准备工时 | string |
| FPlanCommitDate | 计划开工日期 | string |
| FConfirmDate | 单据确认日期 | string |
| FItemModel | 规格型号 | string |
| FErpClsID | 物料属性 | string |
| FGMPBatchNo | 批 号 | string |
| FBomCategory | BOM类别 | string |
| FStartDate | 实际开工日期 | string |
| FTranType | 事务类型 | string |
| FAuxCommitQty | 计划完工数量 | string |
| FScheduleID | 上级重复生产计划单号 | string |
| FAuxQtyPass | 合格数量 | string |
| FCheckDate | 制单日期 | string |
| FAuxStockQty | 入库数量 | string |
| FPlanIssueDate | 计划发料日期 | string |
| FWorktypeID | 生产类型 | string |
| FPPOrderInterID | 生产预测单号 | string |
| FInLowLimit | 完工入库欠收比例(%) | string |
| FPlanConfirmed | 计划确认 | string |
| FQty | 生产数量 | string |
| FType | 生产类型属性 | string |
| FSourceEntryID | 源单行号 | string |
| FPlanMode | 计划模式 | string |
| FAuxPropID | 辅助属性 | string |
| FDecimal | 数量小数位 | string |
| FProcessPrice | 加工单价 | string |
| FBillNo | 编 号 | string |
| FAddInterID | 源入单库号 | string |
| FSelDiscardStockInAuxQty | 报废入库选单数量$ | string |
| FMrpLockFlag | MRP计算标记 | string |
| FRoutingID | 工艺路线 | string |
| FSelDiscardStockInQty | 基本单位报废入库选单数量$ | string |
| FCardClosed | 流转卡关联关闭 | string |
| FFinishDate | 实际完工日期 | string |
| FCheckerID | 结 案 人 | string |
| FPrintCount | 打印次数 | string |
| FItemName | 物料名称 | string |
| FProductionLineID | 生 产 线 | string |
| FInHighLimit | 完工入库超收比例(%) | string |
| FProcessFee | 加工费用 | string |
| FConveyerID | 下 达 人 | string |
| FPlanCategory | 计划类别 | string |
| FMtoNo | 计划跟踪号 | string |
| FUnitID | 单 位 | string |
| FTraceTypeID | 工序跟踪 | string |
| Top | 当前记录数 | string |
| FMRP | 单据来源 | string |
| Filter | 过滤条件 | string |
| FAuxQtyFinish | 实作数量 | string |
| FBillerID | 制 单 人 | string |
| FSupplyID | 加工单位 | string |
| FAuxQtyScrap | 因工报废数量 | string |
| FAuxInHighLimitQty | 完工入库上限 | string |
| FQtyScrap | 基本单位因工报废数量 | string |
| FCommitDate | 单据下达日期 | string |
| FFinishTime | 人工实作工时 | string |
| FPlanOrderInterID | 计划订单号 | string |
| FCommitQty | 完工数量 | string |
| FHeadSelfJ01102 | 备 注 | string |
| FParentInterID | 上级任务单号 | string |
| FSampleBreakQty | 基本单位样本破坏数量 | string |
| FConfirmerID | 确认人 | string |
| FChangeTimes | 变更次数 | string |
| FQtyPass | 基本单位合格数量 | string |
| FSampleBreakAuxQty | 样本破坏数量 | string |
| FFinCloseer | 财务结算人 | string |
| FCustID | 委托加工单位 | string |
| FFinClosed | 财务结算标志 | string |
| FQtyLost | 基本遗失数量 | string |
| FBomInterID | BOM 编号 | string |
| FItemID | 物料代码 | string |
| FPlanFinishDate | 计划完工日期 | string |
| FAuxInLowLimitQty | 完工入库下限 | string |
| FWorkShop | 生产车间 | string |
| FFinClosedate | 财务结算日期 | string |
| FHRReadyTime | 人工准备工时 | string |
| FFixTime | 机台实作工时 | string |
| FStockFlag | 领料标识 | string |
| FQtyForItem | 基本单位因料报废数量 | string |
| Fields | 需查询的字段key集合 | array |
| FCostObjID | 成本对象 | string |
| FProChkMde | 产品检验方式 | string |
| SelectPage | SelectPage | string |
| PageSize | 每页条数 | string |
| FAuxQtyForItem | 因料报废数量 | string |
| Fstatus | 单据状态 | string |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| FConfirmDate | 单据确认日期 | string | |
| FOrderInterID | 销售订单号 | string | |
| FCheckDate | 制单日期 | string | |
| FItemID | 物料代码 | string | |
| FItemName | 物料名称 | string | |
| FItemModel | 规格型号 | string | |
| FUnitID | 单 位 | string | |
| FGMPBatchNo | 批 号 | string | |
| FCostObjID | 成本对象 | string | |
| FTranType | 事务类型 | string | |
| FWorktypeID | 生产类型 | string | |
| FBomInterID | BOM 编号 | string | |
| FRoutingID | 工艺路线 | string | |
| Fauxqty | 计划生产数量 | string | |
| FInHighLimit | 完工入库超收比例(%) | string | |
| FAuxInHighLimitQty | 完工入库上限 | string | |
| FWorkShop | 生产车间 | string | |
| FInLowLimit | 完工入库欠收比例(%) | string | |
| FAuxInLowLimitQty | 完工入库下限 | string | |
| FBillNo | 编 号 | string | |
| FPlanCommitDate | 计划开工日期 | string | |
| FPlanFinishDate | 计划完工日期 | string | |
| FMRP | 单据来源 | string | |
| FHeadSelfJ01102 | 备 注 | string | |
| FProductionLineID | 生 产 线 | string | |
| Fstatus | 单据状态 | string | |
| FCommitDate | 单据下达日期 | string | |
| FBillerID | 制 单 人 | string | |
| FStartDate | 实际开工日期 | string | |
| FSourceEntryID | 源单行号 | string | |
| FPPOrderInterID | 生产预测单号 | string | |
| FPlanOrderInterID | 计划订单号 | string | |
| FChangeTimes | 变更次数 | string | |
| FScheduleID | 上级重复生产计划单号 | string | |
| FType | 生产类型属性 | string | |
| FTraceTypeID | 工序跟踪 | string | |
| FErpClsID | 物料属性 | string | |
| FCommitQty | 完工数量 | string | |
| FProcessPrice | 加工单价 | string | |
| FCustID | 委托加工单位 | string | |
| FAuxQtyLost | 遗失数量 | string | |
| FPlanIssueDate | 计划发料日期 | string | |
| FFinishDate | 实际完工日期 | string | |
| FSupplyID | 加工单位 | string | |
| FProcessFee | 加工费用 | string | |
| FAuxStockQty | 入库数量 | string | |
| FAuxQtyFinish | 实作数量 | string | |
| FAuxQtyPass | 合格数量 | string | |
| FAuxQtyScrap | 因工报废数量 | string | |
| FAuxQtyForItem | 因料报废数量 | string | |
| FDecimal | 数量小数位 | string | |
| FConfirmerID | 确认人 | string | |
| FCheckerID | 结 案 人 | string | |
| FParentInterID | 上级任务单号 | string | |
| FConveyerID | 下 达 人 | string | |
| FFinishTime | 人工实作工时 | string | |
| FReadyTime | 机台准备工时 | string | |
| FFixTime | 机台实作工时 | string | |
| FMrpLockFlag | MRP计算标记 | string | |
| FCloseDate | 结案日期 | string | |
| FPlanMode | 计划模式 | string | |
| FMtoNo | 计划跟踪号 | string | |
| FPlanConfirmed | 计划确认 | string | |
| FPrintCount | 打印次数 | string | |
| FCardClosed | 流转卡关联关闭 | string | |
| FHRReadyTime | 人工准备工时 | string | |
| FFinClosed | 财务结算标志 | string | |
| FFinCloseer | 财务结算人 | string | |
| FFinClosedate | 财务结算日期 | string | |
| FStockFlag | 领料标识 | string | |
| FBomCategory | BOM类别 | string | |
| FAddInterID | 源入单库号 | string | |
| FPlanCategory | 计划类别 | string | |
| FQtyLost | 基本遗失数量 | string | |
| FQtyForItem | 基本单位因料报废数量 | string | |
| FQtyScrap | 基本单位因工报废数量 | string | |
| FSampleBreakAuxQty | 样本破坏数量 | string | |
| FSampleBreakQty | 基本单位样本破坏数量 | string | |
| FSelDiscardStockInAuxQty | 报废入库选单数量$ | string | |
| FSelDiscardStockInQty | 基本单位报废入库选单数量$ | string | |
| FAuxCommitQty | 计划完工数量 | string | |
| FQty | 生产数量 | string | |
| FAuxPropID | 辅助属性 | string | |
| FProChkMde | 产品检验方式 | string | |
| FQtyPass | 基本单位合格数量 | string | |
黑湖MES接口明细
- 接口：openapi/v1/work_order/import
- 接口名称：导入计划工单
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 |
|---|
| status | 计划执行状态 | string |
| amount | 计划数量 | string |
| mbomVersion | Bom版本号 | string |
| remark | 备注 | string |
| type | 类型 | string |
| array | array | string |
| managerName | 生产主管 | string |
| plannerName | 计划员 | string |
| productBatch | 批号 | string |
| priority | 优先级 | string |
| productBatchType | 批号生成方式 | string |
| materialCode | 物料编号 | string |
| code | 计划工单号 | string |
| planEndTime | 计划结束时间 | string |
| planBeginTime | 计划开始时间 | string |
系统对接概况
全新的API数据集成模式，赋能企业业务创新 传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享 基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：黑湖MES与金蝶K3-WISE之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。
