承运商 API 迁移：USPS、FedEx 与 UPS

2023 年至 2026 年间，美国三大包裹承运商都改变了软件连接它们的方式。UPS 用 OAuth 2.0 取代了访问密钥，USPS 停用了运行已久的 Web Tools API，FedEx 则为从旧版 Web Services 迁移到 REST API 设定了截止日期。每一项变化单独来看都合情合理；合在一起，则意味着几年前安装的物流插件可能已经停止返回运费或打印面单，却几乎没有预警。本指南总结了发生的变化，并为网上商店梳理了一份承运商 API 迁移清单。

各承运商发生了什么变化

官方来源包括 UPS OAuth 迁移指南、USPS API 开发者门户以及 FedEx 的迁移公告。USPS Web Tools 的停用影响的不止运费和面单：地址验证、物流跟踪和投递时效标准也已迁移到新平台。

物流插件失效的迹象

故障并不总是动静很大。请留意这些情况：

• 结账时只提供统一运费的备用方案，或者对原本可用的地址显示“没有可用的配送方式”。
• 后台创建面单失败，或者某个承运商能打印面单而另一个不能。
• 物流单号不再更新，或者发货邮件发出时没有跟踪链接。
• 错误日志显示认证错误（401 或 403 响应），或连接承运商地址失败。

最安静的一种代价最高：备用运费看起来正常，却远低于承运商实际收取的费用。当物流插件以这种方式失效时，损失会在数周后才出现在承运商的账单上，而不是在结账时。

承运商 API 迁移清单

1. 列出所有与承运商通信的系统：商店的物流扩展、面单软件、ERP 或仓库系统、市场平台工具以及所有自定义脚本。旧的集成往往藏在后两者中。
2. 在企业自己的承运商账户下创建开发者账户和应用，而不是用开发者的个人登录，并记录由谁负责。
3. 把凭据存放在服务器上，放在代码仓库之外，并确保集成自行请求并刷新其访问令牌，而不是依赖一次性粘贴进去的密钥。
4. 更新或更换连接器。当前适用的 FedEx 和 UPS 的物流连接器，可能是您所用插件的新版本、另一个扩展，或是多承运商物流平台。请确认它调用的是新的 API，而不是旧 API 之上的兼容层。
5. 在承运商的沙盒环境中测试，然后把实时报价与您协商的账户费率及几张近期账单进行比较。
6. 检查面单和文件：热敏（ZPL）或 PDF 格式、国际包裹的海关数据、退货面单。
7. 重新测试地址验证，包括商业地址与住宅地址的分类，因为这会改变价格。

我们的物流 API 集成与物流自动化工作涵盖这些步骤，从保护承运商凭据，到在真实包裹发出之前于测试环境中进行测试发货。

保持正常运行：简单的物流 API 监控

承运商的接口还会不断变化，所以要内置早期预警。基本的物流 API 监控每隔一小时左右，为已知地址和包裹请求一次运费，并在请求失败或价格急剧变化时提醒相关人员。再加上对面单请求失败率的提醒、为任何会过期的凭据设置日历提醒，以及订阅每个承运商的开发者公告。这些都不复杂，却能让下一次停用通知变成一项有计划的任务，而不是周一早晨的意外。

直接集成还是物流平台？

把商店直接连接到每个承运商，控制力最强，也没有按面单收费的平台费用，但承运商的每一次变化都要由您承担。ShipStation、Shippo 或 EasyPost 等多承运商平台会吸收这些变化，并增加批量面单和自动化规则，代价是订阅费或按面单收费，以及链条中多出一个系统。只有一个承运商、规则简单的商店，往往用直接连接就很好；通过多个承运商或从多个地点发货的商店，通常能从平台中受益。无论哪种方式，好的物流 API 集成服务留给您的，都应当是有文档记录的凭据、日志和监控，而不只是一个能用的结账流程。

常见问题：承运商 API 迁移

使用新的 API 需要新的承运商账户吗？

不需要。您保留自己的物流账户，并在承运商的开发者门户中创建一个与之关联的应用。集成所使用的就是该应用的凭据。

我们协商的运费还会在结账时显示吗？

只有当运费请求使用您自己的账户发出时才会。使用通用凭据或标价费率的连接器，显示的将是公布价格。

我们错过了截止日期，现在怎么办？

找出哪些系统仍在调用旧接口；如果实时运费失败，把结账切换为安全的固定运费；并优先修复打印面单的连接，因为这决定订单能否发货。然后再迁移其余的部分。

结账时没有运费，或者承运商变更后面单失败？我们的物流 API 集成服务把商店与 FedEx、UPS、USPS 和物流平台连接起来，提供实时运费、批量面单，并把物流跟踪信息写回商店。如果库存和订单还需要对接 ERP，请参阅 ERP 与 PIM 集成。请联系我们，告知您的平台、承运商以及目前使用的插件，我们可以审查需要更改的内容。