文件CommerceCommerce KB

UPS送貨方法整合從SOAP移轉至RESTful API

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • 開發人員
NOTE
如果您在​ 2024年6月6日前上傳本文的三張修補程式：如果您因為未使用Metric System/SI測量（公斤和公分）而遇到此問題，應再次為您的2.4.4+/2.4.5+/2.4.6+版Adobe Commerce/Magento Open Source重新套用本文現在發佈的這些新更新修補程式之一，因為否則您將無法在​ Admin configuration ​的UPS送貨方法中選取​ 公斤 ​和​ 公分 ​的Metric System/SI測量。 這些新修補程式與先前發行的修補程式相容。 此問題將在預計於​ 2024年6月11日 ​發行的Adobe Commerce 2.4.7-p1版本的範圍內永久修正。
NOTE
如果您在​ 2023年10月10日 ​之前上傳本文中的三個修補程式，您應該再次為您的2.4.4+/2.4.5+/2.4.6+版本的Adobe Commerce/Magento Open Source重新套用本文現在發佈的這些修補程式之一，因為否則，您將無法在​ Admin configuration ​中選取和設定特定的UPS送貨方法，且您必須啟用所有方法。 這些新修補程式與先前發行的修補程式相容。

本文提供修補程式，以解決Adobe Commerce 2.4.4 - 2.4.6-pX的United Parcel Service (UPS)送貨方法整合從SOAP移轉至RESTful API的問題。

根據UPS API安全性模型的最新更新，UPS已針對所有APIs實作OAuth 2.0安全性模型（UPS 開發人員入口網站存取金鑰移轉指南中提供的更多詳細資料），以提升整體安全性，減少欺詐並提供增強的API功能。

此變更會影響我們目前在Adobe Commerce中的UPS送貨方法整合實作，並要求我們修正目前的實作，並從SOAP API移轉至RESTful API以便能夠支援OAuth 2.0驗證通訊協定。

自2024年6月起，Adobe Commerce商家將無法使用我們目前的UPS整合進行交易，因此我們將發佈此Hotfix，允許Adobe Commerce 2.4.4+/2.4.5+/2.4.6+商家移轉至最新的UPS REST APIs。

此問題將在Adobe Commerce/Magento Open Source版本2.4.7中修正，該修正也將包含在2023年10月發行的2.4.7 Beta2中。

受影響的產品和版本

雲端基礎結構和On-Premise及Magento Open Source上的Adobe Commerce：

  • 2.4.4
  • 2.4.4畫素
  • 2.4.5
  • 2.4.5畫素
  • 2.4.6
  • 2.4.6畫素

原因

UPS已發行其 API🔗的安全性更新。

如果您有歐盟（其他來源可能會遇到相同的問題）作為出貨來源，這會導致UPS REST請求中的錯誤：
出貨不能以KGS/IN、LBS/CM或OZS/CM作為測量單位。

解決方案

根據您的Adobe Commerce/Magento Open Source版本，使用以下附加修補程式：

若要解決2.4.4+、2.4.5+和2.4.6+版本中的問題，您必須將對應的修補程式套用至下列Adobe Commerce/Magento Open Source版本。

修補

根據您的Adobe Commerce/Magento Open Source版本，使用以下附加修補程式：

若為版本2.4.4、2.4.4-pX：

若為版本2.4.5、2.4.5-pX：

若為版本2.4.6、2.4.6-pX：

如何套用修補程式

解壓縮檔案，並參閱我們的支援知識庫中的如何套用Adobe提供的撰寫器修補程式，以取得指示。

如何判斷是否已套用修補程式

考慮到無法輕鬆檢查問題是否已修補，您可能想要檢查是否已成功套用修補程式。 這會使用（範例： AC-9363）作為要檢查的修補程式。

您可以執行下列步驟：

  1. 安裝 Quality Patches Tool。

  2. 執行命令：

    code language-bash 
    vendor/bin/magento-patches -n status |grep "9363|Status"

  3. 您應該會看到類似以下的輸出，其中AC-9363傳回​ 已套用 ​狀態：

    code language-bash 
    ║ Id            │ Title                                                        │ Category        │ Origin                 │ Status      │ Details                                          ║ ║ N/A           │ ../m2-hotfixes/AC-9363_USPS_Ground_Advantage_shipping_method_COMPOSER_patch.patch      │ Other           │ Local                  │ Applied     │ Patch type: Custom
recommendation-more-help
8bd06ef0-b3d5-4137-b74e-d7b00485808a