[PaaS のみ]{class="badge informative" title="Adobe Commerce on Cloud プロジェクト(Adobeが管理する PaaS インフラストラクチャ)およびオンプレミスプロジェクトにのみ適用されます。"}

AC-15210:Web ツール API から新しい RESTful USPS API への USPS 統合の移行

AC-15210 パッチは、Adobe Commerceの既存の United States Postal Service (USPS) Web Tools API 統合を、新しく導入された USPS REST API に移行します。 このパッチは、Quality Patches Tool (QPT) 1.1.70 がインストールされている場合に使用できます。 パッチ ID は AC-15210 です。

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

Adobe Commerce バージョン用のパッチが作成されます。

  • Adobe CommerceとMagento Open Source(すべてのデプロイメント方法) 2.4.6-p3 - 2.4.8
NOTE
このパッチは、新しい Quality Patches Tool リリースを含む他のバージョンにも適用される可能性があります。 パッチがAdobe Commerceのバージョンと互換性があるかどうかを確認するには、magento/quality-patches パッケージを最新バージョンに更新し、Quality Patches Tool: Search for patches page で互換性を確認します。 パッチ ID を検索キーワードとして使用して、パッチを見つけます。

問題

Adobe Commerceは現在、USPS の配送機能と統合するために Web Tools API を使用しています。

USPS は 2026 年 1 月 25 日(PT)に、従来の Web Tools API を廃止します。 これらの API は現在、住所ハイジーン、パッケージトラッキング、配達確認、受け取りスケジュール、税関フォーム、料金チェック、サービス標準、郵便施設情報、パーセルロッカーの場所などのサービスをサポートしています。

Adobe Commerce バージョン 2.4.6、2.4.7、2.4.8 では、USPS Web Tools API を使用して、すぐに使える統合機能を提供しています。 廃止日以降、これらの統合は、新しい USPS REST API に移行されない限り、機能しなくなります。

解決策

2026 年 1 月以降も USPS 統合を引き続き使用するには、バージョン 2.4.6、2.4.7、2.4.8 のAdobe Commerceのお客様が AC-15210 パッチをインストールする必要があります。

パッチの適用

個々のパッチを適用するには、デプロイメント方法に応じて、次のリンクを使用します。

  • Adobe CommerceまたはMagento Open Source オンプレミス:Quality Patches Tool > 使用状況 ​ Quality Patches Tool ガイドに記載されています。
  • クラウドインフラストラクチャー上のAdobe Commerce:クラウドインフラストラクチャー上のCommerce ガイドの ​ アップグレードとパッチ ​/ パッチの適用」を参照してください。

パッチを適用したら、Commerce USPS 配送業者の設定を更新して、新しい USPS API と統合します。 手順については、​ ストアと購入エクスペリエンスガイド ​ にある USPS Web ツールの廃止 に関するトピックを参照してください。

関連資料

Quality Patches Tool について詳しくは、以下を参照してください。

recommendation-more-help
c2d96e17-5179-455c-ad3a-e1697bb4e8c3