返回订单API

  • 功能描述:商家可以对用户的退货申请进行处理,商家一次只能处理一张订单,并且该订单必须“退换货申请审核通过”。支持延期退货。不能对代退货申请进行处理。

    支持的数据格式:XML

    HTTP请求方式:GET

    版本:v1.0 v2.0

  • 系统级输入参数:

    请参考系统级输入参数

    应用级输入参数:


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

    订单编号

    o

    long

    12345678

     

    退货单编号

    ro

    long

    4560000

    填写“退货申请单编号”,或者填写“查询退换货订单列表信息”

    接口中返回的“退/换货单编号”字段内容

    逆向退邮费

    shippingAmount

    float


    不大于50

    部分扣款

    deductAmount

    float

    11.1

    1、可以不填,默认为0
    2、只有特定商家,才需要填写此字段
    3、国美已返节能补贴金额通过该字段返回

    商家备注

    mo

    string

    同意退款

    长度:50个汉字内

    商家操作

    op

    int

    1000

    1000、商家同意退款
    1100、商家不同意退款
    1200、商家延期退货


     

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


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

    <?xml version="1.0" encoding="GBK"?>
    <response>
        <functionID>dangdang.order.return</functionID>
        <time>2009-03-20 15:10:50</time>
        <Result>
            <orderID>1111</orderID>
            <returnOrderID>123</returnOrderID>
            <operCode>0</operCode>
            <operation>操作成功</operation>
        </Result>
    </response>



  • java版

       

    SdkClient sdkClient= new SdkClient(appKey, appSecret, session, version) ;
    OrderReturnRequest request=new OrderReturnRequest();
    OrderReturn orderReturn =new OrderReturn();
    orderReturn.setO("38070496150");

    request.setOrderReturn(orderReturn);
    OrderReturnResponse response=sdkClient.excute(request);
    System.out.println(response.toString());



    php版

    $sdkClient = new DDHttpClient(appkey,appSecret,session);
    $orderReturnRequest = new OrderReturnRequest();
    $orderReturnRequest->setOrderId("1013037685707");
    $sdkResponse = $sdkClient->execute($orderReturnRequest);