奇门ISV接入白皮书
奇门标准化协议白皮书
V2.4
阿里巴巴集团商家业务事业部
2015
1
奇门ISV接入白皮书
1 版本记录
Date 2015.03.27 Version 1.0 Description 1、奇门标准化协议v1.0发布 1、增加入库单更新，出库单更新，库存异动更新等32015.03.31 1.2 个接口 2、API名称区分了erp和wms 3、优化部分字段命名 2015.04.07 2015.04.09 1.3 1.4 1、将auditor相关的字段统一成operator 1、更新接口规范，新增“奇门与wms的通信协议”等相关内容 2、新增入库单，去掉一个重复的入库单编码 1、加入奇门项目服务商解决方案章节 2、增加通信协议里的反向协议标准 2015.04.14 1.5 3、更新个别字段名，如Quantity更新为Qty，stockSelectedQty等字段名中将stock去掉，变为selectedQty。 1、加入菜鸟仓业务接口支持 2015.5.6 2.0 2、接口整体改动较大，主要增加业务接口和原有接口内增加字段 1、出入库单据增加ERP行号的概念 2、出库单流水接口升级为订单流水接口 3、仓内加工单更名为storeprocess 2015.5.7 2.1 4、发货单确认接口的生产日期produceDate变更为productDate 5、退货入库单创建接口orderLine节点中增加ownerCode字段；入库单创建接口中ownerCode移到orderLine节点中 1、取消订单，订单类型变为非必填 2015.5.20 2.1 2、发货单创建，付款时间变为非必填 3、所有地址中的区域改为非必填 4、退货入库单确认接口，物流公司编码改为非必填 2015.6.5 2015.6.10 2.2 2.2 1、增加“出库单创建”，“出库单确认”接口 1、“出库单创建”增加货主编码字段 2
奇门ISV接入白皮书
2、增加“订单状态查询”和“库存查询”两个接口 3、规范“冻结库存”的使用范围 1、增加“组合商品接口” 2、入库单的收件人，发件人，物流公司信息为非必填 3、新增入库单类型：生产入库、领用入库、残次品入库。 2015.6.11 2.2 4、入库单新增字段，采购单号 5、盘点单新增字段，盘点时间 6、新增“库存异动接口” 7、“订单状态查询”不仅查当前状态，历史状态也可以 8、“普通出库单”增加发件人信息 1、“组合商品创建接口”和“订单流水查询接口“，去掉warehouseCode编码 2015.6.12 2.2 2、“订单流水查询接口”和“库存查询接口”response增加的flag，code，message这三个标准的应答。 2015.6.25 2.2 1、增加发货单查询接口 1、订单状态查询增加两个入库状态（PARTFULFILLED-2015.7.2 2.2 部分收货完成, FULFILLED-收货完成。） 2、库存查询接口增加货主编码ownerCode 1、退货入库创建接口：商品增加批次等信息 2、发货单创建接口，发票增加普通发票的类型 3、订单流水查询接口，删除NEW状态 2015.7.3 2.2 4、订单流水通知接口，删除NEW，CANCELEDFAIL状态 5、发货单创建和发货单缺货通知接口，在item节点下增加inventoryType等字段 1、商品同步接口的barcode可以填多个 2、发货单创建增加字段“deliveryType” 3、发货单创建返回值支持统仓统配的拆单 2015.7.6 2.2 4、发票内容格式化 5、增加B2B出库的出库类型 6、入库单确认接口的entryOrderId 改为条件必填 7、extendProps和remark统一定义了 3
奇门ISV接入白皮书
8、退货单创建和确认接口增加批次信息 9、订单流水查询删除CANCELFAILED状态 10、订单流水通知接口删除NEW,CANCELFAILED状态 11、发货单缺货通知接口item节点下增加inventoryType和批次信息 1、B2B入库和B2B出库单据状态多接口修订 2015.7.9 2.2 2、发货单SN通知借口，加上分页，并且将sns的节点去掉 2015.7.14 2.2 1、增加库存异动接口，单据类型增加ZZTZ=状态调整单 1、发货单 invoices下面的detail增加item节点 2、发货单发货类型的枚举值CWPS（常温配送）改为2015.7.16 2.2 PTPS（普通配送） 3、商品同步barcode的分隔符改为； 4、部分warehouseCode重新定义约束和说明 5、库存异动接口更名为库存异动通知接口 1、发货单创建的出参，response节点下增加2015.7.17 2.2 warehouseCode和logisticsCode两个字段，以适配以前的版本 1、库存异动接口，结构体变化，将warehouseCode，2015.7.20 2.2 ownerCode，orderCode，orderType，outbizCode等放到item节点下 2015.7.21 2015.7.22 2.2 2.2 1、快递编码中增加京东配送（JD），当当宅配（DD） 1、出库单创建和出库单确认接口增加logisticsCode字段 1、入库单创建、入库单确认、出库单创建、出库单确认2015.7.23 2015.7.30 2.2 2.2 等四个接口增加totalOrderLines，outBizCode这两个字段用于分批传输处理 1、发货单确认接口增加“包裹理论重量” 1、新增接口订单状态查询接口（批量），用于解决通过2015.8.14 2.2 订单最后操作时间的区间值等信息，去批量查询订单 2、发货单创建接口的orderLine下面增加batchCode等字段，用于解决指定批次发货的问题 4
奇门ISV接入白皮书
1、发货单创建接口的orderLine下面增加2015.8.20 2.2 productDate,expireDate等字段 2、渠道枚举字段调整，凡客由FK调整为VANCL 1、新增5个接口，支持用于各种订单在仓内操作结果的详情查询，包括入库单查询，出库单查询，退货入库单查询，发货单查询，发货单缺货查询。 2015/8/31 2.3 2、订单流水查询和订单流水确认接口的status，增加两个状态，PARTFULFILLED，FULFILLED两个状态。 3、入库单确认接口，出库单确认接口，增加单据状态字段status。 1、发货单确认接口，单价和数量字段类型修正 2015/9/6 2.3 2、所有正向接口，均补充warehouseCode，作为可能的一单分多仓的业务场景。 2015/9/7 2.3 1、新增接口，为菜鸟自动流转的业务新增的特殊业务接口。 1、新增盘点单查询接口 2、盘点单确认接口和盘点单查询接口均增加2015/9/14 2.3 checkOrderId 3、发货单查询接口，为了兼容，入参将deliveryOrderCode改为orderCode,deliveryOrderId改为orderId 2015/9/21 2015/9/22 2015/9/24 2015/10/10 2015/10/15 2.3 2.3 2.3 2.3 2.3 入库单确认，出库单确认，退货入库单确认，发货单确认，库存异动通知 新增心跳接口 1、订单流水查询接口增加orderType 2、发货单确认接口orderType增加枚举值QTCK。 1、库存盘点查询的接口名变更 1、在发货单确认，发货单查询，退货入库单确认，退货入库单查询等接口的orderline中增加商品二维码，用于对单个商品的管理。 2015/10/20 2015/10/27 2015/11/19 2.3 2.3 2.3 1、新增商品同步接口（批量），发货单创建接口（批量），发货单确认接口（批量） 1、发货单创建接口的orderline下增加payNo，用于解决合单后的支付宝交易号的传输。 1、出库单类型新增采购退货出库类型（CGTH） 5