-
功能描述：商家可以对“已发货”状态的自发订单（含COD和非COD），标记配送结果。一次最多批量处理100个订单。同一个订单，可以多次反复标记配货成功和标记配货失败。如果当前是“已送达/交易成功”状态，商家还没标记过配送结果，则a）商家标记配送成功，此后订单状态不变，订单能够进入结款但不能重复结款，订单详情页显示商家这个操作记录，b）商家标记配送失败，则退款给顾客（不包括现场COD金额），订单状态为“交易失败”，订单能够进入结款但不能重复结款。对于特定商家，本接口支持把订单配送状态由“配送成功”转为“配送失败”，但是不允许把订单配送状态由“配送失败”转为“配送成功”。具体事宜请咨询商家管理员。
支持的数据格式：XML
HTTP请求方式：POST
版本：v1.0 v2.0
-
系统级输入参数：
请参考系统级输入参数
应用级输入参数：
变量名称 变量命名 变量类型 是否必填 示例 说明 配送状态XML文件
updateMultiOrdersDistriStatus
file
是
<input type=file..
配送状态XML文件，具体内容请参考
“配送状态XML文件”
配送状态XML文件格式说明：
-
配送状态XML文件示例：
<?xml version="1.0" encoding="GBK"?>
<request>
<functionID> dangdang.orders.distristatus.update </functionID>
<time>2009-03-20 15:10:50</time>
<OrdersList>
<OrderInfo>
<orderID>1719544796</orderID>
<distriStatus>1</distriStatus>
<distriTime>2012-3-13 12:12:12</distriTime>
</OrderInfo>
<OrderInfo>
......
</OrderInfo>
......
</OrdersList>
</request>
-
商家接收到的XML文件实例：
<?xml version="1.0" encoding="GBK" standalone="yes"?>
<response>
<functionID>dangdang.orders.distristatus.update</functionID>
<time>2017-07-12 18:12:11</time>
<Result>
<OrdersList>
<OrderInfo>
<orderID>123456</orderID>
<orderOperCode>0</orderOperCode>
<orderOperation>操作成功!</orderOperation>
</OrderInfo>
</OrdersList>
</Result>
</response>
-
java版
SdkClient sdkClient= new SdkClient(appKey, appSecret, session, version) ;
OrdersDistriStatusUpdateRequest request=new OrdersDistriStatusUpdateRequest();
request.setUpdateMultiOrdersDistriStatusFile(new FileItem(new File(path)));
OrdersDistriStatusUpdateResponse response=sdkClient.excute(request);
System.out.println(response.toString());
php版
$sdkClient = new DDHttpClient(appkey,appSecret,session);
$ordersDistristatusUpdate = new OrdersDistristatusUpdateRequest();
$ordersDistristatusUpdate->setUpdateMultiOrdersDistriStatus($xmlFile);
$sdkResponse = $sdkClient->execute($ordersDistristatusUpdate);