物流流转信息查询

---

接口地址： http://www.damaijia168.com/vv/external/searchtrace

---

请求方式： POST

---

传参方式： JSON

---

返回格式： JSON

---

请求头参数

参数	类型	必选	值	示例
Authorization	string	是	授权 access_token	1798c6aadec33d1bc2f5b707f1049aefexxxx

请求参数

参数	类型	必选	描述
shop_id	Number	是	店铺ID
tid	Number	是	淘宝交易号，请勿传非淘宝交易号
is_split	Number	否	表明是否是拆单，默认值0，1表示拆单
sub_tid	Number[]	否	拆单子订单列表，当is_split=1时，需要传人；对应的数据是：子订单号的列表。
edition	string	否	版本 默认:1(不传默认为1) 1:1.0,2:2.0

请求示例

请求代码示例

cURL请求代码示例

PHP请求代码示例

JAVA请求代码示例

Pyton请求代码示例

响应参数

名称	类型	示例值	描述
data	object	返回数据
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	节点说明 ，指明当前节点揽收、派送，签收。
deduct_money	int	1	消耗点券
status	int	0	状态码，0为成功

返回数据

{
  "data": {
      "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"
				}]
			}
		}
        "deduct_money": 4
  },
  "status": 0
}

错误码

状态码(status)	错误信息	解决方案
132	请求格式必须为JSON	修改请求参数格式为json
422	参数列表不合法，在err中会给出提示	根据提示做相应修改
200	认证失败	请确保请求头里的Authorization存在或者未过期
2011	店铺未授权	使用授权店铺