文件

USPS Ground Advantage送貨方法支援AC-9182的Hotfix

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修補程式。

修補

此修補程式已附加至本文。 若要下載，請按一下以下連結：

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傳回「已套用」狀態：

    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