VibeFox bpost Cubee for WooCommerce — ヘルプ

要件

WordPress：5.8 以降。

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

PHP：8.0 以降。

bpost Shipping Platform アカウント（受け取りポイントセレクターのみに必要）：プラグインは bpost Shipping Platform API を通じて受け取りポイントを検索します。plugins.bpost.be で bpost Shipping Platform アカウントにログインし、Settings > Key management でキーを作成してください。必要な値は 3 つです：Account ID（公開キー）、Passphrase（秘密キー）、App ID（X-APPID）。App ID は、お客様の連携のために bpost が発行します。bpost の EC サポート（eol@bpost.be）にお問い合わせください。また、契約の運送業者 ID（68 = bpost）も必要です。キーが完全でない場合も、この方法は固定料金の配送方法として動作しますが、購入者に受け取りポイントの選択は求められません。

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

インストール

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

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

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

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

5. 料金を入力し、受け取りポイントセレクターを使う場合は bpost API キーを入力します（「設定」を参照）。

6. WooCommerce > Settings > Shipping > Shipping zones で、ベルギー向けの配送ゾーンに VibeFox bpost Cubee を追加するか、Ignore shipping zones をオンにして国を選択します。

設定

すべての設定は 1 ページにまとまっています：WooCommerce > Settings > Shipping > VibeFox bpost Cubee。これらはすべての配送ゾーンに適用されます。方法をゾーンに追加すると、ゾーンのウィンドウには 1 つの項目だけが表示されます：

Title (zone)：このゾーンのチェックアウトに表示されるこのオプションの名前。空欄にすると、全体の Name が使われます。

設定ページには、配送方法またはセレクターを目立たないように非表示にする状況があると警告が表示されます：受け取りポイントセレクターはオンなのに API キーが不完全である場合、ベルギーの料金がない場合、または bpost API への最後の接続に失敗した場合です。設定を保存するたびに、保存された API トークンとキャッシュされた受け取りポイントのリストが消去されます。

一般

Enable/Disable：すべてのゾーンで bpost 宅配ロッカー配送を一度にオンまたはオフにします。

Name：チェックアウトで購入者に表示される配送方法の名前。デフォルト：bpost parcel locker。

Tax status：Taxable は料金に WooCommerce の税金を加算します。None は料金が確定額であることを意味します。

bpost API（受け取りポイントの検索）（受け取りポイントセレクターにのみ必要）

Account ID (public key)：bpost Shipping Platform アカウントの公開キーです。plugins.bpost.be の Key management から取得します。

Passphrase (private key)：すべてのリクエストに署名するために使われる秘密キーです（HMAC-SHA256）。bpost に送信されることも、ログに書き込まれることもありません。

App ID (X-APPID)：お客様の連携のために bpost が発行したアプリケーション識別子です。X-APPID ヘッダーで送信されます。

Carrier ID：bpost Shipping Platform 契約の運送業者で、その受け取りポイントと宅配ロッカーが一覧に表示されます。デフォルト：68（bpost）。契約で有効になっている他の運送業者にはそれぞれ独自の ID があります。

受け取りポイントセレクター

Pickup points：チェックアウトに受け取りポイントと宅配ロッカーのセレクターを表示します。デフォルトはオンです。3 つの API キーがすべて入力されている場合にのみセレクターが表示されます。

Search field width：郵便番号 / 市区町村フィールドの CSS 幅です。例：100% や 300px。デフォルト：100%。

Pickup point list width：受け取りポイントのリストの CSS 幅です。例：100% や 400px。デフォルト：100%。

料金（ストアの通貨建て。bpost はこの API を通じて配送料金を返しません）

Price by：料金の決め方です。

Country prices：国ごとに 1 行、CC=PRICE の形式で記入します。例：BE=4.95。*=PRICE の行は、その他すべての国の料金を設定します。例：*=9.95。小数点とカンマのどちらも小数区切りとして受け付けます。無効な行は無視され、保存時にエラーメッセージに一覧表示されます。料金のない国（* の行がない場合）には、この方法は提供されません。

Size prices：Price by が荷物サイズの場合に使われます。形式は S=3.50, M=4.50, L=6.00, XL=8.00 です。サイズはカートの重量で決まります：S は 2 kg まで、M は 5 kg まで、L は 10 kg まで、XL は 10 kg 超。

Calculation：Per order は料金を 1 回だけ請求します。Per item (price x number of items) は料金にカート内の商品数を掛けます。

条件

Min weight (kg)：この方法が表示されるために必要なカートの最小重量です。0 は制限なしを意味します。

Max weight (kg)：カートの重量がこれを超えると、この方法は非表示になります。デフォルト：30。bpost 宅配ロッカーは 30 kg までの荷物を受け付けるためです。0 は制限なしを意味します。

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

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

商品の重量は、ストアの重量単位からキログラムに換算されます。

送料無料

Free shipping：下に記載された金額以上で送料無料にします。

Free shipping from：送料が無料になるカートの小計（税抜き）。Free shipping がオンの場合にのみ使われます。

配送ゾーンなしでの提供

Ignore shipping zones：方法をゾーンに追加せずに、下記の国でこの方法を提供します。

Countries：このモードの配送先の国です。デフォルト：ベルギー。空欄にすると、配送先としているすべての国が使われます。この項目は Ignore shipping zones がオンの場合にのみ使われます。

詳細設定

Debug log：API リクエストと料金計算を WooCommerce > Status > Logs に記録します。ソースは vfd-bpost-cubee です。API エラーはこのオプションがオフでも常に記録されます。キー、トークン、購入者データは決して記録されません。

Remove data on uninstall：オンの場合、プラグインを削除すると、その設定とゾーンの配送方法が削除されます。プラグインを無効化してもデータは削除されません。注文に保存された受け取りポイントは常に保持されます。

チェックアウトでの動作

購入者が配送先住所を入力すると、WooCommerce がプラグインに料金を問い合わせます。プラグインは条件を確認します：配送先の国、カートの重量、最低注文金額、除外する配送クラス。その後、国のリストまたは荷物サイズに基づいて料金を取得し、商品単位モードでは商品数を掛け、送料無料が適用される場合はゼロにします。

購入者が bpost の料金を選択すると、その下に検索フィールド、Search ボタン、受け取りポイントのリストが表示されます。検索フィールドが空の場合、チェックアウト住所の郵便番号が自動的に検索されます。購入者は別の郵便番号または市区町村名を入力できます。各ポイントには名前と住所が表示されます。最大 50 件のポイントが一覧表示されます。受け取りポイントのリストは、オランダ語のサイトではオランダ語で、それ以外ではフランス語でリクエストされます。

購入者は受け取りポイントを選ぶ必要があります。選択がない場合、クラシックチェックアウトには Please select a bpost pickup point. と表示され、ブロックチェックアウトは同じメッセージで注文を拒否します。選択はチェックアウトのセッション中保持されるため、ページを再読み込みしても失われません。

受け取りポイントを一覧表示するために、プラグインは検索された郵便番号または市区町村、国、運送業者 ID のみを、お客様のキーで署名して bpost に送信します。購入者の氏名、メールアドレス、住所の行は送信されません。API トークンは自動的に取得され、更新されます。bpost がトークンを拒否した場合、新しいトークンを 1 回取得して検索を繰り返します。検索結果は 6 時間キャッシュされます。bpost が応答しない場合、購入者には Pickup points cannot be loaded right now. Please try again in a few minutes or choose another shipping method. と表示され、プラグインは 5 分後に再試行します。API のタイムアウトは 15 秒です。

この方法は、クラシックチェックアウト、およびカートとチェックアウトのブロックで動作します。WooCommerce High-Performance Order Storage（HPOS）に対応しています。

プラグインは固定料金のみを使用します。bpost からリアルタイムの運賃を取得せず、出荷の作成、ラベルの印刷、荷物の追跡も行いません。受け取りポイントは地図ではなくリストとして表示されます。出荷は bpost Shipping Platform または Shipping Manager アカウントで作成してください。受け取りポイント ID は注文に含まれています。

受け取りポイント

選択された受け取りポイント（名前と住所）とその ID は、注文に保存されます。管理画面の注文画面では、配送先住所の下に bpost pickup point として表示されます。Change をクリックし、郵便番号または市区町村を検索して、リストから別のポイントを選んでください。注文はすぐに更新され、注文メモ bpost pickup point changed to: … が追加されます。Change リンクは、API キーが入力されている場合にのみ利用できます。

購入者は注文完了ページと My account > Orders で受け取りポイントを確認できます。注文メールにも、HTML 版とプレーンテキスト版の両方に追加されます。

宅配ロッカーと自宅への配送を一緒に提供するには、同じゾーンに別の配送方法（例：Flat rate）を追加してください。受け取りポイントセレクターは bpost の料金の下にのみ表示されます。

ライセンスキー

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

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

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

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

トラブルシューティング

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

チェックアウトに受け取りポイントセレクターが表示されない：Pickup points がオンであること、そして Account ID (public key)、Passphrase (private key)、App ID (X-APPID) がすべて入力されていることを確認してください。キーが不完全な場合、設定ページに警告が表示されます。

購入者に "Pickup points cannot be loaded right now" と表示される：bpost が応答しなかったか、キーを拒否しました。理由は WooCommerce > Status > Logs（ソース vfd-bpost-cubee）と設定ページに記載されています。プラグインは 5 分後に自動的に再試行します。設定を保存すると、すぐに再試行されます。

この郵便番号または市区町村の受け取りポイントが見つからない：bpost がこの検索に対してポイントを返しませんでした。購入者に近隣の郵便番号または市区町村名を試してもらい、Carrier ID を確認してください。

カンマを含む料金が使われない：5,50 と 5.50 はどちらも受け付けられます。Country prices のうち CC=PRICE の形式に従っていない行は無視されます。保存後のエラーメッセージに、それらの行が一覧表示されます。

料金に税金は含まれていますか？Tax status が Taxable に設定されている場合、WooCommerce は料金に税金を加算します。None の場合、料金は確定額です。

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

アンインストール

プラグインを無効化しても、すべての設定は保持されます。消去されるのは API トークンとキャッシュされた受け取りポイントのリストだけです。削除するには、プラグインを無効化してから Plugins ページで削除してください。このプラグインのライセンスキーとライセンスステータス、API トークン、キャッシュは、常に削除されます。設定とゾーンの配送方法は、Remove data on uninstall がオンだった場合にのみ削除されます。そうでなければ、後で再インストールする際のために保持されます。注文に保存された受け取りポイントは注文履歴であるため、決して削除されません。

bpost は、それぞれの所有者の商標です。本プラグインは bpost と提携しておらず、bpost による承認も受けていません。