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

UPS 应用（版本 10.34.1.8）使用 Bearer 访问令牌登录，随后以 JSON 提供跟踪、运费与索赔服务。首页列表从 /v1/shipments/home 加载；包裹页调用 /v1/shipments/{trackingNumber} 获取扫描活动、声明价值与收件字段。

发货流程提交 /v1/rates/quotes 并读取 ratedShipment.totalCharges。索赔从 /v1/claims/{trackingNumber}/eligibility（isEligible、maximumPaymentAmount）开始，通过 /v1/claims/{claim_type} 提交。保存的跟踪别名从 /v1/shipments/history 加载。

UPS（包名 com.ups.mobile.android，版本 10.34.1.8）是联合包裹的安卓客户端，覆盖进出包裹跟踪、运费报价、面单创建、UPS My Choice 登记与索赔。登录调用使用应用账户令牌服务签发的 Bearer 令牌。首页从运单列表接口水合，行内携带 trackingNumber、milestoneCode 与 shipToAddress；包裹页加载含扫描活动与 declaredValueAmount 的跟踪详情；发货流程读取 ratedShipment.totalCharges（资料含 shipperNumber 时带 negotiatedRateCharges）；索赔先过资格校验再返回 claimNumber，历史接口返回 inquiryNumber 别名。

应用截图

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。

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

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

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

获取报价

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

应用截图

API 端点一览

列出首页运单

查询跟踪详情

查询运费报价

校验索赔资格

提交包裹索赔

读取保存的跟踪历史

数据类别

数据使用场景与案例

进港异常处理台

到岸成本报价

从 WMS 接入索赔

共享收发室的别名同步

常见问题

更多出行类应用

Careem Captain

Porter - Logistics Service App

Porter Driver Partner App

Почта России

相关主题

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

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

应用截图

API 端点一览

列出首页运单

查询跟踪详情

查询运费报价

校验索赔资格

提交包裹索赔

读取保存的跟踪历史

数据类别

数据使用场景与案例

进港异常处理台

到岸成本报价

从 WMS 接入索赔

共享收发室的别名同步

常见问题

相关应用

更多出行类应用

Careem Captain

Porter - Logistics Service App

Porter Driver Partner App

Почта России

相关主题

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