全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
物流流转信息查询
接口地址: http://api.vv-tool.com/tool/erps/searchtrace
接口介绍: 用户根据淘宝交易号查询物流流转信息,如 2010-8-10 15:23:00 到达杭州集散地。
此接口的返回信息都由物流公司提供。(备注:使用线下发货(offline.send)的运单,不支持运单状态的实时跟踪,只要一发货,状态就会变为
请求方式: POST
返回格式: JSON
接口收费: 联系客服
频率限制: 10 次/秒
请求头参数
参数 | 类型 | 必选 | 值 | 示例 |
---|---|---|---|---|
Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请使用新的生成 token 接口 点击查看详情
请求参数
参数 | 类型 | 必选 | 描述 |
---|---|---|---|
shop_id | Number | 是 | 店铺 ID |
tid | Number | 是 | 淘宝交易号,请勿传非淘宝交易号 |
is_split | Number | 否 | 表明是否是拆单,默认值 0,1 表示拆单 |
sub_tid | Number[] | 否 | 拆单子订单列表,当 is_split=1 时,需要传人;对应的数据是:子订单号的列表。 |
vvtype | Number | 否 | 2 高级版(必须填 2,不填默认是 2) |
请求示例
请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
响应参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
out_sid | String | 1324657987 | 运单号 |
company_name | String | 中通速递 | 物流公司名称 |
tid | Number | 1324657987 | 交易号 |
status | String | 1 | 订单的物流状态 |
trace_list | TransitStepInfo [] | 流转信息列表 | |
--status_time | String | 2000-01-01 00:00:00 | 状态发生的时间 |
--status_desc | String | 达到杭州物流集中地 | 状态描述 |
--action | String | ARRIVE | 节点说明 ,指明当前节点揽收、派送,签收。 |
withholding_money | Number | 该接口扣费金额(点券) |
返回数据
{
"code": 0,
"msg": "操作成功",
"msec": 1469,
"time": 1617270403,
"data": {
"withholding_money": 1,
"logistics_trace_search_response": {
"out_sid": "1324657987",
"company_name": "中通速递",
"tid": 1324657987,
"status": "1",
"trace_list": {
"transit_step_info": [{
"status_time": "2000-01-01 00:00:00",
"status_desc": "达到杭州物流集中地",
"action": "ARRIVE"
}]
}
}
}
}
响应代码
代码 | 代码描述 | 解决方案 |
---|---|---|
0 | 成功 | |
100 | 请求参数错误 | 检查您的请求参数是否正确 |
101 | 请求超时,请重试 | 检查您的网络情况或者联系客服解决 |
103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
200 | 系统错误,请联系客服 | 检查您的接口地址填写是否正确,其他问题联系客服解决 |
203 | 暂不支持当前接口 | |
204 | 请求异常:无该接口权限,请前往官网开通正式接口。 | 前往官网开通该接口权限 |
204 | 请求异常:API 调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
302 | 未授权店铺 | 根据返回链接进行扫码授权 |