ExpressTrackingData

{
  "meta": {
    "code": 200,
    "type": "Success",
    "message": "Success"
  },
  "data": {
    "id": "10f579847c3f3489f47eee089e271d03",
    // 当前物流状态
    "status": "delivered",
    // 商品名称，已废弃
    "title": "",
    // 商品评论，已废弃
    "comment": null,
    // 指定该单号是否被归档。如果参数为字符串“true”，该单号将处于“归档”状态；如果参数为“false”，该单号处于“未归档”状态
    "archived": false,
    // 该货物的重量（多个包裹会被打包成一个“货物”）
    "weight": null,
    // 当前物流状态的子状态（物流状态）
    "substatus": "delivered001",
    // 所有节点的物流信息，结合了origin_info 和 destination_info 中的trackinfo 信息
    "allNodes": [{
          // 物流状态的子状态（物流状态）
          "substatus": "delivered001",
          // 根据具体物流情况所识别出来的物流状态描述
          "StatusDescription": "Delivered",
          // 本条物流信息的更新时间，由物流商提供（包裹被扫描时，物流信息会被更新）
          "Date": "2023-05-22 11:51:15",
          // 具体的物流情况
          "Details": "LYSTRUP,8520,DK",
          // 根据具体物流情况所识别出来的物流状态
          "checkpoint_status": "delivered"
      },
      ...
    ],
    // 查询单号
    "tracking_number": "1Z77T10T0497662781",
    // 物流商对应的唯一简码
    "carrier_code": "ups",
    // 自动更新查询功能的状态，“true”代表系统会自动更新查询结果，“false”则反之
    "track_update": false,
    // 创建查询的时间
    "created_at": "2023-05-24 09:10:35",
    // 系统最后更新查询的时间
    "updated_at": "2023-05-24 09:10:38",
    // 包裹发货时间
    "order_create_time": null,
    // 客户邮箱，废弃
    "customer_email": "",
    // 顾客接收短信的手机号码，废弃
    "customer_phone": null,
    // 订单id，废弃
    "order_id": null,
    // 用户名称，废弃
    "customer_name": null,
    // 发件国的名称
    "original_country": "China",
    // 目的国的名称
    "destination_country": "Denmark",
    "itemTimeLength": 5,
    "stayTimeLength": 3,
    // 发件国的物流信息
    "origin_info": {
      // 物流商的官网的链接
      "weblink": "http://www.ups.com/",
      // 物流商官网上的电话
      "phone": "1 800 742 5877",
      // 详细物流信息，数组
      "trackinfo": [{
          // 物流状态的子状态（物流状态）
          "substatus": "delivered001",
          // 根据具体物流情况所识别出来的物流状态描述
          "StatusDescription": "Delivered",
          // 本条物流信息的更新时间，由物流商提供（包裹被扫描时，物流信息会被更新）
          "Date": "2023-05-22 11:51:15",
          // 具体的物流情况
          "Details": "LYSTRUP,8520,DK",
          // 根据具体物流情况所识别出来的物流状态
          "checkpoint_status": "delivered"
        },
        ...
      ],
      // 包裹的另一个快递单号，仅由一些快递员提供（很少见，可以忽略它）
      "ReferenceNumber": null,
      // 包裹接收时间
      "ItemReceived": "2023-05-17 17:25:27",
      // 包裹离开此出发机场的时间
      "DepartfromAirport": null,
      // 包裹达到目的国的时间
      "ArrivalfromAbroad": null,
      // 包裹移交给海关的时间
      "CustomsClearance": "2023-05-22 06:53:33",
      // 包裹达到目的国、目的城市的时间
      "DestinationArrived": null,
      // 物流商对应的唯一简码
      "carrier_code": "ups"
    },
    // 快递服务类型，比如次日达（部分物流商返回）
    "service_code": "UPS Worldwide Express Saver",
    // 最新的一条物流信息
    "status_info": null,
    "packageStatus": null,
    "lastEvent": "Delivered,LYSTRUP,8520,DK,2023-05-22 11:51:15",
    // 目的国物流信息，数据结构同origin_info
    "destination_info": null,
    // 最新物流信息的更新时间
    "lastUpdateTime": "2023-05-22 11:51:15"
  }
}

物流状态

状态	描述
pending	查询中：新增包裹正在查询中，请等待
notfound	查询不到：包裹信息目前查询不到
transit	运输途中：物流商已揽件，包裹正被发往目的地
pickup	到达待取：包裹正在派送中，或到达当地收发点
delivered	成功签收：包裹已被成功投递
expired	运输过久：包裹在很长时间内都未投递成功。快递包裹超过30天、邮政包裹超过60天未投递成功，该查询会被识别为此状态
undelivered	投递失败：快递员投递失败（通常会留有通知并再次尝试投递）
exception	可能异常：包裹退回、包裹丢失、清关失败等异常情况
InfoReceived	待上网：包裹正在等待被揽件

子状态

查询不到子状态	描述
notfound002	无任何物流信息

运输途中子状态	描述
transit001	包裹正在运输途中
transit002	包裹到达分拣中心
transit003	包裹到达目的网点
transit004	包裹达到目的国家
transit005	包裹清关完成
transit006	包裹已经封装好，即将送出
transit007	包裹已经交给航空公司

到达待取子状态	描述
pickup001	包裹正在派送中或即将派送
pickup002	包裹到达代收点等待自取
pickup003	派送中，物流商已经与收件人联系过至少一次

成功签收子状态	描述
delivered001	包裹投递成功
delivered002	客户自提成功
delivered003	包裹由客户签字签收
delivered004	包裹放至快递柜，或由物业、门卫代收

投递失败子状态	描述
undelivered001	包裹由于地址问题投递失败
undelivered002	派送时无人在家
undelivered003	无法联系到收件人
undelivered004	由于其他原因导致派送失败

可能异常子状态	描述
exception004	包裹无人认领
exception005	其他异常情况
exception006	包裹被海关扣留
exception007	包裹破损、遗失或被丢弃
exception008	订单在揽件前被取消
exception009	收件人拒收包裹
exception010	包裹已退回发件人处
exception011	包裹正在被退回发件人的途中

待上网子状态	描述
notfound001	包裹正在等待被揽件