金蝶云星空对接外部奇门WMS-A系统
对接系统奇门WMS-A
用于菜鸟的仓库（使用其他支持奇门的仓库同理），故而希望能和仓库的wms系统打通，这样我们采购收货，采购入库，销售出库，采购退货，销售退货等多个场景就能和我们的中台（erp）进行数据同步。
集成系统:金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
接口方案配置
数据集成平台对应的配置奇门WMS-A与金蝶云星空的对接只要三步就能完成两个系统之间的数据对接。第一步根据奇门WMS-A的接口参数要求记录在轻易云集成平台。第二步配置奇门WMS-A与金蝶云星空之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。数据管道ETL：构建一体化的数据融合平台。高级数据转换： 支持公式转换数据格式、支持脚本直接进行数据转换、支持可视化多维度数据处理。高性能实时处理：针对不同数据节点类型提供TB级吞吐量，秒级延迟的增量数据处理能力。自动将旧版web服务转变为基于云端微服务的API，统一接口输出标准。支持接口开放服务，实现内外部能力接入。
奇门WMS-A接口明细
- 接口：stockout.query
- 接口名称：入库单查询接口
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 |
|---|
| pageSize | 每页orderLine条数 | string |
| warehouseCode | 仓库编码 | string |
| entryOrderId | 仓储系统入库单ID | string |
| remark | 备注 | string |
| page | 当前页 | string |
| extendProps | 扩展属性 | string |
| ownerCode | 货主编码 | string |
| entryOrderCode | 入库单编码 | string |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| flag | 响应结果:success | failure | string | 响应结果:success failure |
| code | 响应码 | string | 响应码 |
| message | 响应信息 | string | 响应信息 |
| totalLines | orderLines总条数 | string | orderLines总条数 |
| entryOrder | 入库单信息 | object | 入库单信息 |
| entryOrder.entryOrderCode | 入库单号 | string | 入库单号 |
| entryOrder.ownerCode | 货主编码 | string | 货主编码 |
| entryOrder.warehouseCode | 仓库编码 | string | 仓库编码(统仓统配等无需ERP指定仓储编码的情况填OTHER) |
| entryOrder.entryOrderId | 仓储系统入库单ID | string | 仓储系统入库单ID |
| entryOrder.entryOrderType | 入库单类型 | string | 入库单类型(SCRK=生产入库;LYRK=领用入库;CCRK=残次品入库;CGRK=采购入库;DBRK=调拨入库;QTRK=其他入 库;B2BRK=B2B入库) |
| entryOrder.status | 入库单状态 | string | 入库单状态(NEW-未开始处理;ACCEPT-仓库接单;PARTFULFILLED-部分收货完成;FULFILLED-收货完成;EXCEPTION-异 常;CANCELED-取消;CLOSED-关闭;REJECT-拒单;CANCELEDFAIL-取消失败;只传英文编码) |
| entryOrder.operateTime | 操作时间 | string | 操作时间(YYYY-MM-DD HH:MM:SS;当status=FULFILLED;operateTime为入库时间) |
| entryOrder.orderLines | 入库单单据信息 | array | 入库单单据信息 |
| entryOrder.orderLines.orderLineNo | 入库单的行号 | string | 入库单的行号 |
| entryOrder.orderLines.itemCode | 商品编码 | string | 商品编码 |
| entryOrder.orderLines.itemId | 仓储系统商品ID | string | 仓储系统商品ID |
| entryOrder.orderLines.itemName | 商品名称 | string | 商品名称 |
| entryOrder.orderLines.planQty | 应收商品数量 | string | 应收商品数量 |
| entryOrder.orderLines.actualQty | 实收数量 | string | 实收数量 |
| entryOrder.orderLines.inventoryType | 库存类型 | string | 库存类型(ZP=正品;CC=残次;JS=机损;XS=箱损;默认为ZP) |
| entryOrder.orderLines.productDate | 商品生产日期 | string | 商品生产日期(YYYY-MM-DD) |
| entryOrder.orderLines.expireDate | 商品过期日期 | string | 商品过期日期(YYYY-MM-DD) |
| entryOrder.orderLines.produceCode | 生产批号 | string | 生产批号 |
| entryOrder.orderLines.batchCode | 批次编码 | string | 批次编码 |
| entryOrder.orderLines.remark | 备注 | string | 备注 |
金蝶云星空接口明细
- 接口：batchSave
- 接口名称：采购退货新增
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 |
|---|
| FSupplierID | 供应商 | string |
| FDESCRIPTION | 备注 | string |
| FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FRuleId | 转换规则 | string |
| FPURMRBENTRY.FOWNERID | 货主 | string |
| FBillNo | 单据编号 | string |
| FPURMRBENTRY.IsVerifyBaseDataField | 验证基础资料 | bool |
| FOwnerIdHead | 货主 | string |
| FPURMRBENTRY.FOWNERTYPEID | 货主类型 | string |
| FPURMRBENTRY.FNOTE | 备注 | string |
| FPURMRBENTRY.FAuxPropID | 销售渠道 | string |
| FPURMRBENTRY.FGiveAway | 是否赠品 | string |
| FPURMRBENTRY.FPrice | 单价 | string |
| FPURMRBENTRY.FORDERNO | 订单单号 | string |
| FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSId | 源单分录内码 | string |
| FPURMRBENTRY.IsAutoSubmitAndAudit | 提交并审核 | bool |
| FPURMRBENTRY.FMtoNo | 计划跟踪号 | string |
| FTAKEDELIVERYNO | 提货单号 | string |
| FPURMRBENTRY.FSTOCKID | 仓库 | string |
| FSettleCurrId | 结算币别 | string |
| FPURMRBENTRY.FMATERIALID | 物料编码 | string |
| FStockOrgId | 退料组织 | string |
| FMRMODE | 退料方式 | string |
| FPURMRBENTRY.FProduceDate | 生产日期 | string |
| FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSTableName | 源单表 | string |
| FPURMRBENTRY.FormId | 业务对象表单Id | string |
| FPURMRBENTRY.FKEAPAMTQTY | 扣款数量 | string |
| FPURMRBENTRY.SubSystemId | 系统模块 | string |
| FPURMRBENTRY.FPURMRBENTRY_Link | 关联关系表 | array |
| FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSBillId | 源单内码 | string |
| FCARRYNO | 运输单号 | string |
| FPURMRBENTRY.FTAXPRICE | 含税单价 | string |
| FPURMRBENTRY.FStockStatusId | 库存状态 | string |
| FMRTYPE | 退料类型 | string |
| FPURMRBENTRY.Operation | 执行的操作 | string |
| FPURMRBENTRY.FEXPIRYDATE | 到日期 | string |
| FPURMRBENTRY.FCONTRACTNO | 合同单号 | string |
| FPURMRBENTRY.FLot | 批号 | string |
| FPURMRBENTRY.FRMREALQTY | 实退数量 | string |
| FDate | 退料日期 | string |
| FPURMRBENTRY | 明细信息 | array |
系统对接总览
当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。
