1.功能描述
快递发货后，系统将更新后的全量物流信息回推给贵方，可直接用于物流展示；
2.接口信息
请求的Content-Type：application/json;charset=UTF-8
3.请求参数
| 名称 | 类型(字符长度) | 是否必填 | 描述 |
|---|---|---|---|
| app_key | String | 是 | 由快递100提供，接入应用的唯一标识([快递管家官网API服务],管理中的App Key) |
| timestamp | long | 是 | 时间戳,自1970年01月01日起到现在的秒数, 例： 1502963129 |
| type | String | 是 | 回调接口推送类型，固定为：EXPRESSINFO |
| sign | String | 否 | 签名，签名算法参照【签名说明】 |
| data | String | 是 | Json字符串 |
data参数
| 名称 | 类型(字符长度) | 是否必填 | 描述 |
|---|---|---|---|
| order_number | String(30) | 是 | 订单编号 |
| express_info | Object | 是 | 物流信息 |
| └status | String(30) | 是 | 监控状态: 监控中：polling 结束：shutdown 中止：abort 重新推送：updateall 其中当快递单为已签收时status=shutdown， 当message为“3天查询无记录”或“60天无变 化时”status= abort |
| └message | String(30) | 否 | 监控状态相关消息，如:3天查询无记录，60天无变化 |
| └last_result | Object | 是 | 最新查询结果，全量，倒序(即时间最新的在最前) |
| └-state | String(30) | 是 | 快递单当前签收状态，包括 0:在途中 1:已揽收 2:疑难 3:已签收 4:退签 5:同城派送中 6:退回 7:转单 |
| └-is_check | String(30) | 是 | 是否签收，0：未签收，1：签收 |
| └-company_code | String(30) | 是 | 快递公司编码 |
| └-com_name | String(30) | 是 | 快递公司名称 |
| └-kuaidi_num | String(30) | 是 | 快递单号 |
| └-data | Array | 是 | 详细物流信息 |
| └--context | String(30) | 是 | 操作说明 |
| └--time | String(30) | 是 | 操作时间，原始格式 |
| └--f_time | String(30) | 是 | 操作时间，格式化后时间 |
| └--status | String(30) | 是 | 本数据元对应的签收状态，包括 0:在途中 1:已揽收 2:疑难 3:已签收 4:退签 5:同城派送中 6:退回 7:转单 |
| └--area_code | String(30) | 是 | 本数据元对应的行政区域的编码 |
| └--area_name | String(30) | 是 | 本数据元对应的行政区域的名称 |
示例：
{
"timestamp": 1593398115,
"data": {
"express_info": {
"message": "",
"status": "shutdown",
"bill_status": "check",
"last_result": {
"is_check": "1",
"message": "ok",
"company_code": "yunda",
"kuaidi_num": "46035400000400",
"condition": "F00",
"status": "200",
"data": [
{
"time": "2020-06-29 09:36:44",
"status": "签收",
"f_time": "2020-06-29 09:36:44",
"context": "[北京昌平区昌平公司百善分部]【代收点】您的快件已送达 绿城阳光小区底商百世快递 保管，地址：绿城阳光小区底商百世快递，请及时领取，如有疑问请电联快递员：高环环【13381035639】。"
},
{
"time": "2020-06-29 08:43:30",
"status": "派件",
"area_code": "CN110114113000",
"area_name": "北京,北京,昌平区,百善镇",
"f_time": "2020-06-29 08:43:30",
"context": "[北京昌平区昌平公司百善分部]北京昌平区昌平公司百善分部 快递员 高环环13381035639 正在为您派件【95114/95121/9501395546为韵达快递员外呼专属号码，请放心接听】"
},
{
"time": "2020-06-29 07:22:57",
"status": "在途",
"f_time": "2020-06-29 07:22:57",
"context": "[北京昌平区昌平公司]已离开 北京昌平区昌平公司；发往 北京昌平区昌平公司百善分部"
},
{
"time": "2020-06-28 23:47:52",
"status": "在途",
"f_time": "2020-06-28 23:47:52",
"context": "[华北枢纽]已离开 华北枢纽；发往 北京昌平区昌平公司"
},
{
"time": "2020-06-28 23:21:45",
"status": "在途",
"f_time": "2020-06-28 23:21:45",
"context": "[华北枢纽]已到达 华北枢纽"
},
{
"time": "2020-06-28 00:27:07",
"status": "在途",
"f_time": "2020-06-28 00:27:07",
"context": "[浙江义乌分拨中心]【金华市】已离开 浙江义乌分拨中心"
},
{
"time": "2020-06-27 22:25:05",
"status": "在途",
"f_time": "2020-06-27 22:25:05",
"context": "[浙江义乌分拨中心]【金华市】已到达 浙江义乌分拨中心"
},
{
"time": "2020-06-27 21:43:53",
"status": "在途",
"f_time": "2020-06-27 21:43:53",
"context": "[浙江义乌凌云公司]【金华市】已离开 浙江义乌凌云公司；发往 京西地区包"
},
{
"time": "2020-06-27 21:02:03",
"status": "揽收",
"area_code": "CN330782000000",
"area_name": "浙江,金华市,义乌市",
"f_time": "2020-06-27 21:02:03",
"context": "[浙江义乌兴中公司]【金华市】浙江义乌兴中公司 已揽收"
}
],
"state": "3",
"com_name": ""
}
},
"order_num": "65448002"
},
"app_key": "LeWFeuaGwx1v",
"type": "EXPRESSINFO"
}
4.返回参数
| 名称 | 类型(字符长度) | 是否必填 | 描述 |
|---|---|---|---|
| status | String(5) | 是 | 200:成功 400:失败 |
示例：
成功：
{“status”:200}
失败：
{“status”:400}
