返回订单API

dangdang.orders.exchange.return.apply.approve

批量审核退换货申请

  • 功能描述:商家需要先对用户的退换货申请进行审核,然后才能进行退换货处理。支持订单包括:自发非COD、代发非COD、代发COD、自发COD订单。不能对代退货申请进行审核。

    支持的数据格式:XML

    HTTP请求方式:POST

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

    时间:2017-6-13

    版本:v1.1

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

  • 系统级输入参数:

    请参考系统级输入参数

    应用级输入参数:


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

    审核状态XML文件

    updateReturnExchangeOrdersApprStatus

    file

    <input type=file..

    配送状态XML文件,具体内容请参考“审核状态XML文件”


     

    审核状态XML文件格式说明:


  • 审核状态XML文件示例:

    <?xml version="1.0" encoding="GBK"?>
    <request>
        <functionID>dangdang.orders.exchange.return.apply.approve</functionID>
        <time>2009-03-20 15:10:50</time>
        <OrdersList>
            <OrderInfo>
                <orderID>1719544796</orderID>
                <returnExchangeCode>2567657</returnExchangeCode>
                <returnExchangeOrdersApprStatus>1</returnExchangeOrdersApprStatus>
                <apprComments>可以随时退换货</apprComments>
            </OrderInfo>
            <OrderInfo>
                <orderID>17195447006</orderID>
                <returnExchangeCode>2567525657</returnExchangeCode>
                <returnExchangeOrdersApprStatus>1</returnExchangeOrdersApprStatus>
                <apprComments>可以随时退换货</apprComments>
                <!-- 仅退款的情况-->
                <itemsList>
                    <ItemInfo>
                       <itemID>1123456</itemID>
                       <originalItemId>17195447006001</originalItemId>
                       <itemApproveAmount>10.01</itemApproveAmount>
                    </ItemInfo>
                </itemsList>
            </OrderInfo>
        </OrdersList>
    </request>


     

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


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

    <?xml version="1.0" encoding="GBK"?>

    <response>

     <functionID>dangdang.orders.exchange.return.apply.approve</functionID>

        <time>2014-02-08 14:19:05</time>、

        <ResultList>

            <Result>

                <orderID>01</orderID>

                <returnExchangeCode>exchangecode0</returnExchangeCode>

                <operCode>0</operCode>

                <operation>操作成功</operation>

            </Result>

            <Result>

                <orderID>11</orderID>

                <returnExchangeCode>exchangecode1</returnExchangeCode>

                <operCode>1</operCode>

                <operation>商品名称错误</operation>

            </Result>       

        </ResultList>

    </response>


  • java版

    SdkClient sdkClient= new SdkClient(appKey, appSecret, session, version) ;
    OrdersExchangeReturnBatchApprRequest request=new OrdersExchangeReturnBatchApprRequest();
    request.setUpdateReturnExchangeOrdersApprStatusFile(new FileItem(new File(path)));
    OrdersExchangeReturnBatchApprResponse response=sdkClient.excute(request);
    System.out.println(response.toString());


    php版

    $sdkClient = new DDHttpClient(appkey,appSecret,session);
    $OrdersExchangeReturnApplyApproveRequest = new OrdersExchangeReturnApplyApproveRequest();
    $OrdersExchangeReturnApplyApproveRequest->setUpdateReturnExchangeOrdersApprStatus($xmlFile);
    $sdkResponse = $sdkClient->execute($OrdersExchangeReturnApplyApproveRequest);