返回订单API

dangdang.orders.refund.list

查询商家退款订单列表信息

  • 功能描述:商家可以查询自己店铺的退款订单列表,因买家或商家的订单取消退款无需审核,所以此接口不包含买家或商家取消的订单退款。

    支持的数据格式:XML

    HTTP请求方式:GET

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

    时间:2017-6-29

    版本:v1.1

    变更说明:添加sourceId;


  • 系统级输入参数:

    请参考系统级输入参数

    应用级输入参数:

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

    订单编号

    order_id

    long

    12345678

    一次一个订单信息

    申请单状态

    refundApp_Status

    int

     

    申请单状态包括如下选项:

    9999 全部(预设值)

    1、未审核

    2、审核通过

    3、审核不通过

    修改开始时间

    lastModifyTime_start

    string

    2013-11-01 00:00:00

    修改开始时间和退款单开始时间必填其一,开始时间结束时间,间隔不能超过3个月.

    格式:YYYY-MM-DD hh:mm:ss

    可以查询出最后修改时间在“最后修改时间”当天及以后日期的退款单

    修改结束时间

    lastModifyTime_end

    string

    2013-11-01 00:00:00

    格式:YYYY-MM-DD hh:mm:ss.

    如果输入修改开始时间,该字段为必填项,开始时间结束时间间隔不能超过3个月

    退款单开始日期

    osd

    string

    2010-03-11 00:00:00

    退款单开始时间或修改开始时间必填其一,开始时间和结束时间间隔不能超过3个月

    格式:YYYY-MM-DD  hh:mm:ss

    退款单结束日期

    oed

    string

    2010-05-25 00:00:00

    格式:YYYY-MM-DD hh:mm:ss.

    如果输入退款单开始时间,该字段为必填项

    页数

    pageSize

    int

    10

    默认值为30,最大值100

    页码

    pageIndex

    int

    1

    默认值1




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


  • 商家接收到的XML文件实例:

    <?xml version="1.0" encoding="GBK" standalone="yes"?>
    <response>
        <result>true</result>
        <resultCode>0</resultCode>
        <resultMessage>操作成功</resultMessage>
        <functionID>searchRefundOrders</functionID>
        <time>2013-11-28 16:54:24</time>
        <refundInfos>
            <shopId>489</shopId>
            <totalSize>21</totalSize>
            <pageIndex>1</pageIndex>
            <pageSize>5</pageSize>
            <refundInfoList>
                <refundInfo>
                    <orderId>22031367910</orderId>
                    <sourceId>31367910</sourceId>
                    <isAgree>2</isAgree>
                    <shopId>489</shopId>
                    <refundSource>4</refundSource>
                    <totalAmount>0.0000</totalAmount>
                    <refundAmount>0.0000</refundAmount>
                    <refundDate>2013-08-08 18:20:57</refundDate>
                    <creationDate>2013-08-08 18:20:57</creationDate>
                    <lastModifiedDate>2013-09-02 16:53:04</lastModifiedDate>
                    <remark xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
                </refundInfo>
                <refundInfo>
                    <orderId>22032014330</orderId>
                    <sourceId>22032014330</sourceId>
                    <isAgree>2</isAgree>
                    <shopId>489</shopId>
                    <refundSource>2</refundSource>
                    <totalAmount>75.0000</totalAmount>
                    <refundAmount>0.0000</refundAmount>
                    <refundDate>2013-07-30 14:12:13</refundDate>
                    <creationDate>2013-07-30 14:12:13</creationDate>
                    <lastModifiedDate>2013-09-02 16:53:04</lastModifiedDate>
                    <remark xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
                </refundInfo>
            </refundInfoList>
        </refundInfos>
    </response>



  • java版

    SdkClient sdkClient= new SdkClient(appKey, appSecret, session, version) ;
    OrdersRefundListRequest request=new OrdersRefundListRequest();
    SearchRefundOrders refundOrders =new SearchRefundOrders();
    refundOrders.setOrder_id("38070496150");
    request.setSearchRefundOrders(refundOrders);
    OrdersRefundListResponse response=sdkClient.excute(request);
    System.out.println(response.toString());


    php版

    $sdkClient = new DDHttpClient(appkey,appSecret,session);
    $ordersRefundListRequest = new OrdersRefundListRequest();
    $ordersRefundListRequest->setOrderId("1013037686267");
    $sdkResponse = $sdkClient->execute($ordersRefundListRequest);