韵达 API

物流轨迹查询

POST/outer/logictis/query

接口描述

韵达提供物流轨迹查询接口，对接物流轨迹查询接口需先对接订阅接口。订阅成功后则有权限获取订阅运单的所有物流轨迹信息。
注意：
1：调用查询的运单号必须先订阅（物流轨迹订阅），否则无法查询到轨迹信息
2：订阅成功后60天为有效期
3：只支持单个查询
4：申请使用物流轨迹查询接口，请联系韵达市场营销中心（联系方式：021-39296012或zhangyu6211@yundaex.com）建立合作，完成合作确认后获取接口使用权限（邮件需说明合作内容与公司名）；

节点状态status说明：

状态	说明
GOT	已揽件
TRANSIT	运输中
SIGNED	已签收
RETURN	退回件
SIGNFAIL	异常签收

节点状态action说明：

状态	说明
ACCEPT	收件扫描
GOT	揽件扫描
ARRIVAL	入中转
DEPARTURE	出中转
SENT	派件中
INBOUND	第三方代收入库
SIGNED	已签收
OUTBOUND	第三方代收快递员取出
SIGNFAIL	签收失败
RETURN	退回件
ISSUE	问题件
REJECTION	拒收
OTHER	其他
OVERSEA_IN	入库扫描
OVERSEA_OUT	出库扫描
CLEARANCE_START	清关开始
CLEARANCE_FINISH	清关结束
CLEARANCE_FAIL	清关失败
OVERSEA_ARRIVAL	干线到达
OVERSEA_DEPARTURE	干线离开
TRANSFER	转单

请求参数

mailno

string

运单号

必需

{
  "data": "{\"partner_id\":\"test\",\"time\":\"2020-10-24 17:26:06\",\"city\":\"武汉市\",\"orderid\":\"O93101603780336327s\",\"mailno\":3160000261634,\"action\":\"GOT\",\"station\":430003,\"station_name\":\"华中东西湖区公司\",\"phone\":\"\",\"station_type\":2,\"next_type\":3,\"next_name\":\"华中枢纽\",\"next_city\":\"武汉市\",\"next\":430001,\"description\":\"华中东西湖区公司 已揽收\",\"signer\":null}",
  "appKey": "999999",
  "sign": "c7c95ae82d8b027165d068a86902e15f"
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

result

boolean

是否成功

必需

code

string

响应编码

必需

message

string

响应内容

必需

data

object

返回对象信息

必需

mailno

string

运单号

必需

result

boolean

响应状态

必需

time

string

时间

必需

remark

string

备注

必需

status

string

必需

节点状态，GOT已揽件，TRANSIT运输中，SIGNED 已签收，RETURN 退回件，SIGNFAIL异常签收

steps

array [object {14}]

轨迹参数

必需

未设置

最后修改时间： 3 年前