返回订单API

dangdang.orders.logistics.update

更新订单物流信息

  • 功能描述:当当不提供没有对接的物流公司的运单物流信息,商家可以通过此API回传此类运单的物流信息。

    支持的数据格式:XML

    HTTP请求方式:POST

    版本:1.0

  • 时间:2018-7-13

    版本:v1.0

  • 系统级输入参数:

    请参考系统级输入参数

    应用级输入参数:

    变量名称

    变量命名

    变量类型

    是否必填

    说明

    物流信息XML

    orderTrace

    String

    物流信息XML,具体内容请参考“物流信息XML说明”


    物流信息XML说明:

  • <?xml version="1.0" encoding="GBK" standalone="yes"?>
    <request>
        <functionID>ordertraceupdate</functionID>
        <time>20151121120033998</time>
        <orderTraceList>
            <orderTrace>
                <orderId>1013035352857</orderId>
                <info>顾客订单已从当当发出, 准备送往快递公司</info>
                <location>分拣中心</location>
                <name>出库</name>
                <source>TMS</source>
                <time>2018-06-24 16:00:39</time>
                <trackinNo>jk011</trackinNo>
            </orderTrace>
            <orderTrace>
                <orderId>1013035352857</orderId>
                <info>顾客订单已从当当发出, 准备送往快递公司</info>
                <location>系统</location>
                <name>付款成功</name>
                <source>订单系统</source>
                <time>2018-06-24 15:50:35</time>
                <trackinNo>jk011</trackinNo>
            </orderTrace>
            <orderTrace>
                <orderId>1013035352857</orderId>
                <info>顾客订单已从当当发出, 准备送往快递公司</info>
                <location>系统</location>
                <name>提交订单</name>
                <source>审核系统</source>
                <time>2018-06-24 15:30:49</time>
                <trackinNo>jk011</trackinNo>
            </orderTrace>
        </orderTraceList>
    </request>
  • 返回参数

  • <?xml version="1.0" encoding="GBK" standalone="yes"?>
    <response>
        <functionID>dangdang.orders.logistics.update</functionID>
        <result>
            <orderTraceList>
                <orderTrace>
                    <orderId>1013035352857</orderId>
                    <orderOperCode>0</orderOperCode>
                    <orderOperation>处理成功</orderOperation>
                </orderTrace>
                <orderTrace>
                    <orderId>1013035352857</orderId>
                    <orderOperCode>0</orderOperCode>
                    <orderOperation>处理成功</orderOperation>
                </orderTrace>
                <orderTrace>
                    <orderId>1013035352857</orderId>
                    <orderOperCode>0</orderOperCode>
                    <orderOperation>处理成功</orderOperation>
                </orderTrace>
            </orderTraceList>
        </result>
    </response>


  • Java版

    SdkClient sdkClient= new SdkClient(appKey, appSecret, session, version) ;
    OrderTrace orderTrace=new OrderTrace();
    orderTrace.setInfo("
    顾客订单已从当当发出, 准备送往快递公司");
    List<OrderTrace> orderTraceList=new ArrayList<OrderTrace>();
    orderTraceList.add(orderTrace);
    OrdersLogisticsUpdateRequest request=new OrdersLogisticsUpdateRequest();
    LogisticsUpdate logisticsUpdate=new LogisticsUpdate();
    logisticsUpdate.setOrderTraceList(orderTraceList);
    request.setLogisticsUpdate(logisticsUpdate);
    OrdersLogisticsUpdateResponse response=sdkClient.excute(request);
    System.out.println(response.toString());


    php版

    $sdkClient = new DDHttpClient(appKey,appSecret,session)

    $ordersLogisticsUpdateRequest = new OrdersLogisticsUpdateRequest();
    $result = $ddHttpClient->execute($ordersLogisticsUpdateRequest);