VibeFox DHL Packstation for PrestaShop — ヘルプ
要件
PrestaShop：8.0 〜 9.x。Classic と Hummingbird のテーマに対応しています。
PHP：8.0 以降。古い PHP バージョンではモジュールのインストールを拒否します。
DHL API key：受取場所の一覧は、無料の DHL Location Finder API から取得されます。DHL 開発者ポータル（developer.dhl.com）に登録し、アプリを作成して「Location Finder - Unified」API を追加し、アプリの API キーをコピーしてください。この API に DHL の法人契約は不要です。キーがないと、チェックアウトで配送業者は表示されません。DHL アプリのリクエスト上限に注意してください。郵便番号や都市を新しく検索するたびに、API リクエストが 1 回ずつ消費されます。
VibeFox license key：vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. 管理画面で Modules > Module Manager を開き、Upload a module をクリックします。モジュールの ZIP ファイルを選択します。
2. アップロードが完了したら Configure をクリックします。後で探す場合は、モジュール一覧から VibeFox DHL Packstation を見つけて Configure をクリックします。
3. Configure ページ上部のライセンスブロックで、License key に VibeFox ライセンスキーを入力し、Activate をクリックします（「ライセンスキー」を参照）。
4. DHL API キーを貼り付けて Save をクリックし、続けて Test API key をクリックします。受取場所の種類を選び、国ごとの料金を入力します（「設定」を参照）。
インストール時に、モジュールは配送時間のテキスト Delivery to a DHL Packstation or post office を持つ配送業者 DHL Packstation を作成します。この配送業者は有効になり、すべての顧客グループと、既定の料金表の国であるドイツとオーストリアのゾーンに割り当てられます。ゾーン、顧客グループ、配送時間、ロゴ、サイズ制限は Shipping > Carriers で変更できます。料金はここで設定しないでください。料金は常にモジュールから取得されます。
設定
すべての設定はモジュールのページにあります：Modules > Module Manager > VibeFox DHL Packstation > Configure。各セクションには独自の Save ボタンがあり、ページ全体が保存されます。項目にエラーがある場合（無効な数値やマイナスの値、Min weight (kg) が Max weight (kg) より大きい、名前が 64 文字を超える）、何も保存されず、エラーがページ上部に表示されます。保存のたびに受取場所のキャッシュは消去されます。
設定の上の警告は次の場合に表示されます：配送業者が見つからない場合、ショップの重量単位（International > Localization、Local units）をモジュールが認識できない場合（この場合、重量は kg として読み取られます。kg、g、lb、oz のいずれかを使用してください）、DHL API キーが空の場合、受取場所の種類が 1 つも有効になっていない場合、国別料金の項目が CC:PRICE 形式になっていない場合（これらの項目は無視されます）。
一般
配送業者の顧客グループ、ゾーン、サイズ制限は Shipping > Carriers で設定します。以下の設定はすべてのゾーンに適用されます。
Enable/Disable：配送業者をオンまたはオフにします。Shipping > Carriers にある配送業者のステータスと同じスイッチです。
Name：購入者に表示される配送業者名。初期値：DHL Packstation。必須、最大 64 文字。
Tax：配送業者の税ルール、または No tax。PrestaShop は下記の料金にこの税を加算します。No tax の場合、料金は確定価格になります。
DHL Location Finder API
DHL API key：developer.dhl.com 上のアプリの「API Key」。これがないと、チェックアウトで配送業者は表示されません。保存後、この欄は空のままになり、Saved - leave empty to keep it. と表示されます。値を変更したい場合にのみ新しい値を入力してください。
Remove the saved API key：このチェックボックスをオンにして保存すると、保存済みのキーが削除されます。
Connection test：Test API key ボタンは、保存済みのキーで 53113 Bonn 付近の受取場所を検索し、受取場所のキャッシュを消去します。先に設定を保存してください。見つかった受取場所の数、DHL がキーを拒否したこと（401/403）、または API が正しく応答しなかったこと（詳細はデバッグログ）が表示されます。
受取場所
チェックアウトでは、購入者は配送先の郵便番号の近くにある受取場所を見ることができ、別の郵便番号や都市を検索することもできます。
Location types：購入者が選べる DHL の受取場所：Packstation (parcel locker)、Post Office (Postfiliale)、DHL Parcel Shop (Paketshop)。初期値では 3 つすべてが選択されています。1 つも選択されていない場合、配送業者は表示されません。Packstation の場合、購入者は DHL Postnummer を入力する必要があります。
Search radius (meters)：検索した郵便番号または都市の周囲の半径。初期値：5000。整数です。100 未満または 25000 m（DHL の上限）を超える値は、その上限に設定されます。
Max results：1 回の検索で表示される受取場所の最大数。初期値：20。整数です。DHL の上限は 50 で、それより大きい値は 50 に減らされます。
Shipping address：選択した受取場所を注文の配送先住所として使用します。初期値はオンです。住所の 1 行目は、たとえば「Packstation 105」（Post Office や Parcel Shop の場合は「Postfiliale 502」）になります。2 行目は番号付きの「Postnummer」で、受取場所の郵便番号、都市、国が加わります。これにより、注文から印刷したラベルが正しい場所に届きます。氏名、会社名、電話番号は購入者の住所から取得されます。新しい住所は注文だけで使用され、購入者のアドレス帳には表示されません。
料金（セクションのタイトルにショップの既定通貨が表示されます）
Country prices：配送先の国ごとの料金。ショップの既定通貨、税抜き、CC:PRICE 形式で、カンマまたは改行で区切ります。初期値：DE:4.99, AT:5.99。小数点のカンマも使用できます（DE:4,99）。
Other countries：Country prices に含まれない配送先の国の料金。初期値：5.99。その国で配送業者を非表示にする場合は空欄にします。
Calculation：Per order は料金を 1 回だけ請求します。Per item (price x quantity) は、カート内の商品数を掛けた料金を請求します。
Free shipping from：この配送が無料になるカートの小計（配送が必要な商品、割引後、税前）。一度も無料にしない場合は空欄にします。
提供条件
Min weight (kg)：カートの最小重量。商品の重量は、ショップの重量単位から換算されます。0 は上限なしを意味します。
Max weight (kg)：カートの重量がこの値を超えると、配送業者は表示されません。初期値：31.5。Packstation は最大 31.5 kg までの荷物を受け付けるためです。0 は上限なしを意味します。
Minimum subtotal：カートの小計（配送が必要な商品、割引後、税前）がこの値以上の場合にのみ、配送業者を表示します。空欄にすると常に表示されます。
Ignore shipping zones：オンにすると、配送業者は（後から作成されたものも含め）すべての有効なゾーンに関連付けられ、下に指定した国に提供されます。リストが空の場合は、すべての国に提供されます。再びオフにすると、配送業者は以前のゾーンを取り戻します。
Countries (ignore zones)：このモードの配送先の国。Ctrl/Cmd + クリックで複数の国を選択できます。Ignore shipping zones を使う場合にのみ使用されます。
詳細設定
Debug log：API リクエストとチェックアウトの手順を、モジュールフォルダー内の logs/vfd_dhlp_debug.log.php に書き込みます。このファイルは Web から開くことはできません。このオプションがオフでも、API エラーは常に記録されます。API キー、Postnummer、購入者の住所は一切書き込まれません。
Log：デバッグログのサイズと最新のエントリを表示します。Clear log をクリックすると、ログが空になります。
Remove data on uninstall：オンにすると、モジュールをアンインストールした際に、設定、配送業者、キャッシュされた検索結果、ログが削除されます。選択された受取場所は注文内に残ります。オフの場合は、再インストールに備えてすべてが保持されます。
チェックアウトでの動作
配送ステップで、PrestaShop は DHL Packstation の料金をモジュールに問い合わせます。対象になるのは物理的な商品だけです。バーチャル商品は重量に加算されず、小計にも含まれません。モジュールは、API キーと少なくとも 1 つの受取場所の種類が設定されていること、許可された国（Ignore shipping zones の場合）、カートの重量、最低小計を確認します。次に、配送先の国の料金（または他の国の料金）を取得し、小計が十分に高い場合は送料無料を適用します。料金はショップの既定通貨で計算され、購入者のカートの通貨で表示されます。
配送業者に注文が入った後で Shipping > Carriers から編集すると、PrestaShop はそれを新しい配送業者のバージョンとして保存します。モジュールは自動的に新しいバージョンに従います。
モジュールは DHL の配送の作成、ラベルの印刷、荷物の追跡は行いません。DHL のビジネス顧客ポータルまたはラベルツールを使用してください。Shipping address がオンの場合、注文にはすでに Packstation の住所と Postnummer が含まれています。モジュールは DHL のリアルタイム料金を計算せず、地図も表示しません。Packstation の番号を手入力する機能はありません。
受取場所
購入者が DHL Packstation を選択すると、配送業者の下に選択欄が表示されます。配送先の郵便番号と都市の近くにある DHL の受取場所が読み込まれます。DHL へのリクエストは、選択された配送業者に対してのみ行われます。購入者は別の郵便番号や都市を入力して Search をクリックできます。受取場所は種類（Packstation、Post Office、Parcel Shop）ごとにグループ化され、距離順に並べられます。何も見つからない場合、購入者には No DHL locations found near "…". Try another postcode or city. と表示されます。
Packstation の場合、購入者は DHL Postnummer を入力する必要があります。これは、DHL アプリまたは DHL アカウントに記載されている、6〜12 桁の DHL 顧客番号です。その他の受取場所では任意です。選択内容は、選択された時点でカートに保存されます。Continue をクリックすると、サーバーが再度確認します。受取場所は、配送先の国における DHL 検索結果のいずれかでなければなりません。受取場所がない場合、購入者には Please choose a DHL Packstation or post office for delivery. と表示され、先に進めません。Postnummer が未入力または無効な場合も、同じように通知されます。
検索結果は 12 時間キャッシュされます。空の検索結果や失敗した検索は 10 分間キャッシュされ、チェックアウトの更新のたびに DHL の応答を待つことがなくなります。API のタイムアウトは 12 秒です。DHL API に接続できない場合、購入者には DHL locations cannot be loaded right now. Please try again later or choose another shipping method. と表示されます。購入者がすでに選択していた受取場所は、引き続き受け付けられます。
注文が確定すると、受取場所（ID、種類、番号、名前、住所）と Postnummer が注文とともに保存されます。Shipping address がオンの場合、注文の配送先住所は受取場所の住所に置き換えられます。受取場所は、注文確認ページ、購入者アカウントの Order history and details、注文確認メール、Mail alerts モジュールの新規注文メールに表示されます。その際、配送業者名に DHL pickup location と DHL Postnummer のラベルが追加されます。
管理画面の注文ページには、DHL pickup location ブロックが表示され、受取場所、その種類と ID、Postnummer が示されます。Change をクリックし、郵便番号または都市で検索して別の受取場所を選び、Postnummer を変更してから Save location をクリックします。Postnummer のみを変更することもできます。変更のたびに、注文にプライベートなメッセージ DHL pickup location changed to: … が追加されます。Shipping address がオンの場合、注文の配送先住所も更新されます。受取場所を変更するには注文の編集権限が必要です。モジュールページへのアクセス権限は不要です。同じカートから複数の注文が作成された場合、受取場所は最初の注文にのみ属します。同じカートの別の注文で Change をクリックすると、The DHL location of this cart belongs to another order of the same cart - nothing was changed. と表示されます。
ライセンスキー
このモジュールは、vibefox.net で取得した VibeFox ライセンスキーで動作します。License — VibeFox DHL Packstation のライセンスブロックは、Modules > Module Manager > VibeFox DHL Packstation > Configure ページの設定より上にある最初のブロックです。License key にキーを入力し、Activate をクリックします。その後、ブロックにはキーがマスク表示され、ステータス（ライセンスの有効期限日やドメインなど）が表示されます。また、ステータスを再確認する Check now、別のキーを入力する Change key、このショップからキーを削除する Remove key のボタンが表示されます。その下には Product: presta-shipping-dhl-packstation という行と、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 のアカウントで枠を解放してください。
有効なキーがない場合、DHL Packstation 配送業者はチェックアウトで購入者に表示されず、料金も計算されません。PrestaShop のフロントエンドはバックオフィスにログインしていることを認識しないため、配送業者はあなたに対しても非表示になります。キーを購入する前にモジュールを設定することはできますが、チェックアウトでテストすることはできません。Modules > Module Manager の Alerts タブにリマインダーが表示されます。既存の注文には影響しません。
ライセンスが期限切れになっても、モジュールは動作を続けますが、アップデートとサポートには更新が必要です。バックオフィスで作業している間、ステータスは自動的に再確認されます。キーを入力してから最初の 14 日間は 1 日に 1 回、その後は 1 週間に 1 回です。cron ジョブは不要です。モジュールのアンインストールでは、常にライセンスキーとライセンスステータスが削除されます。Reset はデータを削除しないため、キーとステータスは保持されます。
トラブルシューティング
チェックアウトに DHL Packstation が表示されない：ライセンスが有効で、Enable/Disable がオンになっていることを確認してください。Shipping > Carriers で、配送業者が購入者の国のゾーンと購入者の顧客グループを対象にしていることを確認してください（または Ignore shipping zones をオンにして Countries (ignore zones) を確認してください）。DHL API key が入力されていること、受取場所の種類が少なくとも 1 つ選択されていること、配送先の国に料金が設定されていること（または Other countries が設定されていること）、重量と小計のルールによって非表示になっていないことを確認してください。商品ページで、特定の配送業者に制限されている場合もあります。
受取場所が表示されない：Test API key をクリックしてください。DHL がキーを拒否する場合（401/403）は、キーと、アプリに「Location Finder - Unified」API があることを確認してください。Debug log をオンにして、チェックアウトを再読み込みし、モジュールページの Log 欄を確認してください。DHL アプリのリクエスト上限に達していないことも確認してください。
住所の近くに受取場所がない：Search radius (meters) または Max results を増やすか、購入者に別の郵便番号や都市を検索させてください。DHL のデータで番号がない Packstation は一覧に表示されません。
購入者に「Enter your postcode or city to see DHL locations near you.」と表示される：配送先住所に郵便番号も都市もありません。購入者は検索欄にどちらかを入力できます。
管理画面の注文ページで Change をクリックすると「Please choose a DHL location of the search - nothing was changed.」と表示される：郵便番号または都市で検索し、結果から受取場所を選択してください。注文にまだ受取場所がない場合は、Postnummer を保存する前に受取場所を選択する必要があります。
ページに DHL Packstation 配送業者が見つからないと表示される：配送業者が Shipping > Carriers で削除されています。Modules > Module Manager でモジュールをリセットすると、再作成されます。リセットしても、既存の配送業者のオン/オフの状態は維持されます。
アンインストール
Modules > Module Manager に移動し、VibeFox DHL Packstation の横のメニューを開いて Uninstall を選択してください。ライセンスキー、ライセンスステータス、受取場所のキャッシュは常に削除されます。Remove data on uninstall がオンの場合、配送業者は削除されます（注文は履歴を保持します）。また、設定、ログ、注文のないカートの受取場所も削除されます。オフの場合、配送業者は無効になるだけで、すべての設定は保持されます。モジュールを再インストールすると、以前の配送業者のステータスが復元されます。選択された受取場所は、常に注文内に残ります。
DHL と Packstation は、それぞれの所有者の商標です。本モジュールは DHL と提携しておらず、DHL による推奨も受けていません。