返回订单API

dangdang.order.receipt.details.get

查询订单的快递面单信息

  • 功能描述:根据订单编号查看订单的面单信息。

    a)代发COD订单:

    1)如果先通过页面已经完成标记配货完成,订单状态为“等待发货”,商家再调打单API,根据页面的配货结果,完成打单、手动发货操作

    2)如果订单状态为“已发货”,商家再调打单API,只是完成打单操作

    3)如果订单状态为“等待配货”,通过API打单,则会进行全部发货,并同时完成标记配货完成、打单、手动发货操作。

    b)代发非COD订单:如果状态不是“等待发货”或“已发货”,不容许打单

    c)自发非COD订单:仅打单;面单金额为0;

    d)自发COD:

    1)如果状态不是“等待发货”或“已发货”,不容许打单

    2)如果状态到达“等待发货”或“已发货”,可以调用此接口,此时仅完成打单功能

    支持的数据格式:XML

    HTTP请求方式:GET

    版本:v1.0 v2.0

  • 系统级输入参数:

    请参考系统级输入参数

    应用级输入参数:


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

    订单编号

    o

    long

    12345678

    一次可以查询最多100张订单的面单信息。

    多个订单编号之间,以英文逗号“,”区隔。

     运输方式

    shippingType

    int


    运输方式从API dangdang.shop.carriagetype.get中获取,传递数字格式代码值(type节点数据) 如:

    999 无需选择,

    1 航空件

    2 汽运件

    注意:如果不传此参数,会按配置的默认运输方式


     

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

    <?xml version="1.0" encoding="GBK"?>
    <response>
        <functionID>dangdang.order.receipt.details.get</functionID>
        <time>2009-03-20 15:10:50</time>
        <orderCourierReceiptDetails>
            <courierReceiptDetail>
                <receiptTitle>招商平台快递详情单</receiptTitle>
                <shopWarehouse>北京仓</shopWarehouse>
                <sendGoodsWarehouse>广州仓</sendGoodsWarehouse>
                <expressCompany>北京顺风</expressCompany>
                <orderID>1719544796</orderID>
                <orderCreateTime>2012-02-02 12:22:33</orderCreateTime>
                <consigneeName>李莹</consigneeName>
                <consigneeAddr>中国,天津,天津市,南京路14号中信银行天津分行会计部</consigneeAddr>
                <consigneeAddr_State>中国</consigneeAddr_State>
                <consigneeAddr_Province>湖南</consigneeAddr_Province>
                <consigneeAddr_City>长沙市</consigneeAddr_City>
                <consigneeAddr_Area>雨花区</consigneeAddr_Area>
                <consigneePostcode>410006</consigneePostcode>
                <consigneeTel>022-23028902</consigneeTel>
                <consigneeMobileTel>022-23028902</consigneeMobileTel>
                <shopName>服装3C专卖店</shopName>
                <shopID>489</shopID>
                <consignerName>张三</consignerName>
                <consignerTel>022-23028902</consignerTel>
                <consignerAddr>中国,湖南,长沙市</consignerAddr>
                <payType>货到付款-POS机</payType>
            </courierReceiptDetail>
            <courierReceiptDetail>
            ……
            </courierReceiptDetail>
            ……
        </orderCourierReceiptDetails>
    </response>



  • java版
        SdkClient sdkClient= new SdkClient(appKey, appSecret, session, version) ;
        OrderReceiptDetailGetRequest request=new OrderReceiptDetailGetRequest();
        ExpressDetailDto expressDetailDto=new ExpressDetailDto();
        expressDetailDto.setO("38086091600");
        request.setExpressDetailReq(expressDetailDto);
        OrderReceiptDetailGetResponse response=sdkClient.excute(request);
        System.out.println(response.toString());

    php版

    $sdkClient = new DDHttpClient(appkey,appSecret,session);
    $orderReceiptDetailsGetRequest = new OrderReceiptDetailsGetRequest();
    $orderReceiptDetailsGetRequest->setOrderId("1013037685727");
    $sdkResponse = $sdkClient->execute($orderReceiptDetailsGetRequest);