概要
VibeFox Correos CityPaq は、スペインの Correos CityPaq スマート宅配ロッカーへの配送を、PrestaShop の配送業者として追加します。購入者はチェックアウトの配送ステップで 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）、最低注文金額、注文金額に応じた送料無料、配送業者の税ルール。
PrestaShop 標準の配送業者: インストール時にスペインのゾーンに配送業者が作成されます。ゾーン、顧客グループ、サイズ制限は Shipping > Carriers で管理するほか、Ignore shipping zones を使えば、スペイン国内のすべての住所に CityPaq を提供できます。
管理画面のデバッグログ: モジュールページでログの閲覧と消去ができます。認証情報と個人データがログに記録されることはありません。
要件
PrestaShop 8.0 から 9.x、PHP 8.0 以降。リアルタイムの Correos ロッカー一覧には、"terminals" API 用の Correos API 認証情報が必要です。手動入力や独自のロッカー一覧は、認証情報がなくても利用できます。vibefox.net で取得した VibeFox ライセンスキー（ドメインごとに 1 つ）。