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
Cause
The USPS made an API update.
Solution
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.
Patch
The patch is attached to this article. To download it, click the following link:
AC-9182_USPS_Ground_Advantage_shipping_method_COMPOSER_patch.zip
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:
-
Run the command:
code language-bash vendor/bin/magento-patches -n status |grep "9182|Status"
-
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