黑湖MES和金蝶K3-WISE单据接口对接

对接源平台:金蝶K3-WISE
金蝶K/3WISE是智慧工厂ERP的首选品牌。金蝶K/3WISE推出了国内首个可落地的、可交付的智能制造解决方案,通过有步骤的制造体系改革,帮助中国中小型企业能够在短期内实现智能制造的转型与升级。
对接目标系统:黑湖MES
黑湖智造旗下的制造协同SaaS软件于2018年正式上线以来,在短短两年时间内,服务了中国大陆、港澳台、东南亚近2000家制造企业及其供应链,覆盖了近20个细分行业的全链路生产场景。为不同流程、不同目标的客户提供最贴合的解决方案,赋能了包括农夫山泉、蜜雪冰城、华润医药、三九药业、沃森生物、中国石化、欧莱雅、中国兵器、中信戴卡、特斯拉、小米等众多头部企业及其供应链。
数据接口配置方案
通过轻易云系统数据集成平台:数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统:金蝶K3-WISE,然后选择对应的连接器。选择对应的Delivery_Notice/GetList作为数据对接来源。然后再写入目标平台配置目标系统为黑湖MES,并且选择对应连接器(关于黑湖MES的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息)。选择好对应的openapi/v1/order/delivery_request/import接口作为数据写入动作完成第一步的接口配置。

金蝶K3-WISE接口明细
- 调用接口:Delivery_Notice/GetList
- 接口名称:查询发货通知
- 方法:POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
| Fdate | 日期 | string | Fdate |
| FFetchAdd | 交货地点 | string | FFetchAdd |
| FRelateBrID | 订货机构 | string | FRelateBrID |
| FAreaPS | 销售范围 | string | FAreaPS |
| FSalType | 销售方式 | string | FSalType |
| FSettleID | 结算方式 | string | FSettleID |
| FCustID | 购货单位 | string | FCustID |
| FStockID | 仓库 | string | FStockID |
| FExplanation | 摘要 | string | FExplanation |
| FCurrencyID | 币别 | string | FCurrencyID |
| FTranType | 事务类型 | string | FTranType |
| FSelTranType | 源单类型(选单) | string | FSelTranType |
| FSelBillNo | 选单号 | string | FSelBillNo |
| FExchangeRate | 汇率 | string | FExchangeRate |
| FBillNo | 编号 | string | FBillNo |
| FCheckerID | 审核人 | string | FCheckerID |
| FCheckDate | 审核日期 | string | FCheckDate |
| FManagerID | 主管 | string | FManagerID |
| FDeptID | 部门 | string | FDeptID |
| FEmpID | 业务员 | string | FEmpID |
| FBillerID | 制单 | string | FBillerID |
| FManageType | 保税监管类型 | string | FManageType |
| FExchangeRateType | 汇率类型 | string | FExchangeRateType |
| FEntryID2 | 行号 | string | FEntryID2 |
| FMapNumber | 对应代码 | string | FMapNumber |
| FMapName | 对应名称 | string | FMapName |
| FItemID | 产品代码 | string | FItemID |
| FItemName | 产品名称 | string | FItemName |
| FItemModel | 规格型号 | string | FItemModel |
| FAuxPropID | 辅助属性 | string | FAuxPropID |
| FBaseUnit | 基本单位名称 | string | FBaseUnit |
| 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 |
| 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 |
| FFetchDate | 交货日期 | string | FFetchDate |
| FStockID1 | 仓库 | string | FStockID1 |
| FAuxPropCls | 辅助属性类别 | string | FAuxPropCls |
| FStdAmount | 金额(本位币) | string | FStdAmount |
| FPlanMode | 计划模式 | string | FPlanMode |
| FMTONo | 计划跟踪号 | string | FMTONo |
| FBatchNo | 批号 | string | FBatchNo |
| FCommitQty | 基本单位关联数量 | string | FCommitQty |
| FAuxCommitQty | 关联数量 | string | FAuxCommitQty |
| FSecCommitQty | 辅助单位关联数量 | string | FSecCommitQty |
| FSecStockQty | 辅助单位出库数量 | string | FSecStockQty |
| FStockQty | 基本单位出库数量 | string | FStockQty |
| FAuxStockQty | 出库数量 | string | FAuxStockQty |
| FBarCodeListID | WMS条码外键 | string | FBarCodeListID |
| FClientOrderNo | 客户订单号 | string | FClientOrderNo |
| FClientEntryID | 客户订单行号 | string | FClientEntryID |
| 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 | 1 |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
| Fdate | 日期 | string | |
| FFetchAdd | 交货地点 | string | |
| FRelateBrID | 订货机构 | string | |
| FAreaPS | 销售范围 | string | |
| FSalType | 销售方式 | string | |
| FSettleID | 结算方式 | string | |
| FCustID | 购货单位 | string | |
| FStockID | 仓库 | string | |
| FExplanation | 摘要 | string | |
| FCurrencyID | 币别 | string | |
| FTranType | 事务类型 | string | |
| FSelTranType | 源单类型(选单) | string | |
| FSelBillNo | 选单号 | string | |
| FExchangeRate | 汇率 | string | |
| FBillNo | 编号 | string | |
| FCheckerID | 审核人 | string | |
| FCheckDate | 审核日期 | string | |
| FManagerID | 主管 | string | |
| FDeptID | 部门 | string | |
| FEmpID | 业务员 | string | |
| FBillerID | 制单 | string | |
| FManageType | 保税监管类型 | string | |
| FExchangeRateType | 汇率类型 | string | |
| FEntryID2 | 行号 | string | |
| FMapNumber | 对应代码 | string | |
| FMapName | 对应名称 | string | |
| FItemID | 产品代码 | string | |
| FItemName | 产品名称 | string | |
| FItemModel | 规格型号 | string | |
| FAuxPropID | 辅助属性 | string | |
| FBaseUnit | 基本单位名称 | string | |
| FQty | 基本单位数量 | string | |
| FUnitID | 单位 | string | |
| Fauxqty | 数量 | string | |
| FSecUnitID | 辅助单位 | string | |
| FSecCoefficient | 换算率 | string | |
| FSecQty | 辅助数量 | string | |
| Fauxprice | 单价 | string | |
| Famount | 金额 | string | |
| Fnote | 备注 | string | |
| FSourceBillNo | 源单单号 | string | |
| FSourceTranType | 源单类型 | string | |
| FSourceInterId | 源单内码 | string | |
| FSourceEntryID | 源单分录 | string | |
| FContractBillNo | 合同单号 | string | |
| FContractInterID | 合同内码 | string | |
| FContractEntryID | 合同分录 | string | |
| FOrderBillNo | 订单单号 | string | |
| FOrderInterID | 订单内码 | string | |
| FOrderEntryID | 订单分录 | string | |
| FFetchDate | 交货日期 | string | |
| FStockID1 | 仓库 | string | |
| FAuxPropCls | 辅助属性类别 | string | |
| FStdAmount | 金额(本位币) | string | |
| FPlanMode | 计划模式 | string | |
| FMTONo | 计划跟踪号 | string | |
| FBatchNo | 批号 | string | |
| FCommitQty | 基本单位关联数量 | string | |
| FAuxCommitQty | 关联数量 | string | |
| FSecCommitQty | 辅助单位关联数量 | string | |
| FSecStockQty | 辅助单位出库数量 | string | |
| FStockQty | 基本单位出库数量 | string | |
| FAuxStockQty | 出库数量 | string | |
| FBarCodeListID | WMS条码外键 | string | |
| FClientOrderNo | 客户订单号 | string | |
| FClientEntryID | 客户订单行号 | string | |
黑湖MES接口明细
- API:openapi/v1/order/delivery_request/import
- NAME:创建销售发运
- METHOD:POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
| code | 单号 | {{FBillNo}} | |
| warehouseCode | 发出仓库 | {{details.FStockID1_FNDName}} | |
| items | 物料行 | details | |
| items.materialCode | 物料编号 | {{details.FItemID_FNDName}} | |
| items.amountPlan | 计划数 | {{details.FQty}} | |
| items.unit | 单位 | {{details.FBaseUnit}} | |
| items.line | 行序号 | {{details.FEntryID2}} | |
| items.deliveryDate | 交货日期 | | |
| items.lineDesc | 行备注 | {{details.Fnote}} | |
| items.customCode | 客户编码 | | |
| items.requireTime | 需求时间 | | |
| items.headDesc | 单头备注 | | |
| items.array | array | deliveryList | |
系统对接概况
全面管控企业的API资产,梳理现有业务系统的API。实现API文档的统一管理,建立API的上线、下线、监控的统一管理体系。API低代码开发平台能够实现低代码或零代码一键发布API服务,很好地解决企业用户上面的问题。轻易云应用集成主要解决已有应用系统的无序蔓延现象,减少各业务系统间的维护成本,减少各应用系统的操作系统、开发语言、访问协议、通信技术多而杂、整合难度大的问题,将企业数据平滑对接,减少信息竖井。
