返回订单API

dangdang.orders.exchange.return.list.get

查询退换货订单列表信息

  • 功能描述:商家可以查询自己店铺的退货和换货的订单列表信息。可以查询自发非COD、代发非COD、代发COD、自发COD订单。

    支持的数据格式:XML

    HTTP请求方式:GET

  • 接口调用时传递的v为大版本号,如对于1.1,调用时为v=1.0

    时间:2017-6-13

    版本:v1.1

    变更说明:添加对仅退款类型的支持;

  • 系统级输入参数:

    请参考系统级输入参数

    应用级输入参数:


    变量名称 变量命名 变量类型 是否必填 示例 说明

    订单编号

    o

    long

    12345678

    一次一个订单信息

    申请单状态

    applyStatus

    int

    9999

    申请单状态包括如下选项:
    9999 全部(预设值)
    -100     取消
    1100     失败
    0     等待审核
    300     退换货成功
    1000   已经受理

    申请类型

    type

    int

    1

    申请类型为以下其中一种:
    9999 全部(预设值)
    1    退货
    2    换货

    5    仅退款

    处理状态

    status

    int

    2

    处理状态为以下其中一种:
    9999 全部(预设值)
    1    待处理
    2    已处理

    处理结果

    result

    int

    1

    当“处理状态”项的值是“待处理”的时候,系统不处理此项的值

    处理结果为以下其中一种:
    9999 全部(预设值)
    1    同意
    2    拒绝

    申请退换货
    开始日期

    resd

    string

    2010-02-11

    格式:YYYY-MM-DD
    可以查询出申请退换货时间在“申请退换货开始日期”当天及以后日期的商品

    申请退换货
    结束日期

    reed

    string

    2010-05-25

    格式:YYYY-MM-DD
    可以查询出申请退换货时间在“申请退换货结束日期”当天及以前日期的商品

    是否含有商品的退换货原因

    isNeedReverseReason

    string

    1

    如果为“1”则表示会返回商品的退换货原因,如果为0或者其他值则表示不返回

    页数

    p

    int

    1

    预设值为1


     

  • 商家接收到的XML文件格式说明:


  • <?xml version="1.0" encoding="GBK" standalone="yes"?>
    <response>
        <functionID>searchReturnExchangeOrders</functionID>
        <time>2017-06-13 17:23:31</time>
        <totalInfo>
            <totalOrderCount>1</totalOrderCount>
            <needReturnOrderCount>0</needReturnOrderCount>
            <needExchangeOrderCount>1</needExchangeOrderCount>
            <pageItemCount>2</pageItemCount>
            <pageItemMoney>302.40</pageItemMoney>
            <currentOrderCount>1</currentOrderCount>
            <pageTotal>1</pageTotal>
            <currentPage>1</currentPage>
        </totalInfo>
        <OrdersList>
            <OrderInfo>
                <orderID>35100004091</orderID>
                <returnExchangeStatus>2</returnExchangeStatus>

                <returnExchangeCode>346464531</returnExchangeCode>

                <parcelPostCode>440480319014</parcelPostCode>
                <expressCompanyName>顺丰快递</expressCompanyName>

                <orderMoney>302.40</orderMoney>
                <orderTime>2017-06-07 21:18:16</orderTime>
                <orderStatus>2</orderStatus>
                <orderResult>1</orderResult>
                <returnExchangeOrdersApprStatus>1</returnExchangeOrdersApprStatus>
                <warning></warning>
                <onlyRefundApplyTotal xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
                <onlyRefundreversApproveTotal xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
                <onlyRefundCouldRefundTotal xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
                <reverseOrderId>35182000000</reverseOrderId>
                <itemsList>
                    <ItemInfo>
                        <itemID>1153170049</itemID>
                        <itemName>女裤_蓝色,37</itemName>
                        <itemSubhead></itemSubhead>
                        <unitPrice>151.20</unitPrice>
                        <orderCount>1</orderCount>
                        <outerItemID></outerItemID>
                        <originalItemId>35100004091001</originalItemId>
                        <itemOnlyRefundApplyTotal xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
                        <itemOnlyRefundApproveTotal xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
                        <itemOnlyRefundCouldRefund xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
                    </ItemInfo>
                    <ItemInfo>
                        <itemID>1153171049</itemID>
                        <itemName>女裤_蓝色,32</itemName>
                        <itemSubhead></itemSubhead>
                        <unitPrice>151.20</unitPrice>
                        <orderCount>1</orderCount>
                        <outerItemID></outerItemID>
                        <originalItemId>35100004091001</originalItemId>
                        <itemOnlyRefundApplyTotal xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
                        <itemOnlyRefundApproveTotal xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
                        <itemOnlyRefundCouldRefund xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
                    </ItemInfo>
                </itemsList>
            </OrderInfo>
        </OrdersList>
    </response>
  • <?xml version="1.0" encoding="GBK" standalone="yes"?>
    <response>
        <functionID>searchReturnExchangeOrders</functionID>
        <time>2017-06-13 17:25:46</time>
        <Error>
            <operCode>35</operCode>
            <operation>订单编号错误</operation>
        </Error>
    </response>


  • java版

    SdkClient sdkClient= new SdkClient(appKey, appSecret, session, version) ;
    OrdersExchangeReturnListGetRequest request=new OrdersExchangeReturnListGetRequest();
    ReverseApplyList applyList=new ReverseApplyList();
    applyList.setO("38070496150");
    request.setReverseApplyList(applyList);
    OrdersExchangeReturnListGetResponse response=sdkClient.excute(request);
    System.out.println(response.toString());


    php版

    $sdkClient = new DDHttpClient(appkey,appSecret,session);
    $ordersExchangeReturnListGetRequest = new OrdersExchangeReturnListGetRequest();
    $ordersExchangeReturnListGetRequest->setOrderId("1013037690717");
    $sdkResponse = $sdkClient->execute($ordersExchangeReturnListGetRequest);