USPS Ground Advantage shipping method support hotfix for AC-9182

This article provides a patch to resolve the issue AC-9182 for the new USPS Ground Advantage shipping method in Adobe Commerce 2.4.4 - 2.4.6-p2.

On July 9, 2023, The United States Postal Service (USPS) released a new shipping method, USPS Ground Advantage.

This new shipping method is replacing their three main current shipping methods:

  • USPS Retail Ground
  • USPS First-Class Package Service
  • USPS Parcel Select Ground

USPS announced that starting from September 30, 2023, these three shipping methods will be discontinued and all customers must use the new USPS Ground Advantage method instead.

So after September 30, 2023, all the Adobe Commerce merchants who are using the USPS shipping method will not be able to get shipping rates from USPS by using these three legacy shipping methods anymore.

This issue will be fixed in the scope of upcoming security-only patch releases in October 2023, in versions 2.4.6-p3, 2.4.5-p5, and 2.4.4-p6.

Affected products and versions

Adobe Commerce on cloud infrastructure and on-premises, and 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


The USPS made an API update.


To resolve the issue in the 2.4.4, 2.4.5, and 2.4.6 versions, you must apply the AC-9182 patch below.


The patch is attached to this article. To download it, click the following link:

How to apply the patch

Unzip the file and see How to apply a composer patch provided by Adobe in our support knowledge base for instructions.

How to tell whether the patches have been applied

Considering that it is not possible to easily check if the issue was patched, you might want to check whether the AC-9182 patch has been successfully applied.

You can do this by taking the following steps:

  1. Install the Quality Patches Tool.

  2. Run the command:

    code language-bash
    vendor/bin/magento-patches -n status |grep "9182|Status"
  3. You should see output similar to this, where AC-9182 returns the  Applied  status:

    code language-bash
    ║ 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