VibeFox USPS for WooCommerce — ヘルプ
要件
WordPress：5.8 以降。
WooCommerce：7.0 以降。インストールされ、有効であること。WooCommerce がないとプラグインは有効化できません。
PHP：8.0 以降。
USPS Developer Portal のアプリ（リアルタイム送料の場合のみ）：無料の USPS ビジネスアカウントで USPS Developer Portal（developers.usps.com）にサインインし、アプリを作成して Consumer Key と Consumer Secret をコピーします。プラグインは OAuth 2.0 を使用する現在の USPS API を利用します。USPS は従来の Web Tools API（User ID と XML）を 2026 年 1 月 25 日に停止したため、Web Tools User ID はもう使用できません。キーがない場合は固定料金のみが使用されます。
Ship-from ZIP code：リアルタイム送料には、荷物を発送する米国の 5 桁の郵便番号が必要です。
VibeFox ライセンスキー：vibefox.net で購入します。1 つのキーは 1 つのドメインでのみ使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin に移動し、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_usps フォルダを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます：WooCommerce > Settings > Shipping > VibeFox USPS。または、プラグインのページでプラグイン名の下にある Settings をクリックします。
4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。
5. Consumer Key と Consumer Secret、5 桁の Ship from ZIP code を入力し、サービスを選択します。ストアの通貨が USD でない場合は、USD exchange rate を入力します。
6. WooCommerce > Settings > Shipping > Shipping zones で VibeFox USPS を配送ゾーンに追加するか、Ignore shipping zones をオンにして国を選択します。
7. 任意：代替として固定料金を入力します。
設定
すべての設定は 1 つのページにあります：WooCommerce > Settings > Shipping > VibeFox USPS。設定はすべての配送ゾーンに適用されます。ゾーンにこの方法を追加すると、ゾーンのウィンドウには 1 つのフィールドだけが表示されます：
Title (zone)：チェックアウトでのこのオプションの名前です。空欄にすると、全体の Name が使用されます。
設定を保存するたびに、キャッシュされた USPS トークンと料金が消去されます。USPS API セクションの Clear cached USPS token and rates をクリックすることもできます。設定の上にある警告は、キーのどちらか一方だけが設定されている場合、キーも固定料金もない場合、Ship from ZIP code がない場合、サービスが選択されていない場合、USD exchange rate がない場合、またはテスト環境が有効な場合に表示されます。
一般
Enable/Disable：すべてのゾーンでこの方法を一度にオンまたはオフにします。
Name：チェックアウトに表示される配送方法の名前です。デフォルト：USPS。
Tax status：USPS の料金には税金が含まれません。Taxable を選ぶと、WooCommerce が送料に配送税を加算します。None を選ぶと加算されません。
USPS API（リアルタイム送料）
Consumer Key：USPS 開発者アプリの Consumer Key（client_id）です。
Consumer Secret：同じアプリの Consumer Secret（client_secret）です。
Test environment：USPS Testing Environment for Mailers を使用します。これにアクセスできるアプリでのみ使用してください。実際の料金を取得するには、オフのままにしてください。デフォルト：オフ。
Prices：使用する USPS の料金です。
Services：提供できる USPS のサービスです。荷物に対して USPS が提供する、選択したサービスのうち最も安いものが表示されます。Flat Rate、Cubic、Hold for Pickup、Sunday の料金は使用されません。デフォルト：USPS Ground Advantage、Priority Mail、First-Class Package International Service。
USD exchange rate：USPS の料金は米ドル建てです。ストアの通貨が USD でない場合は、1 USD のストア通貨での価格を入力します（例：0.92）。入力しないと、リアルタイム送料は使用されず、固定料金が適用されます。ストアの通貨が USD の場合は不要です。
発送元と荷物（USPS の料金は発送元の郵便番号、重量、荷物のサイズによって決まります）
Ship from ZIP code：荷物を発送する米国の 5 桁の郵便番号です。ZIP+4 は 5 桁に切り詰められます。それ以外の値はメッセージとともに拒否されます。
Box size：任意の箱の寸法です。ストアの寸法単位で指定します（例：30x20x15）。空欄にすると、商品の寸法から計算されます。最も長い長さ、最も広い幅、重ねた高さを使用します。商品に寸法がない場合は、10 x 8 x 4 インチの箱が使用されます。
Default product weight (kg)：重量のない商品に使用される重量です。USPS の料金、重量制限、重量区分で使用されます。デフォルト：0.5。
固定料金（料金はストアの通貨で指定します。API キーが入力されていない場合に使用され、USPS が料金を返さない場合（API 停止、キーの誤り、サービスなし、米国の郵便番号がない宛先など）の代替としても使用されます。この場合にメソッドを非表示にするには、両方を空欄にします）
Country prices：配送先の国とカートの重量ごとの料金です。+ Add country をクリックして行を追加し、バツ印をクリックして削除します。列は Price と、重量区分の XS（1 kg まで）、S（1～2 kg）、M（2～3 kg）、L（3～5 kg）、XL（5 kg 超）です。空欄または 0 の区分では Price が使用されます。* Default の行は、それ以外のすべての国に適用されます。数値でない値はメッセージとともに消去されます。
Fallback cost：一致する国別の料金がない場合に使用される固定料金です。空欄にすると、その場合にメソッドが非表示になります。
Fixed price is：Per order は料金を 1 回だけ請求します。Per item (each item priced by its own weight x quantity) は、各商品を自身の重量（重量がない場合はデフォルトの重量）で計算し、その数量を掛けます。USPS のリアルタイム送料は常に荷物全体について見積もられます。
条件
Free shipping from：この方法が無料になるカートの小計です。この場合、USPS へのリクエストは送信されません。空欄にすると、送料無料は提供されません。
Minimum subtotal：カートの小計がこの金額以上の場合にのみ、この方法を表示します。空欄にすると、常に表示されます。
Min weight (kg)：この方法が表示されるために必要なカートの最低重量です。0 は制限なしを意味します。
Max weight (kg)：このカートの重量を超えると、この方法は非表示になります。デフォルト：30。USPS は最大 70 lb（31.7 kg）まで受け付けます。0 は制限なしを意味します。
Excluded shipping classes：カートに、これらの WooCommerce 配送クラスのいずれかの商品が含まれている場合、この方法を非表示にします。
配送ゾーンを使わない場合の利用可能性
Ignore shipping zones：配送ゾーンにこの方法を追加していなくても、下記の国に対して提供します。
Countries：このモードでの配送先の国です。空欄にすると、ストアのすべての配送対象国が使用されます。このフィールドは Ignore shipping zones がオンの場合にのみ使用されます。
詳細設定
Debug log：API リクエストと送料の計算を WooCommerce > Status > Logs に記録します。ソースは vfd-usps です。API エラーは、このオプションがオフでも常に記録されます。キー、トークン、顧客の住所は記録されません。
Remove data on uninstall：オンにすると、プラグインを削除したときに、すべてのプラグイン設定とゾーンの方法が削除されます。無効化しても設定が削除されることはありません。
チェックアウトでの動作
購入者が配送先の住所を入力すると、WooCommerce がプラグインに送料を問い合わせます。プラグインはまず条件を確認します。カートの重量、最低小計、除外する配送クラスです。送料無料が適用される場合は、料金 0 でこの方法が表示され、USPS へのリクエストは送信されません。
プラグインは USPS から OAuth トークンを取得し、有効期限が切れるまで保持します。USPS に拒否されたトークンは更新され、見積もりのリクエストは再試行されます。米国とその領土（プエルトリコ、米領バージン諸島、グアムを含む）宛てには Domestic Prices API を使用し、購入者の 5 桁の郵便番号が必要です。その他の国には、国と郵便番号を指定して International Prices API を使用します。
リクエストには、発送元の郵便番号、カートの重量（ポンド）、荷物のサイズ（インチ）、料金の種類が含まれます。70 lb を超える荷物には固定料金が適用されます。購入者には、選択したサービスのうち最も安いものが 1 つの選択肢として表示され、ストアの通貨に換算されます。
各見積もりは 1 時間キャッシュされます。失敗した見積もりは 10 分間記憶されます。タイムアウト、サーバーエラー、レート制限、またはキーの拒否が発生すると、5 分間は USPS に問い合わせません。HTTP のタイムアウトは 10 秒です。プラグインを無効化すると、キャッシュされたトークンと料金が消去されます。
USPS が料金を返さない場合、料金は Country prices から取得され、次に Fallback cost から取得されます。どちらも該当しない場合、この方法は非表示になります。購入者が USPS のエラーメッセージを目にすることはありません。
この方法は、クラシックチェックアウトと、カートおよびチェックアウトのブロックで動作します。WooCommerce の高性能注文保存（HPOS）に対応しています。
プラグインが行うのは送料の計算のみです。郵便料金や配送ラベルの購入、集荷の予約、荷物の追跡、購入者による郵便局や受け取り場所の選択は行いません。複数の USPS サービスではなく、1 つの選択肢だけを表示します。箱詰めは行わず、カート全体を 1 個の荷物として見積もります。保険やその他の追加サービスは含まれません。
注文
リアルタイム送料の場合、注文の配送項目には USPS service（例：USPS Ground Advantage）が保存されます。ストアマネージャーは、管理画面の注文ページでこれを確認できます。
ライセンスキー
このプラグインは、vibefox.net で購入した VibeFox ライセンスキーで動作します。ライセンスブロックは WooCommerce > Settings > Shipping > VibeFox USPS の上部にあります。キーを License key に貼り付け、Activate をクリックします。ブロックには、ライセンスの有効期限日や、お使いのドメインなどのステータスが表示されます。Check now でステータスを再確認、Change key で別のキーを入力、Remove key でこのサイトからキーを削除できます。Manage licenses and domains in your account のリンクから、vibefox.net のアカウントを開けます。
1 つのキーは 1 つのドメインでのみ使用できます。サイトからキーを削除しても、そのドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、USPS はチェックアウトで購入者に表示されません。ログインしているストアマネージャーには、(unlicensed — visible to admins only) と表示された状態で引き続き表示されるため、キーを購入する前にプラグインを設定してテストできます。プラグインのページと WooCommerce のページにはリマインダーが表示されます。既存の注文には影響しません。
ライセンスの期限が切れた後もプラグインは動作し続けますが、アップデートとサポートには更新が必要です。ステータスはバックグラウンドで自動的に再確認されます。
トラブルシューティング
チェックアウトに USPS が表示されない：ライセンスが有効であること、Enable/Disable がオンであること、購入者の国のゾーンにこの方法が追加されていることを確認してください（または Ignore shipping zones がオンで、その国が許可されていること）。重量制限、Minimum subtotal、Excluded shipping classes も確認してください。有効な USPS キーがない場合、この方法には固定料金（Country prices または Fallback cost）が必要です。
リアルタイム送料が表示されない：設定ページの上部にある警告を確認してください。Debug log をオンにして、WooCommerce > Status > Logs を開き、ソース vfd-usps を選択してください。誤ったキー、誤った環境、USPS のエラーメッセージがここに記録されています。国内の送料には、購入者の 5 桁の郵便番号が必要です。
ストアの通貨が USD ではない：USPS は USD でのみ見積もりを提供します。USD exchange rate を入力してください。入力しない場合、リアルタイム送料は使用されず、代わりに固定料金が表示されます。
Web Tools User ID が機能しない：従来の Web Tools API は停止されています。USPS Developer Portal でアプリを作成し、その Consumer Key と Consumer Secret を使用してください。
変更後に料金が古く見える：設定を保存するとキャッシュが消去されます。Clear cached USPS token and rates をクリックすることもできます。
ライセンスブロックにエラーが表示される：ブロック内のメッセージに従ってください。たとえば、キーが別のドメインで既に使用されている場合は、vibefox.net のアカウントで枠を解放し、Check now をクリックします。サイトのアドレスが変更された場合は、Check now をクリックして、新しいドメインでキーを有効化します。ライセンスサーバーに接続できない場合、プラグインは最後に確認できたステータスで動作を続けます。
アンインストール
プラグインを無効化しても設定は保持され、キャッシュされたトークンと料金のみが消去されます。削除するには、無効化してから Plugins ページで削除してください。このプラグインのライセンスキーとライセンスステータス、およびキャッシュされたトークンと料金は、常に削除されます。設定とゾーンの方法は、Remove data on uninstall がオンだった場合にのみ削除されます。それ以外の場合は、後で再インストールするために残ります。既存の注文は配送項目を保持します。
USPS は、それぞれの所有者の商標です。本プラグインは USPS と提携しておらず、USPS の承認も受けていません。