VibeFox PostNord for OpenCart — ヘルプ
要件
OpenCart：3.0.x（3.0.5.0 で動作確認）または 4.0.2 以降（4.1.0.3 で動作確認）。
PHP：8.0 以降。
PostNord API キー（サービスポイント選択用）：developer.postnord.com で無料アカウントを作成し、アプリケーションを追加して、その API キーをコピーします。キーがなくても配送方法は動作しますが、購入者はサービスポイントを選択できません。
PostNord 契約：荷物を発送するには、通常の PostNord 顧客契約が必要です（例: MyPack Collect または MyPack Home）。
VibeFox ライセンスキー：vibefox.net で購入します。1 つのキーは 1 つのドメインでのみ使用できます。
インストール
このダウンロードは、両方の OpenCart バージョン用のパッケージが入った zip ファイル 1 つです。コンピュータで解凍してください。README.txt、OpenCart 3 用パッケージ vfd_postnord-oc3-(version).ocmod.zip、OpenCart 4 用パッケージ vfd_postnord.ocmod.zip が含まれています。お使いの OpenCart のバージョンのパッケージのみをインストールしてください。ライセンスキーは両方のバージョンで同じです。
OpenCart 3
1. 管理画面で Extensions > Installer に移動し、Upload をクリックして、ファイル vfd_postnord-oc3-(version).ocmod.zip を選択します。本拡張機能は OCMOD の変更を追加しないため、Extensions > Modifications を更新する必要はありません。Installer を使わずに、このパッケージの upload フォルダの内容をストアのルートフォルダにコピーすることもできます。
2. Extensions > Extensions に移動し、拡張機能の種類 Shipping を選択します。VibeFox PostNord を見つけ、Install（緑色の + ボタン）をクリックします。
3. Edit（鉛筆のボタン）をクリックして設定ページを開きます。
4. Edit ページ上部のライセンスブロックで、License key に VibeFox ライセンスキーを入力し、Activate をクリックします（ライセンスキーの項を参照）。
5. Enable/Disable（サービスポイント配送）や Home delivery をオンにし、PostNord の API key を貼り付け、Agreement country を選択し、Country prices または Fallback cost を入力（設定の項を参照）してから、Save をクリックします。
OpenCart 4
1. 管理画面で Extensions > Installer に移動し、Upload をクリックして、ファイル vfd_postnord.ocmod.zip を選択します。ファイル名を変更しないでください。OpenCart 4 は拡張機能のコードをファイル名から読み取るため、名前を変更したパッケージは動作しません。
2. パッケージは同じページのインストール済み拡張機能の一覧に表示されます。その横の Install（緑色の + ボタン）をクリックします。
3. Extensions > Extensions に移動し、拡張機能の種類 Shipping を選択します。VibeFox PostNord を見つけ、Install（緑色の + ボタン）をクリックしてから、Edit（鉛筆のボタン）をクリックします。
4. ライセンスキーと設定は、OpenCart 3 の手順 4 と 5 と同じように入力します。設定ページとその項目は両方のバージョンで同じです。
インストール直後は、どちらかのオプションをオンにして保存するまで、両方とも無効です。アンインストール後に拡張機能を再インストールした場合は、保持されていた PostNord の設定が再び使用されます。
設定
すべての設定は拡張機能のページにあります：Extensions > Extensions > Shipping > VibeFox PostNord > Edit。セクションは左側に並んでいます。ページ下部の Save ボタンで、ページを再読み込みせずにページ全体を保存します。保存のたびに、キャッシュされたサービスポイント一覧も消去されます。この拡張機能の変更権限を持つ管理者ユーザーだけが設定を保存できます。
値が正しくない場合は、何も保存されず、ページに理由が表示されます：名前が空である、64 文字を超える、または < > ; = # { } を含む、並べ替え順序が整数でない、税ステータスやジオゾーンが無効である、Min weight (kg) が Max weight (kg) より大きい、などです。0 以上の数値ではない値が入力された数値欄は、空欄として保存され、メッセージが表示されます。0 以上の数値ではない料金表のセルは、0 として保存され、メッセージが表示されます。
設定の上部には、API キーがまだない場合、料金がまだ設定されていない場合、ストアに「kg」の重量クラスがない場合に警告が表示されます。
一般
2 つの配送オプションは、Availability で設定されたジオゾーン内、または Ignore shipping zones の国に対して提供されます。
Enable/Disable：PostNord によるサービスポイントまたは宅配ロッカーへの配送のオン・オフを切り替えます。購入者はチェックアウトでポイントを選択します。デフォルト：オフ。
Name：チェックアウトに表示されるサービスポイントのオプション名（例: 「PostNord MyPack Collect」）。デフォルト：PostNord。必須、最大 64 文字、< > ; = # { } は使用不可。
Home delivery：PostNord の宅配も提供します。サービスポイントを使わない 2 つ目のオプションです。デフォルト：オフ。
Home delivery name：チェックアウトに表示される宅配オプションの名前（例: 「PostNord MyPack Home」）。デフォルト：PostNord Home delivery。Name と同じルールが適用されます。
Sort order：チェックアウトの配送方法の中で PostNord が表示される位置。整数です。
Tax status：None (the prices are final)（デフォルト）、または税クラス。税クラスを選ぶと、OpenCart はそのクラスの配送税を料金に加算します。両方のオプションに適用されます。
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 として保存されます。
Fallback cost：送付先に対応する行と * の行が国別の料金表にない場合に使用されます。その国で PostNord を非表示にする場合は空欄のままにします。
Free shipping from：送料無料になるカート小計（配送が必要な商品、クーポン適用後、税抜き）です。この金額に達すると PostNord は無料になります。国別の料金表よりも前に確認されるため、料金の行がない国にも適用されます。送料無料を提供しない場合は空欄のままにします。
利用可能条件
Min weight (kg)：カートの重量がこの値より軽い場合に PostNord を非表示にします。商品の重量は、その重量クラスから換算されます。デフォルト：0（制限なし）。
Max weight (kg)：カートの重量がこの値より重い場合に PostNord を非表示にします。デフォルト：30。0 は制限なしを意味します。PostNord サービスの重量制限を確認してください。宅配ロッカーは、サービスポイントより少ない重量しか受け付けません。
Minimum subtotal：カート小計（配送が必要な商品、クーポン適用後、税抜き）がこの金額以上の場合にのみ PostNord を表示します。空欄の場合は常に表示します。
Geo zone：このジオゾーン内の住所に対してのみ PostNord を提供します。All zones（デフォルト）は制限なしを意味します。ジオゾーンは System > Localisation > Geo Zones で管理します。Ignore shipping zones がオンの間は使用されません。
Ignore shipping zones：オンの場合、ジオゾーンは確認されず、PostNord は下記の国に対して提供されます。オフの場合は、ジオゾーン内でのみ提供されます。
Countries (Ignore shipping zones)：このモードの送付先の国です。空欄の場合はすべての国が対象になります。このフィールドは Ignore shipping zones がオンの場合にのみ使用されます。
詳細設定
Debug log：料金の計算と API 呼び出しを storage/logs/vfd_ptnd_debug.log.php に記録します。このファイルは Web から読み取ることはできません。API のエラーは常に記録されます。API キーは記録されません。作業が終わったらログをオフにしてください。ファイルが 5 MB に達すると、新しいログが開始されます。
Log：デバッグログのサイズと最新のエントリを表示します。Clear log をクリックすると消去されます。
Remove data on uninstall：オンの場合、拡張機能のアンインストール時に PostNord の設定とログが削除されます。キャッシュされたサービスポイント一覧は常に削除されます。注文に保存されたサービスポイントは常に保持されます。
インポート / エクスポート
Export：Download JSON をクリックして、設定を JSON ファイルとして保存します。API キーはエクスポートされません。
Import：以前にエクスポートした JSON を貼り付け、Import をクリックして設定を復元します（例: 別のストアで使用する場合）。値は通常の保存と同じように確認されます。保存済みの API キーは保持されます。
チェックアウト時の動作
OpenCart は配送方法を表示するときに、PostNord の各オプションの料金を拡張機能に問い合わせます。Requires Shipping が Yes に設定されている商品のみが対象です。それ以外の商品は重量に加算されず、小計にも含まれません。拡張機能は、ジオゾーンまたは国のリスト、カートの重量、最低小計を確認します。送料無料の条件を満たす場合、料金は 0 です。それ以外の場合は、国別の料金表から、次に代替料金から料金を取得します。料金がない場合は、そのオプションは非表示になります。料金は既定の通貨で計算され、選択された Tax status の税金を含めて購入者の通貨で表示されます。料金の計算で PostNord に問い合わせることはありません。
サービスポイントのオプションで、配送先の住所がスウェーデン、デンマーク、ノルウェー、フィンランドにある場合、サーバーは PostNord Business Location API に対して、配送郵便番号に最も近い 10 か所のサービスポイントを問い合わせます。送信するのは、配送先の国と郵便番号、および契約国です。API のタイムアウトは 10 秒です。一覧は郵便番号ごとに 6 時間キャッシュされ、「ポイントなし」の応答は 1 時間キャッシュされます。API のエラーは 5 分間キャッシュされるため、PostNord の障害があっても、チェックアウトの更新のたびに遅くなることはありません。キャッシュは拡張機能専用のデータベーステーブルに保存されます。配送ステップが PostNord の応答を待つことはありません。一覧がまだキャッシュされていない場合は、購入者がオプションを選択した後に読み込まれます。
その他の送付先では、選択ツールなしで、貴店の料金によりオプションを引き続き提供できます。宅配オプションでは選択ツールは表示されません。
拡張機能は PostNord のリアルタイム料金を取得せず、配送ラベルの作成、配送の予約（EDI）、追跡番号の発行、追跡メールの送信も行いません。地図表示もありません。発送には PostNord Portal、Skicka Direkt Business、またはラベル作成ツールを使用してください。これらのツールには、保存されたサービスポイントの ID が必要です。
OpenCart 4 では、購入者はチェックアウトページの配送方法ブロックで Choose をクリックし、Shipping method options のウィンドウで PostNord のオプションを選択します。料金は OpenCart 3 と同じです。
受け取りポイント
配送先の住所がスウェーデン、デンマーク、ノルウェー、フィンランドにある場合、サービスポイントのオプションの下に PostNord service point の一覧が表示され、最寄りのポイントが都市ごとにまとめられ、それぞれに住所と距離が表示されます。郵便番号が入力される前は、購入者に「PostNord のサービスポイントを選択するには、郵便番号を入力してください。」と表示されます。選択内容は、チェックアウトのためにすぐに保存されます。
一覧が読み込まれた後は、ポイントの選択が必須です。選択しない場合、配送方法のステップで Continue を押すと、「PostNord のサービスポイントを選択してください。」と表示され、先に進めません。選択されたポイントは、配送先の住所に対する PostNord の一覧と照合してサーバー側で確認されます。別の郵便番号のために選択されたポイントは使用されません。
選択ツールが販売を妨げることはありません。一覧を読み込めない場合（API キーが未設定、PostNord API が利用できない、郵便番号の近くにポイントがない）、購入者には注記が表示され、それでも注文は完了できます。その場合、PostNord は住所に最も近いサービスポイントに配送します。
注文ページ、メール、請求書：ポイントは注文の配送方法に追加されます（例: 「PostNord: 名前、住所（ID 12345）」。オプション名の後にポイントが続きます）。テキストが 128 文字を超える場合、住所は省略されます。OpenCart が配送方法を表示するすべての場所に表示されます：購入者の注文履歴、注文メール、請求書、Sales > Orders。ポイントのない注文には、配送方法の通常の名前が表示されます。
管理者の注文ページ：Sales > Orders で注文ページを開くと、履歴の上に PostNord service point のパネルが表示され、名前、住所、Service point ID が示されます。ポイントが選択されていない場合は、「未選択 - PostNord は配送先住所に最も近いサービスポイントに配送します」と表示されます。
OpenCart 4 では、サービスポイントの一覧は Shipping method options のウィンドウの、サービスポイントのオプションの下に表示され、ウィンドウを開くたびに読み込み直されます。ワンページのチェックアウトでは住所が変わることがあるためです。ウィンドウの Continue ボタンは、一覧のポイントがないと先に進めず、同じメッセージが表示されます。一覧の読み込み中に押された場合、ウィンドウはメッセージなしで一覧を待ち、その後自動的に再度 Continue を押します。一覧が利用できない場合も注文はブロックされません。OpenCart 4 は、チェックアウトごとに注文を 1 つ保持し、購入者が再度確定するたびにその注文を更新します。注文のサービスポイントも一緒に更新されます。
ライセンスキー
拡張機能は、vibefox.net で取得した VibeFox ライセンスキーで動作します。ライセンスブロック License — VibeFox PostNord は Extensions > Extensions > Shipping > VibeFox PostNord > Edit ページの最初のブロックで、設定の上にあります。キーを License key に入力して Activate をクリックします。その後、ブロックにはマスクされたキー、ステータス（ライセンスの有効期限日やドメインなど）、そして Check now（ステータスを再確認）、Change key（別のキーを入力）、Remove key（このストアからキーを削除）のボタンが表示されます。その下には Product: opencart-shipping-postnord の行と、vibefox.net のアカウントを開くリンク Manage licenses and domains in your account があります。キーを変更できるのは、この拡張機能の Modify 権限を持つ管理者ユーザーだけです。ブロックの表示テキストは管理画面の言語に従います（英語とロシア語を含みます）。
キーが受け付けられない場合、ブロックに理由が表示されます。例: Key not found、This key belongs to another product、Domain limit reached、または日付付きの License expired on。ストアのアドレスを変更した後、またはアカウントでドメインの枠を解放した後は、Check now をクリックしてください。ライセンスサーバーに接続できない場合、拡張機能は最後に確認された状態で動作を続けます。
1 つのキーは 1 つのドメインでのみ使用できます。OpenCart の設定にあるストアのアドレスが対象です。ストアからキーを削除しても、そのドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、PostNord の配送オプションはチェックアウトで購入者に表示されず、料金も計算されません。同じブラウザで管理画面にログインしている管理者ユーザーには、ストアでこれらのオプションが (unlicensed — visible to admins only) と表示された状態で引き続き見えるため、キーを購入する前に拡張機能を設定してテストできます。OpenCart 4 ではこのプレビューは利用できません。ストアは管理画面のログインを認識しないため、有効なキーがない場合は全員にこのオプションが非表示になります。Edit ページを一度開くと、管理画面の Dashboard にリマインダーが表示されます。× で閉じると 7 日間非表示になります。既存の注文は影響を受けません。
ライセンスの期限が切れても、拡張機能は動作を続けますが、アップデートとサポートには更新が必要です。管理画面の Dashboard または Edit ページを開くと、ステータスが自動的に再確認されます。キーの入力後最初の 14 日間は 1 日に 1 回、その後は 1 週間に 1 回です。cron ジョブは不要です。拡張機能をアンインストールすると、ライセンスキーとライセンスのステータスは常に削除されます。
トラブルシューティング
チェックアウトに PostNord が表示されない：ライセンスが有効で、Enable/Disable（または Home delivery）がオンになっていることを確認してください。Ignore shipping zones がオンの場合は、Geo zone または Countries の一覧を確認してください。その国の料金（国の行、* の行、または Fallback cost）、重量の制限、Minimum subtotal が設定されていることを確認してください。商品の Requires Shipping が Yes に設定されていることを確認してください。
選択ツールでサービスポイントを読み込めないと表示される：API key と Test mode の設定を確認してください。本番用のキーはテスト環境では動作せず、逆の場合も同様です。Debug log をオンにし、チェックアウトを再読み込みして、拡張機能のページにある Log の欄を確認してください。注文は完了できます。その場合、PostNord は最寄りのサービスポイントに配送します。
予期しないサービスポイントが表示される：Agreement country を確認してください。提供されるサービスポイントを決定します。
誤って送料が無料になっている：Country prices で、Price が 0 の行を確認してください。特に、Add country で追加されて未入力のままになっている * の行に注意してください。また、Free shipping from も確認してください。
変更後にサービスポイントが古いままに見える：拡張機能のページで Save をクリックしてください。キャッシュされた一覧が消去されます。
商品の重量が正しくないように見える：拡張機能のページに、ストアに「kg」の重量クラスがないと表示される場合は、System > Localisation > Weight Classes を確認してください。商品の重量は、そのクラスの単位名に基づいて換算されます。不明な単位は kg として扱われます。
ページに「Warning: You do not have permission to modify VibeFox PostNord!」と表示される：管理者ユーザーのグループは、設定の閲覧のみ可能な可能性があります。System > Users > User Groups で、グループに extension/shipping/vfd_postnord（OpenCart 3）または extension/vfd_postnord/shipping/vfd_postnord（OpenCart 4） の変更権限を付与してください。
開発者向け：PostNord API のアドレスは、設定 vfd_ptnd_api_url（テスト用）で置き換えられます。この設定は設定ページにはフィールドがありません。
アンインストール
Extensions > Extensions に移動し、種類 Shipping を選択して、VibeFox PostNord の横にある Uninstall（赤い − ボタン）をクリックします。この拡張機能のライセンスキーとライセンスのステータスは常に削除されます。OpenCart は常に拡張機能のステータス、Sort order、Tax status、Geo zone をリセットします。キャッシュされたサービスポイント一覧は常に削除されます。Remove data on uninstall がオンの場合は、PostNord の設定、デバッグログ、注文にならなかったチェックアウトのサービスポイントも削除されます。オフの場合、その他の設定は保持され、拡張機能を再インストールしたときに再び使用されます。既存の注文は、配送方法、料金、保存されたサービスポイントを保持します。
OpenCart 4 で拡張機能のファイルも削除するには、アンインストール後に Extensions > Installer に移動し、インストール済み拡張機能の一覧で VibeFox PostNord の横にある Uninstall（オレンジ色の − ボタン）をクリックしてから、アップロードしたパッケージを削除するために Delete（赤いゴミ箱ボタン）をクリックしてください。
PostNord は各所有者の商標です。本拡張機能は PostNord との提携や承認を受けたものではありません。