运单服务-轨迹查询

基本信息

• 方法：POST
• 路径：/label/carrier/tracking
• Handler：carrierApi.GetTracking
• Service：CarrierOpenAPIService.GetTracking

用途

按承运商和跟踪号查询轨迹明细。

请求参数

字段	类型	必填	说明
carrierCode	string	是	承运商代码
accountAlias	string	否	账号别名
accountId	int	否	预留字段，当前未使用
trackingNumber	string	是	跟踪号

请求示例

{
  "carrierCode": "FEDEX",
  "accountAlias": "FEDEX_MAIN",
  "accountId": 0,
  "trackingNumber": "1Z999AA10123456784"
}

成功响应示例

{
  "code": 200,
  "data": {
    "trackingNumber": "1Z999AA10123456784",
    "carrierCode": "FEDEX",
    "details": [
      {
        "timeStamp": "2026-06-11 10:00:00",
        "status": "DELIVERED",
        "statusInfo": "Delivered",
        "description": "Package delivered",
        "city": "Memphis",
        "state": "TN",
        "country": "US",
        "postalCode": "38116"
      }
    ]
  },
  "message": "success"
}

返回字段说明

字段	类型	说明
data.trackingNumber	string	跟踪号
data.carrierCode	string	承运商代码
data.details	array	轨迹明细列表
data.details[].timeStamp	string	轨迹时间
data.details[].status	string	轨迹状态
data.details[].statusInfo	string	状态说明
data.details[].description	string	轨迹描述
data.details[].city	string	城市
data.details[].state	string	州/省
data.details[].country	string	国家
data.details[].postalCode	string	邮编

接口说明

当前实现只支持以下承运商：

• UPARCEL
• FEDEX

错误响应示例

如果传入其他承运商代码，会返回类似错误：

{
  "code": 400,
  "data": null,
  "message": "carrier UPS does not support tracking"
}