1、奇门接入白皮书 1 奇门标准化协议白皮书 V3.9.5 阿里巴巴集团 2019 奇门接入白皮书 2 1 版本记录 Date Version Description 2015.03.27 1.0 1、奇门标准化协议 v1.0 发布 2015.03.31 1.2 1、增加入库单更新，出库单更新，库存异动更新等 3 个接口 2、API 名称区分了 erp 和 wms 3、优化部分字段命名 2015.04.07 1.3 1、将 auditor 相关的字段统一成 operator 2015.04.09 1.4 1、更新接口规范，新增“奇门与 wms 的通信协议”等相关内容 2、新增入库单，去掉一个重复的

2、入库单编码 2015.04.14 1.5 1、加入奇门项目服务商解决方案章节 2、增加通信协议里的反向协议标准 3、更新个别字段名，如 Quantity 更新为 Qty，stockSelectedQty 等字段名中将 stock 去掉，变为selectedQty。 2015.5.6 2.0 1、加入菜鸟仓业务接口支持 2、接口整体改动较大，主要增加业务接口和原有接口内增加字段 2015.5.7 2.1 1、出入库单据增加 ERP 行号的概念 2、出库单流水接口升级为订单流水接口 3、仓内加工单更名为 storeprocess 4、发货单确认接口的生产日期 produceDate 变更为prod

3、uctDate 5 、 退 货 入 库 单 创 建 接 口 orderLine 节 点 中 增 加ownerCode 字段；入库单创建接口中 ownerCode 移到orderLine 节点中 2015.5.20 2.1 1、取消订单，订单类型变为非必填 2、发货单创建，付款时间变为非必填 3、所有地址中的区域改为非必填 4、退货入库单确认接口，物流公司编码改为非必填 2015.6.5 2.2 1、增加“出库单创建”，“出库单确认”接口 2015.6.10 2.2 1、“出库单创建”增加货主编码字段 奇门接入白皮书 3 2、增加“订单状态查询”和“库存查询”两个接口 3、规范“冻结库存”的使用

4、范围 2015.6.11 2.2 1、增加“组合商品接口” 2、入库单的收件人，发件人，物流公司信息为非必填 3、新增入库单类型：生产入库、领用入库、残次品入库。 4、入库单新增字段，采购单号 5、盘点单新增字段，盘点时间 6、新增“库存异动接口” 7、“订单状态查询”不仅查当前状态，历史状态也可以 8、“普通出库单”增加发件人信息 2015.6.12 2.2 1、“组合商品创建接口”和“订单流水查询接口“，去掉 warehouseCode 编码 2 、“ 订单 流水查 询接 口” 和“ 库存 查询 接口 ”response 增加的 flag，code，message 这三个标准的应答。 20

5、15.6.25 2.2 1、增加发货单查询接口 2015.7.2 2.2 1、订单状态查询增加两个入库状态（PARTFULFILLED-部分收货完成, FULFILLED-收货完成。） 2、库存查询接口增加货主编码 ownerCode 2015.7.3 2.2 1、退货入库创建接口：商品增加批次等信息 2、发货单创建接口，发票增加普通发票的类型 3、订单流水查询接口，删除 NEW 状态 4、订单流水通知接口，删除NEW，CANCELEDFAIL状态 5、发货单创建和发货单缺货通知接口，在 item 节点下增加 inventoryType 等字段 2015.7.6 2.2 1、商品同步接口的 b

6、arcode 可以填多个 2、发货单创建增加字段“deliveryType” 3、发货单创建返回值支持统仓统配的拆单 4、发票内容格式化 5、增加 B2B 出库的出库类型 6、入库单确认接口的 entryOrderId 改为条件必填 7、extendProps 和 remark 统一定义了 奇门接入白皮书 4 8、退货单创建和确认接口增加批次信息 9、订单流水查询删除 CANCELFAILED 状态 10、订单流水通知接口删除 NEW,CANCELFAILED 状态 11 、 发 货 单 缺 货 通 知 接 口item节 点 下 增 加inventoryType 和批次信息 2015.7.9