文档中心 > API类目 > 淘宝物流API

taobao.logistics.instant.trace.search (物流详情查询)

物流详情查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
mail_no String 可选 SF123456 运单号
is_split Number 可选 0 是否拆单
sub_tid String 可选 123,123 子订单列表
tid Number 必须 2958957469277453416 交易单号

响应参数

名称 类型 示例值 描述
result Result 返回结果
  • └ success
  • Boolean
  • true
  • 是否成功
  • mail_list
  • TopLogisticsMailDTO []
  • 运单列表
  • └ out_sid
  • String
  • SF123456
  • 运单号
  • trace_list
  • TopLogisticsNodeDTO []
  • 物流节点列表
  • └ status_desc
  • String
  • 卖家已发货
  • 节点描述
  • └ status_time
  • Number
  • 1666944383000
  • 当前节点发生时间
  • └ action
  • String
  • CONSIGN
  • 节点枚举
  • └ company_name
  • String
  • 蜂鸟
  • 物流公司
  • └ tid
  • Number
  • 2981194851610453500
  • 交易单号
  • └ status
  • String
  • CONSIGN
  • 当前最新节点

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
LogisticsInstantTraceSearchRequest req = new LogisticsInstantTraceSearchRequest();
req.setMailNo("SF123456");
req.setIsSplit(0L);
req.setSubTid("123,123");
req.setTid(2958957469277453416L);
LogisticsInstantTraceSearchResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<logistics_instant_trace_search_response>
    <result>
        <success>true</success>
        <mail_list>
            <top_logistics_mail_d_t_o>
                <out_sid>SF123456</out_sid>
                <trace_list>
                    <top_logistics_node_d_t_o>
                        <status_desc>卖家已发货</status_desc>
                        <status_time>1666944383000</status_time>
                        <action>CONSIGN</action>
                    </top_logistics_node_d_t_o>
                </trace_list>
                <company_name>蜂鸟</company_name>
                <tid>2981194851610453500</tid>
                <status>CONSIGN</status>
            </top_logistics_mail_d_t_o>
        </mail_list>
    </result>
</logistics_instant_trace_search_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

返回
顶部