alibaba.open.logistics.trace.get (物流流转信息查询)

用户根据交易号查询物流流转信息,如2010-8-10 15:23:00到达杭州集散地。 此接口的返回信息都由物流公司提供。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
logistics_id String 可选 AL8234243 该订单下的物流编号
trade_source_type String 必须 cbu-trade 交易订单来源,支持的来源有:cbu-trade
order_id Number 必须 13342343 订单号

响应参数

名称 类型 示例值 描述
result_msg String 成功 请求返回结果信息
total_count Number 0 订单中物流单个数
result_code String success 请求发货结果编码
is_success Boolean true 操作是否成功
trace_list Trace [] 物流单及跟踪信息列表
  • └ logistics_id
  • String
  • AL13242342
  • 物流编号
  • └ order_id
  • Number
  • 1342424
  • 交易订单号
  • └ logistics_bill_no
  • String
  • 223422143
  • 物流公司提供的运单号
  • logistics_steps
  • LogisticsStep []
  • 流转信息列表
  • └ accept_time
  • String
  • 2000-01-01 00:00:00
  • 状态发生的时间
  • └ remark
  • String
  • 达到杭州物流集中地
  • 状态描述
  • trace_node_list
  • TraceNode []
  • 物流节点信息列表
  • └ accept_time
  • String
  • 2012-04-13 09:38:00
  • 流转节点的时间 格式 yyyy-MM-dd HH:mm:ss
  • └ encrypt
  • String
  • GB
  • 地区编码规范(CN、GB)
  • └ area_code
  • String
  • 3111111
  • 事件发生城市的省市区编码
  • └ action
  • String
  • SIGN
  • 事件/操作,事件包括:TRANSPORT,SIGN,UNSIGN
  • └ facility_name
  • String
  • 滨东路网点
  • 网点名称或分拨中心名称
  • └ facility_no
  • String
  • 234
  • 网点编号
  • └ facility_type
  • String
  • 网点
  • 站点类型:1. 网点,2. 中转中心\分拨中心
  • └ remark
  • String
  • 到达杭州集散中心
  • 状态描述

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaOpenLogisticsTraceGetRequest req = new AlibabaOpenLogisticsTraceGetRequest();
req.setLogisticsId("AL8234243");
req.setTradeSourceType("cbu-trade");
req.setOrderId(13342343L);
AlibabaOpenLogisticsTraceGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_open_logistics_trace_get_response>
    <result_msg>成功</result_msg>
    <total_count>0</total_count>
    <result_code>success</result_code>
    <is_success>true</is_success>
    <trace_list>
        <trace>
            <logistics_id>AL13242342</logistics_id>
            <order_id>1342424</order_id>
            <logistics_bill_no>223422143</logistics_bill_no>
            <logistics_steps>
                <logistics_step>
                    <accept_time>2000-01-01 00:00:00</accept_time>
                    <remark>达到杭州物流集中地</remark>
                </logistics_step>
            </logistics_steps>
            <trace_node_list>
                <trace_node>
                    <accept_time>2012-04-13 09:38:00</accept_time>
                    <encrypt>GB</encrypt>
                    <area_code>3111111</area_code>
                    <action>SIGN</action>
                    <facility_name>滨东路网点</facility_name>
                    <facility_no>234</facility_no>
                    <facility_type>网点</facility_type>
                    <remark>到达杭州集散中心</remark>
                </trace_node>
            </trace_node_list>
        </trace>
    </trace_list>
</alibaba_open_logistics_trace_get_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部