奇门WMS-A与金蝶云星空对接集成入库单查询接口打通采购退货新增

接入系统：奇门WMS-A

用于菜鸟的仓库（使用其他支持奇门的仓库同理），故而希望能和仓库的wms系统打通，这样我们采购收货，采购入库，销售出库，采购退货，销售退货等多个场景就能和我们的中台（erp）进行数据同步。

对接系统：金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

系统对接接口配置

通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：奇门WMS-A，并且选择对应的连接器（关于奇门WMS-A的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的入库单查询接口接口作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器。选择对应的采购退货新增接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。

奇门WMS-A接口明细

API：stockout.query
NAME：入库单查询接口
METHOD：POST

请求参数

接口字段字段名称预设值描述 ownerCode货主编码货主编码 warehouseCode仓库编码仓库编码 entryOrderCode入库单编码入库单编码 entryOrderId仓储系统入库单ID仓储系统入库单ID page当前页当前页(从1开始) pageSize每页orderLine条数每页orderLine条数(最多100条) extendProps扩展属性扩展属性 remark备注备注

响应参数

接口字段字段名称预设值描述 flag响应结果:successfailure响应结果:success failure code响应码响应码 message响应信息响应信息 totalLinesorderLines总条数orderLines总条数 entryOrder入库单信息入库单信息 entryOrder.entryOrderCode入库单号入库单号 entryOrder.ownerCode货主编码货主编码 entryOrder.warehouseCode仓库编码仓库编码(统仓统配等无需ERP指定仓储编码的情况填OTHER) entryOrder.entryOrderId仓储系统入库单ID仓储系统入库单ID entryOrder.entryOrderType入库单类型入库单类型(SCRK=生产入库;LYRK=领用入库;CCRK=残次品入库;CGRK=采购入库;DBRK=调拨入库;QTRK=其他入库;B2BRK=B2B入库) entryOrder.status入库单状态入库单状态(NEW-未开始处理;ACCEPT-仓库接单;PARTFULFILLED-部分收货完成;FULFILLED-收货完成;EXCEPTION-异常;CANCELED-取消;CLOSED-关闭;REJECT-拒单;CANCELEDFAIL-取消失败;只传英文编码) entryOrder.operateTime操作时间操作时间(YYYY-MM-DD HH:MM:SS;当status=FULFILLED;operateTime为入库时间) entryOrder.orderLines入库单单据信息入库单单据信息 entryOrder.orderLines.orderLineNo入库单的行号入库单的行号 entryOrder.orderLines.itemCode商品编码商品编码 entryOrder.orderLines.itemId仓储系统商品ID仓储系统商品ID entryOrder.orderLines.itemName商品名称商品名称 entryOrder.orderLines.planQty应收商品数量应收商品数量 entryOrder.orderLines.actualQty实收数量实收数量 entryOrder.orderLines.inventoryType库存类型库存类型(ZP=正品;CC=残次;JS=机损;XS=箱损;默认为ZP) entryOrder.orderLines.productDate商品生产日期商品生产日期(YYYY-MM-DD) entryOrder.orderLines.expireDate商品过期日期商品过期日期(YYYY-MM-DD) entryOrder.orderLines.produceCode生产批号生产批号 entryOrder.orderLines.batchCode批次编码批次编码 entryOrder.orderLines.remark备注备注

金蝶云星空接口明细

API：batchSave
NAME：采购退货新增
METHOD：POST

请求参数

接口字段字段名称预设值描述 FBillNo单据编号{{deliveryOrderCode}}单据编号 FDate退料日期{{orderConfirmTime}}日期 FMRTYPE退料类型findCollection find FBusinessType from from 66853b32-56f1-37b1-b875-e4d4567fd35b where FBillNo={{deliveryOrderCode}}下拉列表 FMRMODE退料方式B下拉列表 FStockOrgId退料组织{[warehouseCode}}组织 FDESCRIPTION备注多行文本 FSupplierID供应商_findCollection find FSUPPLIERID_Fnumber from 66853b32-56f1-37b1-b875-e4d4567fd35b where FBillNo={{deliveryOrderCode}}文本 FCARRYNO运输单号文本 FTAKEDELIVERYNO提货单号文本 FSettleCurrId结算币别PRE001基础资料 FOwnerIdHead货主findCollection find FRequireOrgId_Fnumber from 66853b32-56f1-37b1-b875-e4d4567fd35b where FBillNo={{deliveryOrderCode}}多类别基础资料 FPURMRBENTRY明细信息orderLines明细信息 FPURMRBENTRY.FMATERIALID物料编码{{orderLines.itemCode}}基础资料 FPURMRBENTRY.FAuxPropID销售渠道_findCollection find FAUXPROPID from 66853b32-56f1-37b1-b875-e4d4567fd35b where FBillNo={{deliveryOrderCode}} FMATERIALID_Fnumber={{orderLines.itemCode}}文本 FPURMRBENTRY.FRMREALQTY实退数量{{orderLines.actualQty}}数量 FPURMRBENTRY.FKEAPAMTQTY扣款数量数量 FPURMRBENTRY.FSTOCKID仓库{{warehouseCode}}基础资料 FPURMRBENTRY.FStockStatusId库存状态KCZT01_SYS维度关联字段 FPURMRBENTRY.FNOTE备注文本 FPURMRBENTRY.FPrice单价单价 FPURMRBENTRY.FGiveAway是否赠品复选框 FPURMRBENTRY.FLot批号{{orderLines.batchCode}}批次 FPURMRBENTRY.FOWNERID货主{{warehouseCode}}多类别基础资料 FPURMRBENTRY.FOWNERTYPEID货主类型BD_OwnerOrg多类别基础资料列表 FPURMRBENTRY.FProduceDate生产日期{{orderLines.productDate}}小数 FPURMRBENTRY.FEXPIRYDATE到日期{{orderLines.expireDate}}小数 FPURMRBENTRY.FTAXPRICE含税单价{{orderLines.price}}单价 FPURMRBENTRY.FORDERNO订单单号文本 FPURMRBENTRY.FCONTRACTNO合同单号文本 FPURMRBENTRY.FMtoNo计划跟踪号文本 FPURMRBENTRY.FPURMRBENTRY_Link关联关系表 FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FRuleId转换规则PUR_MRAPP-PUR_MRB FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSTableName源单表T_PUR_MRAPPENTRY FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSBillId源单内码findCollection find FID from 66853b32-56f1-37b1-b875-e4d4567fd35b where FBillNo={{deliveryOrderCode}} FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSId源单分录内码_findCollection find FEntity_FEntryID from 66853b32-56f1-37b1-b875-e4d4567fd35b where FBillNo={{deliveryOrderCode}} FMATERIALID_Fnumber={{orderLines.itemCode}} FPURMRBENTRY.FormId业务对象表单IdPUR_MRB必须填写金蝶的表单ID如😛UR_PurchaseOrder FPURMRBENTRY.Operation执行的操作batchSave FPURMRBENTRY.IsAutoSubmitAndAudit提交并审核false FPURMRBENTRY.IsVerifyBaseDataField验证基础资料false是否验证所有的基础资料有效性，布尔类，默认false（非必录） FPURMRBENTRY.SubSystemId系统模块21默认仓库模块

数据对接效果

全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系。API低代码开发平台能够实现低代码或零代码一键发布API服务，很好地解决企业用户上面的问题。轻易云应用集成主要解决已有应用系统的无序蔓延现象，减少各业务系统间的维护成本，减少各应用系统的操作系统、开发语言、访问协议、通信技术多而杂、整合难度大的问题，将企业数据平滑对接，减少信息竖井。

奇门WMS-A与金蝶云星空对接集成入库单查询接口打通采购退货新增