韵达 API

物流轨迹订阅

POST/outer/logictis/subscribe

接口描述

为方便各合作方快速安全的查询到物流轨迹信息，特制定此接口规范，请各合作方严格遵循手册中的各项规范及要求，并同时做好相关的保密工作，谢谢配合。
1：合作方先通过订阅接口将运单信息给到韵达才能有后续的物流轨迹服务；
2：运单订阅后的有效期是60天；
3：合作方需合理控制调用物流查询接口频率；
4：申请使用物流轨迹订阅接口，请联系韵达市场营销中心（联系方式：021-39296012或zhangyu6211@yundaex.com）建立合作，完成合作确认后获取接口使用权限（邮件需说明合作内容与公司名）；

错误码说明

s00 未知错误
s01 非法的合作商账户
s02 非法的主机来源
s03 非法的数据签名
s04 非法的请求类型
s06 非法的订单号
s07 账户不具有访问本功能的权限
s08 查询的运单没有经过指定账号进行订阅操作
s09 当天下单量超出限额
s10 当天查询量超出限额
s11 无效的指令操作
s12 没有指定有效的查询条件
s13 非法运单号
s14 数据格式错误
s15 发件人手机错误
s16 发件人电话错误
s17 收件人手机错误
s18 收件人电话错误
s51 发件人信息不完整
s52 收件人信息不完整
s71 发件人所在地区服务已关闭
s72 收件人所在地区服务已关闭
s91 信息不完整
s97 数据更新失败
s98 数据保存失败
s99 服务器错误
s100 服务器网络波动，建议稍后重试
e03 黑名单客户
e99 其他原因

请求参数

orders

array [object {4}]

订单详情集合

必需

orderid

string

订单号

必需

mailno

string

必需

运单号(快递面单上的韵达单号)

receiver

object

receiver

必需

sender

object

发件信息

必需

{
  "orders": [
    {
      "orderid": "9987765544332",
      "mailno": "3309876541228",
      "receiver": {
        "address": "青浦区盈港东路 6679 号",
        "city": "上海市",
        "county": "青浦区",
        "mobile": "0553-9876542",
        "name": "李四",
        "phone": 17601205970,
        "province": "上海市"
      },
      "sender": {
        "address": "盈港东路 7766 号",
        "city": "上海市",
        "county": "青浦区",
        "mobile": "0553-9876542",
        "name": "张三",
        "phone": 17601205970,
        "province": "上海市"
      }
    },
    {
      "orderid": "8876544333322",
      "mailno": "3309876541228",
      "receiver": {
        "address": "青浦区盈港东路 6679 号",
        "city": "上海市",
        "county": "青浦区",
        "mobile": "0553-9876542",
        "name": "李四",
        "phone": 17601205970,
        "province": "上海市"
      },
      "sender": {
        "address": "盈港东路 7766 号",
        "city": "上海市",
        "county": "青浦区",
        "mobile": "0553-9876542",
        "name": "张三",
        "phone": 17601205970,
        "province": "上海市"
      }
    }
  ]
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

code

string

响应编码

必需

message

string

响应内容

必需

result

boolean

是否成功

必需

data

array [object {2}]

返回对象信息

必需

orderId

string

订单号

必需

result

boolean

必需

订阅结果（true-成功，false-失败）

{
  "result": true,
  "code": "0000",
  "message": "请求成功",
  "data": [
    {
      "result": true,
      "orderid": "8876544333322"
    },
    {
      "result": true,
      "orderid": "8876544333322"
    }
  ]
}

最后修改时间： 3 年前