概要
VibeFox NZ Post は、ニュージーランドから荷物を発送するストア向けに、NZ Post を PrestaShop の配送業者として追加します。購入者はチェックアウトの配送ステップで NZ Post を選択し、住所と荷物に応じた NZ Post のリアルタイム料金、または国と重量ごとに貴店が設定した固定料金を支払います。
国内配送（CourierPost と ParcelPost のサービス）と海外配送を行うニュージーランドのストアに適しています。本モジュールはチェックアウト時に配送料を計算します。送り状の作成、集荷の予約、荷物の追跡は行わず、購入者が受取場所、私書箱（PO Box）、宅配ロッカー（parcel locker）を選ぶこともできません。
主な機能
NZ Post のリアルタイム料金：NZ Post ShippingOptions API 2.0 から国内・国際の料金を取得します。NZ Post が返す中で最も安いサービスを使うか、指定したサービスコードのみを使います。割増料金や、農村部への配達などの必須オプションも含まれます。
契約料金：NZ Post の法人口座番号を入力すると、国際リクエストで貴店の契約料金が返されます。
固定料金（予備）：国ごとの料金に、任意の重量区分（1 kg、2 kg、3 kg、5 kg まで、および 5 kg 超）を加えて設定できます。注文単位または商品単位で計算でき、予備の送料も設定できます。リアルタイム料金が設定されていない場合や、NZ Post が料金を返さない場合に使われます。
NZD と GST の処理：NZ Post の NZD 建て料金は、貴店の為替レートでストア通貨に換算されます。国内料金は 15% の GST を含めることも含めないこともでき、配送業者の税ルールと併用しても税金の二重課税を防ぎます。
正確な荷物サイズ：重量と寸法はストアの単位から kg と cm に換算されます。重量や寸法がない商品には、既定の重量と荷物サイズが使われます。
高速なチェックアウト：料金は 1 時間、失敗したリクエストは 10 分間キャッシュされます。アクセストークンはキャッシュされ、自動的に更新されます。API のエラーが購入者に表示されることはありません。
配送ルール：カートの最小・最大重量、最低注文金額、注文金額による送料無料、配送業者の税ルール、配送ゾーンを使わない場合に使う国のリスト。
PrestaShop 標準の配送業者：インストール時に作成され、Shipping > Carriers で管理されます。料金が確定した NZ Post サービスは、管理画面の注文ページに表示されます。デバッグログはモジュールのページで閲覧・消去できます。
動作要件
PrestaShop 8.0 から 9.x、PHP 8.0 以降。リアルタイム料金には NZ Post API へのアクセス（Client ID と Client Secret）が必要です。ニュージーランド国内の料金には、さらに NZ Post の法人口座が必要です。固定料金はこれらがなくても利用できます。vibefox.net で入手した VibeFox ライセンスキー（ドメインごとに 1 つ）。