VibeFox DPD Pickup for WooCommerce — ヘルプ
要件
WordPress: 5.8 以降。
WooCommerce: 7.0 以降。インストールされ、有効になっている必要があります。WooCommerce がないとプラグインを有効化できません。
PHP: 8.0 以降。
DPD Baltic の認証情報（リトアニア、ラトビア、エストニア）: 集配ポイントの一覧は DPD Baltic のウェブサービスから取得されます。DPD が法人のお客様に発行する API のユーザー名とパスワードが必要です。DPD の担当アカウントマネージャーまたはお住まいの国の DPD カスタマーサービスにお問い合わせください。1 つのアカウントで、リトアニア、ラトビア、エストニアの集配ポイントを一覧表示できます。
DPD Slovakia: DPD Slovakia の公開 parcelshop 検索は、認証情報を必要としません。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin に移動し、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_dpd_pickup フォルダを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます: WooCommerce > Settings > Shipping > VibeFox DPD Pickup。または、Plugins ページでプラグイン名の下にある Settings をクリックします。
4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。
5. DPD API を選択します。DPD リトアニア、ラトビア、エストニアの場合は、API のユーザー名とパスワードを入力します。国ごとの料金を入力して保存します。Refresh pickup points をクリックすると、接続を確認できます（設定の項を参照）。
6. WooCommerce > Settings > Shipping > Shipping zones で、配送ゾーンに VibeFox DPD Pickup を追加するか、Ignore shipping zones をオンにします。
設定
すべての設定は 1 つのページにあります: WooCommerce > Settings > Shipping > VibeFox DPD Pickup。これらの設定はすべての配送ゾーンに適用されます。配送方法をゾーンに追加すると、ゾーンのウィンドウには項目が 1 つだけ表示されます:
Title (zone): このゾーンでチェックアウト時に表示されるこのオプションの名前。空欄にすると、全体の Name が使用されます。
設定の上の警告は、DPD Baltic のユーザー名またはパスワードが空の場合と、料金が設定されていない場合に表示されます。設定を保存するたびに、集配ポイントのキャッシュがクリアされます。
一般
Enable/Disable: すべてのゾーンでこの配送方法をオンまたはオフにします。
Name: チェックアウトに表示される配送方法の名前。初期値: DPD Pickup Point。
Tax status: Taxable は配送料に WooCommerce の税金を加算します。None は加算しません。
DPD 集配ポイントの一覧
集配ポイントは DPD から読み込まれ、24 時間キャッシュされます。
DPD API: お客様のアカウントがある DPD の会社です。Baltic のアカウントは、それぞれの国のウェブサービスを使用します。
API username (Baltic): DPD Baltic のウェブサービスのユーザー名です。DPD Slovakia では不要です。
API password (Baltic): DPD Baltic のウェブサービスのパスワードです。DPD Slovakia では不要です。
Pickup points: Refresh pickup points ボタンは、キャッシュをクリアして、DPD から集配ポイントを今すぐ読み込みます。Baltic API では、リトアニア、ラトビア、エストニアが対象です。DPD Slovakia では、ブラチスラバでテスト検索を行います。結果は国ごとに表示されます。先に設定を保存してください。
料金
配送料は、ストアの通貨で国ごとに固定されています。DPD の料金は API から取得しません。
Country prices: 国ごとに 1 行、CC:price の形式で入力します（例: EE:3.50）。小数点区切りの「,」も使用できます。初期値: SK:3.50、LT:4.00、LV:4.00、EE:4.00。
Fallback cost: Country prices に含まれない国の料金です。初期値: 5.00。空欄にすると、リストにある国でのみこの配送方法を提供します。
Calculation type: Per order は料金を 1 回だけ請求します。Per item (price x quantity) は、カート内の商品数を掛けた金額を請求します。
Free shipping from: 注文の小計（クーポン適用後）がこの金額に達すると、配送料は無料になります。空欄にするとこの機能は無効になります。
提供条件
DPD が購入者の住所に対して集配ポイントを返さない場合、または DPD API に接続できない場合も、この配送方法は非表示になります。集配ポイントがない注文は配送できないためです。
Min weight (kg): カートの最小重量です。商品の重量は、ストアの重量単位から換算されます。空欄または 0 の場合は制限なしです。
Max weight (kg): これより重いカートには、この配送方法は表示されません。初期値: 31.5。0 の場合は制限なしです。お住まいの国の DPD Pickup の集配ポイントと宅配ロッカーの荷物の制限を確認してください。
Minimum subtotal: 注文の小計がこの金額以上の場合にのみ、この配送方法を表示します。空欄にすると常に表示されます。
Excluded shipping classes: カートに、これらの WooCommerce 配送クラスのいずれかに属する商品が含まれている場合、この配送方法は非表示になります。
Ignore shipping zones: 購入者の配送ゾーンにこの配送方法が含まれていない場合でも、下に記載する国については提供します。オフの場合は、通常どおり配送ゾーンに配送方法を追加します。
Countries: このモードの配送先の国です。空欄の場合はすべての国が対象です。Ignore shipping zones と組み合わせる場合にのみ使用されます。
集配ポイントセレクター
City order: 主要な都市（タリン、リガ、ヴィリニュス、ブラチスラバなど）を先に表示します。初期値はオンです。
City list width: 都市の一覧の CSS の幅です（例: 100% または 300px）。初期値: 100%。
Pickup point list width: 集配ポイントの一覧の CSS の幅です（例: 100% または 400px）。初期値: 100%。
詳細設定
Debug log: API のリクエストとチェックアウトの手順を WooCommerce > Status > Logs に記録します。ソースは vfd-dpd-pickup です。このオプションがオフでも、API のエラーは常に記録されます。認証情報は一切記録されません。
Remove data on uninstall: オンの場合、プラグインを削除すると、その設定と配送ゾーンの配送方法が削除されます。無効化しても設定は削除されません。注文に保存された集配ポイントは、常に保持されます。
チェックアウト時の動作
購入者が配送先住所を入力すると、WooCommerce はプラグインに料金を問い合わせます。プラグインはカートの重量、最小小計、除外された配送クラスを確認し、その国の料金（または代替料金）を取得します。小計が十分に高い場合は、送料無料を適用します。その後、住所に対応する DPD の集配ポイントを読み込みます。DPD がポイントを 1 つも返さない場合、接続できない場合、または Baltic の認証情報が不足している場合、この配送方法は非表示になります。
集配ポイントの一覧は 24 時間キャッシュされます。失敗したリクエストは 5 分間記憶されるため、DPD の障害によってチェックアウトが遅くなることはありません。API のタイムアウトは 15 秒です。
この配送方法は、クラシックチェックアウトとカートブロック、チェックアウトブロックで動作します。WooCommerce の高性能注文保存（HPOS）に対応しています。
プラグインは、DPD への料金の問い合わせ、DPD の配送の作成、ラベルの印刷、マニフェストの作成、宅配便の集荷依頼、荷物の追跡、地図の表示は行いません。サポートされているのは、DPD Baltic のウェブサービスと DPD Slovakia の parcelshop 検索のみです。
集配ポイント
購入者が DPD Pickup を選択すると、配送方法の下に都市の一覧と集配ポイントの一覧が表示されます。購入者の住所の都市が初期選択されています。DPD Slovakia の場合、購入者はまず都市と郵便番号を入力し、その後、近くのポイントが表示されます。集配ポイントの選択は必須です。サーバーは、そのポイントが購入者の国と住所に属していることを確認するため、偽造されたものや古い選択は拒否されます。
選択された集配ポイントは注文に保存されます。注文画面の配送先住所の下、サンキューページ、My account > Orders、注文メール（HTML とプレーンテキスト）に、DPD pickup point として表示されます。注文に保存される名称は、ブラウザではなく DPD から取得されます。
注文画面で、集配ポイントの横にある Edit をクリックし、都市と別のポイントを選択します。ポイントは、注文の住所に対する DPD の一覧と照合されます。集配ポイントを変更するには、注文に配送先の都市と郵便番号が必要です。
ライセンスキー
プラグインは、vibefox.net で入手した VibeFox ライセンスキーで動作します。ライセンスブロックは WooCommerce > Settings > Shipping > VibeFox DPD Pickup の上部にあります。キーを License key に貼り付け、Activate をクリックします。ブロックには、ライセンスの有効期限日やお使いのドメインなど、ステータスが表示されます。Check now でステータスを再確認、Change key で別のキーを入力、Remove key でこのサイトからキーを削除できます。Manage licenses and domains in your account のリンクから vibefox.net のアカウントを開きます。
1 つのキーは 1 つのドメインでのみ使用できます。サイトからキーを削除しても、ドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、DPD Pickup はチェックアウト時に購入者に表示されません。ログイン中のストア管理者には、(unlicensed — visible to admins only) と表示されて見えるため、キーを購入する前にプラグインを設定してテストできます。プラグインページと WooCommerce のページには、通知が表示されます。既存の注文には影響しません。
ライセンスの期限が切れても、プラグインは動作を続けますが、アップデートとサポートを利用するには更新が必要です。ステータスは、バックグラウンドで自動的に再確認されます。
トラブルシューティング
DPD Pickup がチェックアウトに表示されない: ライセンスが有効であること、Enable/Disable がオンであること、購入者の国の配送ゾーンに配送方法が追加されていること（または Ignore shipping zones がオンで、その国が許可されていること）を確認してください。設定ページ上部の警告を確認し、Refresh pickup points をクリックしてください。重量と小計の制限、除外された配送クラス、その国に料金（または代替料金）が設定されているかを確認してください。
Refresh pickup points の後の「Login failed」: DPD が Baltic の認証情報を拒否したため、集配ポイントを読み込めません。API のユーザー名とパスワードを DPD で確認してください。
DPD Slovakia にポイントが表示されない: ポイントは、購入者が都市と郵便番号を入力した後に表示されます。DPD は、その住所から 50 km 以内のポイントのみを一覧表示します。
原因を特定する: Debug log をオンにしてください。すべての判断が WooCommerce > Status > Logs に、ソース vfd-dpd-pickup で記録されます。API のエラーは常に記録されます。API のユーザー名とパスワードは、ログに書き込まれることはありません。
ライセンスブロックにエラーが表示される: ブロック内のメッセージに従ってください。たとえば、そのキーが別のドメインで使用中の場合は、vibefox.net のアカウントで枠を解放し、Check now をクリックしてください。サイトのアドレスが変わった場合は、Check now をクリックして、新しいドメインでキーを有効化してください。ライセンスサーバーに接続できない場合、プラグインは最後に確認された状態で動作を続けます。
アンインストール
プラグインを無効化しても、すべての設定は保持されます。無効化で削除されるのは、集配ポイントのキャッシュのみです。プラグインを削除するには、Plugins ページで無効化してから削除してください。このプラグインのライセンスキーとライセンスステータス、および集配ポイントのキャッシュは、常に削除されます。設定と配送ゾーンの配送方法は、Remove data on uninstall がオンだった場合にのみ削除されます。そうでなければ、後で再インストールできるように残ります。注文に保存された集配ポイントは削除されることはなく、既存の注文は配送の行を保持します。
DPD は、各所有者の商標です。本プラグインは DPD と提携しておらず、DPD による推奨も受けていません。