版本0.1
日期：2017年12月22日
| 序号 |
版本号 |
修订内容 |
作者 |
日期 |
| 1 |
V0.1 |
新建 |
毅石 |
12月22日 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
为了给天猫的买家提供更好订单履约的体验，需要ERP接收订单部分发货并回传对应的物流信息给天猫交易平台。
商家通过ERP调用该接口可以创建的菜鸟发货单
接口名称：
ERP调用的奇门API名称：taobao.qimen.deliveryorder.create
奇门调用WMS的API名称：deliveryorder.create
线上地址：http://pac.i56.taobao.com/apiinfo/showDetail.htm?spm=0.0.0.0.TpJlVc&apiId=taobao.qimen.deliveryorder.create
商家ERP调用该接口进行订单发货物流详情回传
接口名称：
ERP调用的TOPAPI名称：taobao.logistics.offline.send
线上地址：//open.taobao.com/docs/api.htm?spm=a219a.7386797.0.0.JNDT2u&source=search&apiId=10690
1.该接口需要改造对部分包裹的回传进行兼容；
2.ERP回传发货类型的时候，新增一个部分发货状态回传
商家通过该接口接收订单部分出库的信息
<deliveryOrder>
<deliveryOrderCode>出库单号, string (50) , 必填</deliveryOrderCode>
<deliveryOrderId>仓储系统出库单号, string (50) ，条件必填</deliveryOrderId>
<warehouseCode>仓库编码, string (50)，必填 </warehouseCode>
<orderType>出库单类型, string (50)，JYCK=一般交易出库,HHCK=换货出库,BFCK=补发出库，QTCK=其他出库单,必填</orderType>
<outBizCode>string (50) , 外部业务编码, 消息ID, 用于去重, ISV对于同一请求，分配一个唯一性的编码。用来保证因为网络等原因导致重复传输，请求不会被重复处理，条件必填，条件为一单需要多次确认时 </outBizCode>
<orderConfirmTime>订单完成时间, string (19) , YYYY-MM-DD HH:MM:SS </orderConfirmTime>
<operatorCode>当前状态操作员编码, string (50) </operatorCode>
<operatorName>当前状态操作员姓名, string (50) </operatorName>
<operateTime>当前状态操作时间, string (19) , YYYY-MM-DD HH:MM:SS</operateTime>
</deliveryOrder>
<packages>
<package>
<logisticsCode>物流公司编码, string (50) , SF=顺丰、EMS=标准快递、EYB=经济快件、ZJS=宅急送、YTO=圆通 、ZTO=中通 (ZTO) 、HTKY=百世汇通、UC=优速、STO=申通、TTKDEX=天天快递 、QFKD=全峰、FAST=快捷、POSTB=邮政小包 、GTO=国通、YUNDA=韵达、JD=京东配送、DD=当当宅配、AMAZON=亚马逊物流、OTHER=其他，必填, (只传英文编码) </logisticsCode>
<logisticsName>物流公司名称, string (200) </logisticsName>
<expressCode>运单号, string (50) , 必填</expressCode>
<packageCode>包裹编号, string (50) </packageCode>
<length>包裹长度 (厘米) , double (18, 2) </length>
<width>包裹宽度 (厘米) , double (18, 2) </width>
<height>包裹高度 (厘米) , double (18, 2) </height>
<theoreticalWeight>包裹理论重量 (千克) , double (18, 3) </theoreticalWeight>
<weight>包裹重量 (千克) , double (18, 3) </weight>
<volume>包裹体积 (升, L) , double (18, 3) </volume>
<invoiceNo>发票号, string (500) </invoiceNo>
<packageMaterialList>
<packageMaterial>
<type>包材型号, string (50) </type>
<quantity>包材的数量, int</quantity>
</packageMaterial>
</packageMaterialList>
<items>
<item>
<itemCode>商品编码, string (50) , 必填</itemCode>
<itemId>商品仓储系统编码, string (50)</itemId>
<quantity>包裹内该商品的数量, int, 必填</quantity>
</item>
</items>
</package>
</packages>
<orderLines>
<orderLine>
<orderLineNo>单据行号，string（50）</orderLineNo>
<orderSourceCode>平台交易订单编码, string (50) </orderSourceCode>
<subSourceCode>平台交易子订单编码, string (50) </subSourceCode>
<ownerCode>货主编码, string (50) </ownerCode>
<itemCode>商品编码, string (50) </itemCode>
<itemId>商品仓储系统编码, string (50)</itemId>
<库存类型，string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损, ZT=在途库存，默认为查所有类型的库存</inventoryType>
<ownerCode>货主编码，string(50)</ownerCode>
<itemName>商品名称, string (200) </itemName>
<extCode>交易平台商品编码, string (50) </extCode>
<planQty>应发商品数量, int</planQty>
<actualQty>实发商品数量, int</actualQty>
<batchCode>批次编号，string(50)，</batchCode>
<productDate>生产日期，string(10)，YYYY-MM-DD</productDate>
<expireDate>过期日期，string(10)，YYYY-MM-DD </expireDate>
<produceCode>生产批号，string(50)，</produceCode>
<batchs><!-- 同一行号下多批次支持-->
<batch>
<batchCode>批次编号，string(50)</batchCode>
<productDate>生产日期，string(10)，YYYY-MM-DD</productDate>
<expireDate>过期日期，string(10)，YYYY-MM-DD </expireDate>
<produceCode>生产批号，string(50)，</produceCode>
<inventoryType>库存类型，string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损, ZT=在途库存，默认为查所有类型的库存</inventoryType>
<actualQty>实发数量, int，要求batchs节点下所有的实发数量之和等于orderline中的实发数量</actualQty>
</batch>
</batchs>
</orderLine>
</orderLines>
</request>