韵达 API
  1. 物流轨迹
韵达 API
  • 接口简介
  • API 鉴权说明
    • API 鉴权说明
  • 电子面单
    • 电子面单取消接口
      POST
    • 电子面单下单
      POST
    • 电子面单余量查询接口
      POST
    • 电子面单更新接口
      POST
  • 散件下单
    • 运单推送接口
      POST
    • 散单取消接口
      POST
    • 预估运费接口
      POST
    • 散件下单接口
      POST
  • 物流轨迹
    • 物流轨迹推送
      POST
    • 物流轨迹查询
      POST
    • 物流轨迹订阅
      POST
  • 国际件
    • 国际进口下单接口
      POST
  • 页面嵌入
    • 微信小程序嵌入
    • 微信公众号接入
    • h5页面嵌入
  1. 物流轨迹

物流轨迹查询

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转单
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://openapi.yundaex.com/openapi-api/outer/logictis/query' \
--header 'app-key;' \
--header 'sign;' \
--header 'req-time;' \
--header 'Content-Type: application/json' \
--data-raw '{
	"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"
}'
响应示例响应示例
{
    "result": true,
    "code": "string",
    "message": "string",
    "data": {
        "mailno": "string",
        "result": true,
        "time": "string",
        "remark": "string",
        "status": "string",
        "steps": [
            {
                "time": "string",
                "station": 0,
                "station_name": "string",
                "station_type": "string",
                "action": "string",
                "description": "string",
                "next": 0,
                "next_type": 0,
                "next_name": "string",
                "phone": "string",
                "signer": "string",
                "status": "string",
                "city": "string",
                "next_city": "string"
            }
        ]
    }
}

请求参数

Header 参数
app-key
string 
开放平台发放
必需
默认值:
{{app-key}}
sign
string 
必需
签名说明参看附录《鉴权说明》
默认值:
{{sign}}
req-time
string 
当前时间戳(毫秒)
必需
默认值:
{{$timestamp}}
Body 参数application/json
mailno
string 
运单号
必需
示例

返回响应

🟢200成功
application/json
Body
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}] 
轨迹参数
必需

【韵达】API开发者 微信交流群

用微信扫右侧二维码,加入【韵达】API开发者 交流群,互助沟通

扫码加入交流群
修改于 2021-11-10 04:26:26
上一页
物流轨迹推送
下一页
物流轨迹订阅
Built with