韵达 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 参数

Body 参数application/json

示例

返回响应

🟢200成功
application/json
Body

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

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

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