概要
VibeFox NZ Post は、ニュージーランドから荷物を発送するストア向けに、OpenCart 3 と OpenCart 4 へ NZ Post の配送方法を追加します。購入者はチェックアウトの配送方法の段階で NZ Post を選び、お届け先と荷物に応じた NZ Post のリアルタイム料金を支払います。または、国と重量ごとに設定した固定料金を支払います。
国内（CourierPost と ParcelPost のサービス）と海外へ発送するニュージーランドのストアに適しています。この拡張機能は、チェックアウト時に配送料を計算します。送り状（配送ラベル）の作成、集荷の予約、荷物の追跡は行わず、購入者が集配ポイント、私書箱（PO Box）、パーセルロッカーを選ぶこともできません。
主な機能
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 を含めた金額でも除いた金額でも取り込めるため、税率クラスを使用しても税金が二重に計算されることはありません。
正確な荷物サイズ: 重量と寸法は、OpenCart の重量クラスと長さクラスから kg と cm に変換されます。これらが設定されていない商品には、既定の重量と荷物サイズが使われます。
高速なチェックアウト: 料金は 1 時間、失敗したリクエストは 10 分間キャッシュされます。アクセストークンはキャッシュされ、自動的に更新されます。API のエラーが購入者に表示されることはありません。
配送ルール: ジオゾーン、カートの最小・最大重量、最低注文金額、注文金額による送料無料、税率クラス、ジオゾーン以外で使う国のリスト。
注文の詳細と分かりやすい設定: 料金が計算された NZ Post のサービスが、管理画面の注文ページに表示されます。ページを再読み込みせずに保存できる Save ボタン、設定の JSON インポートとエクスポート、拡張機能のページで閲覧・消去できるデバッグログがあります。
要件
OpenCart 3.0.x（3.0.5.0 で動作確認）または OpenCart 4.0.2 以降（4.1.0.3 で動作確認）、PHP 8.0 以降。1 つのダウンロードに両方のバージョン用のパッケージが含まれています。リアルタイム料金には NZ Post API へのアクセス（Client ID と Client Secret）が必要です。ニュージーランド国内の料金には、さらに NZ Post の法人口座が必要です。固定料金だけであれば、これらは不要です。vibefox.net で入手できる VibeFox ライセンスキー（ドメインごとに 1 つ）。