物流轨迹推送
POST
{{backurl}}
接口描述
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 | 否 | 签收人 |
| 状态 | 说明 |
|---|---|
| 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 -g --request POST '' \
--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": "0000",
"message": "接收成功",
"data": {
"orderid": "14437042180846542"
}
}请求参数
Header 参数
app-key
string
开放平台发放
默认值:
{{app-key}}
sign
string
必需
默认值:
{{sign}}
req-time
string
当前时间戳（毫秒）
默认值:
{{$timestamp}}
Body 参数application/json
返回响应
扫码加入交流群修改于 2021-11-10 04:26:26