概要
VibeFox USPS は、PrestaShop に USPS 配送業者を追加します。OAuth 2.0 を使用して現在の USPS API から国内および国際の荷物のリアルタイム送料を取得し、選択したサービスの中で最も安いものを 1 つの USPS の選択肢として購入者に表示します。USPS から送料が返されない場合は、固定料金が適用されます。
米国から USPS で荷物を発送するショップに適しています。USPS が 2026 年 1 月に廃止した従来の Web Tools API は使用しません。本モジュールは送料の計算のみを行います。郵便料金やラベルの購入、集荷の予約、荷物の追跡、郵便局や受け取り場所の選択機能、保険やその他の追加サービスは提供しません。
主な機能
現在の USPS API：OAuth 2.0 による Domestic Prices 3.0 および International Prices 3.0。本番環境と USPS Testing Environment for Mailers。
サービスの選択：USPS Ground Advantage、Priority Mail、Priority Mail Express、First-Class Package International Service、Priority Mail (Express) International、Media Mail、Library Mail。選択したサービスのうち最も安いものが表示され、注文とともに保存されます。
正確な料金：荷物に対する通常の単品料金のみを使用します。Flat Rate、Cubic、Hold for Pickup、Sunday の料金は、安いという理由だけで選ばれることはありません。Retail または Commercial の料金。
通貨の扱い：USPS の料金は米ドル建てです。ショップの他の通貨の場合は、設定した USD 為替レートで換算され、ユーロで表示されることはありません。
正しい荷物：ショップの単位で入力された重量と寸法をポンドとインチに換算します。重量が未設定の商品にはデフォルトの重量を使用し、荷物のサイズは箱のサイズまたは商品の寸法から決定します。
代替料金としての固定料金：重量区分と代替料金を含む国別の料金表です。注文ごとまたは商品ごとに適用でき、API キーがない場合や USPS が応答しない場合に使用されます。
高速なチェックアウト：見積もりは 1 時間キャッシュされます。エラー発生後は 5 分間 USPS への問い合わせを一時停止し、障害がすべてのチェックアウト更新を遅らせないようにします。
PrestaShop 標準の配送業者：Shipping > Carriers の配送ゾーンと顧客グループ、または国のリスト。小計による送料無料、最低小計、重量制限、税ルール、デバッグログ。
要件
PrestaShop 8.0 ～ 9.x、PHP 8.0 以降。USPS Developer Portal のアプリ（Consumer Key と Consumer Secret）と、発送元となる米国の 5 桁の郵便番号。固定料金はキーなしで利用できます。vibefox.net で購入する VibeFox ライセンスキー（1 つのキーにつき 1 ドメイン）。