从金蝶K3-WISE到黑湖MES通过接口配置打通数据

数据源平台:金蝶K3-WISE
金蝶K/3WISE是智慧工厂ERP的首选品牌。金蝶K/3WISE推出了国内首个可落地的、可交付的智能制造解决方案,通过有步骤的制造体系改革,帮助中国中小型企业能够在短期内实现智能制造的转型与升级。
接入系统:黑湖MES
黑湖智造旗下的制造协同SaaS软件于2018年正式上线以来,在短短两年时间内,服务了中国大陆、港澳台、东南亚近2000家制造企业及其供应链,覆盖了近20个细分行业的全链路生产场景。为不同流程、不同目标的客户提供最贴合的解决方案,赋能了包括农夫山泉、蜜雪冰城、华润医药、三九药业、沃森生物、中国石化、欧莱雅、中国兵器、中信戴卡、特斯拉、小米等众多头部企业及其供应链。
数据集成方案配置
集成方案是整个轻易云集成平台的核心,每一个集成方案代表一种业务的对接策略(对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息),用户可以根据业务的不同新建多个不同规则的集成方案。比如:采购订单同步,线上销售出库同步,线下销售出库同步。一个集成方案必须要配置源系统:金蝶K3-WISE,源系统 API:收料通知/请检单,目标系统:黑湖MES,目标系统 API导入采购清单。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。



金蝶K3-WISE接口明细
- 调用接口:Material_Receipt_Notice/GetList
- 接口名称:收料通知/请检单
- 方法:POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
| Fdate | 日期 | string | Fdate |
| FPOStyle | 采购方式 | string | FPOStyle |
| FBizType | 业务类型 | string | FBizType |
| FWWType | 委外类型 | string | FWWType |
| FAreaPS | 采购范围 | string | FAreaPS |
| FFetchAdd | 交货地点 | string | FFetchAdd |
| FStockID | 收料仓库 | string | FStockID |
| FSupplyID | 供应商 | string | FSupplyID |
| FRelateBrID | 供货机构 | string | FRelateBrID |
| FClassTypeID | 事务类型 | string | FClassTypeID |
| FExplanation | 摘要 | string | FExplanation |
| FCurrencyID | 币别 | string | FCurrencyID |
| FSelTranType | 源单类型(选单) | string | FSelTranType |
| FSelBillNo | 选单号 | string | FSelBillNo |
| FExchangeRate | 汇率 | string | FExchangeRate |
| FBillNo | 编号 | string | FBillNo |
| FExchangeRateType | 汇率类型 | string | FExchangeRateType |
| FPOMode | 采购模式 | string | FPOMode |
| FCheckerID | 审核 | string | FCheckerID |
| FCheckDate | 审核日期 | string | FCheckDate |
| FFManagerID | 主管 | string | FFManagerID |
| FDeptID | 部门 | string | FDeptID |
| FEmpID | 业务员 | string | FEmpID |
| FBillerID | 制单 | string | FBillerID |
| FManageType | 保税监管类型 | string | FManageType |
| FEntryID2 | 行号 | string | FEntryID2 |
| FAuxSampleBreakQty | 样本破坏数量 | string | FAuxSampleBreakQty |
| FAuxScrapInCommitQty | 报废入库关联数量 | string | FAuxScrapInCommitQty |
| FAuxScrapQty | 报废数量 | string | FAuxScrapQty |
| FMapNumber | 对应代码 | string | FMapNumber |
| FMapName | 对应名称 | string | FMapName |
| FItemID | 物料代码 | string | FItemID |
| FItemName | 物料名称 | string | FItemName |
| FItemModel | 规格型号 | string | FItemModel |
| FAuxPropID | 辅助属性 | string | FAuxPropID |
| FBaseUnit | 基本单位名称 | string | FBaseUnit |
| FBatchNo | 批号 | string | FBatchNo |
| FQty | 基本单位数量 | string | FQty |
| FUnitID | 单位 | string | FUnitID |
| Fauxqty | 数量 | string | Fauxqty |
| FSecUnitID | 辅助单位 | string | FSecUnitID |
| FSecCoefficient | 换算率 | string | FSecCoefficient |
| FSecQty | 辅助数量 | string | FSecQty |
| Fauxprice | 单价 | string | Fauxprice |
| Famount | 金额 | string | Famount |
| Fnote | 备注 | string | Fnote |
| FDischarged | 紧急放行 | string | FDischarged |
| FKFDate | 生产/采购日期 | string | FKFDate |
| FKFPeriod | 保质期(天) | string | FKFPeriod |
| FPeriodDate | 有效期至 | string | FPeriodDate |
| FStockID1 | 收料仓库 | string | FStockID1 |
| FDCSPID | 仓位 | string | FDCSPID |
| FSourceBillNo | 源单单号 | string | FSourceBillNo |
| FSourceTranType | 源单类型 | string | FSourceTranType |
| FSourceInterId | 源单内码 | string | FSourceInterId |
| FSourceEntryID | 源单分录 | string | FSourceEntryID |
| FContractBillNo | 合同单号 | string | FContractBillNo |
| FContractInterID | 合同内码 | string | FContractInterID |
| FContractEntryID | 合同分录 | string | FContractEntryID |
| FOrderBillNo | 订单单号 | string | FOrderBillNo |
| FOrderInterID | 订单内码 | string | FOrderInterID |
| FOrderEntryID | 订单分录 | string | FOrderEntryID |
| FAuxPropCls | 辅助属性类别 | string | FAuxPropCls |
| FPlanMode | 计划模式 | string | FPlanMode |
| FMTONo | 计划跟踪号 | string | FMTONo |
| FOrderType | 订单类型 | string | FOrderType |
| FCheckMethod | 检验方式 | string | FCheckMethod |
| FQCheckQty | 基本单位检验数量 | string | FQCheckQty |
| FAuxQCheckQty | 检验数量 | string | FAuxQCheckQty |
| FSecQCheckQty | 辅助单位检验数量 | string | FSecQCheckQty |
| FRelateQty | 检验基本关联数量 | string | FRelateQty |
| FAuxRelateQty | 检验关联数量 | string | FAuxRelateQty |
| FSecRelateQty | 辅助单位检验关联数量 | string | FSecRelateQty |
| FQtyPass | 基本单位合格数量 | string | FQtyPass |
| FAuxQtyPass | 合格数量 | string | FAuxQtyPass |
| FSecQtyPass | 辅助单位合格数量 | string | FSecQtyPass |
| FConPassQty | 基本单位让步接收数量 | string | FConPassQty |
| FAuxConPassQty | 让步接收数量 | string | FAuxConPassQty |
| FSecConPassQty | 辅助单位让步接收数量 | string | FSecConPassQty |
| FNotPassQty | 基本单位不合格数量 | string | FNotPassQty |
| FAuxNotPassQty | 不合格数量 | string | FAuxNotPassQty |
| FSampleBreakQty | 基本单位样本破坏数量 | string | FSampleBreakQty |
| FSecNotPassQty | 辅助单位不合格数量 | string | FSecNotPassQty |
| FSecSampleBreakQty | 辅助单位样本破坏数量 | string | FSecSampleBreakQty |
| FScrapQty | 基本单位报废数量 | string | FScrapQty |
| FConCommitQty | 入库基本关联数量 | string | FConCommitQty |
| FAuxConCommitQty | 入库关联数量 | string | FAuxConCommitQty |
| FBackQty | 退料基本关联数量 | string | FBackQty |
| FDeliveryNoticeFID | 交货通知单内码 | string | FDeliveryNoticeFID |
| FAuxBackQty | 退料关联数量 | string | FAuxBackQty |
| FDeliveryNoticeEntryID | 交货通知单分录 | string | FDeliveryNoticeEntryID |
| FSecScrapQty | 辅助单位报废数量 | string | FSecScrapQty |
| FSecConCommitQty | 辅助单位入库关联数量 | string | FSecConCommitQty |
| FSecBackQty | 辅助单位退料关联数量 | string | FSecBackQty |
| FScrapInCommitQty | 报废入库基本关联数量 | string | FScrapInCommitQty |
| FSecScrapInCommitQty | 辅助单位报废入库关联数量 | string | FSecScrapInCommitQty |
| FAuxQtyMust | 应收数量 | string | FAuxQtyMust |
| FQtyMust | 基本单位应收数量 | string | FQtyMust |
| FAuxPickQty | 挑选使用数量 | string | FAuxPickQty |
| FPickQty | 基本单位挑选使用数量 | string | FPickQty |
| FSamBillNo | 样品试制单号 | string | FSamBillNo |
| FSamEntryID | 样品试制单行号 | string | FSamEntryID |
| FSamInterID | 样品试制单内码 | string | FSamInterID |
| FSecPickQty | 辅助单位挑选使用数量 | string | FSecPickQty |
| FTime | 打样次数 | string | FTime |
| FBarCodeListID | WMS条码外键 | string | FBarCodeListID |
| Top | 当前记录数 | string | 90000000 |
| PageSize | 每页条数 | string | {{PAGINATION_PAGE_SIZE}} |
| PageIndex | 开始行索引 | string | _function {{PAGINATION_START_PAGE}}+1 |
| Filter | 过滤条件 | string | [FCheckDate]>='{{LAST_SYNC_TIME date}}' and [FCheckerID] > 0 |
| Fields | 需查询的字段key集合 | array | |
| SelectPage | SelectPage | string | 2 |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
| Fdate | 日期 | string | |
| FPOStyle | 采购方式 | string | |
| FBizType | 业务类型 | string | |
| FWWType | 委外类型 | string | |
| FAreaPS | 采购范围 | string | |
| FFetchAdd | 交货地点 | string | |
| FStockID | 收料仓库 | string | |
| FSupplyID | 供应商 | string | |
| FRelateBrID | 供货机构 | string | |
| FClassTypeID | 事务类型 | string | |
| FExplanation | 摘要 | string | |
| FCurrencyID | 币别 | string | |
| FSelTranType | 源单类型(选单) | string | |
| FSelBillNo | 选单号 | string | |
| FExchangeRate | 汇率 | string | |
| FBillNo | 编号 | string | |
| FExchangeRateType | 汇率类型 | string | |
| FPOMode | 采购模式 | string | |
| FCheckerID | 审核 | string | |
| FCheckDate | 审核日期 | string | |
| FFManagerID | 主管 | string | |
| FDeptID | 部门 | string | |
| FEmpID | 业务员 | string | |
| FBillerID | 制单 | string | |
| FManageType | 保税监管类型 | string | |
| FEntryID2 | 行号 | string | |
| FAuxSampleBreakQty | 样本破坏数量 | string | |
| FAuxScrapInCommitQty | 报废入库关联数量 | string | |
| FAuxScrapQty | 报废数量 | string | |
| FMapNumber | 对应代码 | string | |
| FMapName | 对应名称 | string | |
| FItemID | 物料代码 | string | |
| FItemName | 物料名称 | string | |
| FItemModel | 规格型号 | string | |
| FAuxPropID | 辅助属性 | string | |
| FBaseUnit | 基本单位名称 | string | |
| FBatchNo | 批号 | string | |
| FQty | 基本单位数量 | string | |
| FUnitID | 单位 | string | |
| Fauxqty | 数量 | string | |
| FSecUnitID | 辅助单位 | string | |
| FSecCoefficient | 换算率 | string | |
| FSecQty | 辅助数量 | string | |
| Fauxprice | 单价 | string | |
| Famount | 金额 | string | |
| Fnote | 备注 | string | |
| FDischarged | 紧急放行 | string | |
| FKFDate | 生产/采购日期 | string | |
| FKFPeriod | 保质期(天) | string | |
| FPeriodDate | 有效期至 | string | |
| FStockID1 | 收料仓库 | string | |
| FDCSPID | 仓位 | string | |
| FSourceBillNo | 源单单号 | string | |
| FSourceTranType | 源单类型 | string | |
| FSourceInterId | 源单内码 | string | |
| FSourceEntryID | 源单分录 | string | |
| FContractBillNo | 合同单号 | string | |
| FContractInterID | 合同内码 | string | |
| FContractEntryID | 合同分录 | string | |
| FOrderBillNo | 订单单号 | string | |
| FOrderInterID | 订单内码 | string | |
| FOrderEntryID | 订单分录 | string | |
| FAuxPropCls | 辅助属性类别 | string | |
| FPlanMode | 计划模式 | string | |
| FMTONo | 计划跟踪号 | string | |
| FOrderType | 订单类型 | string | |
| FCheckMethod | 检验方式 | string | |
| FQCheckQty | 基本单位检验数量 | string | |
| FAuxQCheckQty | 检验数量 | string | |
| FSecQCheckQty | 辅助单位检验数量 | string | |
| FRelateQty | 检验基本关联数量 | string | |
| FAuxRelateQty | 检验关联数量 | string | |
| FSecRelateQty | 辅助单位检验关联数量 | string | |
| FQtyPass | 基本单位合格数量 | string | |
| FAuxQtyPass | 合格数量 | string | |
| FSecQtyPass | 辅助单位合格数量 | string | |
| FConPassQty | 基本单位让步接收数量 | string | |
| FAuxConPassQty | 让步接收数量 | string | |
| FSecConPassQty | 辅助单位让步接收数量 | string | |
| FNotPassQty | 基本单位不合格数量 | string | |
| FAuxNotPassQty | 不合格数量 | string | |
| FSampleBreakQty | 基本单位样本破坏数量 | string | |
| FSecNotPassQty | 辅助单位不合格数量 | string | |
| FSecSampleBreakQty | 辅助单位样本破坏数量 | string | |
| FScrapQty | 基本单位报废数量 | string | |
| FConCommitQty | 入库基本关联数量 | string | |
| FAuxConCommitQty | 入库关联数量 | string | |
| FBackQty | 退料基本关联数量 | string | |
| FDeliveryNoticeFID | 交货通知单内码 | string | |
| FAuxBackQty | 退料关联数量 | string | |
| FDeliveryNoticeEntryID | 交货通知单分录 | string | |
| FSecScrapQty | 辅助单位报废数量 | string | |
| FSecConCommitQty | 辅助单位入库关联数量 | string | |
| FSecBackQty | 辅助单位退料关联数量 | string | |
| FScrapInCommitQty | 报废入库基本关联数量 | string | |
| FSecScrapInCommitQty | 辅助单位报废入库关联数量 | string | |
| FAuxQtyMust | 应收数量 | string | |
| FQtyMust | 基本单位应收数量 | string | |
| FAuxPickQty | 挑选使用数量 | string | |
| FPickQty | 基本单位挑选使用数量 | string | |
| FSamBillNo | 样品试制单号 | string | |
| FSamEntryID | 样品试制单行号 | string | |
| FSamInterID | 样品试制单内码 | string | |
| FSecPickQty | 辅助单位挑选使用数量 | string | |
| FTime | 打样次数 | string | |
| FBarCodeListID | WMS条码外键 | string | |
黑湖MES接口明细
- API:openapi/v1/order/procure_order/import
- NAME:导入采购清单
- METHOD:POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
| procureOrders | array | details | |
| procureOrders.procureOrderCode | 单号 | {{FBillNo}} | |
| procureOrders.supplierCode | 供应商 | test | |
| procureOrders.amountPlanned | 数量 | {{details.FQty}} | |
| procureOrders.demandTime | 时间 | {{Fdate datex}} | |
| procureOrders.unitName | 单位 | {{details.FUnitID_DSPName}} | |
| procureOrders.erpline | 行号 | {{details.FEntryID2}} | |
| procureOrders.note | 单头备注 | | |
| procureOrders.materialCode | materialCode | {{details.FItemID_FNDName}} | |
系统数据集成价值
从API服务总线层面解决企业烟囱式业务系统集成现状 相互连接企业各业务系统,实现流程端到端打通,复用已有的业务系统能力,让集成架构、服务关系更清晰 使用统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升API利用率,发挥业务系统价值,实现企业IT资产的可插拔、可复用、可组成。


