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

qimen.taobao.logistics.express.trace.query (淘天物流快递轨迹查询接口)

淘天物流快递轨迹查询

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	描述
supplier_id	String	必须	820282020	淘天服务商id
delivery_code	String	必须	10000	物流公司（资源）
mail_no	String	必须	10000	运单号
biz_code	String	可选	10000	单据编码
type	String	可选	SELLER	是否为原始值 ORIGIN：原始轨迹（默认） SELLER：消费者端展示轨迹

响应参数

名称	类型	示例值	描述
success	Boolean	true	系统成功失败
error_code	String	10000	响应码
error_message	String	系统错误	响应信息
is_retry	Boolean	true	是否可重试
data	TmsTraceQueryResponse		轨迹信息
traces TraceDO [] 详情明细 trace TraceDO 轨迹信息 operator OperatorDO 操作员信息 └ operator_mobile String 18** 操作员电话号码 └ operator_name String 张三操作原名称 └ operator_code String 123434 操作员编码 site SiteDO 站点信息 └ site_sub_type String 1 站点子类型 └ site_type String 1 站点类型 └ site_name String 杭州站点站点名称 └ site_code String 123343 站点编码 address AddressDO 地址信息 └ address String 不包含省市区街道的详细地址详细地址 └ street String 仓前街道街道 └ district String 余杭区区 └ city String 杭州市市 └ province String 浙江省省 └ country String 中国国家 detail DetailDO 详情 └ predict_next_node_time String 2024-05-04 00:23:23 预计到达下一节点信息 └ predict_delivery_time String 2024-05-04 00:23:23 预计送达时间 └ error_msg String 因无法派送异常原因 └ error_code String 1002 异常码 └ operate_desc String 订单在**揽收详细描述 └ display_action String 揽收中展示状态 └ operate_action String TMS_COLLECT 操作类型 └ operate_time String 2024-05-04 00:23:23 操作时间 └ mail_no String 10000 运单号 └ biz_code String 10000 单号编码

请求示例

{"delivery_code":"10000","biz_code":"10000","type":"SELLER","supplier_id":"820282020","mail_no":"10000"}

响应示例

{
    "success":true,
    "error_code":"10000",
    "error_message":"系统错误",
    "is_retry":true,
    "data":{
        "traces":[
            {
                    "trace":{
                        "operator":{
                            "operator_mobile":"18****",
                            "operator_name":"张三",
                            "operator_code":"123434"
                        },
                        "site":{
                            "site_sub_type":"1",
                            "site_type":"1",
                            "site_name":"杭州站点",
                            "site_code":"123343"
                        },
                        "address":{
                            "address":"不包含省市区街道的详细地址",
                            "street":"仓前街道",
                            "district":"余杭区",
                            "city":"杭州市",
                            "province":"浙江省",
                            "country":"中国"
                        },
                        "detail":{
                            "predict_next_node_time":"2024-05-04 00:23:23",
                            "predict_delivery_time":"2024-05-04 00:23:23",
                            "error_msg":"因***无法派送",
                            "error_code":"1002",
                            "operate_desc":"订单在***揽收",
                            "display_action":"揽收中",
                            "operate_action":"TMS_COLLECT",
                            "operate_time":"2024-05-04 00:23:23"
                        }
                    }
            }
        ],
        "mail_no":"10000",
        "biz_code":"10000"
    }
}

验签示例

{"error_message":"Illegal request","success":"false","error_code":"sign-check-failure"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

物流API

qimen.taobao.logistics.express.trace.query (淘天物流快递轨迹查询接口)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ