ドキュメントCommerceCommerce KB

SOAP から RESTful API への UPS 送方法の統合の移行

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • 開発者
NOTE
2024 年 6 月 6 日（PT） より前にこの記事から 3 つのパッチをアップロードした場合：Metric System/SIMetric System/SI の測定値（キログラムとセンチメートル）が使用されていないので、この問題が発生した場合は、この記事で公開されている新しいパッチの 1 つをAdobe Commerce/Magento Open Sourceの 2.4.4+/2.4.5+/2.4.6+用に再度適用する必要があります。そうしないと、Admin configuration の UPS 送方法で キログラム と ​ ​センチメートルののの測定値を選択できなくなります。 これらの新しいパッチは、以前にリリースされたパッチと互換性があります。 この問題は、2024 年 6 月 11 日（PT） に予定されている今後のAdobe Commerce バージョン 2.4.7-p1 リリースの範囲で永続的に修正されます。
NOTE
2023 年 10 月 10 日（PT） より前にこの記事から 3 つのパッチをアップロードした場合は、Adobe Commerce/Magento Open Sourceの 2.4.4+/2.4.5+/2.4.6+のバージョンに対して、この記事で公開されているパッチのいずれかを再度適用する必要があります。そうしないと、Admin configuration で特定の UPS 送方法を選択して設定できず、すべてを有効にする必要があるからです。 これらの新しいパッチは、以前にリリースされたパッチと互換性があります。

この記事では、Adobe Commerce 2.4.4 ～ 2.4.6-pX での SOAP から RESTful API への United Parcel Service (UPS) shipping method integration の移行に関する問題を解決するためのパッチを提供します。

UPS API セキュリティモデルの最新の更新に従って、UPS はすべての APIs ーザーに OAuth 2.0 セキュリティモデルを実装し（詳細については、UPS 開発者ポータルアクセスキー移行ガイドを参照）、全体的なセキュリティを強化して詐欺を減らし、API 機能を強化しました。

この変更は、Adobe Commerceにおける現在の UPS shipping method integration の実装に影響を与えます。また、OAuth 2.0 認証プロトコルをサポートするには、現在の実装を修正し、SOAP API から RESTful API に移行する必要があります。

2024 年 6 月以降、Adobe Commerce マーチャントは、現在の UPS 統合と取引できなくなりました。そのため、このホットフィックスをリリースしています。これにより、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 リリースにも含まれる予定です。

影響を受ける製品とバージョン

クラウドインフラストラクチャー上の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

原因

UPS は 彼らのためのセキュリティの更新 API をリリースしました。

発送元として欧州連合（EU）がある場合（他の発送元も同じ問題を経験する可能性があります）、UPS REST のリクエストでエラーが発生します。
「1 つの出荷の単位として、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提供の Composer パッチの適用方法を参照して手順を確認します。

パッチが適用されているかどうかを知る方法

問題にパッチが適用されたかどうかを簡単に確認できないのであれば、そのパッチが正常に適用されたかどうかを確認することをお勧めします。 チェックするパッチとして（例：AC-9363）を使用します。

これは、次の手順で実行できます 。

  1. をインストールします Quality Patches Tool。

  2. 次のコマンドを実行します。

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

  3. AC-9363 が Applied ステータスを返す場合、次のような出力が表示されます。

    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