概述
VibeFox Loggi 为 PrestaShop 添加巴西 Loggi 快递配送承运商。对于填写了完整 8 位 CEP 的巴西地址，购物车会以您的取货地址作为订单估算发送至 Loggi API，顾客在结账的配送步骤即可看到 Loggi 运费。按国家和重量设置的固定运费作为安全备用。
本模块适合已拥有支持 API 访问的 Loggi 企业账户的巴西店铺，也适合希望在无需账户的情况下使用简单 Loggi 运费表的店铺。模块在结账时计算运费。它不会创建 Loggi 订单或发货单，不打印面单，不跟踪包裹，不显示送达时间，也不提供自提点。
主要功能
实时 Loggi 运费：运费来自 Loggi GraphQL API 的订单估算，需填写您的 Loggi 账户电子邮件、API 密钥和 Shop ID。支持 Staging 环境。
真实 Loggi 包裹：重量（克）和尺寸（厘米）根据您店铺的单位换算。商品会打包成最大 55 × 55 × 55 cm、20 kg 的包裹；较大的购物车会分多次请求报价，并将总额相加。
安全的货币处理：Loggi 运费以巴西雷亚尔计价。如果您店铺的默认货币不是 BRL，将按您设置的 BRL 汇率换算。没有汇率时，仅使用固定运费，并且模块页面会显示警告。
固定运费作为备用：按国家设置的运费表，包含 XS 至 XL 的重量栏，可按订单或按商品计费，另设所有其他国家的运费。在 API 未配置、非巴西地址、没有完整 CEP 或 Loggi 未返回价格时使用。
快速结账：Loggi 实时运费缓存 1 小时，失败的估算缓存 10 分钟。若无法连接 Loggi，请求将暂停 2 分钟。API 错误绝不会显示给顾客。
配送规则：购物车最小和最大重量、最低订单金额、订单金额达到后免运费、承运商税务规则。
标准 PrestaShop 承运商：安装时会自动创建承运商。配送区域、客户组和尺寸限制像往常一样在 Shipping > Carriers 中管理，或者可以为一组国家提供 Loggi 配送。
后台调试日志：在模块页面查看和清空日志。API 密钥和顾客地址绝不会被记录。
系统要求
PrestaShop 8.0 至 9.x，PHP 8.0 或更高版本。实时运费需要一个可访问 Loggi GraphQL API 的 Loggi 企业账户（账户电子邮件、API 密钥和 Shop ID）。固定运费无需该账户即可使用。还需要一个来自 vibefox.net 的 VibeFox 许可证密钥（每个域名一个密钥）。