返回订单API

  • 功能描述:根据订单编号查看订单详细信息(包括自发非COD订单、代发非COD订单、代发COD订单、自发COD订单)。支持有“买A赠多”促销的订单。

    支持的数据格式:XML

    HTTP请求方式:GET

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

    时间:2017-6-13

    版本:v1.1

    变更说明:添加orderStatus、couponId、couponProvider、eReceiptAddress 等信息;扩展receiptType;


    时间:2017-6-27

    版本:v1.2

    变更说明:添加taxpayerId;



    时间:2021-6-01

    版本:2.0

    变更说明:添加totalBarginPrice;更改sendGoodsCount指实发;ItemInfo.specialAttribute格式修改;新增gatherSalesPromoDeductAmount字段为集合级促销总和;新增订单级金额信息集合汇总本订单所有金额



    时间:2021-08-05
    版本:4.0
    变更说明:
    返回参数
    1、添加encrypt_content;对消费者信息进行加密,需要调取解密接口获取真实信息;
    2、加密字段包括:收货人姓名:consigneeName; 收货人固定电话:consigneeTel; 收货人移动电话:consigneeMobileTel; 收货地址:consigneeAddr


  • 系统级输入参数:

    请参考系统级输入参数

    应用级输入参数:


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

    订单编号

    o

    long

    12345678

    一次只能查询一张订单详细信息。

    “订单编号”和“外部订单编号”:可以都填,但是至少得填写一项。

    推荐按订单号查询

    外部订单编号

    outerOrderID

    string

    AT9-023902

    外部订单编号,可以填写字母/数字/汉字。支持包裹的“外部订单编号”

    和父订单的“外部订单编号”。
    “订单编号”和“外部订单编号”:可以都填,但是至少得填写一项。


     

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

    <response>
        <functionID>searchOrders</functionID>
        <time>2021-08-31 16:07:09</time>
        <totalInfo>
            <sendGoodsOrderCount>0</sendGoodsOrderCount>
            <needExchangeOrderCount
                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
                <orderCount>487902</orderCount>
                <totalOrderMoney
                    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
                    <pageSize>2</pageSize>
                    <pageTotal>243951</pageTotal>
                    <currentPage>1</currentPage>
                </totalInfo>
                <OrdersList>
                    <OrderInfo>
                        <orderID>43168867049</orderID>
                        <consigneeName>潘</consigneeName>
                        <consigneeTel
                            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
                            <consigneeMobileTel>182****5157</consigneeMobileTel>
                            <consigneeAddr>中国,**北京**阳区**园街**三环**号静**</consigneeAddr>
                            <DangdangWarehouseAddr
                                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
                                <sendGoodsMode>1</sendGoodsMode>
                                <orderMoney>0.01</orderMoney>
                                <orderTimeStart>2021-08-30 16:46:03</orderTimeStart>
                                <lastModifyTime>2021-08-30 19:11:01</lastModifyTime>
                                <orderState>-100</orderState>
                                <orderStatus>-100</orderStatus>
                                <outerOrderID
                                    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
                                    <remark
                                        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
                                        <label
                                            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
                                            <paymentDate
                                                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
                                                <orderMode>1</orderMode>
                                                <isPresale>0</isPresale>
                                                <sendDate
                                                    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
                                                    <originalOrderId
                                                        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
                                                        <invoiceCategory
                                                            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
                                                            <encrypt_content>
    qL+MfSHlpdxl2HsOkooac6apsSnsr+oGm3LTK0CgzNvZNEYtDRavCpB3rbM5LTYGWxtVRH3R7ZWSyYQ9LDVzUlKkSzNxxJU2Qzcp4YIerlAe3RIGQO5s4cibMy2GEuVa4Uk5Q4HAV0KAYkj3X1yDB/MBjxSiPSA1RzqwAMQYvKyn1DyZQIWS7i6CxVQW9qlxSRcymeat4fAmZ4X1bVeGo9/SqOtnlDKbgaVjghnOYAVKRFyvgMH3O6OEOg+fdBwixtzNJ4nltaSSt6o4lbCjN0f8xvdN7c8MsEJTKSCRVVGofHqRAfEsh42dnApUkCt9
    </encrypt_content>
                                                        </OrderInfo>
                                                        <OrderInfo>
                                                            <orderID>43168736979</orderID>
                                                            <consigneeName>潘</consigneeName>
                                                            <consigneeTel
                                                                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
                                                                <consigneeMobileTel>182****5157</consigneeMobileTel>
                                                                <consigneeAddr>中国,**北京**阳区**园街**三环**号静**</consigneeAddr>
                                                                <DangdangWarehouseAddr
                                                                    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
                                                                    <sendGoodsMode>1</sendGoodsMode>
                                                                    <orderMoney>0.01</orderMoney>
                                                                    <orderTimeStart>2021-08-30 16:37:52</orderTimeStart>
                                                                    <lastModifyTime>2021-08-30 16:39:50</lastModifyTime>
                                                                    <orderState>-100</orderState>
                                                                    <orderStatus>-100</orderStatus>
                                                                    <outerOrderID
                                                                        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
                                                                        <remark
                                                                            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
                                                                            <label
                                                                                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
                                                                                <paymentDate
                                                                                    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
                                                                                    <orderMode>1</orderMode>
                                                                                    <isPresale>0</isPresale>
                                                                                    <sendDate
                                                                                        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
                                                                                        <originalOrderId
                                                                                            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
                                                                                            <invoiceCategory
                                                                                                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
                                                                                                <encrypt_content>
    qL+MfSHlpdxl2HsOkooac6apsSnsr+oGm3LTK0CgzNvZNEYtDRavCpB3rbM5LTYGWxtVRH3R7ZWSyYQ9LDVzUlKkSzNxxJU2Qzcp4YIerlAe3RIGQO5s4cibMy2GEuVa4Uk5Q4HAV0KAYkj3X1yDB/MBjxSiPSA1RzqwAMQYvKyn1DyZQIWS7i6CxVQW9qlxSRcymeat4fAmZ4X1bVeGo9/SqOtnlDKbgaVjghnOYAVKRFyvgMH3O6OEOg+fdBwixtzNJ4nltaSSt6o4lbCjN0f8xvdN7c8MsEJTKSCRVVGofHqRAfEsh42dnApUkCt9
    </encrypt_content>
                                                                                            </OrderInfo>
                                                                                        </OrdersList>
                                                                                    </response>

  • <?xml version="1.0" encoding="GBK" standalone="yes"?>
    <response>
        <functionID>getOrderDetail</functionID>
        <time>2017-06-13 17:04:28</time>
        <Error>
            <operCode>35</operCode>
            <operation>订单编号错误</operation>
        </Error>
    </response>

  • java版
    SdkClient sdkClient= new SdkClient(appKey, appSecret, session, version) ;

    OrderDetailsGetRequest request=new OrderDetailsGetRequest();

    OrderDetailsGet orderDetailsGet=new OrderDetailsGet();

    orderDetailsGet.setO("38086091600");

    request.setOrderDetailsGet(orderDetailsGet);

    OrderDetailsGetResponse result=sdkClient.excute(request);

    System.out.println("ok:" + result.toString());

    php版

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

    $OrderDetailsGetRequest = new OrderDetailsGetRequest();
    $OrderDetailsGetRequest->setOrderId("1013037686167");
    $sdkResponse = $sdkClient->execute($OrderDetailsGetRequest);