UPS 移动端数据 API：跟踪、运费与索赔

UPS 是联合包裹服务公司（United Parcel Service，总部位于亚特兰大的包裹承运商）的官方 Android 应用，把其美国网络的包裹跟踪、寄件与索赔集中到一个 UPS ID 账户里。首页及桌面小组件把包裹分为“跟踪中”和“已签收”两个页签，显示每件包裹的里程碑、派送时间窗与收件地址；未登录的游客也能直接输入单个 1Z 跟踪号查询。跟踪详情页列出服务等级（如 UPS Ground）、声明价值、放置位置，以及从揽收扫描开始的逐条扫描活动时间线。在寄件流程中，用户填写起运地、目的地、重量与尺寸，按价格和运输时效比较各项服务；资料绑定 UPS 发货账号时还能看到协议运价，随后直接创建面单。应用还提供 UPS My Choice 派送偏好管理、可为保存的跟踪号设置别名的跟踪历史，以及先校验资格再提交损坏或丢失索赔的索赔流程。它面向追踪网购到货的美国消费者，以及寄出包裹的小企业和收发部门，与 FedEx、USPS Informed Delivery、DHL Express 以及 AfterShip 这类多承运商跟踪工具竞争。

1Z 跟踪号是整套包裹记录的主键：首页的在途与已签收列表携带 trackingNumber、milestoneCode、currentStatusDescription、shipToAddress 和 lastActivityDateTime；单件包裹详情再补上 serviceLevelDescription、packageWeight、declaredValueAmount、deliveryDetailDate、leaveAtLocation、发件与收件的城市和邮编，以及由 activityCode 与 gmtDate 标记的 activity 扫描时间线。

运费报价按服务为一条起运地—目的地线路定价：每条 ratedShipment 以 currencyCode 加 monetaryValue 返回 transportationCharges、baseServiceCharge 和 totalCharges，并附带该账户 shipperNumber 的 negotiatedRateCharges 与 guaranteedDelivery 运输天数。索赔数据分两步：先是含 isEligible、maximumPaymentAmount 与 accountNumber 的资格记录，再是以 claimNumber、claimId、registrationID 和 status 标识的损坏或丢失索赔；保存的跟踪历史则把 inquiryNumber 与 inquiryNickname、lastTrackedTimeStamp、statusCode 配成一行。

收货台轮询这些里程碑标记延误包裹，把 deliveryDetailDate 与采购订单交期比对，并在包裹符合条件时发起索赔；结账服务把报价的 totalCharges 和协议运价存到每笔订单上，用于到岸成本计价；仓储系统为标记受损的纸箱提交损坏索赔，并把 claimNumber 回填到 ASN；共享收发室把别名映射到跟踪号，隐藏前台已处理的包裹。openData Studio 把这套 UPS 包裹记录变成可调用的开放数据。

应用截图

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构，为示意说明，并非实际抓包。

列出首页运单

GET /v1/shipments/home opendata

返回登录首页的 trackTab 与 deliveredTab 列表（trackingNumber、里程碑、状态、收件地址、派送窗口），供 UPS 首页与小组件使用。

认证方式：应用账户令牌服务签发的 Bearer 访问令牌（Authorization: Bearer）。游客按单号查询无需 UPS 账号仍可用。

trackTab
deliveredTab
trackingNumber
milestoneCode
milestoneDescription
currentStatusCode
currentStatusDescription
shipToAddress
addressLine
city
stateProvinceCode
postalCode
countryCode
lastActivityDateTime
displayDateValue
deliveryLocation
shipFromName
nickName
consolidatedDcoEligibility

GET /v1/shipments/home HTTP/1.1
Authorization: Bearer <accessToken>
Accept: application/json

{
  "response": {"statusCode": "1"},
  "trackTab": [{
    "trackingNumber": "1Z999AA10123456784",
    "milestoneCode": "I",
    "milestoneDescription": "In Transit",
    "currentStatusCode": "I",
    "currentStatusDescription": "On the way",
    "shipToAddress": {
      "name": "Alex Rivera",
      "attentionName": "Receiving",
      "type": "DESTINATION",
      "address": {
        "addressLine": ["55 Glenlake Pkwy NE"],
        "city": "Atlanta",
        "stateProvinceCode": "GA",
        "postalCode": "30328",
        "countryCode": "US"
      }
    },
    "lastActivityDateTime": "2026-09-25T14:22:00Z",
    "displayDateValue": "Thu, Sep 26",
    "displayTimeValue": "By 8:00 PM",
    "deliveryDateType": "SCHEDULED",
    "deliveryLocation": "Front door",
    "shipFromName": "Acme Warehouse",
    "nickName": "Office monitors",
    "type": "1Z",
    "isHidden": false,
    "consolidatedDcoEligibility": true,
    "securityCodeEligible": false
  }],
  "deliveredTab": []
}

查询跟踪详情

GET /v1/shipments/{trackingNumber} opendata

水合跟踪详情界面：当前状态、服务等级、声明价值、发件 / 收件地址分段，以及扫描活动时间线。

认证方式：应用账户令牌服务签发的 Bearer 访问令牌。公开的跟踪号查询是允许的；派送变更与索赔字段需要登录的 UPS ID。

trackingNumber
currentStatusCode
currentStatusDescription
serviceLevelCode
serviceLevelDescription
packageWeight
declaredValueAmount
declaredValueCurrencyCode
deliveryDetailDate
deliveryDetailTime
signedForByName
leaveAtLocation
shipFromCity
shipFromPostalCode
shipToCity
shipToPostalCode
activity
activityCode
description
gmtDate

GET /v1/shipments/1Z999AA10123456784 HTTP/1.1
Authorization: Bearer <accessToken>
Accept: application/json

{
  "trackingNumber": "1Z999AA10123456784",
  "currentStatusCode": "I",
  "currentStatusDescription": "On the way",
  "serviceLevelCode": "03",
  "serviceLevelDescription": "UPS Ground",
  "brandedServiceLevelCode": "GND",
  "brandedServiceLevelDescription": "Ground",
  "packageWeight": "12.4",
  "packageWeightUnits": "LBS",
  "declaredValueAmount": "250.00",
  "declaredValueCurrencyCode": "USD",
  "deliveryDetailDate": "20260926",
  "deliveryDetailTime": "200000",
  "deliveryDetailTypeCode": "DEL",
  "signedForByName": "",
  "leaveAtLocation": "Front Door",
  "shipFromCity": "Louisville",
  "shipFromStateProvinceCode": "KY",
  "shipFromPostalCode": "40213",
  "shipFromCountryCode": "US",
  "shipFromCompanyName": "Acme Warehouse",
  "shipToCity": "Atlanta",
  "shipToStateProvinceCode": "GA",
  "shipToPostalCode": "30328",
  "shipToCountryCode": "US",
  "activity": [{
    "activityCode": "OR",
    "description": "Origin Scan",
    "city": "Louisville",
    "stateProvinceCode": "KY",
    "postalCode": "40213",
    "countryCode": "US",
    "displayDate": "09/24/2026",
    "displayTime": "6:14 PM",
    "gmtDate": "20260924",
    "gmtTime": "221400"
  }]
}

查询运费报价

POST /v1/rates/quotes openfinance

返回 ratedShipment 报价（transportationCharges、totalCharges、negotiatedRateCharges、运输时效），供发货服务选择器使用。

认证方式：应用账户令牌服务签发的 Bearer 访问令牌。当资料带有 shipperNumber 时返回 NegotiatedRateCharges。

rateRequest
shipment
shipFrom
shipTo
shipmentPackage
pickUpDate
shipperNumber
ratedShipment
code
description
billingWeight
transportationCharges
baseServiceCharge
totalCharges
currencyCode
monetaryValue
negotiatedRateCharges
guaranteedDelivery

POST /v1/rates/quotes HTTP/1.1
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "rateRequest": {
    "shipment": {
      "shipFrom": {"city": "Atlanta", "stateProvinceCode": "GA", "postalCode": "30328", "countryCode": "US"},
      "shipTo": {"city": "New York", "stateProvinceCode": "NY", "postalCode": "10001", "countryCode": "US"},
      "shipmentPackage": {
        "packagingType": {"code": "02"},
        "packageWeight": {"unitOfMeasurement": {"code": "LBS"}, "weight": "5.0"},
        "dimensions": {"unitOfMeasurement": {"code": "IN"}, "length": "12", "width": "8", "height": "4"}
      },
      "pickUpDate": "20260926",
      "shipperNumber": "A1B2C3",
      "promoAliasCode": "",
      "estimatedQuote": true,
      "service": {"code": "03"}
    }
  }
}

{
  "ratedShipment": [{
    "service": {"code": "03", "description": "UPS Ground"},
    "billingWeight": {"unitOfMeasurement": {"code": "LBS"}, "weight": "5.0"},
    "transportationCharges": {"currencyCode": "USD", "monetaryValue": "14.82"},
    "baseServiceCharge": {"currencyCode": "USD", "monetaryValue": "12.40"},
    "serviceOptionsCharges": {"currencyCode": "USD", "monetaryValue": "0.00"},
    "totalCharges": {"currencyCode": "USD", "monetaryValue": "14.82"},
    "negotiatedRateCharges": {"totalCharge": {"currencyCode": "USD", "monetaryValue": "11.10"}},
    "guaranteedDelivery": {"businessDaysInTransit": "2"},
    "timeInTransit": {"serviceSummary": {"estimatedArrival": {"date": "20260929", "time": "230000"}}},
    "upSellTag": ""
  }],
  "alert": [],
  "response": null
}

校验索赔资格

GET /v1/claims/{trackingNumber}/eligibility openfinance

为创建索赔流程把关：包裹是否可申报、发货方 accountNumber、maximumPaymentAmount 与币种。

认证方式：应用账户令牌服务签发的 Bearer 访问令牌。需要寄出或收到该包裹的 UPS 账号。

isEligible
isUpsStoreAccount
isRedirect
isSppPhotoExists
shipperDefaultCurrency
maximumPaymentAmount
accountNumber
accountCountry
shipmentData
eligibilityMessages

GET /v1/claims/1Z999AA10123456784/eligibility HTTP/1.1
Authorization: Bearer <accessToken>
Accept: application/json

{
  "isEligible": true,
  "isUpsStoreAccount": false,
  "isRedirect": false,
  "isSppPhotoExists": true,
  "shipperDefaultCurrency": "USD",
  "maximumPaymentAmount": 100.0,
  "accountNumber": "A1B2C3",
  "accountCountry": "US",
  "shipmentData": {
    "trackingNumber": "1Z999AA10123456784",
    "serviceLevelDescription": "UPS Ground"
  },
  "eligibilityMessages": []
}

提交包裹索赔

POST /v1/claims/{claim_type} openfinance

创建损坏或丢失索赔，并返回索赔看板使用的 claimNumber、claimId、registrationID 和 status。

认证方式：应用账户令牌服务签发的 Bearer 访问令牌。资格校验通过后，路径中的索赔类型为 damage 或 loss。

trackingNumber
iobb
endUserIP
claimRequesterType
claimType
accountNumber
accountCountry
phoneNumber
claimNumber
claimId
registrationID
status
message
transId

POST /v1/claims/damage HTTP/1.1
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "trackingNumber": "1Z999AA10123456784",
  "iobb": "N",
  "endUserIP": "203.0.113.10",
  "claimRequesterType": "SHIPPER",
  "claimType": "DAMAGE",
  "accountNumber": "A1B2C3",
  "accountCountry": "US",
  "phoneNumber": "4045550100",
  "shipFromAddress": {"city": "Louisville", "stateProvinceCode": "KY", "postalCode": "40213", "countryCode": "US"},
  "shipToAddress": {"city": "Atlanta", "stateProvinceCode": "GA", "postalCode": "30328", "countryCode": "US"}
}

{
  "claimNumber": "CLM-2026-88421",
  "claimId": "c8f1e2a0-4b11-4d22-9c33-11aa22bb33cc",
  "trackingNumber": "1Z999AA10123456784",
  "registrationID": "REG-441902",
  "accountNumber": "A1B2C3",
  "status": "SUBMITTED",
  "message": "Claim accepted",
  "transId": "trx-9f2c"
}

读取保存的跟踪历史

POST /v1/shipments/history opendata

加载已登录用户保存的跟踪列表（inquiryNumber、别名、lastTrackedTimeStamp、status），供跟踪历史与别名保存 / 删除使用。

认证方式：应用账户令牌服务签发的 Bearer 访问令牌。绑定到保存该 inquiryNumber 列表的 UPS ID。

request
userData
updateNicknameOnlyIndicator
trackHistoryData
inquiryNickname
inquiryNumber
lastTrackedTimeStamp
statusCode
statusDescription

POST /v1/shipments/history HTTP/1.1
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "request": {"requestAction": "Retrieve"},
  "userData": {"userId": "ups-uuid-4419"},
  "updateNicknameOnlyIndicator": "N"
}

{
  "trackHistoryData": [{
    "inquiryNickname": "Office monitors",
    "inquiryNumber": "1Z999AA10123456784",
    "lastTrackedTimeStamp": "2026-09-25T14:22:00Z",
    "statusCode": "I",
    "statusDescription": "In Transit"
  }],
  "response": {"statusCode": "1"}
}

数据类别

运单跟踪
派送状态
运费
索赔
保存的跟踪历史
收件地址

数据使用场景与案例

进港异常处理台
收货台轮询运单列表与跟踪详情接口，标记延迟的 milestoneCode，把 deliveryDetailDate 与采购订单交期比对，并在 isEligible 为 true 时发起索赔。
到岸成本报价
结账服务把起运地 / 目的地与 packageWeight 提交给运费报价接口，并把 totalCharges.monetaryValue 连同该 shipperNumber 的 negotiatedRateCharges 存到订单上。
从 WMS 接入索赔
当仓库标记纸箱受损时，先运行资格校验，再用 trackingNumber、claimType DAMAGE 与 accountNumber 提交损坏索赔，并把 claimNumber 回填到 ASN。
共享收发室的别名同步
收发室应用读取保存的跟踪历史，把 inquiryNickname 映射到 inquiryNumber，并用 lastTrackedTimeStamp 与 statusCode 隐藏前台已处理的包裹。

常见问题

哪个 UPS 调用列出首页的包裹？

GET /v1/shipments/home 返回 trackTab 与 deliveredTab 数组。每项携带 trackingNumber、milestoneCode、currentStatusDescription、shipToAddress、lastActivityDateTime 和 nickName。

UPS 应用如何给运单报价？

POST /v1/rates/quotes，携带起运地 / 目的地、包裹重量与尺寸、取件日期和 shipperNumber。ratedShipment 列表返回 transportationCharges、totalCharges 与 negotiatedRateCharges，均以 currencyCode 加 monetaryValue 表示。

可以在同一 API 面上提交 UPS 索赔吗？

可以。GET /v1/claims/{trackingNumber}/eligibility 返回 isEligible 与 maximumPaymentAmount。随后 POST /v1/claims/{claim_type} 返回 claimNumber、claimId 和 status。

保存的跟踪号存在哪里？

POST /v1/shipments/history 返回已登录 UPS ID 的 trackHistoryData 行，含 inquiryNumber、inquiryNickname、lastTrackedTimeStamp、statusCode 和 statusDescription。

与 UPS 相似的应用

FedEx — FedEx 是包裹递送公司，其 FedEx Express 业务提供隔夜快递，常被当作美国市场里 UPS 的替代选择。
USPS Informed Delivery — 美国邮政 Informed Delivery 可预览即将送达的平信，并在同一处跟踪管理进出港包裹，也提供手机应用。
DHL Express — DHL 提供快递、包裹递送和特快邮件服务，DHL Express 是其国际快递业务，常用于跨境包裹。
AfterShip — AfterShip 是货运跟踪服务，把多家邮政和民营快递的运单信息汇总到同一界面。

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

每个项目均签 NDA 与 SOW
3–7 天交付
验收通过后才付款
仅在授权范围内作业

获取报价

UPS 移动端数据 API：跟踪、运费与索赔

应用截图

API 端点一览

列出首页运单

查询跟踪详情

查询运费报价

校验索赔资格

提交包裹索赔

读取保存的跟踪历史

数据类别

数据使用场景与案例

进港异常处理台

到岸成本报价

从 WMS 接入索赔

共享收发室的别名同步

常见问题

与 UPS 相似的应用

更多出行类应用

99 Motorista e Entregador

Borzo: Courier Delivery App

Careem Captain

Delhivery: Courier App

相关主题

需要集成这个 App 的数据 API？

UPS 移动端数据 API：跟踪、运费与索赔

应用截图

API 端点一览

列出首页运单

查询跟踪详情

查询运费报价

校验索赔资格

提交包裹索赔

读取保存的跟踪历史

数据类别

数据使用场景与案例

进港异常处理台

到岸成本报价

从 WMS 接入索赔

共享收发室的别名同步

常见问题

相关应用

与 UPS 相似的应用

更多出行类应用

99 Motorista e Entregador

Borzo: Courier Delivery App

Careem Captain

Delhivery: Courier App

相关主题

需要集成这个 App 的数据 API？