VibeFox 99Minutos for WooCommerce — 帮助
系统要求
WordPress：5.8 或更高版本。
WooCommerce：5.0 或更高版本，已安装并启用。没有它插件无法启用。
PHP：8.0 或更高版本。
99minutos API 密钥（仅用于覆盖检查）：请向您的 99minutos 客户经理索取，或在 99minutos 开发者门户（developers.99minutos.com）获取。沙盒和正式环境的密钥不同。如果您只使用价格矩阵，则不需要 API 密钥。
VibeFox 许可证密钥：在 vibefox.net 购买。一个密钥只能在一个域名上使用。
安装
1. 在 WordPress 中进入 Plugins > Add New > Upload Plugin，选择插件的 ZIP 文件，然后点击 Install Now。您也可以通过 FTP 将 vfd_99minutos 文件夹上传到 /wp-content/plugins/。
2. 点击 Activate。
3. 打开设置：WooCommerce > Settings > Shipping > VibeFox 99Minutos，或在插件列表页面点击插件名称下方的 Settings。
4. 在页面顶部的许可证区块中输入您的 VibeFox 许可证密钥，然后点击 Activate。
5. 填写 Price matrix（至少一行，例如“* Default”），并可选填 API 密钥和覆盖检查模式（参见“配置”一节）。
6. 在 WooCommerce > Settings > Shipping > Shipping zones 中，将 VibeFox 99Minutos 添加到覆盖墨西哥、哥伦比亚、智利或秘鲁的配送区域。
配置
所有设置都在一个页面中：WooCommerce > Settings > Shipping > VibeFox 99Minutos。它们适用于所有配送区域。将该方式添加到某个区域时，区域窗口中只有一个字段：
Method title (zone)：此区域中顾客看到的名称。留空则使用全局的 Method title。
保存设置时，如果价格矩阵为空，或选择了覆盖检查模式却没有 API 密钥，页面会发出警告。
通用
Enable/Disable:一次性在所有配送区域中启用 99Minutos。该方式还必须添加到覆盖墨西哥、哥伦比亚、智利或秘鲁的配送区域。默认：开启。
Method title:结账时向顾客显示的配送方式名称。配送区域可以覆盖此名称。默认：99Minutos。
Tax status：Taxable 会在运费上加收 WooCommerce 税费，None 则不加。
99minutos API（覆盖检查）（可选）
API 仅用于检查 99minutos 能否配送至顾客的邮政编码。价格始终来自价格矩阵。
Coverage check：是否检查邮政编码，以及如何检查。
启用覆盖检查后，只有顾客输入邮政编码之后该方式才会出现。结果会被缓存：覆盖 6 小时，不覆盖 30 分钟，API 错误 5 分钟。仅将邮政编码发送给 99minutos。
API key：您的 99minutos API 密钥，以 Bearer 令牌形式发送至 99minutos 覆盖检查端点。开启覆盖检查时必填。该字段已隐藏。
Environment：Sandbox (test)（默认）或 Production。沙盒和正式环境使用不同的 API 密钥，请选择与您的密钥相符的环境。
费率
价格以您商店的货币计，按您输入的数值使用，不做换算。
Price matrix：目的国家与价格的表格。点击 + Add country 添加一行，点击叉号删除一行。每行包括 Country、Base price，以及 XS（最多 1 千克）、S（最多 2 千克）、M（最多 3 千克）、L（最多 5 千克）和 XL（超过 5 千克）各尺寸的价格。尺寸价格留空或为 0 时，使用 Base price。* Default 行适用于没有单独行的国家。小数点和逗号均可作为小数分隔符；负价格保存为 0。在矩阵至少有一行之前，结账时不会显示该配送方式。
Calculation：Per order — size by the total cart weight（默认）按整个购物车的包裹尺寸收取一个价格。Per item — each unit priced by its own weight 按每件商品自身重量对应的尺寸为其定价，然后相加。
Free shipping：开启购物车小计免运费。
Free shipping from：购物车小计（扣除折扣后、不含税）达到此金额时，运费为 0。仅在 Free shipping 开启时使用。
限制
Min weight (kg)：如果购物车低于此重量，则隐藏该方式。0 表示不限制。商品重量会从您商店的重量单位换算。
Max weight (kg)：如果购物车超过此重量，则隐藏该方式。默认：25。0 表示不限制。
Minimum subtotal：仅当购物车小计（扣除折扣后、不含税）至少达到此金额时才显示该方式。留空则始终显示。
Excluded shipping classes：如果购物车中有任何商品属于这些 WooCommerce 配送类别，则隐藏该方式。
Restrict countries：仅为下列国家提供该方式。这是配送区域之上的附加筛选：该方式仍需添加到某个配送区域。当一个区域涵盖多个国家时很有用。
Countries：99minutos 国家选项（墨西哥、哥伦比亚、智利、秘鲁）。仅在 Restrict countries 开启时使用。留空则允许所有 99minutos 国家。
高级
Debug log：将费率计算记录到 WooCommerce > Status > Logs（来源为“vfd-99minutos”）。即使此选项关闭，API 错误也会被记录。API 密钥以及顾客姓名和地址从不记录。
Remove data on uninstall：开启后，删除插件会移除其设置和覆盖缓存。停用插件不会删除任何内容。配送区域中的配送方式和订单在任何情况下都会保留。
结账时的工作方式
只有当配送国家为墨西哥、哥伦比亚、智利或秘鲁时才会提供该方式（如果开启了 Restrict countries，则国家还必须在 Countries 列表中）。顾客输入配送地址后，插件会检查购物车重量限制、Minimum subtotal 和 Excluded shipping classes。
如果开启了覆盖检查模式，插件随后会向 99minutos API 查询该邮政编码是否在覆盖范围内。请求超时为 10 秒，结果会被缓存，因此同一邮政编码不会再次触发请求。API 错误从不向顾客显示：在 Strict 模式下隐藏该方式，在 Soft 模式下使用价格矩阵价格。免运费不会绕过覆盖检查。
价格取自配送国家对应的矩阵行，或 * Default 行。如果两者都不存在，则隐藏该方式。如果开启了 Free shipping 且购物车小计达到 Free shipping from，则费率为 0。
该方式适用于经典结账以及购物车和结账区块。它兼容 WooCommerce 高性能订单存储（HPOS）。
插件不会从 99minutos 获取实时运费报价：价格始终来自您的矩阵。它不会在 99minutos 中创建运单或订单，不打印面单（guides），不跟踪包裹，不提供 Punto99 取件点，也不处理货到付款。请像平常一样在您的 99minutos 账户中创建运单。
许可证密钥
插件需要来自 vibefox.net 的 VibeFox 许可证密钥。许可证区块位于 WooCommerce > Settings > Shipping > VibeFox 99Minutos 页面顶部。将密钥粘贴到 License key 中，然后点击 Activate。该区块会显示状态，例如许可证有效期截止日期以及您的域名。使用 Check now 重新检查状态，使用 Change key 输入其他密钥，使用 Remove key 将其从本站点移除。Manage licenses and domains in your account 链接可打开您的 vibefox.net 账户。
一个密钥只能在一个域名上使用。从站点移除密钥并不会释放域名名额。请在您的 vibefox.net 账户中释放名额。
没有有效密钥时，99Minutos 不会在结账时向顾客显示。已登录的店铺管理员仍能看到它，并标有 (unlicensed — visible to admins only)，这样您可以在购买密钥之前设置和测试插件。插件列表页面和 WooCommerce 页面上会出现提醒。现有订单不受影响。
许可证到期后，插件仍可继续工作，但更新和支持需要续费。状态会在后台自动重新检查。
故障排除
99Minutos 未出现在结账页面：请检查许可证是否有效、Enable/Disable 是否开启，以及该方式是否已添加到顾客地址所在的配送区域。配送国家必须是墨西哥、哥伦比亚、智利或秘鲁。请确认 Price matrix 中有该国家的行或 * Default 行，并检查重量限制、Minimum subtotal、Excluded shipping classes 和 Restrict countries。
只有输入邮政编码后该方式才会出现：启用覆盖检查时这属于正常现象。在 Strict 模式下，只有 API 确认覆盖范围时它才会出现。
在 Strict 模式下该方式始终隐藏：开启 Debug log，重新加载结账页面，然后打开 WooCommerce > Status > Logs（来源为“vfd-99minutos”）。HTTP 401 或 403 错误表示 API 密钥被拒绝：请检查密钥，以及 Environment 是否与之匹配（沙盒和正式环境的密钥不同）。如果在 API 不可用时顾客仍应获得价格矩阵中的价格，请使用 Soft 模式。
价格与您的预期不符：请检查 Calculation（按订单或按商品）、商品重量以及您商店的重量单位。空白或为 0 的尺寸价格会回退到 Base price。
其他国家：开发者可以使用 vfd_99m_supported_countries 过滤器更改支持的国家列表。
许可证区块显示错误：请按区块中的提示操作。例如，如果该密钥已在另一个域名上使用，请在您的 vibefox.net 账户中释放一个名额，然后点击 Check now。如果站点地址已更改，请点击 Check now，为新域名激活密钥。如果无法连接许可证服务器，插件会继续使用最后已知的状态运行。
卸载
停用插件会保留所有数据。要移除插件，请在 Plugins 页面停用并删除它。本插件的许可证密钥和许可证状态始终会被移除。只有在开启了 Remove data on uninstall 的情况下，设置和覆盖缓存才会被移除；否则会保留，以便日后重新安装。配送区域中的配送方式和现有订单会被保留。
99minutos 是其各自所有者的商标。本插件与 99minutos 无关联，也未获得 99minutos 的认可或背书。