文档中心 > 奇门中心

奇门白皮书-版本记录

更新时间:2023/08/21 访问次数:26987

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、新增入库单,去掉一个重复的入库单编码

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=微信视频号小店、

 

 

FAQ

关于此文档暂时还没有FAQ
返回
顶部