VibeFox PostNord for PrestaShop — ヘルプ
要件
PrestaShop：8.0 ～ 9.x。
PHP：8.0 以降。モジュールは、それより古い PHP バージョンではインストールできません。
PostNord API キー（サービスポイント選択用）：developer.postnord.com で無料アカウントを作成し、アプリケーションを追加して、その API キーをコピーしてください。キーがなくても配送業者は動作しますが、購入者はサービスポイントを選べません。
PostNord 契約：荷物を送るには、通常の PostNord 顧客契約（例：MyPack Collect や MyPack Home）が必要です。
VibeFox ライセンスキー：vibefox.net で購入します。1 つのキーは 1 つのドメインで利用できます。
インストール
1. 管理画面で Modules > Module Manager に移動し、Upload a module をクリックします。モジュールの ZIP ファイルを選択してください。
2. アップロードが完了したら Configure をクリックします。後で探す場合は、モジュール一覧で VibeFox PostNord を見つけ、Configure をクリックしてください。
3. Configure ページ上部のライセンスブロックで、License key に VibeFox ライセンスキーを入力し、Activate をクリックします（ライセンスキーを参照）。
4. PostNord の API key を貼り付け、Agreement country を選択し、Country prices を入力して（設定を参照）、Save をクリックします。
インストール時に、モジュールは 2 つの配送業者を作成します。PostNord はサービスポイントへ配送し、配送日数のテキストは Delivery to a PostNord service point です。有効な状態になります。PostNord Home delivery は住所へ配送し、テキストは PostNord home delivery です。Home delivery をオンにするまで無効です。両方の配送業者は、スウェーデン、デンマーク、ノルウェー、フィンランドのゾーンと、すべての顧客グループに割り当てられます。ゾーン、顧客グループ、配送日数のテキスト、ロゴ、サイズ制限は Shipping > Carriers で変更できます。料金はそこで設定しないでください。料金は常にモジュールから取得されます。
設定
すべての設定はモジュールページにあります：Modules > Module Manager > VibeFox PostNord > Configure。各セクションには独自の Save ボタンがあり、ページ全体が保存されます。保存するたびに、キャッシュされたサービスポイントの一覧も消去されます。
設定の上部には、API キーが未入力の場合、料金が未設定の場合、PostNord の配送業者が削除された場合、またはストアの重量単位をモジュールが認識できない場合に警告が表示されます。その場合、商品の重量は kg として扱われます。International > Localization（Local units）で kg、g、lb、oz のいずれかを使用してください。
一般
Enable/Disable：サービスポイントの配送業者をオンまたはオフにします。これは Shipping > Carriers の配送業者ステータスと同じスイッチです。
Name：チェックアウト時に表示されるサービスポイント配送業者の名前です。例：「PostNord MyPack Collect」。既定値：PostNord。必須です。
Home delivery：PostNord の自宅配送も提供します。これは 2 つ目の配送業者で、サービスポイントはありません。既定ではオフです。
Home delivery name：チェックアウト時に表示される自宅配送の配送業者の名前です。例：「PostNord MyPack Home」。既定値：PostNord Home delivery。必須です。
Tax status：None は、以下の料金が最終料金であることを意味します。Taxable: に続けて税ルールを選ぶと、PrestaShop は料金に、そのルールの配送税を追加します。両方の配送業者に適用されます。
PostNord API（サービスポイント選択）
API key：developer.postnord.com で作成したアプリケーションの API キーです。お使いのサーバーからのみ PostNord に送信され、ブラウザに送られることはなく、ログにも記録されません。保存後、このフィールドは空になり、Saved - leave empty to keep it. と表示されます。変更する場合にのみ新しい値を入力してください。
Remove the saved API key：チェックボックスをオンにして Save をクリックすると、保存済みのキーを削除します。
Test mode：PostNord のテスト環境（atapi2.postnord.com）を使用します。テスト環境用に発行されたキーの場合にのみ使用してください。
Agreement country：PostNord 顧客契約の国です。スウェーデン、デンマーク、ノルウェー、またはフィンランドから選択します。提供されるサービスポイントを決定します。Same as the delivery country（既定）を選ぶと、購入者の国が使用されます。
料金
このセクションのタイトルには、ストアの既定通貨が表示されます。料金はその通貨で、税抜きで設定され、両方の配送業者で共通です。PostNord には公開された料金 API がないため、料金は貴店で設定します。通常は PostNord 契約の料金を使います。適用の順序は、送料無料の基準額、国別の料金表、最後にフォールバック料金です。
Calculation type：Per order は料金を 1 回だけ請求します。Per item (price x number of items) は、料金にカート内の商品数を掛けます。
Country prices：配送先の国とカートの重量ごとに料金を設定します。Add country をクリックすると行が追加され、ごみ箱のアイコンをクリックすると行が削除されます。各行には Price と重量列があります。XS は 1 kg まで、S は 2 kg まで、M は 3 kg まで、L は 5 kg まで、XL は 5 kg を超える場合です。重量列が 0 の場合は Price 列が使われ、Price が 0 の場合は送料無料になります。* All other countries は、独自の行がないすべての国を対象とします。小数点はカンマまたはドット（9,99 または 9.99）で入力できます。新しい行は、すべての料金が 0 の * All other countries として追加されます。保存する前に国を選び、料金を入力するか、行を削除してください。空欄は 0 として保存されます。数値ではないセルは 0 として保存され、メッセージが表示されます。
Fallback cost：国別の料金表に配送先の行も * の行もない場合に使われます。空欄にすると、その国では配送業者が表示されません。
Free shipping from：PostNord が無料になるカートの小計（配送が必要な商品、割引後、税抜き）です。国別の料金表より先に判定されるため、料金行のない国にも適用されます。空欄にすると、送料無料は提供されません。
提供条件
Min weight (kg)：カートの重量がこの値より軽い場合、配送業者を非表示にします。商品の重量は、ストアの重量単位から換算されます。0 は制限なしを意味します。
Max weight (kg)：カートの重量がこの値より重い場合、配送業者を非表示にします。既定値：30。0 は制限なしを意味します。PostNord サービスの重量制限を確認してください。ロッカーはサービスポイントより軽い荷物しか受け付けません。Min weight (kg) が Max weight (kg) より大きい場合は、エラーになり、何も保存されません。
Minimum subtotal：カートの小計（配送が必要な商品、割引後、税抜き）がこの金額以上の場合にのみ配送業者を表示します。常に表示する場合は空欄にしてください。
Ignore shipping zones：オンにすると、配送業者のゾーンに以下の国が含まれていなくても、それらの国に対して PostNord が提供されます。配送業者は有効なすべてのゾーンに紐付けられ、後から作成したゾーンにもすぐに紐付けられます。オフに戻すと、配送業者は以前のゾーンに戻ります。オフの場合、配送業者は自身のゾーン内でのみ提供されます。
Countries (Ignore shipping zones)：このモードの配送先の国です。空欄にするとすべての国が許可されます。このフィールドは Ignore shipping zones がオンの場合にのみ使われます。
金額と重量はカンマまたはドットで入力できます。0 以上の数値ではない値は保存されず、メッセージが表示されます。
詳細設定
Debug log：料金の計算と API 呼び出しを、モジュールフォルダー内の logs/vfd_ptnd_debug.log.php に記録します。このファイルは Web から開くことはできません。API エラーは常に記録されます。API キーがログに記録されることはありません。作業が終わったらログをオフにしてください。
Log：デバッグログのサイズと最新のエントリを表示します。Clear log をクリックすると、ログを消去できます。
Remove data on uninstall：オンの場合、モジュールをアンインストールすると PostNord の設定と配送業者が削除されます。オフの場合、アンインストールで配送業者はオフになるだけです。注文に保存されたサービスポイントは、常に保持されます。
チェックアウト時の動作
配送ステップで、PrestaShop は各 PostNord 配送業者の料金をモジュールに問い合わせます。計算対象になるのは物理的な商品だけです。仮想商品は重量に含まれず、小計にも含まれません。モジュールは、カートの重量と最低小計を確認します。送料無料の条件を満たす場合、料金は 0 になります。それ以外の場合は、国別の料金表から、次にフォールバック料金から料金を取得します。料金がない場合、配送業者は非表示になります。料金はストアの既定通貨で計算され、購入者のカートの通貨で表示されます。
サービスポイントの配送業者で、配送先住所がスウェーデン、デンマーク、ノルウェー、フィンランドにある場合、お使いのサーバーは、配送郵便番号に最も近い 10 件のサービスポイントを PostNord Business Location API に問い合わせます。配送先の国、配送郵便番号、契約の国を送信します。API のタイムアウトは 10 秒です。一覧は郵便番号ごとに 6 時間キャッシュされ、「ポイントなし」の応答は 1 時間キャッシュされます。API エラーは 5 分間キャッシュされるため、PostNord の障害があっても、配送ステップの更新がすべて遅くなることはありません。配送ステップが PostNord の応答を待つことはありません。一覧がまだキャッシュされていない場合は、購入者が配送業者を選択した後に読み込まれます。
その他の配送先では、選択画面なしで、貴店の料金を使って配送業者を提供できます。自宅配送の配送業者では、選択画面は表示されません。
注文がある配送業者を Shipping > Carriers で編集すると、PrestaShop はそれを配送業者の新しいバージョンとして保存します。モジュールは新しいバージョンに自動的に追従します。
モジュールは PostNord のリアルタイム料金を取得せず、配送ラベルの作成、配送の予約（EDI）、追跡番号の提供、追跡メールの送信は行いません。地図表示はありません。配送には PostNord Portal、Skicka Direkt Business、またはラベル作成ツールを使用してください。これらのツールに必要なのは、保存されたサービスポイント ID です。
受け取りポイント
購入者がサービスポイントの配送業者を選ぶと、その下に PostNord service point の一覧が表示され、最寄りのポイントが都市ごとにまとめられて距離とともに示されます。郵便番号を入力する前は、購入者に「PostNord サービスポイントを選ぶには郵便番号を入力してください。」と表示されます。選択内容はカートとともに保存され、配送ステップの更新後も維持されます。
一覧が読み込まれたら、ポイントを選択する必要があります。選択しないと、Continue は「PostNord サービスポイントを選択してください。」というメッセージで止まります。選択されたポイントは、サーバー上で配送先住所の PostNord の一覧と照合されます。別の郵便番号で選んだポイントは使用されません。
選択画面が販売を妨げることはありません。一覧を読み込めない場合（API キーが未設定、PostNord API に接続できない、郵便番号の近くにポイントがないなど）、購入者には注意書きが表示されますが、注文は続けられます。その場合、PostNord は住所に最も近いサービスポイントへ配送します。
管理画面の注文ページ：名前、住所、Service point ID を含む PostNord service point のブロックです。ポイントが選択されていない場合は、「未選択 - PostNord は配送先住所に最も近いサービスポイントへ配送します」と表示されます。
注文確認と購入者の注文詳細：PostNord service point：名前と住所を表示します。
注文メール：購入者へ送られる注文確認と、ストアへ送られる新規注文の通知には、配送業者名の横にポイント名、住所、ID が表示されます。ストア向けの通知には、ポイントがない場合に「not selected」とも表示されます。
ライセンスキー
このモジュールは、vibefox.net で取得した VibeFox ライセンスキーで動作します。ライセンスブロック License — VibeFox PostNord は、Modules > Module Manager > VibeFox PostNord > Configure ページの一番上、設定より上にあります。キーを License key に貼り付けて、Activate をクリックしてください。その後、ブロックにはキーがマスク表示され、ステータス（ライセンスの有効期限日やお使いのドメインなど）と、Check now（ステータスを再確認）、Change key（別のキーを入力）、Remove key（このストアからキーを削除）のボタンが表示されます。その下には Product: presta-shipping-postnord の行と、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 のアカウントで解放してください。
有効なキーがない場合、PostNord の配送業者はチェックアウト時に購入者へ表示されず、送料も計算されません。PrestaShop のストアフロントは、バックオフィスにログインしていることを認識しないため、配送業者はあなたにも表示されません。キーを購入する前にモジュールを設定することはできますが、チェックアウトでテストすることはできません。Modules > Module Manager の Alerts タブにリマインダーが表示されます。既存の注文には影響しません。
ライセンスの期限が切れた場合も、モジュールは動作を続けますが、アップデートとサポートには更新が必要です。バックオフィスで作業している間、ステータスは自動的に再確認されます。キー入力後の最初の 14 日間は 1 日 1 回、その後は週 1 回です。cron ジョブは不要です。モジュールをアンインストールすると、ライセンスキーとライセンスステータスは常に削除されます。このモジュールの Reset ではデータは削除されないため、キーとステータスは保持されます。
トラブルシューティング
チェックアウトに PostNord が表示されない：ライセンスが有効であること、Enable/Disable（または Home delivery）がオンであることを確認してください。Shipping > Carriers で、配送業者が購入者の国のゾーンと顧客グループを含んでいるか確認するか、Ignore shipping zones をオンにしてください。その国の料金が設定されているか（国の行、* の行、または Fallback cost）、重量制限、Minimum subtotal も確認してください。商品ページで、商品が特定の配送業者に制限されている場合もあります。
選択画面で「サービスポイントを読み込めません」と表示される：API key と Test mode の設定を確認してください。本番用のキーはテスト環境では使えず、その逆も同様です。Debug log をオンにして、チェックアウトを再読み込みし、モジュールページの Log フィールドを確認してください。注文は引き続き行えます。その場合、PostNord は最寄りのサービスポイントへ配送します。
想定外のサービスポイントが表示される：Agreement country を確認してください。提供されるサービスポイントは、この設定で決まります。
誤って送料が無料になっている：Country prices で Price が 0 の行を確認してください。特に Add country で追加して未入力のままの * の行に注意し、Free shipping from も確認してください。
変更後にサービスポイントが古く見える：モジュールページで Save をクリックしてください。キャッシュされた一覧が消去されます。
PostNord の配送業者が見つからないと表示される：配送業者は Shipping > Carriers で削除されています。Modules > Module Manager でモジュールをリセットすると、再作成されます。
アンインストール
Modules > Module Manager に移動し、VibeFox PostNord の横のメニューを開いて Uninstall を選んでください。ライセンスキーとライセンスステータスは常に削除されます。モジュールを無効にしても、キャッシュされたサービスポイントの一覧が消去されるだけです。アンインストール時には、キャッシュされた一覧が常に削除されます。Remove data on uninstall がオンの場合、配送業者は削除され（注文の履歴は残ります）、設定とログも削除されます。オフの場合、配送業者はオフになるだけで、すべての設定が保持されます。モジュールを再インストールすると、保存されていた配送業者は以前のステータスに戻ります。注文に保存されたサービスポイントは、常に保持されます。
PostNord は、それぞれの所有者の商標です。本モジュールは PostNord とは提携しておらず、PostNord による承認もありません。