VibeFox Shippo for WooCommerce — ヘルプ
要件
WordPress: 5.8 以降。
WooCommerce: 7.0 以降。インストールされ有効になっている必要があります。WooCommerce がなければ、本プラグインは有効化できません。
PHP: 8.0 以降。
Shippo アカウント: Shippo アカウントを作成し、配送業者（USPS、UPS、FedEx、DHL など）を接続または有効にして、Shippo > Settings > Advanced > API から API トークンをコピーします。Shippo は料金の照会ではなく、購入したラベルに対して課金します。新しい Shippo アカウントは、リアルタイム料金が返されるようになる前に Shippo による確認が必要な場合があります。トークンがない場合は、代替料金のみが使用されます。
商品: 商品には重量と寸法を設定してください。寸法のない商品にはデフォルトの箱サイズが使われます。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin に移動し、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_shippo フォルダを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます: WooCommerce > Settings > Shipping > VibeFox Shippo。または、Plugins ページでプラグイン名の下にある Settings をクリックします。
4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。
5. Shippo API トークンを貼り付け、Ship from の住所を入力します。郵便番号は必須です。
6. Shippo rate currency を選びます（米国から発送する場合は USD）。ストアが別の通貨を使っている場合は、為替レートを入力します。
7. 必要に応じて、国と重量の表に代替料金を入力します。
8. WooCommerce > Settings > Shipping > Shipping zones で、配送ゾーンに VibeFox Shippo を追加するか、Ignore shipping zones を有効にして国を選択します。
設定
すべての設定は 1 つのページにあります: WooCommerce > Settings > Shipping > VibeFox Shippo。設定はすべての配送ゾーンに適用されます。配送ゾーンに方法を追加すると、ゾーンのウィンドウには 1 つの項目だけが表示されます:
Title (zone): このゾーンで購入者に表示される名前。空欄にすると、全体の Name が使われます。
設定を保存するたびに、キャッシュされた Shippo の料金が消去されます。設定の上部にある警告は、この方法が表示されないケースや、リアルタイム料金を使用できないケースを知らせます。API トークンがない、発送元の郵便番号または国がない、為替レートがない、といった場合です。テスト用トークンが設定されている場合は、通知で知らされます。
一般
Enable/Disable: すべてのゾーンでこの方法を一括でオンまたはオフにします。
Name: チェックアウトに表示される配送方法の名前。ゾーンごとに独自の Title で上書きできます。デフォルト: Shippo Shipping。
Shippo アカウント
API token: Shippo API トークン。本番ストアで実際の料金を取得するには本番トークン（shippo_live_...）を、Shippo のテスト料金を取得するにはテストトークン（shippo_test_...）を使用します。
Allowed carriers / services: 任意。カンマ区切りで入力します。配送業者は Shippo の名称どおり（USPS、UPS、FedEx、DHL Express）、または Shippo のサービスレベルトークン（usps_priority、ups_ground）で指定します。許可された中で最も安い料金が表示されます。空欄の場合は、どの配送業者でも最も安い料金が表示されます。
Ship from（荷物を発送する住所。空欄の項目は、同じ国にある場合、WooCommerce > Settings > General のストアの住所から補われます）
Sender name / company: 送り主の名前。税関申告書への署名にも使われます。
Street address: 送り主の番地。
City: 送り主の市区町村。
State / province: 2 文字の州または県コード（例: CA、NY）。配送業者によっては必要です。
Postal / ZIP code: リアルタイム料金に必須です。
Country: 発送元の国。デフォルト: United States。
料金
Parcels: カートを Shippo にどのように送信するか。
Default box size: ストアの寸法単位での 縦 x 横 x 高さ（例: 30 x 20 x 10）。Shippo には箱のサイズが必要です。カート内の商品に寸法がない場合に使われます。空欄の場合は 30 x 20 x 10 cm が使われます。
Shippo rate currency: Shippo が配送業者の料金を見積もる通貨で、発送元の国の通貨です: USD（米国）、CAD（カナダ）、GBP（英国）、EUR（ユーロ圏）、AUD（オーストラリア）。デフォルト: USD。Shippo がストアの通貨で返す料金は、常にそのまま使用されます。
Exchange rate: Shippo rate currency の 1 単位をストアの通貨で表した価格。例: 0.92。両者が同じ場合は不要です。未入力の場合、別の通貨の料金は使われず、代替料金が適用されます。本プラグインは通貨を自動換算しません。
Tax status: Taxable を選ぶと、税ルールに従って WooCommerce が配送料に税を加算します。None では加算されません。Shippo の料金には売上税は含まれません。
代替料金（リアルタイム料金がない場合に使われます: API トークンがない、Shippo に接続できない、トークンが拒否された、または住所に対する配送業者の料金がない場合。料金はストアの通貨で入力します。両方を空欄にすると、この場合は方法を非表示にします）
Country prices: 国とカート重量ごとの料金表です。+ Add country をクリックして行を追加し、×をクリックして削除します。列は Price と、重量区分の XS（1 kg まで）、S（2 kg まで）、M（3 kg まで）、L（5 kg まで）、XL（5 kg 超）です。空欄または 0 の区分では Price 列の料金が使われます。* Default の行は、独自の行がない国に適用されます。新しい行は * Default として始まります。すべてのセルが空欄のまま保存された行は 0 の料金を請求するため、入力しない行は削除してください。
Other countries: 上の表にない国の料金です（* Default の行がない場合）。空欄の場合、その国では方法を非表示にします。
条件
Free shipping from: この小計以上になると送料が無料になるカートの小計。その場合、Shippo へのリクエストは行われません。空欄の場合は無効です。
Minimum subtotal: カートの小計がこの金額以上の場合にのみ方法を表示します。空欄の場合は常に表示します。
Minimum weight (kg): この方法を表示するためのカートの最小重量。0 は制限なしを意味します。
Maximum weight (kg): カートの重量がこの値を超えると、方法は非表示になります。デフォルト: 30。0 は制限なしを意味します。
Disabled shipping classes: カートに、これらの WooCommerce 配送クラスのいずれかに属する商品が含まれている場合、方法を非表示にします。
配送ゾーンを使わない場合の提供
Ignore shipping zones: 方法がゾーンに追加されているかどうかに関係なく、下記の国に対して方法を提供します。
Countries: このモードでの配送先の国。空欄の場合、ストアが配送しているすべての国が対象になります。このフィールドは Ignore shipping zones が有効な場合にのみ使用されます。配送ゾーンに追加された方法は、そのゾーンの国に対して常に機能します。
詳細設定
Debug log: Shippo へのリクエストを WooCommerce > Status > Logs に記録します。ソースは vfd-shippo です。API エラーは、このオプションがオフでも常に記録されます。API トークンと購入者の住所は、ログに記録されることはありません。
Remove data on uninstall: 有効にすると、プラグインを削除したときに、その設定と配送ゾーンの方法が削除されます。プラグインを無効化しても、設定は削除されません。
チェックアウトでの動作
購入者が配送先の住所を入力すると、WooCommerce はプラグインに料金を問い合わせます。プラグインはまず条件を確認します: カートの重量、最低小計、無効化された配送クラス。送料無料が適用される場合は、料金 0 円で方法が表示され、Shippo へのリクエストは送信されません。
次にプラグインは、発送元の住所、購入者の住所、荷物を Shippo に送信します。WooCommerce が郵便番号を必要とする国では、購入者が入力するまでリクエストを待機します。国際配送の場合は、商品名、数量、重量、価格を含む税関申告書が追加されます。Shippo が配送業者の料金を返すと、プラグインは、許可された中で最も安い料金をストアの通貨で、方法名の下に表示します。
注文ごとのモードでは、商品を 1 つの箱にまとめます。最も大きい商品の最長辺と中間辺、およびすべての個数の最短辺を合計します。いずれかの商品に寸法がない場合は、荷物全体にデフォルトの箱サイズが使われます。商品ごとのモードでは、各商品が別の荷物として料金を計算され、その料金に数量を掛けます。
各応答は、住所と荷物ごとに 1 時間キャッシュされます。Shippo が使用可能な料金を返さなかった場合、その住所は 10 分間記憶されます。タイムアウト、トークンの拒否、サーバーエラー、またはレート制限の後、プラグインは 5 分間リクエストを停止し、代替料金を使用します。リクエストのタイムアウトは 10 秒です。
リアルタイム料金がない場合、料金は代替料金の表から、次に Other countries から取得されます。どちらも該当しない場合、方法は非表示になります。購入者にエラーが表示されることはありません。
この方法は、クラシックチェックアウトと、カートブロックおよびチェックアウトブロックで動作します。WooCommerce High-Performance Order Storage（HPOS）に対応しています。
本プラグインが行うのは料金の計算のみです。ラベルの購入、荷物の追跡、住所の検証、集荷・受け取り拠点の提供、保険、署名オプション、返品ラベルには対応していません。許可された中で最も安い料金だけが表示され、すべてのサービスの一覧は表示されません。上記のまとめ方以外に箱詰めの最適化はなく、料金の上乗せや手数料もありません。
注文
注文の配送行には、選択された Carrier / service と、注文ごとに 1 つの荷物の場合は Estimated delivery days が保存されます。これらは管理画面の注文ページで確認でき、Shippo で対応するラベルを購入できます。
ライセンスキー
本プラグインは、vibefox.net で購入した VibeFox ライセンスキーで動作します。ライセンスブロックは、WooCommerce > Settings > Shipping > VibeFox Shippo ページの上部にあります。キーを License key に貼り付けて Activate をクリックします。ブロックには、ステータス（例: ライセンスの有効期限日）とドメインが表示されます。Check now でステータスを再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除します。Manage licenses and domains in your account のリンクからは、vibefox.net のアカウントを開けます。
1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、そのドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、Shippo はチェックアウトで購入者には表示されません。ログイン中のストア管理者には、(unlicensed — visible to admins only) と表示された状態で引き続き表示されるため、キーを購入する前にプラグインを設定してテストできます。プラグインページと WooCommerce のページには、リマインダーが表示されます。既存の注文には影響しません。
ライセンスの有効期限が切れてもプラグインは動作を続けますが、アップデートとサポートには更新が必要です。ステータスは、バックグラウンドで自動的に再確認されます。
トラブルシューティング
チェックアウトに Shippo が表示されない: ライセンスが有効か、Enable/Disable がオンか、購入者の国のゾーンに方法が追加されているか（または Ignore shipping zones がオンで、その国が許可されているか）を確認してください。重量制限、Minimum subtotal、Disabled shipping classes も確認してください。リアルタイム料金がない場合は、その国、* Default、または Other countries に料金が設定されているか確認してください。
リアルタイム料金が表示されない: Debug log をオンにし、チェックアウトを再読み込みしてから、WooCommerce > Status > Logs でソース vfd-shippo を開いてください。よくある原因: API トークンまたは発送元の郵便番号がない、ストアの通貨が為替レートなしで Shippo rate currency と異なる、購入者の郵便番号がまだ入力されていない、Shippo アカウントのどの配送業者もその住所を扱っていない、または Shippo アカウントがまだ確認されていない。
本番ストアでテスト料金を表示する: テストトークン（shippo_test_...）は、Shippo のテスト料金を返します。本番トークン（shippo_live_...）を使用してください。
想定外の国で送料が無料になる: 料金表に空の行がないか確認してください。特に、空の * Default 行に注意してください。すべてのセルが空の行は 0 円になります。
変更後に料金が古く見える: 設定ページを保存してください。キャッシュされた Shippo の料金が消去されます。
開発者向け: フィルター vfd_shpo_shipment_request、vfd_shpo_customs_declaration、vfd_shpo_selected_rate、vfd_shpo_api_url は、リクエストの本文、税関申告書、選択された料金、API の URL を変更します。
ライセンスブロックにエラーが表示される: ブロックのメッセージに従ってください。たとえば、そのキーが別のドメインで使用されている場合は、vibefox.net のアカウントで枠を解放してから Check now をクリックしてください。サイトのアドレスが変わった場合は、Check now をクリックして新しいドメインでキーを有効にしてください。ライセンスサーバーに接続できない場合、プラグインは最後に確認したステータスで動作を続けます。
アンインストール
プラグインを無効化しても、すべてのデータは保持されます。削除するには、Plugins ページでプラグインを無効化してから削除してください。このプラグインのライセンスキー、ライセンスステータス、キャッシュされた料金は、常に削除されます。設定とゾーンの配送方法は、Remove data on uninstall がオンだった場合にのみ削除されます。それ以外の場合は、後で再インストールする際のために残ります。既存の注文は、配送行を保持します。
Shippo は、それぞれの所有者の商標です。本プラグインは Shippo と提携しておらず、Shippo による推奨も受けていません。