概要
VibeFox Correos CityPaq は、スペインにある Correos のスマート宅配ロッカー CityPaq への配送を、OpenCart 3 および OpenCart 4 の配送方法として追加します。購入者はチェックアウトの配送方法の手順で CityPaq ロッカーを選択し、そのロッカーは注文に保存されます。
Correos は CityPaq の料金 API を公開していないため、料金は荷物のサイズ別にお客様が用意した料金表から取得されます。本拡張機能は、配送の事前登録、ラベルの印刷、集荷の依頼、地図の表示、荷物の追跡は行いません。
主な機能
荷物サイズごとの料金: 基本料金と、XS（1 kg まで）、S（2 kg まで）、M（3 kg まで）、L（5 kg まで）、XL（5 kg 超）の任意の料金を、注文単位または商品単位で設定できます。
リアルタイムの Correos ロッカー一覧: Correos API の認証情報を使うと、購入者は郵便番号に対応する有効な CityPaq ロッカーから選択するか、別の郵便番号を検索できます。郵便番号にロッカーがない場合は、近くの郵便番号が表示されます。
その他のロッカーの選び方: 購入者は、Correos CityPaq ファインダーで見つけたロッカーのコードまたは住所を入力するか、お客様が用意したロッカー一覧から選択できます。
チェックアウトが止まらない仕組み: Correos の一覧を読み込めない場合、購入者はロッカーを手動で入力できます。一覧は 12 時間、エラーは 10 分間キャッシュされます。Correos への問い合わせは、購入者が CityPaq を選択したときにのみ行われます。
注文に含まれるロッカー: 配送方法の手順で必須となり、サーバー側でも検証されます。ロッカーは注文の配送方法に追加されるため、購入者の注文履歴、注文メール、請求書、管理画面に表示され、管理画面からも変更できます。
配送ルール: ジオゾーンまたはスペイン国内のすべての住所、カートの最小および最大重量（既定値は 30 kg）、最低注文金額、注文金額に応じた送料無料、税率クラス。
わかりやすい設定ページ: ページを再読み込みせずに 1 つの Save ボタンで保存できるセクション構成、JSON のインポートとエクスポート、最後の Correos API エラーを表示する設定の警告。
管理画面のデバッグログ: 拡張機能のページでログを確認して消去できます。認証情報や個人データがログに記録されることはありません。
要件
OpenCart 3.0.x（3.0.5.0 で検証済み）または OpenCart 4.0.2 以降（4.1.0.3 で検証済み）、PHP 8.0 以降。ダウンロードファイルには両方のバージョン用のパッケージが含まれています。リアルタイムの Correos ロッカー一覧には、"terminals" API の Correos API 認証情報が必要です。手動入力とお客様のロッカー一覧は、認証情報がなくても利用できます。vibefox.net で取得した VibeFox ライセンスキー（1 つのキーは 1 つのドメインで使用可能）。