返回订单API

dangdang.orders.list.get

查询订单列表信息

  • 功能描述:商家可以查询自己店铺的订单列表信息(包括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; 收货地址:consigneeAddr

    4、返回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; 收货地址:consigneeAddr

    4、返回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);