文档Commerce工具

[仅限PaaS]{class="badge informative" title="仅适用于云项目(Adobe管理的PaaS基础架构)和内部部署项目上的Adobe Commerce 。"}

AC-15210：将USPS集成从Web Tools API迁移到新的RESTful USPS API

Last update: Thu Oct 09 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • 有经验的
  • 管理员
  • 开发人员

AC-15210修补程序将Adobe Commerce中现有的美国邮政服务(USPS) Web工具API集成过渡到新引入的USPS REST API。 安装Quality Patches Tool (QPT) 1.1.70时，此修补程序可用。 修补程序ID为AC-15210。

受影响的产品和版本

为Adobe Commerce版本创建了修补程序：

  • Adobe Commerce和Magento Open Source（所有部署方法） 2.4.6-p3 - 2.4.8
NOTE
该修补程序可能适用于具有新Quality Patches Tool发行版本的其他版本。 要检查修补程序是否与您的Adobe Commerce版本兼容，请将magento/quality-patches包更新到最新版本，并在Quality Patches Tool：搜索修补程序页面上检查兼容性。 使用修补程序ID作为搜索关键字来查找修补程序。

问题

Adobe Commerce当前使用Web Tools API与USPS送货功能集成。

USPS将于2026年1月25日停用其旧版Web工具API。 这些API当前支持地址卫生、包裹跟踪、交货证明、取货计划、海关表格、费率检查、服务标准、邮政设施信息和包裹储物柜位置等服务。

Adobe Commerce版本2.4.6、2.4.7和2.4.8使用USPS Web Tools API进行开箱即用集成。 在停用日期之后，这些集成将停止工作，除非迁移到新的USPS REST API。

解决方案

要在2026年1月之后继续使用USPS集成，需要安装版本2.4.6、2.4.7和2.4.8的Adobe Commerce客户来安装AC-15210修补程序。

应用修补程序

要应用单独的修补程序，请根据您的部署方法使用以下链接：

相关阅读

要了解有关Quality Patches Tool的更多信息，请参阅：

recommendation-more-help
c2d96e17-5179-455c-ad3a-e1697bb4e8c3