从金蝶K3-WISE到黑湖MES通过接口配置打通数据|轻易云数据集成平台

从金蝶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
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
Top	当前记录数	string	金蝶的查询分页参数
PageSize	每页条数	string	金蝶的查询分页参数
PageIndex	开始行索引	string	金蝶的查询分页参数
Filter	过滤条件	string	需要先去k3增加自定义字段示例写法 [Fdate]>='{{LAST_SYNC_TIME dateTime}}'
Fields	需查询的字段key集合	array	金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber
SelectPage	SelectPage	string

响应参数

字段	名称	类型	描述
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接口明细

接口：openapi/v1/order/procure_order/import
接口名称：导入采购清单
接口方法：POST

请求参数

字段	名称	类型	描述
procureOrders	array	array
procureOrders.procureOrderCode	单号	string
procureOrders.supplierCode	供应商	string
procureOrders.amountPlanned	数量	string
procureOrders.demandTime	时间	string
procureOrders.unitName	单位	string
procureOrders.erpline	行号	string
procureOrders.note	单头备注	string
procureOrders.materialCode	materialCode	string

数据对接价值

从API服务总线层面解决企业烟囱式业务系统集成现状相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。