VibeFox Instabee for WooCommerce — ヘルプ

要件

WordPress：5.8 以降。

WooCommerce：7.0 以降。インストールされ、有効になっている必要があります。WooCommerce がない場合、プラグインは有効化できません。

PHP：8.0 以降。

Budbee API の認証情報（宅配ボックスの選択にのみ必要）：API キーと API シークレット。Instabee は配送契約のある加盟店にこれらを発行します。Instabee の担当者に問い合わせるか、Instabee 加盟店ポータルをご利用ください。API のドキュメントは developer.budbee.com にあります。認証情報がなくても、この配送方法は固定料金で動作しますが、購入者は宅配ボックスを選べません。

VibeFox ライセンスキー：vibefox.net で購入します。一つのキーは一つのドメインで使用できます。

インストール

1. WordPress で Plugins > Add New > Upload Plugin に移動し、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_instabee フォルダを /wp-content/plugins/ にアップロードすることもできます。

2. Activate をクリックします。

3. 設定を開きます：WooCommerce > Settings > Shipping > VibeFox Instabee。または、プラグインのページでプラグイン名の下にある Settings をクリックします。

4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。

5. 料金セクションに入力します。宅配ボックスの選択には、Budbee の API key と API secret も入力します（「設定」を参照）。

6. 配送先の国（例：スウェーデン）の配送ゾーンに VibeFox Instabee を追加します。WooCommerce > Settings > Shipping > Shipping zones で設定できます。または Ignore shipping zones をオンにして国を選択します。

設定

すべての設定は一つのページにあります：WooCommerce > Settings > Shipping > VibeFox Instabee。設定はすべての配送ゾーンに適用されます。配送ゾーンにこの方法を追加すると、ゾーンのウィンドウには一つの欄だけが表示されます：

Title：このゾーンのチェックアウトに表示されるこの料金の名称です。空欄にすると、全体の Method name が使われます。

設定の上部には警告が表示され、API の認証情報が片方だけ入力されている場合、認証情報がまったくない場合、国ごとの料金と予備の送料がない場合、直近の Budbee API リクエストが失敗した場合（日時と理由を含む）に通知されます。設定を保存するたびに、キャッシュされた宅配ボックスの一覧と直近の API エラーが消去されます。

一般

Enable/Disable：配送ゾーンを含むすべての場所で、この方法をオンまたはオフにします。デフォルト：オン。

Method name：カートとチェックアウトに表示される配送方法の名称です。ゾーンごとに独自の Title で上書きできます。デフォルト：Instabee parcel box。

Tax status：Taxable の場合、送料に WooCommerce の税金が加算されます。None の場合は加算されません。

宅配ボックスセレクター（Budbee API）

API の認証情報を設定すると、購入者はチェックアウトで郵便番号近くの宅配ボックスを選択でき、そのボックスが注文に保存されます。両方の欄が必要です。両方が設定されるまで、セレクターは無効のままです。

API key：Budbee の API キー（HTTP Basic のユーザー名）です。

API secret：Budbee の API シークレット（HTTP Basic のパスワード）です。

Test environment：Budbee のステージング API（api.staging.budbee.com）を使用します。Instabee から発行されたステージング用の認証情報を使う場合にのみオンにしてください。本番のストアではオフのままにします（api.budbee.com）。デフォルト：オフ。

料金（セクションの見出しには、ストアの通貨が表示されます）

すべての料金は、ストアの通貨で入力します。小数点はカンマでもピリオドでも入力できます（49,90 = 49.90）。数値でない値は保存されず、エラーメッセージに該当する欄の名称が表示されます。

Calculation type：料金の適用方法です。

Per order (weight tier of the whole cart):カート全体の重量が該当する重量区分の料金が一度だけ請求されます。これがデフォルトです。

Per item (price of each item's weight tier × quantity):各商品は、その商品自身の重量区分の料金で計算され、数量を掛けたものになります。

Country prices：列が Country、Price、XS（1 kg まで）、S（2 kg まで）、M（3 kg まで）、L（5 kg まで）、XL（5 kg 超）の表です。+ Add country をクリックすると行を追加でき、×印をクリックすると行を削除できます。個別の行がないすべての国に適用される行には * Any other country を選択します。区分が空欄または 0 の場合は Price 列が使われます。Price が 0 の場合は送料無料です。国の行にカート重量に対応する料金がない場合は * の行が使われ、それもない場合は Fallback cost が使われます。重量はストアの重量単位から kg に変換されます。

Fallback cost：配送先の国の行と * の行のいずれにも料金がない場合に使われます。空欄にすると、該当する国ではこの方法を非表示にします。

条件

Min weight (kg)：カートの重量がこの値より軽い場合、この方法を非表示にします。デフォルト：0（制限なし）。

Max weight (kg)：カートの重量がこの値より重い場合、この方法を非表示にします。宅配ボックスは約 20 kg まで対応しています。デフォルト：20。0 の場合は制限なし。

Minimum order amount：カートの小計（割引後、税抜き）がこの金額に達した場合のみ、この方法を表示します。空欄の場合は常に表示します。

Free shipping from：カートの小計（割引後、税抜き）がこの金額に達すると、この方法は無料になります。空欄の場合は無料にしません。

Excluded shipping classes：カートに、これらの WooCommerce 配送クラスのいずれかに属する商品が含まれている場合、この方法を非表示にします。

配送ゾーンを使わない場合の提供条件

通常は VibeFox Instabee を配送ゾーンに追加します。または、ここで国のリストに対して有効にすることもできます。

Ignore shipping zones：どの配送ゾーンにもこの方法が含まれていなくても、下記の国でこの方法を提供します。

Countries：このモードでの配送先の国です。空欄の場合は、配送先に設定したすべての国が使われます。この欄は Ignore shipping zones がオンの場合にのみ使われます。

詳細設定

Debug log：デバッグメッセージを WooCommerce > Status > Logs に書き込みます（ソースは vfd-instabee）。API エラーは、この設定がオフでも常に記録されます。API キーと購入者データは一切記録されません。

Remove data on uninstall：オンの場合、プラグインを削除すると、この方法の設定とゾーンごとの料金が削除されます。プラグインを無効化しても、設定は削除されません。注文に保存された宅配ボックスは保持されます。

チェックアウト時の動作

購入者が配送先住所を入力すると、WooCommerce はプラグインに料金を問い合わせます。プラグインは条件を確認します：カートの重量、最低注文金額、除外する配送クラス。カートの小計が Free shipping from に達した場合、料金は無料です。それ以外の場合、料金は配送先の国の Country prices の行、* の行、または Fallback cost から取得されます。料金がない場合、この方法は非表示になります。

購入者が Instabee の料金を選択し、API の認証情報が設定されている場合、スウェーデン、フィンランド、デンマーク、オランダ、ベルギーについて、料金の下に Parcel box セレクターが表示されます。配送先住所の郵便番号近くのボックスが距離順に、名称、住所、距離とともに表示されます。購入者は別の郵便番号を入力して Search をクリックできます。郵便番号が入力されるまで、セレクターは郵便番号の入力を求めます。ボックスが見つからない場合は、別の郵便番号を試すか、別の配送方法を選ぶよう案内されます。

宅配ボックスの選択は必須です。注文が確定すると、プラグインはサーバー側で、選択したボックスがその郵便番号の Budbee のリストに含まれているかを確認します。含まれていない場合、購入者には Please choose an Instabee parcel box. と表示されます。ボックスの名称は、ブラウザではなく Budbee のリストから取得されます。

プラグインが Budbee に送信するのは、配送先の国と郵便番号だけです。氏名、住所、メールアドレス、注文データは送信しません。ボックスの一覧は郵便番号ごとに 12 時間、ボックスがない郵便番号は 1 時間、リクエストの失敗は 5 分間キャッシュされます。そのため、API の応答が遅い場合や不具合がある場合でも、チェックアウトの更新のたびに遅くなることはありません。API のタイムアウトは 10 秒です。

Budbee API に接続できない場合、購入者にはボックスを選択せずに注文できることが通知されます。注文にはフラグが付けられ、配送を手配するときに貴店がボックスを選択します。以前に選択されたボックスがその時点で確認できない場合は、そのまま保持され、未確認としてマークされます。

セレクターは、クラシックチェックアウトと、カートおよびチェックアウトのブロックで動作します。本プラグインは WooCommerce の高パフォーマンス注文保存（HPOS）に対応しています。

本プラグインは、リアルタイムの料金計算、配送の手配、伝票の印刷、追跡番号や追跡メールの発行、Budbee Home の配達時間枠の提供、地図の表示は行いません。選択したボックス宛ての荷物は、Instabee / Budbee の加盟店ツールで手配してください。

受け取りポイント

選択した宅配ボックスは注文に保存され、次の場所に表示されます：

管理画面の注文画面：配送先住所の下に、Instabee parcel box としてボックス名、住所、Box ID が表示されます。チェックアウト時にボックスを確認できなかった場合は、not verified (Budbee API was unavailable at checkout) と表示されます。API が利用できなかったためにボックスが選択されなかった場合は、その旨が表示され、配送を手配する際にボックスを選択するよう通知されます。

サンクスページおよびマイアカウントの注文ページ：ボックス名と住所。

注文メール：HTML とプレーンテキスト。ストア宛てのメールには、ボックス ID も表示されます。API が利用できなかったためにボックスが選択されなかった場合は、ストア宛てのメールにのみその旨が記載されます。

ライセンスキー

本プラグインは、vibefox.net から取得した VibeFox ライセンスキーで動作します。ライセンスブロックは WooCommerce > Settings > Shipping > VibeFox Instabee のページ上部にあります。キーを License key に貼り付けて Activate をクリックします。ブロックには、ライセンスの有効期限日やお使いのドメインなどのステータスが表示されます。Check now でステータスを再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除します。Manage licenses and domains in your account のリンクから vibefox.net のアカウントを開けます。

一つのキーは一つのドメインで使用できます。サイトからキーを削除しても、ドメインの枠は解放されません。枠は vibefox.net のアカウントで解放してください。

有効なキーがない場合、Instabee はチェックアウトで購入者に表示されません。ログインしている管理者には表示され、(unlicensed — visible to admins only) と表示されるため、キーを購入する前にプラグインを設定してテストできます。プラグインのページと WooCommerce のページには通知が表示されます。既存の注文には影響しません。

ライセンスの有効期限が切れた後も、プラグインは動作を続けますが、アップデートとサポートには更新が必要です。ステータスは、バックグラウンドで自動的に再確認されます。

トラブルシューティング

Instabee がチェックアウトに表示されない：ライセンスが有効であること、Enable/Disable がオンであること、購入者の国のゾーンにこの方法が追加されていること（または Ignore shipping zones がオンで、その国が許可されていること）を確認してください。その国に料金が設定されているか、* の行または Fallback cost があるかを確認してください。重量制限、Minimum order amount、Excluded shipping classes を確認してください。料金が設定されていない場合は、設定の上部に警告が表示されます。

購入者に宅配ボックスの一覧が表示されない：一覧は、API key と API secret の両方が設定され、スウェーデン、フィンランド、デンマーク、オランダ、ベルギーのいずれかが配送先で、郵便番号が入力された後にのみ表示されます。直近の API エラーは設定の上部に表示されます。詳細は WooCommerce > Status > Logs（ソース vfd-instabee）にあります。詳細な情報が必要な場合は Debug log をオンにしてください。

ログに HTTP 401 または 403 が出力される：Budbee が API キーまたはシークレットを拒否しました。両方を確認し、Test environment の設定が認証情報と一致しているか確認してください（ステージング用の認証情報は、テスト環境をオンにした場合にのみ使用します）。

郵便番号にボックスがない：Budbee はその郵便番号を提供していません。購入者は別の郵便番号を検索するか、別の配送方法を選択できます。

変更後も古いボックスの一覧が表示される：設定ページを保存してください。キャッシュされたボックスの一覧が消去されます。

ボックス検索の対象国：開発者は vfd_ibee_box_countries フィルターで国のリストを変更できます。

ライセンスブロックにエラーが表示される：ブロックに表示されたメッセージに従ってください。たとえば、キーが別のドメインで既に使用されている場合は、vibefox.net のアカウントで枠を解放し、Check now をクリックします。サイトのアドレスが変わった場合は、Check now をクリックして新しいドメインでキーを有効化します。ライセンスサーバーに接続できない場合、プラグインは最後に確認されたステータスで動作を続けます。

アンインストール

プラグインを無効化すると、キャッシュされた宅配ボックスの一覧のみが消去されます。完全に削除するには、無効化してから Plugins ページで削除してください。このプラグインのライセンスキーとライセンスのステータス、キャッシュされた宅配ボックスの一覧、直近の API エラーは、常に削除されます。設定、ゾーンごとの配送方法、バージョンデータは、Remove data on uninstall がオンだった場合にのみ削除されます。それ以外の場合は、後で再インストールするために保持されます。注文に保存された宅配ボックスは常に保持され、既存の注文は配送の行をそのまま保持します。

Instabee と Budbee は、それぞれの所有者の商標です。本プラグインは Instabee または Budbee と提携しておらず、両社による推奨も受けていません。