| 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、新增入库单，去掉一个重复的入库单编码 |
| 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 变更为 productDate 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、“出库单创建”增加货主编码字段 2、增加“订单状态查询”和“库存查询”两个接口 3、规范“冻结库存”的使用范围 |
| 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 这三个标准的 应答。 |
| 2015.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、商品同步接口的 barcode 可以填多个 2、发货单创建增加字段“deliveryType” 3、发货单创建返回值支持统仓统配的拆单 4、发票内容格式化 5、增加 B2B 出库的出库类型 6、入库单确认接口的 entryOrderId 改为条件必填 7、extendProps 和 remark 统一定义了 8、退货单创建和确认接口增加批次信息 9、订单流水查询删除 CANCELFAILED 状态 10、订单流水通知接口删除 NEW,CANCELFAILED 状态 11 、发货单缺货通知接口 item 节点下增加 inventoryType 和批次信息 |
| 2015.7.9 |
2.2 |
1、B2B 入库和 B2B 出库单据状态多接口修订 2、发货单 SN 通知借口，加上分页，并且将 sns 的节点 去掉 |
| 2015.7.14 |
2.2 |
1、增加库存异动接口，单据类型增加 ZZTZ=状态调整 单 |
| 2015.7.16 |
2.2 |
1、发货单 invoices 下面的 detail 增加 item 节点 2、发货单发货类型的枚举值 CWPS（常温配送）改为 PTPS（普通配送） 3、商品同步 barcode 的分隔符改为； 4、部分warehouseCode重新定义约束和说明 5、库存异动接口更名为库存异动通知接口 |
| 2015.7.17 |
2.2 |
1 、发货单 创建的出参 ， response 节 点 下 增 加 warehouseCode 和 logisticsCode 两个字段，以适配以 前的版本 |
| 2015.7.20 |
2.2 |
1、库存异动接口，结构体变化，将 warehouseCode， ownerCode，orderCode，orderType，outbizCode 等放到 item 节点下 |
| 2015.7.21 |
2.2 |
1、快递编码中增加京东配送（JD），当当宅配（DD） |
| 2015.7.22 |
2.2 |
1、出库单创建和出库单确认接口增加 logisticsCode 字 段 |
| 2015.7.23 |
2.2 |
1、入库单创建、入库单确认、出库单创建、出库单确认 等四个接口增加 totalOrderLines，outBizCode 这两个 字段用于分批传输处理 |
| 2015.7.30 |
2.2 |
1、发货单确认接口增加“包裹理论重量” |
| 2015.8.14 |
2.2 |
1、新增接口订单状态查询接口（批量），用于解决通过 订单最后操作时间的区间值等信息，去批量查询订单 2、发货单创建接口的 orderLine 下面增加 batchCode 等字段，用于解决指定批次发货的问题 |
| 2015.8.20 |
2.2 |
1 、 发 货 单 创 建 接 口 的 orderLine 下 面 增 加 productDate,expireDate 等字段 2、渠道枚举字段调整，凡客由 FK 调整为 VANCL |
| 2015/8/31 |
2.3 |
1、新增 5 个接口，支持用于各种订单在仓内操作结果的 详情查询，包括入库单查询，出库单查询，退货入库单 查询，发货单查询，发货单缺货查询。 2、订单流水查询和订单流水确认接口的 status，增加两 个状态，PARTFULFILLED，FULFILLED 两个状态。 3、入库单确认接口，出库单确认接口，增加单据状态字 段 status。 |
| 2015/9/6 |
2.3 |
1、发货单确认接口，单价和数量字段类型修正 2、所有正向接口，均补充 warehouseCode，作为可能 的一单分多仓的业务场景。 |
| 2015/9/7 |
2.3 |
1、新增接口，为菜鸟自动流转的业务新增的特殊业务接 口。 |
| 2015/9/14 |
2.3 |
1、新增盘点单查询接口 2 、盘点单确认接口和盘点单查询接口均增加 checkOrderId 3、发货单查询接口，为了兼容，入参将 deliveryOrderCode 改为 orderCode,deliveryOrderId 改为 orderId |
| 2015/9/21 |
2.3 |
入库单确认，出库单确认，退货入库单确认，发货单确 认，库存异动通知 |
| 2015/9/22 |
2.3 |
新增心跳接口 |
| 2015/9/24 |
2.3 |
1、订单流水查询接口增加 orderType 2、发货单确认接口 orderType 增加枚举值 QTCK。 |
| 2015/10/10 |
2.3 |
1、库存盘点查询的接口名变更 |
| 2015/10/15 |
2.3 |
1、在发货单确认，发货单查询，退货入库单确认，退货 入库单查询等接口的orderline中增加商品二维码，用于 对单个商品的管理。 |
| 2015/10/20 |
2.3 |
1、新增商品同步接口（批量），发货单创建接口（批 量），发货单确认接口（批量） |
| 2015/10/27 |
2.3 |
1、发货单创建接口的 orderline 下增加 payNo，用于 解决合单后的支付宝交易号的传输。 |
| 2015/11/19 |
2.3 |
1、出库单类型新增采购退货出库类型（CGTH） |
| 2015/11/23 |
2.3 |
1、发货单创建接口，出参 response 下增加 createTime。 |
| 2015/11/25 |
2.4 |
新增 4 个接口，主要用来注册奇门的仓库编码，奇门的 用户号，包括奇门仓库注册接口，奇门仓库查询接口， 奇门仓库更新接口，奇门用户注册接口 |
| 2015/12/3 |
2.4 |
1、新增店铺同步接口 |
| 2015/12/8 |
2.4 |
1、新增库存查询接口（多条件） |
| 2015/12/21 |
2.4 |
1、新增挂起（恢复）接口 2、取消和挂起接口的订单类型增加 THRK=退货入库 |
| 2015/12/28 |
2.4 |
1、组合商品增加 itemId 字段 |
| 2015/12/30 |
2.4 |
1、出库单确认接口，orderline 节点下增加货主编码这 个字段 2、单据取消接口，单据类型增加采购退货出库 |
| 2015/12/31 |
2.4 |
1、商品同步接口，商品同步接口（批量）新增字段 goodsCode |
| 2016/1/11 |
2.4 |
1. 发货单查询接口增加使用交易单查询 2. 订单状态查询返回结果增加交易单号 3. 仓库加工单创建接口增加货主信息和商品配比信息 4. 仓库加工单确认接口增加货主信息 |
| 2016/1/27 |
2.4 |
1. 新增数据字典获取接口 2. 新增数据字典更新接口 |
| 2016/2/17 |
2.4 |
1. 为发货单创建新增异步化的结果返回接口——发货 单创建结果通知接口（批量） |
| 2016/2/18 |
2.4 |
1. 入库单创建、出库单创建接口单据类型增加虚拟入 库、虚拟出库 2. 入库单创建、出库单创建接口增加关联单据节点， 以满足调拨、虚入虚出的业务场景的需求 |
| 2016/2/19 |
2.4 |
1. 新增发货单波次通知接口，用来给 ERP 或者 OMS 回传波次号及对应的发货单号，以支持商家货票同 行、波次内包裹的处理等需求。 |
| 2016/3/8 |
2.4 |
1. sourcePlatformCode 字段添加 MIA=蜜芽 2. 出库单创建接口入参添加字段：供应商编码和供应 商名称 3. 异动通知接口添加异动时间字段 changeTime |
| 2016/3/21 |
2.4 |
物流公司编码中，增加枚举值：AMAZON=亚马逊物 流、DBWL=德邦物流、DBKD=德邦快递、DBKY=德邦 快运 |
| 2016/4/11 |
2.4 |
6.13 发货单创建接口 & 6.14 发货单创建接口 （批量） 两个接口，在 receiverInfo 中新增两个字段： 收件人证件类型，string (50)， 1-身份证 2- 军官证 3-护照 4-其他 收件人证件号码，string (50) 6.16 发货单确认接口 & 6.17 发货单确认接口（批量） 中，新增一个字段： 仓储费用，double (18, 2) |
| 2016/4/28 |
2.4 |
6.13 6.14 两个接口中，字段增加枚举 值：HBP(环保配), |
| 2016/5/19 |
2.5 |
订单流水通知接口 （taobao.qimen.orderprocess.report）& 订单流水查 询接口（taobao.qimen.orderprocess.query）的 processStatus 字段，新增枚举值 （TMSCANCELFAILED=快递拦截失败），对应菜鸟特 有接口配送拦截接口 （taobao.qimen.order.callback），用于异步返回拦截 结果 |
| 2016/5/27 |
2.6 |
发货单查询接口(taobao.qimen.deliveryorder.query), 新增枚举值：SIGN=签收(菜鸟仓可以返回签 收的状态) |
| 2016/6/6 |
2.6 |
所有包括 sourcePlatformCode 字段的接口， sourcePlatformCode 字段添加 GW=商家官网，CT= 村淘 枚举值 |
| 2016/7/7 |
2.6 |
添加一些接口和字段的说明，方便 ISV 理解接口 |
| 2016/7/14 |
2.7 |
删除接口 6.38-6.43。如果需要查看可参考 V2.6 43 个 接口封存版。 删除接口 6.34 菜鸟自动流转查询接口 （扩展），移至 菜鸟专有接口白皮书中。6.13 发货单创建接口新增字段：生产 批号，string(50) |
| 2016/9/10 |
2.8 |
6.13 发货单创建接口 (taobao.qimen.deliveryorder.create)、 6.14 发货单 创建接口（批量） (taobao.qimen.deliveryorder.batchcreate)新增服务 编码字段：服务编码, string (50)， NCWLJH=集包, 条件必填，条件为集包订单发货 |
| 2016/11/22 |
2.9 |
1. 新增 6.19 订单 SN 通知接口 2. 物流公司编码中新增：DBWL=德邦物流、DBKD=德 邦快递、DBKY=德邦快运 |
| 2017/4/28 |
3.0 |
添加调拨单创建、调拨单查询和调拨单通知接口（菜 鸟） |
| 2017/5/3 |
3.0 |
添加承运商 RRS=日日顺 |
| 2017/5/16 |
3.1 |
库存盘点查询通知接口添加商品总量字段： 盘点商品总量，int |
| 2017/6/16 |
3.1 |
订单来源平台编码 OTHER=其他 修改为 OTHERS=其 他，和电子面单编码一致 |
| 2017/6/20 |
3.1 |
入库单确认增加邮费字段，帮助商家分摊成本， 快递费用 (元) , double (18, 2) |
| 2017/6/29 |
3.1 |
发货单创建和发货单创建批量接口增加税号字段 税号,string(50) |
| 2017/9/19 |
3.1 |
taobao.qimen.orderprocess.report 增加 expressCode(运单号) |
| 2018/1/23 |
3.1 |
订单来源平台编码添加 YJWD=云集微店 |
| 2018/2/5 |
3.1 |
添加仓库信息查询接口 taobao.qimen.warehouseinfo.query |
| 2018/3/5 |
3.2 |
入库单创建、退货入库单创建、入库单确认、退货入库 单确认、出库单确认、发货单确认接口增加商品序 列号, string(50)节点 |
| 2018/5/15 |
3.2 |
出库单创建添加 purchasePrice、retailPrice 、actualPrice 字段 |
| 2018/5/30 |
3.3 |
升级出库单创建接口支持唯品会调拨场景 |
| 2018/6/13 |
3.4 |
添加商品查询接口 taobao.qimen.singleitem.query |
| 2018/9/17 |
3.5 |
在出库单创建环节增加唯品会 JIT 业务送仓单关联，添 加生产批号和批次编号的解释。 |
| 2019/1/7 |
3.5 |
在出库单确认接口的 package 字段下增加 logisticsCode 字段 |
| 2019/2/19 |
3.6 |
添加新接口退货包裹状态通知接口 |
| 2019/8/15 |
3.7 |
更新退货入库单创建接口，增加来源平台和卖家信息 |
| 2019/8/16 |
3.7 |
添加订单异常通知接口 |
| 2019/9/16 |
3.7.1 |
发货接口增加区域零售的订单标识 |
| 2019/9/24 |
3.7.2 |
订单流水通知接口增加枚举类型 |
| 2019/12/10 |
3.7.3 |
添加配送公司信息查询接口 |
| 2020/03/02 |
3.7.4 |
出入库确认接口增加其他出入库子类型和费用承担部门 |
| 2020/09/03 |
3.7.5 |
发货单创建接口增加最晚发货时间和最晚揽收时间 |
| 2020/09/14 |
3.7.6 |
发货单创建接口增加PRESELLCONSIGN=预售极速达订单 |
| 2021/01/26 |
3.7.7 |
发货单创建接口增加PRESELESPACKAGE=预售预包订单 |
| 2021/01/27 |
3.8 |
发货单创建接口添加订单收件人ID字段 OAID |
| 2021/03/04 |
3.9 |
增加taobao.qimen.order.query和taobao.qimen.receiverinfo.query接口 |
| 2021/03/16 |
3.9.1 |
增加商品单仓批次库存查询接口 |
| 2021/05/16 |
3.9.2 |
taobao.qimen.deliveryorder.confirm接口增加订单部分出库信息回传相关字段 |
| 2021/05/24 |
3.9.3 |
OAID收件人信息解密接口增加货主ID字段 |
| 2021/07/16 |
3.9.4 |
taobao.qimen.deliveryorder.create接口中渠道枚举值增加；taobao.qimen.entryorder.confirm接口中增加分批次入库整单数据回传结构体(totalorderLines) |
| 2021/09/02 |
3.9.5 |
taobao.qimen.returnorder.create接口中orderFlag字段增加枚举值FETCH_RETURN用于菜鸟大件上门取退业务 |
2023/08/21 |
4.1 |
sourcePlatformCode增加 WXXSD=微信小商店、WXSPHXD=微信视频号小店、 |