接 UPS：实时费率、打 Label、查轨迹

在 UPS Developer Kit 建应用，把 OAuth Client ID / Secret 加 6 位 Shipper Number 填进 Integration，测试通过就能查费率、打单。

UPS 连接器走 UPS API 查实时费率、买 Label、查轨迹。您需要一个带 6 位 Shipper Number 的 UPS 账号——费率按这个账号报价。

前置条件#

• 一个带 6 位 Shipper Number 的 UPS 账号。
• 能进 UPS Developer Kit 建应用（developer.ups.com）。
• 测试和生产用两套凭证——先用测试模式。

拿凭证#

1. 在 UPS Developer Kit 建一个应用，记下 OAuth Client ID 和 Client Secret。
2. 在 UPS 账号里找到 6 位 Shipper Number（就是发票上的账号）。
3. 测试模式用 UPS 给的沙箱凭证；生产模式用生产应用的凭证。

填进 Integration#

1. 打开 Integration → 连接器市场 → UPS → 新建连接。
2. Client ID / Client Secret：粘贴 OAuth 应用凭证。加密存储，永不回显。
3. Shipper Number：您的 6 位 UPS 账号。
4. 环境：先测试，费率测试通过后再切生产。

测试连接#

测试会对一个示例包裹（如 1 磅、ZIP 到 ZIP）做一次真实费率报价。能拿到报价，说明认证、账号、费率三层都通了。报价失败时，报错会告诉您是哪一层断的——见常见问题。

配 Mapping / 选模板#

UPS 不需要订单 Mapping——它处理包裹，不处理订单。在连接设置里勾选您提供的服务（Ground、2nd Day Air、Next Day Air 等），这样比价只报您真正发的服务。

激活#

激活后，连接即可在发货时用于比价和买 Label。轨迹更新会自动回来（Webhook / 轮询），落到运单上。

常见问题#

认证失败（401）

Client ID / Secret 错了，或者把测试凭证填进了生产连接（反之亦然）。

先检查环境开关，再按对应环境重新复制凭证。

费率失败但认证通

Shipper Number 错了，或账号没开通该服务。

用 UPS 发票核对 Shipper Number。

买了 Label 但轨迹一直不更新

轨迹是按 UPS 的节奏回来的，不是实时的。

24 小时还没到，去 运行监控 / 日志里查 Webhook 报错。