文档中心 > API类目 > 天猫服务平台

tmall.servicecenter.workcard.logisticsorder.query (物流单信息查询)

物流订单信息查询API

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
logistics_order_id Number 必须 2333344444 物流单号
new_logistics Boolean 可选 true 是否查询新物流,不填默认查原有物流

响应参数

名称 类型 示例值 描述
result FulfilplatformResult 112223333 结果
  • result_data
  • ExpressDto
  • resultdata
  • 物流信息
  • └ goods_info
  • String
  • [{ "name": "大衣,毛衣", "count": 1 }, { "name": "裤子", "count": 2 }]
  • 物品信息明细 字符串格式为:json 串 例子: [{ "name": "大衣,毛衣", "count": 1 }, { "name": "裤子", "count": 2 }]
  • └ sub_mail_nos
  • String []
  • [333333,33333]
  • 子物流单号
  • └ mail_no
  • String
  • 444554444
  • 物流单号
  • sender
  • CustomerInfo
  • sender
  • 寄件人信息
  • └ account_nick
  • String
  • 寄件人测试账号NIck
  • 寄件人名称
  • └ phone
  • String
  • 133344333333
  • 寄件人手机号码
  • └ full_address
  • String
  • 浙江省 杭州市 XX区 XX路XX号
  • 寄件地址
  • receiver
  • CustomerInfo
  • receiver
  • 收件人信息
  • └ account_nick
  • String
  • 收件人测试账号NIck
  • 收件人名称
  • └ phone
  • String
  • 122233444444
  • 收件人手机号码
  • └ full_address
  • String
  • 浙江省 杭州市 XX区 XX路XX号
  • 收件地址
  • └ logistics_order_id
  • Number
  • 111122333
  • 物流单号
  • └ reserve_end_time
  • Date
  • 2021-03-04 11:37:40
  • 预约开始时间
  • └ reserve_start_time
  • Date
  • 2021-03-04 13:37:40
  • 预约结束时间
  • └ status_code
  • String
  • create
  • 物流创建 :create 物流取消 :cancel 分派小件员:assign 已经分派小件员: assigned 包裹上门揽收: pickup_door 包裹已揽收完成: pickup_finished 包裹派送中: dispatching 包裹已签收: signed
  • └ goods_type
  • String
  • luxury
  • luxury(奢饰商品)/common(普通商品)
  • └ value_added_service_demand
  • String
  • {"needInsurance":"true","insuranceValue":"1000"}
  • 增值服务需求
  • └ extend_info
  • String
  • {"senderMemo":"abc"}
  • 扩展属性
  • └ success
  • Boolean
  • true
  • 结果 true /false
  • └ display_msg
  • String
  • ******业务错误
  • 错误信息
  • └ stage_type
  • String
  • STAGE1
  • 物流类型 消费者--> 商家 STAGE1;商家--->消费者 STAGE2

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallServicecenterWorkcardLogisticsorderQueryRequest req = new TmallServicecenterWorkcardLogisticsorderQueryRequest();
req.setLogisticsOrderId(2333344444L);
req.setNewLogistics(true);
TmallServicecenterWorkcardLogisticsorderQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tmall_servicecenter_workcard_logisticsorder_query_response>
    <result>
        <result_data>
            <goods_info>[{ &quot;name&quot;: &quot;大衣,毛衣&quot;, &quot;count&quot;: 1 }, { &quot;name&quot;: &quot;裤子&quot;, &quot;count&quot;: 2 }]</goods_info>
            <sub_mail_nos>
                <string>[333333</string>
                <string>33333]</string>
            </sub_mail_nos>
            <mail_no>444554444</mail_no>
            <sender>
                <account_nick>寄件人测试账号NIck</account_nick>
                <phone>133344333333</phone>
                <full_address>浙江省 杭州市 XX区 XX路XX号</full_address>
            </sender>
            <receiver>
                <account_nick>收件人测试账号NIck</account_nick>
                <phone>122233444444</phone>
                <full_address>浙江省 杭州市 XX区 XX路XX号</full_address>
            </receiver>
            <logistics_order_id>111122333</logistics_order_id>
            <reserve_end_time>2021-03-04 11:37:40</reserve_end_time>
            <reserve_start_time>2021-03-04 13:37:40</reserve_start_time>
            <status_code>create</status_code>
            <goods_type>luxury</goods_type>
            <value_added_service_demand>{&quot;needInsurance&quot;:&quot;true&quot;,&quot;insuranceValue&quot;:&quot;1000&quot;}</value_added_service_demand>
            <extend_info>{&quot;senderMemo&quot;:&quot;abc&quot;}</extend_info>
        </result_data>
        <success>true</success>
        <display_msg>******业务错误</display_msg>
        <stage_type>STAGE1</stage_type>
    </result>
</tmall_servicecenter_workcard_logisticsorder_query_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

返回
顶部