dangdang.order.goods.sendPackage
发货接口(支持拆分包裹发货和普通发货,全部包裹只能一次性发货)
-
功能描述：商家可以将“正在配货”或者“等待发货”的订单修改为“已发货”，商家可以批量处理多张发货订单。本接口支持自发订单（包括COD和非COD订单），暂时不支持当当代发订单（包括COD和非COD订单）。对于“买A赠多”促销，需要处理主商品和赠品每次。除此之外，本接口还支持多包裹发货，即一个订单拆分为多个包裹，如果当前使用物流非当当对接物流，则物流编码可以填写为9999
a）如果订单当前状态是“正在配货”，则实际发货商品数量，以商家在本接口录入的商品数量为准
b）如果订单当前状态是“等待发货”，则实际发货商品数量，以商家在后台页面操作“标记配货完成”时录入的商品数量为准
c）参与了“多买多折”促销的商品，只能全部发货。
d) 不支持网络课程订单发货
注意：本接口只支持一次性发货，如果发货的时候少填则按照报缺处理
支持最大订单量：50
支持的数据格式：XML
HTTP请求方式：POST
版本:1.0
物流公司名称代码匹配表：
物流公司名称 物流公司编码 物流公司电话
中通快递 102 400-827-0270
韵达快递 103 400-821-6789
申通快递 104 400-889-5543
圆通快递 101 95554
顺丰快递 105 400-811-1111
全峰快递 106 400-100-0001
百世汇通快递 107 400-956-5656
天天快递 108 4001-888-888
宅急送快递 109 400-6789-000
国通快递 110 400-111-1123
龙邦快递 111 021-59218889
安能快递 112 400-104-0088
优速快递 113 400-111-1119
EMS 114 11185
快捷快递 115 400-830-4888
中铁物流 116 400-000-5566
德邦物流
117
400-830-5555
邮政
118 11183 跨越速运
119
4008-098-098
极兔速递
120
400-820-1666
-
系统级输入参数：
请参考系统级输入参数
应用级输入参数：
变量名称 变量命名 变量类型 是否必填 示例 说明 发货XML文件
sendGoods
file
是
<input type=file..
发货的XML文件，具体内容请参考“发货XML文件格式说明” 发货XML文件格式说明：
-
发货XML文件示例：
<?xml version="1.0" encoding="utf-8"?>
<request>
<functionID>dangdang.order.goods.send</functionID>
<time>2018-06-23 15:10:50</time>
<OrdersList>
<OrderInfo>
<orderID>1013035347567</orderID>
<shopId>9001</shopId>
<sendAll>false</sendAll>
<donePackageSendList>
<donePackageSend>
<expressCompany>dangdang</expressCompany>
<expressCompanyId>dd_201</expressCompanyId>
<expressCompanyTel>01057999999</expressCompanyTel>
<expressNo>jk011</expressNo>
<isSplite>1</isSplite>
<SendGoodsList>
<ItemInfo>
<itemID>60012202</itemID>
<sendGoodsCount>1</sendGoodsCount>
<productItemId>1013035347567001</productItemId>
</ItemInfo> ......
</SendGoodsList>
</donePackageSend>
<donePackageSend>
<expressCompany>dangdang</expressCompany>
<expressCompanyId>dd_201</expressCompanyId>
<expressCompanyTel>01057999999</expressCompanyTel>
<expressNo>jk022</expressNo>
<isSplite>1</isSplite>
<SendGoodsList>
<ItemInfo>
<itemID>1078436424</itemID>
<sendGoodsCount>2</sendGoodsCount>
<productItemId>1013035347567002</productItemId>
</ItemInfo>
</SendGoodsList>
</donePackageSend>
</donePackageSendList>
</OrderInfo>
<OrderInfo>
<orderID>1013035347527</orderID>
<shopId>9001</shopId>
<sendAll>false</sendAll>
<donePackageSendList>
<donePackageSend>
<expressCompany>dangdang</expressCompany>
<expressCompanyId>dd_201</expressCompanyId>
<expressCompanyTel>01057999999</expressCompanyTel>
<expressNo>jk033</expressNo>
<isSplite>1</isSplite>
<SendGoodsList>
<ItemInfo>
<itemID>60012202</itemID>
<sendGoodsCount>1</sendGoodsCount>
<productItemId>1013035347527001</productItemId>
</ItemInfo>
</SendGoodsList>
</donePackageSend>
<donePackageSend>
<expressCompany>dangdang</expressCompany>
<expressCompanyId>dd_201</expressCompanyId>
<expressCompanyTel>01057999999</expressCompanyTel>
<expressNo>jk044</expressNo>
<isSplite>1</isSplite>
<SendGoodsList>
<ItemInfo>
<itemID>1078436424</itemID>
<sendGoodsCount>1</sendGoodsCount>
<productItemId>1013035347527002</productItemId>
</ItemInfo>
</SendGoodsList>
</donePackageSend>
</donePackageSendList>
</OrderInfo> ......
</OrdersList>
</request>
-
商家接收到的XML文件实例：
<?xml version="1.0" encoding="utf-8"?>
<response>
<functionID>sendxmlPackage</functionID>
<time>2009-03-21 15:10:50</time>
<Result>
<operCode>100</operCode>
<operation>没有上传xml文件</operation>
</Result>
</response>实例2：
<?xml version="1.0" encoding="utf-8"?>
<response>
<functionID>sendxmlPackage</functionID>
<time>2009-03-21 15:10:50</time>
<Result>
<OrdersList>
<OrderInfo>
<orderID>1111</orderID>
<orderOperCode>0</orderOperCode>
<orderOperation>发货成功</orderOperation>
</OrderInfo>
<OrderInfo>
<orderID>1112</orderID>
<orderOperCode>3</orderOperCode>
<orderOperation>发货数量全为0</orderOperation>
</OrderInfo>
</OrdersList>
</Result>
</response> -
java版
SdkClient sdkClient= new SdkClient(appKey, appSecret, session, version) ;
OrderGoodsSendPackageRequest sendGoodsRequest=new OrderGoodsSendPackageRequest();
sendGoodsRequest.setSendGoodsFile(new FileItem(new File(path)));
OrderGoodsSendResponse result=sdkClient.excute(sendGoodsRequest);
System.out.println(result.toString());
php版
$sdkClient = new DDHttpClient(appkey,appSecret,session);
$orderGoodsSendPackageRequest = new OrderGoodsSendPackageRequest();
$orderGoodsSendPackageRequest->setSendGoods($xmlFile);
$sdkResponse = $sdkClient->execute($orderGoodsSendPackageRequest);