VibeFox EasyPost for WooCommerce — ヘルプ
要件
WordPress: 5.8 以降。
WooCommerce: 7.0 以降。インストールされ、有効になっている必要があります。WooCommerce がないとプラグインを有効化できません。
PHP: 8.0 以降。
EasyPost アカウント（リアルタイム送料の場合のみ）: EasyPost の Web サイトでアカウントを作成し、EasyPost ダッシュボードで配送業者アカウント（USPS、UPS、FedEx など）を接続して、EasyPost Dashboard > Account Settings > API Keys から APIキーをコピーします。EasyPost が課金するのは購入したラベルであり、送料の問い合わせではありません。予備価格だけを使う場合は、EasyPost アカウントは不要です。
商品: 商品には重量が必要で、できれば寸法も設定してください。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin を開き、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_easypost フォルダを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます：WooCommerce > Settings > Shipping > VibeFox EasyPost。または、プラグイン一覧ページでプラグイン名の下にある Settings をクリックします。
4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。
5. EasyPost の APIキーを貼り付け、Ship from の住所を入力します。リアルタイム送料には郵便番号が必要です。
6. ストアの通貨が USD でない場合は、USD exchange rate を入力します。必要に応じて予備価格も入力できます（設定の項を参照）。
7. WooCommerce > Settings > Shipping > Shipping zones で、配送ゾーンに VibeFox EasyPost を追加するか、Ignore shipping zones を有効にして国を選択します。
設定
すべての設定は 1 つのページにあります：WooCommerce > Settings > Shipping > VibeFox EasyPost。設定はすべての配送ゾーンに適用されます。ゾーンにこの方法を追加すると、ゾーンのウィンドウには次の 1 つの項目だけが表示されます：
Title (zone): そのゾーンで購入者に表示される配送方法の名前。空欄にすると、全体の Name が使われます。
ページの上部には、リアルタイム送料を使用できない場合に警告が表示されます。APIキーが未設定、出荷元の郵便番号または国が未設定、ストアの通貨が USD 以外で為替レートが未設定、などの場合です。テスト用のAPIキーが設定されている場合も注意が表示されます。設定を保存するたびに、キャッシュされた EasyPost の送料は消去されます。
一般
Enable/Disable: すべてのゾーンでこの方法を一度に有効または無効にします。既定値：有効。
Name: カートとチェックアウトで表示される配送方法の名前。ゾーンでは、独自の Title で上書きできます。既定値：EasyPost Shipping。
EasyPost アカウント
API key: EasyPost Dashboard > Account Settings > API Keys にある EasyPost の APIキーです。本番キー（EZAK で始まる）は実際の送料を返します。テストキー（EZTK で始まる）は EasyPost のテスト送料を返すので、テスト目的でのみ使用してください。
Allowed carriers / services: 任意。カンマで区切って入力します。EasyPost の名称どおりに、配送業者（USPS）または配送業者とサービス（USPS:Priority、UPS:Ground）を指定します。許可された中で最も安い送料が表示されます。空欄にすると、どの配送業者の中でも最も安い送料が表示されます。
出荷元
荷物の発送元住所です。Country がストアの国である場合、空欄は WooCommerce > Settings > General のストア住所から補完されます（送り主の名前はサイトタイトルから取得されます）。
Sender name / company: 送り主の名前または会社名。
Street address: 出荷元住所の番地。
City: 出荷元の市区町村。
State: 2 文字の州コード（例: CA、NY）。
ZIP code: 出荷元の郵便番号。リアルタイム送料に必要です。
Country: 出荷元の国。既定値：United States。
送料
Parcels: カートを EasyPost にどのように送信するか。
重量はストアの重量単位からオンス（最小 1 oz）に、寸法はインチに変換されます。商品に寸法が設定されていない場合、荷物は重量だけで計算されます。
USD exchange rate: EasyPost の送料は USD で提供されます。1 USD あたりのストア通貨の価格を入力します（例: 0.92）。この値がないと、リアルタイム送料は使われず、予備価格のみが使われます。ストアの通貨が USD の場合は不要です。USD と CAD のストアは、EasyPost に自国の通貨で見積もりを依頼します。小数点区切りとしてピリオドとカンマの両方を使用できます。
Tax status: Taxable を選ぶと、WooCommerce は税ルールに従って送料に税金を加算します。None を選ぶと加算しません。EasyPost の送料には消費税は含まれません。既定値：Taxable。
予備価格
リアルタイム送料がない場合に使用されます。APIキーがない、EasyPost に接続できない、キーが拒否された、または、どの配送業者もその住所の送料を提供していない、といった場合です。価格はストアの通貨で入力します。その場合に方法を非表示にするには、両方の項目を空欄にしてください。
Country prices: 1 行に 1 か国。2 文字の国コード、コロン、価格の順に入力します（例: US:9.99）。形式が異なる行は無視され、保存時にエラーメッセージに一覧表示されます。
Other countries: 上のリストにない国の価格。空欄にすると、それらの国では方法が非表示になります。
条件
Free shipping from: この小計以上で送料が無料になるカートの小計。その場合、EasyPost へのリクエストは行われません。空欄にすると、この機能は無効になります。
Minimum subtotal: カートの小計がこの金額以上の場合にのみ、この方法を表示します。空欄にすると、常に表示されます。
Minimum weight: カートの重量がこれより軽い場合、この方法を非表示にします（ストアの重量単位）。0 は制限なしを意味します。
Maximum weight: カートの重量がこれより重い場合、この方法を非表示にします（ストアの重量単位）。0 は制限なしを意味します。
Disabled shipping classes: カートに、これらの WooCommerce 配送クラスのいずれかの商品が含まれている場合、この方法を非表示にします。
配送ゾーンを使わない場合の提供
Ignore shipping zones: この方法がゾーンに追加されているかどうかにかかわらず、下記の国でこの方法を提供します。
Countries: このモードでの配送先の国。空欄にすると、ストアが配送するすべての国が使われます。このフィールドは Ignore shipping zones が有効な場合にのみ使用されます。
詳細設定
Debug log: EasyPost へのリクエストを WooCommerce > Status > Logs に書き込みます（ソースは vfd-easypost）。このオプションが無効でも、API エラーは常に記録されます。APIキーと購入者の住所は、記録されることはありません。
Remove data on uninstall: 有効にすると、プラグインを削除したときに、その設定とゾーンの方法も削除されます。プラグインを無効化しても、設定が削除されることはありません。
チェックアウト時の動作
購入者が配送先住所を入力すると、WooCommerce はプラグインに送料を問い合わせます。プラグインはまず条件を確認します：配送先の国、カートの重量、最低小計、無効化された配送クラス。送料無料が適用される場合、この方法は価格ゼロで表示され、EasyPost へのリクエストは送信されません。
それ以外の場合、プラグインは出荷元住所、配送先住所、荷物を EasyPost に送信し、お使いのすべての配送業者アカウントの送料を受け取ります。許可された中で最も安い送料を選び、ストアの通貨に換算して、方法の名前の下に表示します。郵便番号が必要な国では、購入者が郵便番号を入力した後にのみリクエストが行われます。
各応答は、同じ住所と同じ荷物について 1 時間キャッシュされます。使用可能な送料がない住所は、10 分間記憶されます。タイムアウト、キーの拒否、レート制限、または EasyPost のサーバーエラーの後、5 分間はリクエストが行われません。API のタイムアウトは 10 秒です。これらのいずれの場合も、購入者にエラーは表示されません。予備価格が使用されるか、予備価格がない場合は方法が非表示になります。
選ばれた配送業者とサービス、および 1 梱包モードでの推定配達日数は、注文の配送明細に保存されます。管理画面の注文ページで確認できます。
この方法は、クラシックチェックアウトと、カートとチェックアウトのブロックで動作します。WooCommerce の高性能注文保存（HPOS）に対応しています。
本プラグインは送料の計算のみを行います。ラベルの購入、荷物の追跡、住所の検証、集荷・受け取り拠点の提供は行わず、保険や署名オプションも追加しません。表示するのは 1 つの選択肢（許可された中で最も安い送料）だけで、サービスの一覧ではありません。商品を 1 つの荷物にまとめる以外の箱詰め最適化はなく、送料の上乗せや手数料もありません。
ライセンスキー
本プラグインは、vibefox.net で購入した VibeFox ライセンスキーで動作します。ライセンスブロックは、WooCommerce > Settings > Shipping > VibeFox EasyPost ページの上部にあります。キーを License key に貼り付けて、Activate をクリックします。ブロックには、ステータス（ライセンスの有効期限日など）と、お使いのドメインが表示されます。Check now でステータスを再確認、Change key で別のキーを入力、Remove key でこのサイトからキーを削除できます。Manage licenses and domains in your account のリンクから、vibefox.net のアカウントを開けます。
1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、ドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、チェックアウトで購入者に EasyPost は表示されません。ログイン中のストア管理者には、(unlicensed — visible to admins only) と表示されたうえで表示されるので、キーを購入する前にプラグインを設定してテストできます。プラグインのページと WooCommerce のページには、リマインダーが表示されます。既存の注文には影響しません。
ライセンスの期限が切れても、プラグインは動作を続けますが、アップデートとサポートには更新が必要です。ステータスはバックグラウンドで自動的に再確認されます。
トラブルシューティング
チェックアウトに EasyPost が表示されない: ライセンスが有効であること、Enable/Disable が有効であること、購入者の国のゾーンにこの方法が追加されていること（または Ignore shipping zones が有効で、その国が許可されていること）を確認してください。重量の上限、Minimum subtotal、Disabled shipping classes も確認してください。リアルタイム送料がない場合、この方法にはその国、または Other countries の予備価格が必要です。
リアルタイム送料が表示されない: 設定ページ上部の警告を読み、Debug log を有効にして、チェックアウトを再読み込みし、WooCommerce > Status > Logs をソース vfd-easypost で開いてください。よくある原因：APIキーまたは出荷元の郵便番号がない、USD 以外のストアで USD exchange rate がない、購入者がまだ郵便番号を入力していない、EasyPost アカウントのどの配送業者もその住所に対応していない、または Allowed carriers / services がすべての送料を除外している。
送料がテスト価格のように見える: テストキー（EZTK...）が設定されています。実際のストアでは本番キー（EZAK...）を使用してください。
送料が数分間停止した: タイムアウト、キーの拒否、または EasyPost のサーバーエラーの後、プラグインは 5 分間リクエストを停止し、予備価格を使用します。APIキーとログを確認してください。
税金は含まれていますか？ EasyPost の送料には消費税は含まれません。Tax status が Taxable の場合、WooCommerce は税の設定に従って送料に税金を加算します。
変更後に送料が古いように見える: 設定ページを保存してください。キャッシュされた EasyPost の送料が消去されます。
開発者向けフック: フィルター vfd_ep_shipment_request（リクエスト本文）、vfd_ep_selected_rate（選択された送料）、vfd_ep_api_url（API のベース URL）、および woocommerce_shipping_vfd_easypost_is_available でプラグインを調整できます。
ライセンスブロックにエラーが表示される: ブロック内のメッセージに従ってください。たとえば、キーが別のドメインで使用されている場合は、vibefox.net のアカウントで枠を解放して Check now をクリックします。サイトのアドレスが変わった場合は、Check now をクリックして、新しいドメインでキーを有効化します。ライセンスサーバーに接続できない場合、プラグインは最後に確認されたステータスで動作を続けます。
アンインストール
プラグインを無効化すると、すべての設定は保持され、キャッシュされた送料だけが消去されます。削除するには、無効化してから Plugins ページで削除してください。このプラグインのライセンスキーとライセンスステータス、キャッシュされた送料、古いログファイルは、常に削除されます。設定とゾーンの方法は、Remove data on uninstall が有効だった場合にのみ削除されます。そうでない場合は、後で再インストールするために残ります。既存の注文は配送明細を保持します。
EasyPost は各所有者の商標です。本プラグインは EasyPost と提携しておらず、EasyPost の推奨も受けていません。