VibeFox PostNL for WooCommerce — ヘルプ

要件

WordPress: 5.8 以降。

WooCommerce: 7.0 以降、インストールおよび有効化済みであること。WooCommerce がないとプラグインは有効化できません。

PHP: 8.0 以降。

PostNL API キー（ピックアップポイントのみ）: ピックアップポイントは PostNL Checkout API から読み込まれます。PostNL のビジネス顧客は、Mijn PostNL の My account > API beheren で API キーを確認できます。PostNL サンドボックスには、別のサンドボックスキーが必要です。自宅への配送方法ではキーは不要です。

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

インストール

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

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

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

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

5. 料金を入力します。ピックアップポイントの場合は、PostNL の API key と Ship from (postcode) も入力します（設定の項目を参照）。

6. WooCommerce > Settings > Shipping > Shipping zones で、配送ゾーン（例：オランダとベルギー）に VibeFox PostNL を追加します。ゾーンで Title と Delivery to を設定します。もう一方の配送タイプを提供するには、同じ方法をもう一度追加します。

設定

タイトルと配送タイプを除くすべての設定は、1 つのページにあります：WooCommerce > Settings > Shipping > VibeFox PostNL。これらの設定はすべての配送ゾーンに適用されます。方法をゾーンに追加すると、ゾーンのウィンドウに 2 つのフィールドが表示されます：

Title (zone): このゾーン方法で購入者に表示される名前。空欄にすると、グローバルの Name が使われます。

Delivery to (zone): As in the global settings（デフォルト）、PostNL pickup point (customer chooses a point)、または Home address。両方を提供するには、同じ方法を 1 つのゾーンに 2 回追加します。

設定の上には警告が表示されます：ピックアップポイントの API キーや発送元郵便番号の未入力、サンドボックスの有効化、料金未設定、そして最後に失敗した PostNL リクエストの日時とエラーです。

一般

Enable/Disable: すべてのゾーンで PostNL 配送を一括で有効または無効にします。

Name: チェックアウトに表示される配送方法の名前です。ゾーンで設定した Title があれば、そちらが優先されます。デフォルト: PostNL。

Delivery to: As in the global settings を使うゾーン方法と、Ignore zones モードでのデフォルトの配送タイプです。

Tax status: Taxable は配送料に WooCommerce の税金を加算し、None は加算しません。

PostNL API（ピックアップポイント）（自宅への配送には不要）

API key: Mijn PostNL（My account > API beheren）で取得した PostNL の API キーです。"apikey" ヘッダーで PostNL に送信され、WordPress のデータベースに保存されます。購入者に表示されることも、ログに書き込まれることもありません。

Sandbox: PostNL サンドボックス（api-sandbox.postnl.nl）とサンドボックス用 API キーを使用します。その場合、購入者にはテスト用のピックアップポイントが表示されます。本番ストアでは無効のままにしてください。

Ship from (country): 荷物を PostNL に引き渡す国です。オランダまたはベルギーを選びます。デフォルトはストアの国です。PostNL は集荷日の算出に発送元住所を使用します。

Ship from (postcode): 発送元の郵便番号です。例：オランダなら 1234AB、ベルギーなら 1000。ストアが同じ国にある場合は、空欄にすると WooCommerce > Settings > General のストア郵便番号が使われます。無効な郵便番号は、メッセージとともに拒否されます。API キー、サンドボックス設定、発送元住所を変更すると、キャッシュされたピックアップポイントの一覧は消去されます。

料金（ストアの通貨で）

PostNL には公開されたレート API がないため、本プラグインはリアルタイムの料金を取得せず、料金を換算することもありません。

Price per country: 配送先の国ごとに 1 行です。+ Add country をクリックすると行を追加し、×印をクリックすると削除できます。独自の行がないすべての国を対象とする行には、* All other countries を選びます。各行には Price があり、カートの重量に応じた重量クラスを任意で設定できます：XS は 1 kg まで、S は 2 kg まで、M は 3 kg まで、L は 5 kg まで、XL は 5 kg を超える場合です。重量クラスの料金は Price より優先されます。空欄にすると Price が使われます。Price を 0 にすると送料無料になります。"6.95" と "6,95" のどちらも受け付けます。空の行と無効な国コードは、保存時に削除されます。同じ国が 2 回出てくる場合は、最初の行が保持されます。無効な料金は、メッセージとともに無視されます。

Calculation: Per order は料金を 1 回だけ請求します。Per item (price x quantity) は、カート内の配送可能な商品の数を掛けた金額を請求します。

Price for other countries: 料金表に、その国も * の行もない場合に使われます。空欄にすると、その地域では方法を非表示にします。

条件

Free shipping from: 送料が無料になるカート小計です。料金が見つかった場合にのみ適用されます。空欄にすると、送料無料は提供されません。

Minimum subtotal: カート小計がこの金額以上の場合にのみ、方法を表示します。空欄にすると常に表示します。

Minimum weight (kg): カートの重量がこれより軽い場合、方法を非表示にします。商品の重量は、ストアの単位から換算されます。空欄にすると制限はありません。

Maximum weight (kg): これより重いカートでは、方法を非表示にします。デフォルト: 30（PostNL の荷物はベネルクスで最大 30 kg まで）。空欄にすると制限はありません。

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

すべての金額と重量は、小数点としてカンマも受け付けます。千の位の区切り記号を含めることもできます（1.234,50 または 1,234.50）。無効な数値は、メッセージとともに無視されます。

配送ゾーンがない場合の提供

Ignore zones: どのゾーンも PostNL を追加していない場合に、下に指定した国でも PostNL を提供します。方法を含むゾーンは、通常どおり機能します。このモードでは、グローバルの Name と Delivery to を使用します。

Countries: このモードの配送先の国です。空欄にすると、ストアが配送するすべての国が使われます。このフィールドは、Ignore zones が有効な場合にのみ使用されます。

詳細設定

Debug log: デバッグメッセージを WooCommerce > Status > Logs（ソース "vfd-postnl"）に書き込みます。API エラーは常に記録されます。API キーや購入者のデータは書き込まれません。作業が終わったら、ログを無効にしてください。

Remove data on uninstall: 有効にすると、プラグインを削除したときに PostNL の設定とゾーン方法が削除されます。プラグインを無効化しても、設定は削除されません。注文に保存されたピックアップポイントは、常に保持されます。

チェックアウトでの動作

購入者が配送先住所を入力すると、WooCommerce がプラグインに料金を問い合わせます。プラグインは条件を確認します：カートの重量、最低小計、配送クラスです。次に、国と重量クラスに対応する料金表の金額を取得します。その他の国向けの料金を使う場合もあります。料金がない場合、方法は非表示になります。カート小計が Free shipping from に達すると、料金は 0 になります。

ピックアップポイントの方法は、オランダとベルギーの住所に対してのみ、API キーがある場合にのみ提供されます。購入者が有効な郵便番号を入力すると、プラグインは PostNL Checkout API に最寄りのピックアップポイントを問い合わせます。送信されるのは、購入者の郵便番号、番地、建物番号、市区町村、国と、発送元住所です。自宅への配送方法では何も送信されません。PostNL に接続できない場合、または住所にポイントがない場合、ピックアップポイントの方法は非表示になり、他の方法は引き続き利用できます。API のタイムアウトは 12 秒です。

ポイントの一覧は郵便番号ごとに 6 時間キャッシュされ、「ポイントなし」の応答は 1 時間キャッシュされます。失敗したリクエストは 10 分間キャッシュされるため、障害が発生してもチェックアウトの更新ごとに遅くなることはありません。最後のエラーは設定画面に表示されます。

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

本プラグインは PostNL のリアルタイム料金を取得せず、配送ラベル、バーコード、track and trace、返品、事前通知を作成しません。配達日、夜間配達、午前配達のオプションもありません。保存されたピックアップポイントを使って、Mijn PostNL または他の PostNL ツールで発送を作成してください。

ピックアップポイント

購入者がピックアップポイントの方法を選択すると、その下に PostNL pickup point のリストが表示されます。最寄りの 3 つのポイントを、会社名、住所、距離とともに表示します。郵便番号を入力する前は、購入者に「PostNL のピックアップポイントを表示するには、郵便番号を入力してください（例：1234 AB）。」というメッセージが表示されます（ベルギーの場合は 4 桁）。選択内容は、チェックアウトが更新されても保持されます。

ポイントの選択は必須です。選択しないと、チェックアウトは「PostNL のピックアップポイントを選択してください。」というメッセージで止まります。サーバーは、ポイントが配送先住所について PostNL のリストにあるかを確認します。リストにない場合、チェックアウトは「選択された PostNL のピックアップポイントは、この住所では利用できません。もう一度選択してください。」というメッセージで止まります。注文とともに保存される名前と住所は、ブラウザではなく PostNL から取得されます。

管理画面の注文画面: 配送先住所の下に、PostNL pickup point として名前と住所、および Location code を表示します。

注文受付ページとマイアカウントの注文表示: PostNL pickup point として名前と住所を表示します。

注文メール: HTML メールとテキストメールに、ポイントの名前と住所を表示します。

データベースでは、ポイントは注文のメタデータに保存されます：_vfd_ptnl_servicepoint_id（PostNL のロケーションコード）、_vfd_ptnl_servicepoint_name（名前と住所）、_vfd_ptnl_servicepoint（パートナー ID、会社、番地、建物番号、郵便番号、市区町村、国）。

ライセンスキー

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

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

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

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

トラブルシューティング

チェックアウトに PostNL が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、購入者の国のゾーンに方法が追加されていること（または Ignore zones がオンで、その国が許可されていること）を確認してください。その国の料金、重量制限、Minimum subtotal、Hide for shipping classes も確認します。

ピックアップポイントの方法が表示されない: オランダとベルギーの住所に対してのみ、API キー、発送元郵便番号、料金がある場合にのみ表示され、さらに購入者の郵便番号に対して PostNL がポイントを返した場合にのみ表示されます。設定画面の上部の警告と、WooCommerce > Status > Logs（ソース "vfd-postnl"）を確認してください。エラーは常に記録されます。詳細を見るには Debug log をオンにしてください。

「現在 PostNL のピックアップポイントを読み込めません」: PostNL に接続できない、PostNL が API キーを拒否した、または発送元郵便番号が未入力です。設定画面に最後のエラーが表示されます。サンドボックスのキーは Sandbox がオンのときのみ、本番のキーはオフのときのみ有効です。

購入者にテスト用のピックアップポイントが表示される: Sandbox をオフにしてください。

開発者向けフィルター: vfd_ptnl_number_of_locations（デフォルト 3）、vfd_ptnl_checkout_request（リクエストの本文）、vfd_ptnl_api_url。

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

アンインストール

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

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