奇门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 | 响应结果:success | failure | | 响应结果:success failure |
| code | 响应码 | | 响应码 |
| message | 响应信息 | | 响应信息 |
| totalLines | orderLines总条数 | | 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 | 业务对象表单Id | PUR_MRB | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
| FPURMRBENTRY.Operation | 执行的操作 | batchSave | |
| FPURMRBENTRY.IsAutoSubmitAndAudit | 提交并审核 | false | |
| FPURMRBENTRY.IsVerifyBaseDataField | 验证基础资料 | false | 是否验证所有的基础资料有效性，布尔类，默认false（非必录） |
| FPURMRBENTRY.SubSystemId | 系统模块 | 21 | 默认仓库模块 |
数据对接效果
全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系。API低代码开发平台能够实现低代码或零代码一键发布API服务，很好地解决企业用户上面的问题。轻易云应用集成主要解决已有应用系统的无序蔓延现象，减少各业务系统间的维护成本，减少各应用系统的操作系统、开发语言、访问协议、通信技术多而杂、整合难度大的问题，将企业数据平滑对接，减少信息竖井。
