物流轨迹推送
POST
{{backurl}}接口描述
1.申请使用物流轨迹推送接口,请联系韵达市场营销中心(联系方式:021-39296012或zhangyu6211@yundaex.com)建立合作,完成合作确认后获取接口使用权限(邮件需说明合作内容与公司名);
2.物流推送接口只推送运单订阅后产生的物流轨迹信息;
3.推送地址可在控制台中自行设置(控制台-回推联调-地址编辑)
4.网络异常产生的错误韵达默认最大重推10次;
5.sign 签名字符生成规则为 MD5(data字符串 + “_” + app-secret)
data参数说明
参数 | 类型 | 必填 | 参数说明 | |
---|---|---|---|---|
partner_id | String | 是 | 客户app-key | |
orderid | string | 是 | 合作方订单号 | |
mailno | string | 是 | 物流公司运单号 | |
time | date | 是 | 轨迹产生时间 格式 yyyy-MM-dd HH : mm : ss | |
action | String | 是 | 节点状态 见下面节点状态action说明 | |
city | String | 否 | 当前城市 | |
next_city | String | 否 | 下级站点城市 | |
station | int | 是 | 轨迹发生站点编码 | |
station_name | String | 是 | 轨迹发生站点名称 | |
station_type | int | 是 | 轨迹发生站点类型 1是网点,2是分拨中心 |
|
next | int | 否 | 下级站点编码 | |
next_name | String | 否 | 下级站点名称 | |
next_type | int | 否 | 下级站点类型 1是网点,2是分拨中心 |
|
description | String | 是 | 轨迹描述信息 | |
phone | String | 否 | 快递员电话 | |
signer | String | 否 | 签收人 |
节点状态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 | 转单 |
请求参数
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json