文档

USPS Ground Advantage配送方式支持AC-9182的修补程序

Last update: Mon Jul 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

本文提供了一个修补程序，用于解决Adobe Commerce 2.4.4 - 2.4.6-p2中新 USPS Ground Advantage 配送方法的AC-9182问题。

2023年7月9日，美国邮政局(USPS)发布了一种新的配送方式USPS Ground Advantage。

这种新的配送方式正在取代目前三种主要的配送方式：

  • USPS零售场
  • USPS一级软件包服务
  • USPS包裹选择接地

USPS宣布从2023年9月30日开始，将停止使用这三种配送方式，所有客户都必须改用新的 USPS Ground Advantage 方法。

因此，在2023年9月30日之后，所有使用USPS配送方法的Adobe Commerce商户将无法再使用这三种传统配送方法从USPS获得运费。

此问题将在即将发布的2023年10月版本2.4.6-p3、2.4.5-p5和2.4.4-p6的仅安全补丁发行范围内修复。

描述 description

环境

云基础架构和内部部署上的Adobe Commerce以及Magento Open Source：

  • 2.4.4
  • 2.4.4-p1
  • 2.4.4 - p2
  • 2.4.4 - p3
  • 2.4.4-p4
  • 2.4.4 - p5
  • 2.4.5
  • 2.4.5-p1
  • 2.4.5 - p2
  • 2.4.5-p3
  • 2.4.5-p4
  • 2.4.6
  • 2.4.6-p1
  • 2.4.6 - p2

原因

USPS进行了API更新。

解决方法 resolution

要解决2.4.4、2.4.5和2.4.6版本中的问题，必须应用下面的AC-9182修补程序。

Patch

该修补程序已附加到本文。 要下载它，请单击以下链接：

AC-9182_USPS_Ground_Advantage_shipping_method_COMPOSER_patch.zip

如何应用修补程序

解压缩文件，并在我们的支持知识库中参阅如何应用Adobe提供的编辑器修补程序获取相关说明。

如何判断是否已应用修补程序

考虑到无法轻松检查问题是否已修补，您可能需要检查AC-9182修补程序是否已成功应用。

您可以通过以下步骤执行此操作：

  1. 安装质量修补程序工具。

  2. 运行以下命令：

    code language-none 
    vendor/bin/magento-patches -n status |grep "9182|Status"

  3. 您应该会看到类似于以下内容的输出，其中AC-9182返回Applied状态：

    code language-none 
    ║ Id            │ Title                                                        │ Category        │ Origin                 │ Status      │ Details                                          ║ ║ N/A           │ ../m2-hotfixes/AC-9182_USPS_Ground_Advantage_shipping_method_COMPOSER_patch.patch      │ Other           │ Local                  │ Applied     │ Patch type: Custom
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f