VibeFox PostNord for WooCommerce — ヘルプ
要件
WordPress：5.8 以降。
WooCommerce：7.0 以降。インストールされて有効化されている必要があります。WooCommerce がないと、プラグインは有効化できません。
PHP：8.0 以降。
PostNord API キー（サービスポイント選択用）：developer.postnord.com で無料アカウントを作成し、アプリケーションを追加して、API キーをコピーします。キーがなくても配送方法は動作しますが、購入者はサービスポイントを選べません。
PostNord 契約：荷物を送るには、通常お使いの PostNord 顧客契約（例：MyPack Collect や MyPack Home）が必要です。
VibeFox ライセンスキー：vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin に移動し、プラグインの ZIP ファイルを選んで Install Now をクリックします。FTP で vfd_postnord フォルダを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます：WooCommerce > Settings > Shipping > VibeFox PostNord。または、プラグインページでプラグイン名の下にある Settings をクリックします。
4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。
5. PostNord の API key を貼り付け、Agreement country を選択し、Country prices を入力します（「設定」を参照）。
6. WooCommerce > Settings > Shipping > Shipping zones で、スウェーデン、デンマーク、ノルウェー、フィンランドの配送ゾーンに VibeFox PostNord を追加します。その方法の設定で Title と Delivery type を指定します。または Ignore shipping zones をオンにします。
設定
タイトルと配送タイプ以外のすべての設定は、1 つのページにまとまっています：WooCommerce > Settings > Shipping > VibeFox PostNord。これらはすべての配送ゾーンに適用されます。ゾーンに配送方法を追加すると、ゾーンの画面には 2 つの項目が表示されます。
Title (zone)：チェックアウトでこの選択肢に表示される名前（例：「PostNord MyPack Collect」）。空欄にすると、全体の Name を使います。
Delivery type (zone)：Same as global setting（既定）、Service point / parcel locker、または Home delivery。ゾーンに PostNord を 2 つ追加すると、両方を提供できます。
設定の上部には、API キーまたは料金が未設定の場合に警告が表示されます。設定を保存するたびに、キャッシュされたサービスポイントの一覧は消去されます。
一般
Enable/Disable：チェックを外すと、この方法はどこでも非表示になります。配送ゾーンでも同様です。
Name：チェックアウトに表示される配送方法の名前。ゾーンの方法では、独自の Title で上書きできます。既定値：PostNord。
Delivery type：すべての PostNord 方法の既定値です。各ゾーンの方法で個別に選択できます。
Tax status：Taxable を選ぶと WooCommerce の税金が送料に加算され、None を選ぶと加算されません。
PostNord API（サービスポイント選択）
API key：developer.postnord.com で登録したアプリケーションの API キーです。サーバーから PostNord に送信されるだけで、ブラウザに送られることはなく、ログにも記録されません。
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 × 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 列を使います。* All other countries は、独自の行がないすべての国を対象とします。小数はカンマまたはドット（9,99 または 9.99）で入力できます。新しい行は、すべての料金を 0 にした * All other countries として追加されます。これは送料無料を意味します。保存する前に国を選択して料金を入力するか、行を削除してください。数値ではないセルは 0 として保存され、メッセージが表示されます。
Fallback cost：国の料金表に送付先の行も * の行もない場合に使われます。空欄にすると、その国では方法が非表示になります。
Free shipping from：PostNord が無料になるカート小計（割引後、税抜き）です。料金が設定されている場合にのみ適用されます：国の行、* の行、またはフォールバック料金。空欄にすると、送料無料は提供されません。
提供条件
Min weight (kg)：カートの重量がこの値より軽い場合、方法を非表示にします。商品の重量は、ストアの重量単位から換算されます。0 は上限なしを意味します。
Max weight (kg)：カートの重量がこの値より重い場合、方法を非表示にします。既定値：30。0 は上限なしを意味します。使用する PostNord サービスの重量制限を確認してください。宅配ロッカーはサービスポイントより軽い荷物しか受け付けません。
Minimum subtotal：カートの小計がこの金額以上の場合にのみ、方法を表示します。空欄にすると、常に表示します。
Disabled shipping classes：カートにこれらの WooCommerce 配送クラスのいずれかの商品が含まれている場合、方法を非表示にします。
Ignore shipping zones：オンにすると、配送ゾーンに追加していなくても、下記の国に対して全体設定で PostNord を提供します。オフにすると、追加した配送ゾーンでのみ提供します。
Countries (Ignore shipping zones)：このモードの送付先の国です。空欄にすると、すべての配送先の国を使います。この項目は Ignore shipping zones がオンの場合にのみ使われます。
金額と重量はカンマまたはドットで入力できます。無効な数値は保存されず、メッセージが表示されます。
詳細設定
Debug log：料金計算と API 呼び出しを WooCommerce > Status > Logs（ソース "vfd-postnord"）に書き込みます。API エラーは常に記録されます。API キーは記録されません。作業が終わったらログをオフにしてください。
Remove data on uninstall：オンにすると、プラグインを削除したときに PostNord の設定とゾーンの方法も削除されます。無効化しても設定が削除されることはありません。注文に保存されたサービスポイントは、常に保持されます。
チェックアウトでの動作
購入者が配送先住所を入力すると、WooCommerce がプラグインに料金を問い合わせます。プラグインは条件を確認します：カートの重量、最低小計、無効化された配送クラス。料金は国の料金表から取得し、なければフォールバック料金を使います。料金がない場合、方法は非表示になります。送料無料が適用される場合、購入者は方法を無料で表示されます。
サービスポイントの方法で、配送先住所がスウェーデン、デンマーク、ノルウェー、フィンランドにある場合、お使いのサーバーが PostNord Business Location API に、配送郵便番号に最も近いサービスポイントを問い合わせます。送信するのは、配送先の国と郵便番号、そして契約国です。API のタイムアウトは 10 秒です。一覧は郵便番号ごとに 6 時間キャッシュされ、「ポイントなし」の応答は 1 時間キャッシュされます。API エラーは 5 分間キャッシュされるため、PostNord の障害があっても、チェックアウトの更新のたびに遅くなることはありません。
それ以外の配送先では、サービスポイントの選択なしで、料金を設定して方法を提供できます。
この方法は、クラシックチェックアウトと、カートおよびチェックアウトブロックの両方で動作します。WooCommerce High-Performance Order Storage（HPOS）に対応しています。
本プラグインは、PostNord のリアルタイム料金を取得せず、配送ラベルの作成、配送の予約（EDI）、追跡番号の提供、追跡メールの送信は行いません。地図表示もありません。発送には PostNord Portal、Skicka Direkt Business、またはラベル用プラグインを使用してください。これらのツールに必要なのは、保存されたサービスポイント ID です。
受け取りポイント
購入者がサービスポイントの方法を選択すると、その下に PostNord service point の一覧が表示されます。最寄りのポイントが、市区町村ごとに距離とともに並びます。郵便番号が入力される前は、購入者に "Enter your postcode to choose a PostNord service point." と表示されます。選択内容は、チェックアウトの更新後も保持されます。
一覧が読み込まれている場合、ポイントの選択は必須です。選択しないと、チェックアウトは "Please select a PostNord service point." で止まります。選択したポイントは、クラシックチェックアウトとブロックチェックアウトのどちらでも、サーバー側で一覧と照合されます。
サービスポイントの選択が販売を妨げることはありません。一覧を読み込めない場合（API キーが未設定、PostNord API が停止中、郵便番号の近くにポイントがない場合など）、購入者には注意書きが表示され、それでも注文できます。その場合、PostNord は住所に最も近いサービスポイントに配送します。
管理画面の注文画面：配送先住所の下に、名前、住所、Service point ID とともに PostNord service point が表示されます。ポイントが選択されていない場合は、"not selected — PostNord delivers to the service point nearest to the shipping address" と表示されます。
サンクスページとマイアカウントの注文表示：PostNord service point: として、名前と住所が表示されます。
注文メール：HTML メールとテキストメールに、ポイントの名前、住所、ID が含まれます。
データベースでは、ポイントは注文のメタデータ _vfd_ptnd_servicepoint_id、_vfd_ptnd_servicepoint_name、_vfd_ptnd_servicepoint_address に保存されます。
ライセンスキー
本プラグインは、vibefox.net で取得した VibeFox ライセンスキーで動作します。ライセンスブロックは WooCommerce > Settings > Shipping > VibeFox PostNord の上部にあります。キーを License key に貼り付け、Activate をクリックします。ブロックには、ライセンスが有効な期限やお使いのドメインなど、ステータスが表示されます。Check now でステータスを再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除します。Manage licenses and domains in your account のリンクから、vibefox.net のアカウントを開けます。
1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、そのドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、PostNord はチェックアウトで購入者には表示されません。ログインしているストア管理者には、(unlicensed — visible to admins only) と表示された状態で引き続き表示されるため、キーを購入する前にプラグインを設定してテストできます。プラグインページと WooCommerce のページには、通知が表示されます。既存の注文には影響しません。
ライセンスの期限が切れても、プラグインは動作を続けます。ただし、アップデートとサポートには更新が必要です。ステータスはバックグラウンドで自動的に再確認されます。
トラブルシューティング
チェックアウトに PostNord が表示されない：ライセンスが有効か、Enable/Disable がオンか、購入者の国のゾーンに方法が追加されているか（または Ignore shipping zones がオンで、その国が許可されているか）を確認してください。その国の料金が設定されているか（国の行、* の行、Fallback cost）、重量制限、Minimum subtotal、Disabled shipping classes も確認してください。
サービスポイントを読み込めないという表示が出る：API key と Test mode の設定を確認してください。本番用キーはテスト環境では動作せず、その逆も同様です。Debug log をオンにし、WooCommerce > Status > Logs でソース "vfd-postnord" を確認してください。注文は行えます。その場合、PostNord は最寄りのサービスポイントに配送します。
想定外のサービスポイントが表示される：Agreement country を確認してください。提供されるサービスポイントは、この設定で決まります。
誤って送料が無料になる：Country prices の中で Price が 0 の行を確認してください。特に、+ Add country で追加して未入力のままになっている * の行に注意してください。また Free shipping from も確認してください。
ライセンスブロックにエラーが表示される：ブロック内のメッセージに従ってください。たとえば、キーが別のドメインで既に使われている場合は、vibefox.net のアカウントで枠を解放し、Check now をクリックしてください。サイトのアドレスを変更した場合は、Check now をクリックして、新しいドメインでキーを有効化してください。ライセンスサーバーに接続できない場合、プラグインは最後に確認できたステータスで動作を続けます。
アンインストール
プラグインを無効化しても、すべての設定は残り、キャッシュされたサービスポイントの一覧だけが消去されます。削除するには、無効化してから Plugins ページで削除してください。このプラグインのライセンスキーとライセンスステータスは、キャッシュされたサービスポイントの一覧とともに、常に削除されます。設定とゾーンの方法は、Remove data on uninstall がオンだった場合にのみ削除されます。それ以外の場合は、後で再インストールする際のために残ります。既存の注文は、配送の明細と保存されたサービスポイントを保持します。
PostNord は、その所有者の商標です。本プラグインは PostNord と提携しておらず、PostNord による承認も受けていません。