概述
VibeFox NZ Post 为 OpenCart 3 和 OpenCart 4 添加 NZ Post 配送方式，适用于从新西兰发运包裹的店铺。客户在结账的配送方式步骤中选择 NZ Post，然后按其地址和包裹支付 NZ Post 实时运费，或按国家和重量支付您设定的固定价格。
它适合在新西兰境内（CourierPost 和 ParcelPost 服务）及海外发货的新西兰店铺。本扩展在结账时计算运费。它不会创建运单、预约取件、跟踪包裹，也不允许客户选择自提点、邮政信箱（PO Box）或包裹柜。
主要功能
NZ Post 实时运费：来自 NZ Post ShippingOptions API 2.0 的国内和国际价格。使用 NZ Post 返回的最便宜服务，或仅使用您列出的服务代码。包括附加费和强制性附加服务，例如乡村派送。
合同费率：填写您的 NZ Post 商业账户号后，国际请求将返回您的账户费率。
固定价格作为备用：按国家设定价格，可选按重量分段（最高 1、2、3、5 公斤及超过 5 公斤），可按订单或按商品计算，另有备用费用。在未设置实时运费或 NZ Post 未返回运费时使用。
新西兰元和 GST 处理：NZ Post 的新西兰元价格按您的汇率换算为店铺货币。国内价格可以包含或不包含 15% 的 GST，因此使用税类时不会重复征税。
准确的包裹尺寸：重量和尺寸由 OpenCart 的重量和长度等级换算为公斤和厘米。未设置这些信息的商品使用默认重量和包裹尺寸。
快速结账：运费缓存 1 小时，失败的请求缓存 10 分钟。访问令牌会被缓存并自动更新。API 错误绝不会显示给客户。
配送规则：地理区域、购物车最低和最高重量、最低订单金额、订单金额满额免运费、税类，以及用于地理区域之外的国家列表。
订单详情与清晰的设置：后台订单页面会显示已计价的 NZ Post 服务。一个 Save 按钮，无需刷新页面；设置可以 JSON 格式导入和导出；扩展页面上还有可查看和清空的调试日志。
要求
OpenCart 3.0.x（已在 3.0.5.0 上测试）或 OpenCart 4.0.2 及更高版本（已在 4.1.0.3 上测试），PHP 8.0 或更高版本。一个下载包同时包含两个版本的安装包。实时运费需要 NZ Post API 访问权限（Client ID 和 Client Secret）。新西兰境内的费率还需要 NZ Post 商业账户。固定价格无需这些即可使用。需要来自 vibefox.net 的 VibeFox 许可证密钥（每个域名一个密钥）。