概述
VibeFox Correios 为 OpenCart 3 和 OpenCart 4 添加 Correios（巴西邮政）配送方式。巴西顾客可以看到其 CEP 和包裹对应的 PAC、SEDEX 或其他 Correios 服务的实时运费，该运费由 Correios 运费 API 根据您的合同凭据计算得出。其他国家的顾客，以及未配置凭据的巴西顾客，则按国家和购物车重量获得您设定的固定运费。
本扩展适合拥有 Correios 合同和邮寄卡（cartão de postagem）的巴西店铺。扩展在结账时计算配送运费。它不会生成运单或预先登记邮件，不追踪包裹，不显示配送时效，不添加额外服务，也不允许顾客选择 Correios 网点。每个店铺只提供一种 Correios 服务。
主要功能
实时 Correios 运费：根据始发地和目的地 CEP、包裹重量和尺寸，从 Correios Web Services 运费 API 获取运费，并采用您合同中的价格。
自选服务：PAC、SEDEX、SEDEX 12、SEDEX 10 和 SEDEX Hoje（零售或合同代码）、Correios Mini Envios，或合同中的任何其他服务代码。服务会与订单一同保存，并显示在管理后台的订单页面上。
准确的包裹数据：重量和尺寸根据商品的重量和长度单位类别换算，未设置重量的商品使用默认重量，并应用 Correios 最小尺寸。支持盒装、信封或卷筒格式。
安全的货币处理：Correios 运费以 BRL 计价。默认货币不是 BRL 的店铺需输入 BRL 汇率；未输入汇率时不会使用实时运费。价格以顾客的货币显示。
快速结账：运费缓存 1 小时，失败的请求缓存 10 分钟。API 令牌会自动更新。API 错误绝不会显示给顾客。
固定运费：按国家设置的表格，包含按购物车重量（XS 至 XL）划分的运费和基础运费，可按订单或按商品计算。用于巴西以外的地区，也作为备用运费。
配送规则：地理区域或国家列表、购物车最小和最大重量、最低订单金额、订单金额达到一定数额即免运费、税务类别。
清晰的设置页面：分区显示，只需点击一次 Save 按钮即可保存且无需刷新页面；支持 JSON 导入和导出；提供 Homologation（测试）模式，以及可在扩展页面查看和清空的调试日志，日志中不包含凭据或顾客 CEP。
系统要求
OpenCart 3.0.x（已在 3.0.5.0 上测试）或 OpenCart 4.0.2 及更高版本（已在 4.1.0.3 上测试），PHP 8.0 或更高版本。一个下载包同时包含两个版本的安装包。实时运费需要合同的 Correios Web Services 凭据：Meu Correios 用户、API 访问代码和邮寄卡号码。固定运费无需这些凭据即可使用。需要一个来自 vibefox.net 的 VibeFox 许可证密钥（每个密钥对应一个域名）。