从金蝶K3-WISE到黑湖MES通过接口配置打通数据
接入系统：金蝶K3-WISE
金蝶K/3WISE是智慧工厂ERP的首选品牌。金蝶K/3WISE推出了国内首个可落地的、可交付的智能制造解决方案，通过有步骤的制造体系改革，帮助中国中小型企业能够在短期内实现智能制造的转型与升级。
接通系统：黑湖MES
“制造执行系统(简称MES,亦为生产管理系统)MES系统主要负责车间生产管理和调度,用于跟踪和记录从原材料到成品的生产转换。为实现MES系统现场管理、监控并实时同步执行生产指令,会将订单流程、生产计划与企业管理系统(如ERP或产品生命周期管理(PLM)系统)进行协调。生产全流程数字化管理–黑湖智造协同系统MES实时运作,可以控制生产过程的多个要素,例如物料,人员,设备和库存。更进一步讲,MES打通各系统信息,跨多个功能领域
数据接口配置方案
通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶K3-WISE，并且选择对应的连接器（关于金蝶K3-WISE的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的收料通知/请检单接口作为数据对接来源。然后再通过写入目标平台配置目标系统为黑湖MES，并且选择对应连接器。选择对应的导入采购清单接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。
金蝶K3-WISE接口明细
- API：Material_Receipt_Notice/GetList
- NAME：收料通知/请检单
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| Fdate | 日期 | Fdate | |
| FPOStyle | 采购方式 | FPOStyle | |
| FBizType | 业务类型 | FBizType | |
| FWWType | 委外类型 | FWWType | |
| FAreaPS | 采购范围 | FAreaPS | |
| FFetchAdd | 交货地点 | FFetchAdd | |
| FStockID | 收料仓库 | FStockID | |
| FSupplyID | 供应商 | FSupplyID | |
| FRelateBrID | 供货机构 | FRelateBrID | |
| FClassTypeID | 事务类型 | FClassTypeID | |
| FExplanation | 摘要 | FExplanation | |
| FCurrencyID | 币别 | FCurrencyID | |
| FSelTranType | 源单类型（选单） | FSelTranType | |
| FSelBillNo | 选单号 | FSelBillNo | |
| FExchangeRate | 汇率 | FExchangeRate | |
| FBillNo | 编号 | FBillNo | |
| FExchangeRateType | 汇率类型 | FExchangeRateType | |
| FPOMode | 采购模式 | FPOMode | |
| FCheckerID | 审核 | FCheckerID | |
| FCheckDate | 审核日期 | FCheckDate | |
| FFManagerID | 主管 | FFManagerID | |
| FDeptID | 部门 | FDeptID | |
| FEmpID | 业务员 | FEmpID | |
| FBillerID | 制单 | FBillerID | |
| FManageType | 保税监管类型 | FManageType | |
| FEntryID2 | 行号 | FEntryID2 | |
| FAuxSampleBreakQty | 样本破坏数量 | FAuxSampleBreakQty | |
| FAuxScrapInCommitQty | 报废入库关联数量 | FAuxScrapInCommitQty | |
| FAuxScrapQty | 报废数量 | FAuxScrapQty | |
| FMapNumber | 对应代码 | FMapNumber | |
| FMapName | 对应名称 | FMapName | |
| FItemID | 物料代码 | FItemID | |
| FItemName | 物料名称 | FItemName | |
| FItemModel | 规格型号 | FItemModel | |
| FAuxPropID | 辅助属性 | FAuxPropID | |
| FBaseUnit | 基本单位名称 | FBaseUnit | |
| FBatchNo | 批号 | FBatchNo | |
| FQty | 基本单位数量 | FQty | |
| FUnitID | 单位 | FUnitID | |
| Fauxqty | 数量 | Fauxqty | |
| FSecUnitID | 辅助单位 | FSecUnitID | |
| FSecCoefficient | 换算率 | FSecCoefficient | |
| FSecQty | 辅助数量 | FSecQty | |
| Fauxprice | 单价 | Fauxprice | |
| Famount | 金额 | Famount | |
| Fnote | 备注 | Fnote | |
| FDischarged | 紧急放行 | FDischarged | |
| FKFDate | 生产/采购日期 | FKFDate | |
| FKFPeriod | 保质期(天) | FKFPeriod | |
| FPeriodDate | 有效期至 | FPeriodDate | |
| FStockID1 | 收料仓库 | FStockID1 | |
| FDCSPID | 仓位 | FDCSPID | |
| FSourceBillNo | 源单单号 | FSourceBillNo | |
| FSourceTranType | 源单类型 | FSourceTranType | |
| FSourceInterId | 源单内码 | FSourceInterId | |
| FSourceEntryID | 源单分录 | FSourceEntryID | |
| FContractBillNo | 合同单号 | FContractBillNo | |
| FContractInterID | 合同内码 | FContractInterID | |
| FContractEntryID | 合同分录 | FContractEntryID | |
| FOrderBillNo | 订单单号 | FOrderBillNo | |
| FOrderInterID | 订单内码 | FOrderInterID | |
| FOrderEntryID | 订单分录 | FOrderEntryID | |
| FAuxPropCls | 辅助属性类别 | FAuxPropCls | |
| FPlanMode | 计划模式 | FPlanMode | |
| FMTONo | 计划跟踪号 | FMTONo | |
| FOrderType | 订单类型 | FOrderType | |
| FCheckMethod | 检验方式 | FCheckMethod | |
| FQCheckQty | 基本单位检验数量 | FQCheckQty | |
| FAuxQCheckQty | 检验数量 | FAuxQCheckQty | |
| FSecQCheckQty | 辅助单位检验数量 | FSecQCheckQty | |
| FRelateQty | 检验基本关联数量 | FRelateQty | |
| FAuxRelateQty | 检验关联数量 | FAuxRelateQty | |
| FSecRelateQty | 辅助单位检验关联数量 | FSecRelateQty | |
| FQtyPass | 基本单位合格数量 | FQtyPass | |
| FAuxQtyPass | 合格数量 | FAuxQtyPass | |
| FSecQtyPass | 辅助单位合格数量 | FSecQtyPass | |
| FConPassQty | 基本单位让步接收数量 | FConPassQty | |
| FAuxConPassQty | 让步接收数量 | FAuxConPassQty | |
| FSecConPassQty | 辅助单位让步接收数量 | FSecConPassQty | |
| FNotPassQty | 基本单位不合格数量 | FNotPassQty | |
| FAuxNotPassQty | 不合格数量 | FAuxNotPassQty | |
| FSampleBreakQty | 基本单位样本破坏数量 | FSampleBreakQty | |
| FSecNotPassQty | 辅助单位不合格数量 | FSecNotPassQty | |
| FSecSampleBreakQty | 辅助单位样本破坏数量 | FSecSampleBreakQty | |
| FScrapQty | 基本单位报废数量 | FScrapQty | |
| FConCommitQty | 入库基本关联数量 | FConCommitQty | |
| FAuxConCommitQty | 入库关联数量 | FAuxConCommitQty | |
| FBackQty | 退料基本关联数量 | FBackQty | |
| FDeliveryNoticeFID | 交货通知单内码 | FDeliveryNoticeFID | |
| FAuxBackQty | 退料关联数量 | FAuxBackQty | |
| FDeliveryNoticeEntryID | 交货通知单分录 | FDeliveryNoticeEntryID | |
| FSecScrapQty | 辅助单位报废数量 | FSecScrapQty | |
| FSecConCommitQty | 辅助单位入库关联数量 | FSecConCommitQty | |
| FSecBackQty | 辅助单位退料关联数量 | FSecBackQty | |
| FScrapInCommitQty | 报废入库基本关联数量 | FScrapInCommitQty | |
| FSecScrapInCommitQty | 辅助单位报废入库关联数量 | FSecScrapInCommitQty | |
| FAuxQtyMust | 应收数量 | FAuxQtyMust | |
| FQtyMust | 基本单位应收数量 | FQtyMust | |
| FAuxPickQty | 挑选使用数量 | FAuxPickQty | |
| FPickQty | 基本单位挑选使用数量 | FPickQty | |
| FSamBillNo | 样品试制单号 | FSamBillNo | |
| FSamEntryID | 样品试制单行号 | FSamEntryID | |
| FSamInterID | 样品试制单内码 | FSamInterID | |
| FSecPickQty | 辅助单位挑选使用数量 | FSecPickQty | |
| FTime | 打样次数 | FTime | |
| FBarCodeListID | WMS条码外键 | FBarCodeListID | |
| Top | 当前记录数 | 90000000 | 金蝶的查询分页参数 |
| PageSize | 每页条数 | {{PAGINATION_PAGE_SIZE}} | 金蝶的查询分页参数 |
| PageIndex | 开始行索引 | _function {{PAGINATION_START_PAGE}}+1 | 金蝶的查询分页参数 |
| Filter | 过滤条件 | [FCheckDate]>='{{LAST_SYNC_TIME date}}' and [FCheckerID] > 0 | 需要先去k3增加自定义字段示例写法 [Fdate]>='{{LAST_SYNC_TIME dateTime}}' |
| Fields | 需查询的字段key集合 | | 金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber |
| SelectPage | SelectPage | 2 | |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| Fdate | 日期 | | |
| FPOStyle | 采购方式 | | |
| FBizType | 业务类型 | | |
| FWWType | 委外类型 | | |
| FAreaPS | 采购范围 | | |
| FFetchAdd | 交货地点 | | |
| FStockID | 收料仓库 | | |
| FSupplyID | 供应商 | | |
| FRelateBrID | 供货机构 | | |
| FClassTypeID | 事务类型 | | |
| FExplanation | 摘要 | | |
| FCurrencyID | 币别 | | |
| FSelTranType | 源单类型（选单） | | |
| FSelBillNo | 选单号 | | |
| FExchangeRate | 汇率 | | |
| FBillNo | 编号 | | |
| FExchangeRateType | 汇率类型 | | |
| FPOMode | 采购模式 | | |
| FCheckerID | 审核 | | |
| FCheckDate | 审核日期 | | |
| FFManagerID | 主管 | | |
| FDeptID | 部门 | | |
| FEmpID | 业务员 | | |
| FBillerID | 制单 | | |
| FManageType | 保税监管类型 | | |
| FEntryID2 | 行号 | | |
| FAuxSampleBreakQty | 样本破坏数量 | | |
| FAuxScrapInCommitQty | 报废入库关联数量 | | |
| FAuxScrapQty | 报废数量 | | |
| FMapNumber | 对应代码 | | |
| FMapName | 对应名称 | | |
| FItemID | 物料代码 | | |
| FItemName | 物料名称 | | |
| FItemModel | 规格型号 | | |
| FAuxPropID | 辅助属性 | | |
| FBaseUnit | 基本单位名称 | | |
| FBatchNo | 批号 | | |
| FQty | 基本单位数量 | | |
| FUnitID | 单位 | | |
| Fauxqty | 数量 | | |
| FSecUnitID | 辅助单位 | | |
| FSecCoefficient | 换算率 | | |
| FSecQty | 辅助数量 | | |
| Fauxprice | 单价 | | |
| Famount | 金额 | | |
| Fnote | 备注 | | |
| FDischarged | 紧急放行 | | |
| FKFDate | 生产/采购日期 | | |
| FKFPeriod | 保质期(天) | | |
| FPeriodDate | 有效期至 | | |
| FStockID1 | 收料仓库 | | |
| FDCSPID | 仓位 | | |
| FSourceBillNo | 源单单号 | | |
| FSourceTranType | 源单类型 | | |
| FSourceInterId | 源单内码 | | |
| FSourceEntryID | 源单分录 | | |
| FContractBillNo | 合同单号 | | |
| FContractInterID | 合同内码 | | |
| FContractEntryID | 合同分录 | | |
| FOrderBillNo | 订单单号 | | |
| FOrderInterID | 订单内码 | | |
| FOrderEntryID | 订单分录 | | |
| FAuxPropCls | 辅助属性类别 | | |
| FPlanMode | 计划模式 | | |
| FMTONo | 计划跟踪号 | | |
| FOrderType | 订单类型 | | |
| FCheckMethod | 检验方式 | | |
| FQCheckQty | 基本单位检验数量 | | |
| FAuxQCheckQty | 检验数量 | | |
| FSecQCheckQty | 辅助单位检验数量 | | |
| FRelateQty | 检验基本关联数量 | | |
| FAuxRelateQty | 检验关联数量 | | |
| FSecRelateQty | 辅助单位检验关联数量 | | |
| FQtyPass | 基本单位合格数量 | | |
| FAuxQtyPass | 合格数量 | | |
| FSecQtyPass | 辅助单位合格数量 | | |
| FConPassQty | 基本单位让步接收数量 | | |
| FAuxConPassQty | 让步接收数量 | | |
| FSecConPassQty | 辅助单位让步接收数量 | | |
| FNotPassQty | 基本单位不合格数量 | | |
| FAuxNotPassQty | 不合格数量 | | |
| FSampleBreakQty | 基本单位样本破坏数量 | | |
| FSecNotPassQty | 辅助单位不合格数量 | | |
| FSecSampleBreakQty | 辅助单位样本破坏数量 | | |
| FScrapQty | 基本单位报废数量 | | |
| FConCommitQty | 入库基本关联数量 | | |
| FAuxConCommitQty | 入库关联数量 | | |
| FBackQty | 退料基本关联数量 | | |
| FDeliveryNoticeFID | 交货通知单内码 | | |
| FAuxBackQty | 退料关联数量 | | |
| FDeliveryNoticeEntryID | 交货通知单分录 | | |
| FSecScrapQty | 辅助单位报废数量 | | |
| FSecConCommitQty | 辅助单位入库关联数量 | | |
| FSecBackQty | 辅助单位退料关联数量 | | |
| FScrapInCommitQty | 报废入库基本关联数量 | | |
| FSecScrapInCommitQty | 辅助单位报废入库关联数量 | | |
| FAuxQtyMust | 应收数量 | | |
| FQtyMust | 基本单位应收数量 | | |
| FAuxPickQty | 挑选使用数量 | | |
| FPickQty | 基本单位挑选使用数量 | | |
| FSamBillNo | 样品试制单号 | | |
| FSamEntryID | 样品试制单行号 | | |
| FSamInterID | 样品试制单内码 | | |
| FSecPickQty | 辅助单位挑选使用数量 | | |
| FTime | 打样次数 | | |
| FBarCodeListID | WMS条码外键 | | |
黑湖MES接口明细
- 调用接口：openapi/v1/order/procure_order/import
- 接口名称：导入采购清单
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| procureOrders | array | array | details |
| procureOrders.procureOrderCode | 单号 | string | {{FBillNo}} |
| procureOrders.supplierCode | 供应商 | string | test |
| procureOrders.amountPlanned | 数量 | string | {{details.FQty}} |
| procureOrders.demandTime | 时间 | string | {{Fdate datex}} |
| procureOrders.unitName | 单位 | string | {{details.FUnitID_DSPName}} |
| procureOrders.erpline | 行号 | string | {{details.FEntryID2}} |
| procureOrders.note | 单头备注 | string | |
| procureOrders.materialCode | materialCode | string | {{details.FItemID_FNDName}} |
系统对接总览
从API服务总线层面解决企业烟囱式业务系统集成现状 相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰 使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。
