-
功能描述：商家可以查询自己店铺的订单列表信息（包括COD和非COD订单）。
支持的数据格式：XML
HTTP请求方式：GET
版本：v1.0 v2.0 v3.0
2021年9月1日以后，对用户信息脱敏，参见：http://open.dangdang.com/index.php?c=documentCenter&f=show&page_id=266
V1.0下线，请升级到最新版本：V3.0
-
dangdang.orders.list.get时间：2021-08-05版本：3.0变更说明：请求参数1、status 枚举去掉-200 业务已下线返回参数1、sendGoodsOrderCount 描述修改：等待发货订单数，指到达待发货状态下的订单2、返回添加encrypt_content；对消费者信息进行加密，需要调取解密接口获取真实信息；3、返回加密字段包括：收货人姓名:consigneeName; 收货人固定电话:consigneeTel; 收货人移动电话:consigneeMobileTel; 收货地址:consigneeAddr4、返回needExchangeOrderCount 备注请去dangdang.orders.exchange.return.list.get接口查看，本接口将不予提供
5、字段 isCourierReceiptDetail 废弃
dangdang.orders.list.get时间：2021-09-02版本：v1.0,v2.0,v3.0变更说明：请求参数1、status 枚举去掉-200 业务已下线返回参数1、sendGoodsOrderCount 描述修改：等待发货订单数，指到达待发货状态下的订单2、返回添加encrypt_content；对消费者信息进行加密，需要调取解密接口获取真实信息；3、返回加密字段包括：收货人姓名:consigneeName; 收货人固定电话:consigneeTel; 收货人移动电话:consigneeMobileTel; 收货地址:consigneeAddr4、返回needExchangeOrderCount 备注请去dangdang.orders.exchange.return.list.get接口查看，本接口将不予提供
5、字段 isCourierReceiptDetail 废弃
-
系统级输入参数：
请参考系统级输入参数
应用级输入参数：
变量名称 变量命名 变量类型 是否必填 示例 说明 订单编号
o
long
否
12345678
一次一个订单信息。支持包裹编号和父订单编号。如果输入的是
包裹编号，则只需返回包裹订单信息（列表中的所有项都显示内容）；
如果输入的是父订单编号，则只返回父订单信息。
外部订单编号
outerOrderID
string
否
AT9-023902
外部订单编号，可以填写字母/数字/汉字。支持包裹和父订单的
“外部订单编号”。如果输入的是包裹的“外部订单编号”，则
只需返回包裹订单信息（列表中的所有项都显示内容）；如果输
入的是父订单的“外部订单编号”，则只返回父订单信息。
商品ID
productID
string
否
87654321
一次可包括多个商品ID,并用英文半角逗号’,’隔开。 商品商家编码
oit
string
否
123star
企业商品标识符 订单状态
os
int
否
100
订单状态为以下其中一种：
9999 全部
100 等待到款
101 等待发货(预设值)，商家后台页面中显示为“等待配货”的订单也能够被查询出来
300 已发货
400 已送达
1000 交易成功
-100 取消
1100 交易失败
-200 已拆单50 等待审核
送货方式
sm
int
否
9999
送货方式为以下其中一种：
9999 全部(预设值)
1 普通快递
2 加急快递
3 普通邮递
4 邮政特快专递付款方式
pm
int
否
3
付款方式为以下其中一种：
9999 全部(预设值)
0 货到付款
1 网上支付
2 银行汇款
3 邮局汇款配送方式（配送渠道）
sendMode
int
否
1
配送方式为以下其中一种：
9999全部(预设值)
1 当当代发（当当快递配送）
2 商家自发（商家自行配送）
3 当当仓库配货收货人姓名
name
string
否
张山
是否查询历史订单
history_flag
int
否
0
0或空：查询当前订单（六个月内）
1：查询六个月前历史订单
最后修改时间_开始
lastModifyTime_start
string
否
2010-05-21
格式：YYYY-MM-DD或者YYYY-MM-DD hh:mm:ss
可以查询出最后修改时间在“最后修改时间”当天及以后日期的订单
最后修改时间_结束
lastModifyTime_end
string
否
2010-05-21
格式：YYYY-MM-DD或者YYYY-MM-DD hh:mm:ss
可以查询出最后修改时间在“最后修改时间”当天及以后日期的订单
下单开始日期
osd
string
否
2010-05-21
格式：YYYY-MM-DD或者YYYY-MM-DD hh:mm:ss
可以查询出下单时间在“下单开始日期”当天及以后日期的订单
下单结束日期
oed
string
否
2010-11-01
格式：YYYY-MM-DD或者YYYY-MM-DD hh:mm:ss
可以查询出下单时间在“下单结束日期”当天及以前日期的订单
发货开始日期
sgsd
string
否
2010-01-22
格式：YYYY-MM-DD或者YYYY-MM-DD hh:mm:ss
可以查询出发货时间在“发货开始日期”当天及以后日期的订单
发货结束日期
sged
string
否
2010-11-01
格式：YYYY-MM-DD或者YYYY-MM-DD hh:mm:ss
可以查询出发货时间在“发货结束日期”当天及以前日期的订单
订单标记
ol
int
否
3
5类固定标记：1红色2黄色3绿色4蓝色5紫色 每页结果数量
pageSize
int
否
5
只能选择如下数值：
5、10、15、20
可以不填，默认是20页数
p
int
否
3
预设值为1
-
商家接收到的XML文件实例：
<?xml version="1.0" encoding="GBK"?>
<response>
<functionID>dangdang.orders.list.get</functionID>
<time>2009-03-20 15:10:50</time>
<totalInfo>
<sendGoodsOrderCount>8</sendGoodsOrderCount>
<needExchangeOrderCount>0</needExchangeOrderCount>
<orderCount>28</orderCount>
<totalOrderMoney>2023.30</totalOrderMoney>
< pageSize>5</ pageSize>
<pageTotal>8</pageTotal>
<currentPage>1</currentPage>
</totalInfo>
<OrdersList>
<OrderInfo>
<orderID>1719544796</orderID>
<consigneeName>李x</consigneeName>
<consigneeTel>022-2302xxxx</consigneeTel>
<consigneeMobileTel>139207xxxx</consigneeMobileTel>
<consigneeAddr>中国,天津,天津市,南京路xxx</consigneeAddr>
<sendGoodsMode>1</sendGoodsMode>
<orderMoney>206.00</orderMoney>
<orderTimeStart>2009-02-22 13:10:03</orderTimeStart>
< lastModifyTime>2009-02-22 13:10:03</ lastModifyTime>
<orderState>400</orderState>
<remark>买家很好人</remark><label>2</label>
< originalOrderId>8973923749247</originalOrderId>
</OrderInfo>
<OrderInfo>
......
</OrderInfo>
......
</OrdersList>
</response>
-
java版
SdkClient sdkClient= new SdkClient(appKey, appSecret, session, version) ;
OrdersListGetRequest request=new OrdersListGetRequest();
OrderListGet orderListGet=new OrderListGet();
orderListGet.setOs("300");
orderListGet.setP(1);
request.setOrderListGet(orderListGet);
OrdersListGetResponse result=sdkClient.excute(request);
System.out.println(result.toString());
php版
$sdkClient = new DDHttpClient(appKey,appSecret,session);
$OrdersListGetRequest = new OrdersListGetRequest();
$sdkResponse = $sdkClient->execute($OrdersListGetRequest);