国际快递物流轨迹订阅-产品介绍

一、产品介绍 :

【国际快递查询自动推送，国际快递查询订阅接口】该接口可自动推送快递信息，按单号收费，主动提交查询请求,实时返回物流信息。覆盖全球快递物流查询接口，包括顺丰、邮政，极兔，申通、圆通、韵达、中通、百世、EMS、天天、德邦等近1000家快递公司。—— 我们只做精品！

二、产品特性：

1，全面性 覆盖全面，支持近两千家快递公司查询；

2，实时性，直连各快递公司，数据实时更新；

三、更多产品：

更多商品请点击链接 https://marketplace.huaweicloud.com/seller/0cc531c0b780f23e0f1ec014dadd08a0 进入聚美智数店铺查看。

四、推送说明：

当物流轨迹发生变动时，聚美智数将物流轨迹数据推送至接入商提供地址为callBackUrl的接口
1、数据结构

{
  "expressCode": "00173", // 物流公司代码
  "number": "1ZA596X70455692862", // 单号
   "sendCountry": "GUANGZHOU, 510410, CN, China", // 发送国
  "sendLogisticsCompany": "00173", // 发件地快递公司
  "purposeCountry": "BRONX, NY, 10462, US, United States", // 目的国
  "purposeLogisticsCompany": "00172", // 目的地快递公司
  "logisticsStatus": "SIGN", // 物流最新状态
  "acceptTime": 1649241360000,  //上网时间
  "signTime": 1649708160000, // 签收时间  
  "theTraceDetails": { // 最新一条事件状态
    "areaAddress": "BRONX, NY, 10462, US, United States", // 事件发生地
    "desc": "BRONX, NY, 10462, US, United States, Delivered", // 事件描述
    "logisticsStatus": "SIGN", //事件状态
    "subLogisticsStatus": "SIGN", // 子事件状态
    "time": 1649708160000 // 事件发生时间
  },
  "sendTraceDetails": [ // 发件国事件状态 
    {
      "areaAddress": "BRONX, NY, 10462, US, United States", // 事件发生地
      "desc": "BRONX, NY, 10462, US, United States, Delivered", // 事件描述
      "logisticsStatus": "SIGN", //事件状态
      "subLogisticsStatus": "SIGN", // 子事件状态
      "time": 1649708160000 //  事件发生时间
    },
    {
      "areaAddress": "MOUNT VERNON, NY, 10550, US, United States",
      "desc": "MOUNT VERNON, NY, 10550, US, United States, On FedEx vehicle for delivery",
      "logisticsStatus": "DELIVERING",
      "subLogisticsStatus": "DELIVERING",
      "time": 1649679240000  
    }
    ...
  ],
  "purposeTraceDetails": [  // 目的国事件状态
   {
      "areaAddress": "MOUNT VERNON, NY, 10550, US, United States",
      "desc": "MOUNT VERNON, NY, 10550, US, United States, At local FedEx facility",
      "logisticsStatus": "TRANSPORT",
      "subLogisticsStatus": "TRANSPORT",
      "time": 1649670060000
    },
    {
      "areaAddress": "JAMAICA, NY, 11430, US, United States",
      "desc": "JAMAICA, NY, 11430, US, United States, At destination sort facility",
      "logisticsStatus": "TRANSPORT",
      "subLogisticsStatus": "TRANSPORT",
      "time": 1649501640000
    },
   ...
  ],
}

2、返回接收结果

接入商需要返回接收处理结果返回给聚美智数
如果是接收失败，聚美智能会再次推送，最多推送3次
//接收成功

{ "success":true }

// 接收失败

{ "success":false, "msg": "接收失败"  }

3、请求格式

  application/json

4、接收示例(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; }

5、快递公司编码对照表

请点击最下方  使用指南 中见快递公司编码对照表

6、物流状态对照表

请点击最下方  使用指南 中见物流状态对照表