VibeFox DPD Pickup for PrestaShop — ヘルプ
要件
PrestaShop: 8.0 から 9.x。
PHP: 8.0 以降。モジュールは古い PHP バージョンではインストールできません。
DPD Baltic の認証情報（リトアニア、ラトビア、エストニア）: 集配ポイントの一覧は DPD Baltic のウェブサービスから取得されます。DPD が法人のお客様に発行する API のユーザー名とパスワードが必要です。DPD の担当アカウントマネージャーまたはお住まいの国の DPD カスタマーサービスにお問い合わせください。1 つのアカウントで、リトアニア、ラトビア、エストニアの集配ポイントを一覧表示できます。
DPD Slovakia: DPD Slovakia の公開 parcelshop 検索は認証情報を必要としません。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. 管理画面で Modules > Module Manager に進み、Upload a module をクリックします。モジュールの ZIP ファイルを選択します。
2. アップロードが完了したら Configure をクリックします。後で確認する場合は、モジュール一覧で VibeFox DPD Pickup を探して Configure をクリックします。
3. Configure ページ上部のライセンスブロックにある License key 欄に VibeFox ライセンスキーを入力し、Activate をクリックします（ライセンスキーを参照）。
4. DPD API を選択します。DPD リトアニア、ラトビア、エストニアの場合は、API のユーザー名とパスワードを入力します。国ごとの料金を確認し、Save をクリックします。次に Refresh pickup points をクリックして接続を確認します（設定を参照）。
インストール時、モジュールは配送時間のテキストが DPD Pickup point or locker の配送業者 DPD Pickup Point を作成します。この配送業者は、スロバキア、リトアニア、ラトビア、エストニアのゾーンとすべての顧客グループに割り当てられ、税ルールは設定されません。ゾーン、顧客グループ、配送時間のテキスト、ロゴ、サイズ制限は Shipping > Carriers で変更できます。ここで料金を設定しないでください。料金は常にモジュールから取得されます。
設定
すべての設定はモジュールページにあります: Modules > Module Manager > VibeFox DPD Pickup > Configure。各セクションには独自の Save ボタンがあり、ページ全体が保存されます。保存するたびに、キャッシュされた集配ポイントの一覧も消去されます。
ページ上部の警告は、DPD Baltic のユーザー名またはパスワードが空の場合、料金が 1 つも設定されていない場合（どちらの場合もチェックアウトで配送業者は表示されません）、配送業者が削除された場合、そして、ショップの重量単位（International > Localization、Local units）をモジュールが認識できない場合（この場合、商品の重量は kg として読み取られます）に表示されます。金額または重量の欄に数値以外の値や負の数を入力しても保存されません。その欄は空になり、警告で欄名が示されます。Country prices のうち CC:PRICE 形式でない行は警告に一覧表示され、無視されます。
一般
Enable/Disable: DPD Pickup のオン／オフを切り替えます。Shipping > Carriers の配送業者のステータスと同じスイッチです。
Name: チェックアウトで購入者に表示される配送業者名。初期値: DPD Pickup Point。必須、最大 64 文字。
Tax status: 配送料に適用される配送業者の税ルール。None は非課税を意味します。他の選択肢では、Taxable とともに、ショップの税ルールの名前が表示されます。
DPD 集配ポイントの一覧
集配ポイントは DPD から読み込まれ、24 時間キャッシュされます。
DPD API: お客様のアカウントを持つ DPD の会社。バルト諸国のアカウントは、それぞれの国のウェブサービスを使用します。
API username (Baltic): DPD Baltic ウェブサービスのユーザー名です。DPD Slovakia では不要です。この欄を消去すると、保存されたパスワードも消去されます。
API password (Baltic): DPD Baltic ウェブサービスのパスワードです。DPD Slovakia では不要です。保存後、この欄は空のままになり、Saved - leave empty to keep it. と表示されます。変更する場合にのみ新しい値を入力してください。
Pickup points: Refresh pickup points ボタンはキャッシュを消去し、今すぐ DPD から集配ポイントを読み込みます。Baltic API の場合はリトアニア、ラトビア、エストニアを、DPD Slovakia の場合はブラチスラバでのテスト検索を行います。国ごとに集配ポイントの件数またはエラーが表示されます。先に設定を保存してください。
料金
配送料は国ごとの固定料金で、ショップの既定通貨、税抜きです。DPD の料金は API から取得されません。
Country prices: 国ごとに 1 行、CC:料金の形式で入力します（例: 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 集配ポイントおよびロッカーの荷物制限を確認してください。Min weight (kg) が Max weight (kg) より大きい場合は拒否され、何も保存されません。
Minimum subtotal: 注文の小計（割引後、税抜き）がこの金額以上の場合にのみ配送業者を表示します。空のままにすると、常に表示されます。
Ignore shipping zones: オンにすると、配送業者はすべてのゾーンに関連付けられ、下記の国に対して提供されます。後から作成したゾーンもすぐに関連付けられます。オフにすると、配送業者は Shipping > Carriers で設定されたゾーンでのみ提供されます。オフにすると、配送業者は以前のゾーンに戻ります。
Countries: このモードの配送先の国です。すべての国を対象とする場合は空のままにします。Ignore shipping zones を使用している場合にのみ使われます。
集配ポイントセレクター
City order: 主要な都市（タリン、リガ、ヴィリニュス、ブラチスラバなど）を先に表示します。初期設定ではオンです。
City list width: 都市一覧の CSS の幅です（例: 100% や 300px）。初期値: 100%。
Pickup point list width: 集配ポイント一覧の CSS の幅です（例: 100% や 400px）。初期値: 100%。
詳細設定
Debug log: API のリクエストとチェックアウトの手順を、モジュールフォルダ内の logs/vfd_dpd_debug.log.php に書き込みます。このファイルは Web から開くことはできません。この設定がオフでも、API のエラーは常に記録されます。認証情報は一切記録されません。
Log: デバッグログのサイズと最新のエントリを表示します。Clear log をクリックすると空になります。
Remove data on uninstall: オンにすると、モジュールをアンインストールしたときに、モジュールの設定と配送業者が削除されます。注文に保存された集配ポイントは常に残ります。
チェックアウトでの動作
配送のステップで、PrestaShop はモジュールに DPD Pickup の料金を問い合わせます。対象となるのは実物の商品のみです。バーチャル商品は重量に加算されず、小計にも含まれません。モジュールは、国（Ignore shipping zones の場合）、カートの重量、最小小計を確認し、その国の料金（または代替料金）を取得して、小計が十分であれば送料無料を適用します。その後、住所に対応する DPD の集配ポイントを読み込みます。DPD がポイントを 1 つも返さない場合、接続できない場合、または Baltic の認証情報がない場合は、配送業者が非表示になります。料金はショップの既定通貨で計算され、その後、購入者のカートの通貨で表示されます。
集配ポイントの一覧は 24 時間、空の一覧は 1 時間キャッシュされます。失敗したリクエストは 5 分間記憶されるため、DPD の障害によってチェックアウトが遅くなることはありません。API のタイムアウトは 15 秒です。
注文がある配送業者を Shipping > Carriers で編集すると、PrestaShop はそれを新しいバージョンの配送業者として保存します。モジュールは新しいバージョンに自動的に追従します。
モジュールは、DPD の料金の取得、DPD の配送の作成、ラベルの印刷、マニフェストの作成、集荷の依頼、荷物の追跡、地図の表示は行いません。サポートされているのは DPD Baltic のウェブサービスと DPD Slovakia の parcelshop 検索のみです。
集配ポイント
購入者が DPD Pickup を選択すると、配送業者の下に都市の一覧と集配ポイントの一覧が表示されます。購入者の住所の都市が初期選択されています。購入者が選択すると、その選択はすぐにカートに保存されます。DPD Slovakia では、住所の入力が完了するまで、購入者には Enter your city and postcode to see the DPD pickup points nearby. が表示されます。その後、近くの集配ポイントが表示されます。DPD がその住所のポイントを持っていない場合、購入者には No DPD pickup points are available for this address right now. Please check the address or choose another shipping method. が表示されます。
集配ポイントの選択は必須です。選択しないと購入者は先に進めず、Please select a DPD pickup point. と表示されます。サーバーは、そのポイントが購入者の住所に対する DPD の一覧に含まれていることを確認します。改ざんされた選択や古い選択は、The selected DPD pickup point is not available for this address. Please choose another one. と表示されて拒否されます。
選択された集配ポイントは注文に保存されます。注文確認ページと購入者の注文詳細には DPD pickup point: として表示されます。注文確認メールでは、配送業者名の後に追加されます。ショップに届く新規注文メール（ps_emailalerts）にも、ポイントの ID が表示されます。注文に保存される名称は、ブラウザではなく DPD から取得されます。
管理画面の注文ページでは、DPD pickup point ブロックにポイント名、ID、国が表示されます。Edit をクリックして都市と別のポイントを選択し、Save をクリックします。ポイントは注文の住所に対する DPD の一覧で確認され、ページには Pickup point updated. または Pickup point not found for the order address. が表示されます。ポイントを変更するには、Modules ページへのアクセスではなく、注文を編集する権限が必要です。変更はすべて、注文の Advanced Parameters > Logs に、変更前のポイント、変更後のポイント、担当者と共に記録されます。DPD Slovakia でポイントを変更するには、注文に配送先の都市と郵便番号が必要です。
1 つのカートが複数の注文に分割された場合、集配ポイントは最初の注文に残ります。他の注文には No pickup point was selected for this order. と表示され、デバッグログには各注文のエラーが記録され、そこにある Edit では The pickup point of this cart belongs to another order of the same cart. Nothing was changed. と表示されます。このような注文のポイントは、手動で DPD に伝える必要があります。
ライセンスキー
モジュールは、vibefox.net で入手した VibeFox ライセンスキーで動作します。ライセンスブロック License — VibeFox DPD Pickup は、Modules > Module Manager > VibeFox DPD Pickup > Configure の最初のブロックで、設定の上にあります。キーを License key に入力し、Activate をクリックしてください。その後、ブロックにはキーがマスク表示され、ステータス（ライセンスの有効期限日やドメインなど）が表示されます。また、ステータスを再確認する Check now、別のキーを入力する Change key、このショップからキーを削除する Remove key のボタンが表示されます。その下には、行 Product: presta-shipping-dpd-pickup と、vibefox.net のアカウントを開くリンク Manage licenses and domains in your account があります。キーを変更できるのは、モジュールの Configure 権限を持つ従業員のみです。ブロックのテキストは管理画面の言語に従います（英語とロシア語が含まれます）。
キーが受け付けられない場合、ブロックにその理由が表示されます（例: Key not found、This key belongs to another product、Domain limit reached、License expired on と日付）。ショップの住所を変更した後、またはアカウントでドメイン枠を解放した後は、Check now をクリックしてください。ライセンスサーバーに接続できない場合、モジュールは最後に確認できたステータスで動作を続けます。
1 つのキーは 1 つのドメインで機能します。メインショップのドメインで、マルチストア構成でも同様です。ショップからキーを削除しても、ドメイン枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、DPD Pickup 配送業者はチェックアウトで顧客に表示されず、料金も計算されません。PrestaShop のストアフロントは、バックオフィスにログインしていることを認識しないため、配送業者はあなたに対しても非表示になります。キーを購入する前にモジュールを設定することはできますが、チェックアウトでテストすることはできません。Modules > Module Manager の Alerts タブにリマインダーが表示されます。既存の注文には影響しません。
ライセンスの有効期限が切れてもモジュールは動作を続けますが、アップデートとサポートには更新が必要です。バックオフィスで作業している間、ステータスは自動的に再確認されます。キー入力後の最初の 14 日間は 1 日 1 回、その後は週 1 回です。cron ジョブは不要です。モジュールをアンインストールまたはリセットすると、ライセンスキーとライセンスステータスは必ず削除されます。
トラブルシューティング
チェックアウトに DPD Pickup が表示されない: ライセンスが有効であることと、Enable/Disable がオンであることを確認してください。Shipping > Carriers で、配送業者が購入者の国のゾーンと顧客グループをカバーしていることを確認してください（または Ignore shipping zones がオンで、その国が許可されていることを確認してください）。モジュールページ上部の警告を確認し、Refresh pickup points をクリックしてください。重量と小計の制限、およびその国に料金（または代替料金）が設定されていることを確認してください。商品ページで、商品が特定の配送業者に限定されている場合もあります。
Refresh pickup points の後にエラーが表示される: 結果には国ごとの DPD エラーが表示されます。例えば "Login failed" は、DPD が Baltic の認証情報を拒否したことを意味し、そのため集配ポイントを読み込めません。DPD で API のユーザー名とパスワードを確認してください。
DPD Slovakia にポイントが表示されない: 購入者が都市と郵便番号を入力すると、ポイントが表示されます。DPD は、その住所から 50 km 以内のポイントのみを一覧表示します。開発者は、モジュールのフック actionVfdDpdSkSearchRadius で範囲を変更できます。
原因を特定する: Debug log をオンにして、チェックアウトを再読み込みし、モジュールページの Log 欄を確認してください。すべての判断がそこに記録されます。API のエラーは常に記録されます。API のユーザー名とパスワードがログに書き込まれることはありません。
変更後に集配ポイントが古く見える: モジュールページで Save または Refresh pickup points をクリックしてください。どちらもキャッシュされた一覧を消去します。
ページに DPD Pickup 配送業者が見つからないと表示される: Shipping > Carriers で配送業者が削除されています。Modules > Module Manager でモジュールをリセットすると、再度作成されます。
アンインストール
Modules > Module Manager に進み、VibeFox DPD Pickup の横にあるメニューを開いて、Uninstall を選択します。ライセンスキー、ライセンスステータス、集配ポイントのキャッシュは常に削除されます。Remove data on uninstall がオンの場合、配送業者は削除され（注文は履歴を保持します）、設定、ログ、未完了カートの選択も削除されます。オフの場合、配送業者は無効になるだけで、すべての設定は保持されます。モジュールを再インストールすると、または Reset を実行すると、保存されていた配送業者は以前のステータスに戻ります。以前に無効にした配送業者は、無効のままです。注文に保存された集配ポイントが削除されることはありません。
DPD は、それぞれの所有者の商標です。本モジュールは DPD と提携しておらず、DPD による推奨も受けていません。