概述
VibeFox Correos CityPaq 为 OpenCart 3 和 OpenCart 4 添加配送至西班牙 Correos 智能 CityPaq 包裹柜的配送方式。顾客在结账的配送方式步骤中选择 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 分钟。只有顾客选择 CityPaq 时才会请求 Correos。
订单中的包裹柜：在配送方式步骤中必填，并在服务器端验证。包裹柜会添加到订单的配送方式中，因此会显示在顾客的订单历史、订单电子邮件、发票和管理后台中，您也可以在后台修改。
配送规则：地理区域或所有西班牙地址，购物车最小和最大重量（默认 30 kg），最低订单金额，订单金额满足条件时免运费，税务类别。
清晰的设置页面：分区显示，只需点击一次 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 许可证密钥（每个密钥对应一个域名）。