快递单号订阅自动推送接口-快递物流轨迹订阅-


版本: -- | 交付方式: API |
适用于: 其他 | 上架日期: 2024-06-13 01:51:56 |
更多产品:
请点击链接 https://marketplace.huaweicloud.com/seller/1c9522d96f3511c7d932971c2cb17224 进入聚美智数店铺查看。
推送说明:
当物流轨迹发生变动时,聚美智数将物流轨迹数据推送至接入商提供地址为callBackUrl的接口
1、数据结构
{ "expressCode":"EMS", // 快递公司编号 详见:快递公司编码对照表 "number":"9796578035309",// 运单编号 "logisticsStatus":"SIGN", // 当前最新物流状态 详见:物流状态编码对照表 "logisticsStatusDesc":"已签收", // 当前最新物流状态描述 "details":[ // 完整的物流轨迹 { "time":1632123146000, // 物流变更时间 "logisticsStatus":"ACCEPT", // 物流状态 详见:物流状态编码对照表 "subLogisticsStatus":"ACCEPT", // 物流子状态 详见:物流状态编码对照表 "desc":"【杭州电商仓配揽投部】已收寄,揽投员:刘岭,电话:13754324900", //物流路由信息描述内容 "areaCode":"CN330100000000", // 路由节点所在地区行政编码 "areaName":"浙江省,杭州市" // 路由节路由节点所在地区 }, { "time":1632140994000, "logisticsStatus":"TRANSPORT", "subLogisticsStatus":"TRANSPORT", "desc":"离开【杭州电商仓配揽投部】,下一站【杭州萧山区东片集散中心】", "areaCode":"CN330100000000", "areaName":"浙江省,杭州市" }, ... ] }
2、返回接收结果
接入商需要根据接受成功、接受失败样例,返回接收处理结果返回给聚美智数
如果是接收失败,聚美智数会再次推送,最多推送3次
//接收成功
{ "success":true }
// 接收失败
{ "success":false, "msg": "接收失败" }
3、接收示例(java)
@PostMapping("callbackUrl") public Map<String,Object> receive(@RequestBody String data, HttpServletRequest request) { log.info("接收到快递物流推送数据: {}", data); Map<String,Object> map = new HashMap<>(); // 1、处理自己的业务逻辑 // 2、根据处理结果返回接收结果 if (处理成功) { map.put("success",true); } else { map.put("success",false); map.put("msg","接收失败, xxx"); } return map; }
4、快递公司编码对照表
请点击最下方 【使用指南】中见快递公司编码对照表
5、物流状态对照表
请点击最下方【使用指南】中见物流状态对照表