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

最后更新 2026-11-01

在 USPS Developer Portal 拿到 Consumer Key 和 Consumer Secret，填进 Integration，测试、配服务映射，就能查费率、打单。

USPS 连接器走 USPS API 查费率、买 Label、查轨迹。一对 OAuth 凭证——Consumer Key 和 Consumer Secret——就能覆盖费率与轨迹；买 Label 还另外需要您的 USPS 付款账号标识。

USPS 接入步骤：先拿凭证，再测试，再配服务映射，最后激活。

前置条件#

能进 USPS Developer Portal（developers.usps.com），且 Apps 下已有一个应用——Consumer Key 和 Consumer Secret 就在该应用页面上。
先定环境：先用测试环境（TEM）验证，再切生产。
费率与轨迹只需要这对 OAuth 凭证——不需要填账号字段。
买 Label 前，先备齐 USPS 付款账号标识：CRID、MID、EPS。它们是买面单时要用的，不是建这个连接时填的。

打开 Integration → 连接器市场 → USPS → 新建连接。
Consumer Key（client_id）——必填：粘贴 USPS Developer Portal 应用页面上的 Consumer Key。向导里这个字段的标签就叫「Consumer Key」。
Consumer Secret（client_secret）——必填：粘贴同一应用页面上的 Consumer Secret。加密存储，永不回显。
Use sandbox（sandbox）——可选：填 “true” 走测试环境 TEM（apis-tem.usps.com）；留空走生产（apis.usps.com）。
CRID / MID / EPS——不要在这里找：它们是买 Label 用的付款账号标识，不是这个连接向导的字段。买 Label 前备齐即可。

点测试连接。测试只做一件事：用 Consumer Key 和 Consumer Secret 换一次 OAuth token，确认凭证能用——它不查费率、不买 Label、也不查轨迹。通过说明 Key、Secret 与您选的环境三者匹配；失败时先记下报错，对照下方常见问题排查，不要先改其他设置。

USPS 不需要订单 Mapping——它处理包裹，不处理订单。这里要配的是承运商服务映射：在连接设置里，把您内部用的每个发货服务配到对应的 USPS 服务，只启用您真正会发的服务，这样比价只报您真正提供的服务。

USPS 发货流程：报价、买 Label、追踪——全走 Integration。

激活后，连接即可在发货时用于比价和买 Label，轨迹更新也会回来并落到运单上。打第一张真实 Label 前，先确认付款账号标识（CRID / MID / EPS）已备齐——测试连接不会查它们。先在运行监控 / 日志里盯几票，确认无误再放手跑。

Consumer Key 或 Consumer Secret 错了：两个值填反了，或其中一个复制时少了字符、多了空格，USPS 拒绝换 token。

回 USPS Developer Portal（developers.usps.com）→ Apps → 您的应用，把 Consumer Key 原样复制到 Consumer Key 字段、Consumer Secret 原样复制到 Consumer Secret 字段，再重新测试。

环境与预期对不上：Use sandbox 填了 “true”，调用走的是测试环境 TEM，却当成生产在测——或 Use sandbox 留空走生产，却还按测试在看结果。

让设置与您要测的环境一致，再重新测试：测试环境把 Use sandbox 填 “true”；生产把 Use sandbox 留空。两个环境都要用时，分开建两个连接。

付款侧没备齐时就会这样：测试只查费率与轨迹用的 OAuth 换 token，而买 Label 还另外需要 USPS 付款账号标识——CRID、MID、EPS。

买 Label 前先备齐 CRID、MID、EPS——它们不是连接向导字段，测试通过并不覆盖它们。备齐后再试买一次；仍失败就看运行监控 / 日志里的报错。

轨迹是按 USPS 的节奏回来的，不是实时的；包裹还没交给 USPS 时，也没有轨迹可显示。

先确认包裹确实已交出，再等一段时间复查。24 小时后仍没有，去运行监控 / 日志里查这票的轨迹报错。