全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试

物流流转信息查询


接口地址: http://api.vv-tool.com/tool/erps/searchtrace


接口介绍: 用户根据淘宝交易号查询物流流转信息,如 2010-8-10 15:23:00 到达杭州集散地。
此接口的返回信息都由物流公司提供。(备注:使用线下发货(offline.send)的运单,不支持运单状态的实时跟踪,只要一发货,状态就会变为对方已签收,该字段仅对线上发货(online.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 未授权店铺 根据返回链接进行扫码授权