VibeFox Delhivery for WooCommerce — 帮助
系统要求
WordPress：5.8 或更高版本。
WooCommerce：5.0 或更高版本，已安装并启用。未安装时插件无法激活。
PHP：8.0 或更高版本。
Delhivery API 令牌（仅用于实时运费）：登录 Delhivery One，打开 Settings > API setup。Delhivery 帮助文章 “API token generation” 说明了具体步骤。测试令牌可用于 staging 环境。您还需要取件地点的 6 位 PIN 码。如果仅使用固定价格，则无需令牌。
VibeFox 许可证密钥：在 vibefox.net 购买。一个密钥只能用于一个域名。
安装
1. 在 WordPress 中进入 Plugins > Add New > Upload Plugin，选择插件 ZIP 文件并点击 Install Now。您也可以通过 FTP 将 vfd_delhivery 文件夹上传到 /wp-content/plugins/。
2. 点击 Activate。
3. 打开设置：WooCommerce > Settings > Shipping > VibeFox Delhivery，或在插件页面点击插件名称下方的 Settings。
4. 在页面顶部的许可证区块中输入您的 VibeFox 许可证密钥，然后点击 Activate。
5. 输入 API 令牌和发货 PIN 码，选择 Express 或 Surface 以及 Pre-paid 或 COD。如果您的商店货币不是 INR，请输入汇率。可选择输入固定价格（参见“配置”）。
6. 在 WooCommerce > Settings > Shipping > Shipping zones 中，将 VibeFox Delhivery 添加到配送区域（例如印度），或开启 Ignore zones 并选择国家。
配置
所有设置都在一个页面中：WooCommerce > Settings > Shipping > VibeFox Delhivery。它们适用于所有配送区域。将该方式添加到某个区域时，区域窗口中只有一个字段：
Title (zone)：客户在此区域看到的名称。留空则使用全局的 Method title。
每次保存设置时，缓存的 Delhivery 运费都会被清除。价格和金额可以输入 “9.99” 或 “9,99”。
常规
Enable/Disable：一次性在所有区域启用或停用该方式。
Method title：结账时显示的配送方式名称。默认：Delhivery。区域可以用自己的 Title 覆盖它。
Tax status：Taxable 会在运费上加收 WooCommerce 税费，None 则不加收。
Delhivery API 账户（仅实时运费需要）
Environment：Production (track.delhivery.com)（默认）或 Staging / test account (staging-express.delhivery.com)。仅在使用 Delhivery 测试令牌时使用 Staging。
API token：您的 Delhivery API 令牌。仅在授权请求头中发送，且从不写入日志。
Origin pincode：取件地点或仓库的 6 位 PIN 码，例如 110001。
实时运费
对于具有有效 6 位 PIN 码的印度目的地，会请求实时运费，适用于正向（送达）运输。
Shipping mode：用于计算运费的 Delhivery 计费模式：Express（默认）或 Surface。
Payment type：发送给 Delhivery 的付款类型：Pre-paid（默认）或 COD（货到付款，Delhivery 会加收其 COD 费用）。插件不会根据客户选择的支付方式切换该设置。
Rate amount：Delhivery 返回含 GST 和不含 GST 的运费。
INR to (store currency) conversion rate：Delhivery 运费以印度卢比计。如果您的商店货币不是 INR，请输入一个卢比等于多少单位您的货币，例如 0.011。留空则不使用实时运费，改用固定价格，并在设置上方显示警告。商店货币为 INR 时无需填写。
固定价格（无实时运费时使用）
当尚未设置令牌或 PIN 码、目的地在印度境外、PIN 码不在服务范围内或 API 返回错误时，使用固定价格。价格以您的商店货币计。
Prices per country：每行一条，格式为 COUNTRY_CODE:price，例如 IN:120。在备用价格之前检查。
Fallback price：在实时运费和国家价格都不适用时使用。留空则隐藏该方式。0 表示免费。
Fixed price is charged：Per order 只收取一次价格。Per item (price × quantity) 则按购物车中的商品数量相乘。Delhivery 实时运费始终针对整个包裹的重量。
条件
Free shipping from：购物车小计达到此金额时免运费。不会向 Delhivery 发送请求。留空则关闭此功能。
Show from subtotal：仅当购物车小计达到此金额时才显示该方式。留空则始终显示。
Min weight (kg)：显示该方式所需的最小购物车重量。0 表示无限制。
Max weight (kg)：如果购物车重量超过此值则隐藏该方式。默认：30。0 表示无限制。
商品重量会从您的商店重量单位换算为千克。运费使用实际购物车重量（商品重量之和），不计算体积重量或包装箱。
Excluded shipping classes：如果购物车中的任一商品属于这些 WooCommerce 配送类别，则隐藏该方式。
无配送区域时的可用性
Ignore zones：在不将 Delhivery 添加到配送区域的情况下，为下方所列国家提供该方式。
Countries：该模式的目的国家。留空则使用您发货的所有国家。仅在 Ignore zones 开启时使用。
高级
Debug log：将运费计算记录到 WooCommerce > Status > Logs，来源为 vfd_delhivery。即使此选项关闭，API 错误也始终会记录。令牌和客户的完整 PIN 码从不记录。
Remove data on uninstall：开启后，删除插件将移除其所有设置、区域方式和缓存的运费。停用插件从不删除任何内容。
结账时的工作方式
当客户输入配送地址时，WooCommerce 会向插件请求运费。插件首先检查购物车重量、小计和排除的配送类别。如适用免运费，客户将获得免费配送，且不会向 Delhivery 发送任何请求。
对于具有有效 6 位 PIN 码的印度地址，插件会向 Delhivery 发送发货和收货 PIN 码、以克为单位的购物车重量、配送模式和付款类型，并将返回的金额换算为您的商店货币后显示。每个响应缓存 1 小时。失败的请求缓存 10 分钟，这样结账页面在每次刷新时都无需等待 Delhivery。API 超时时间为 10 秒。
如果没有实时运费，则使用该国家的价格或备用价格。若两者均未设置，则隐藏该方式。客户永远不会看到 API 错误。
该方式适用于经典结账以及购物车和结账区块。它与 WooCommerce 高性能订单存储（HPOS）兼容。
插件计算运费并显示跟踪链接。它不会创建运单或面单，不打印标签，不预约取件或交接清单，不检查 PIN 码服务范围，不估算送达日期，不同步物流状态，也不报价 Delhivery 国际运费。在印度境外仅使用固定价格。
订单与物流跟踪
在订单页面的配送地址下方，Delhivery 区块会显示配送模式（Express 或 Surface）和价格来源：Delhivery 实时运费、固定价格或免运费门槛。
在 Delhivery One 中创建运单，然后将其 AWB 粘贴到 Delhivery AWB / tracking number 字段中并保存订单。后台会出现 Track on delhivery.com 链接。客户在“我的账户”的订单页面以及订单邮件（HTML 和纯文本）中会看到带链接的 Delhivery tracking。AWB 会在订单状态之前保存，因此如果您在同一次保存中完成订单，“已完成订单”邮件已经包含 AWB。
许可证密钥
插件需要一个来自 vibefox.net 的 VibeFox 许可证密钥。许可证区块位于 WooCommerce > Settings > Shipping > VibeFox Delhivery 页面顶部。将密钥粘贴到 License key 中并点击 Activate。该区块会显示状态，例如许可证有效期至何时以及您的域名。使用 Check now 重新检查状态，Change key 输入其他密钥，Remove key 将其从本站点移除。链接 Manage licenses and domains in your account 会打开您的 vibefox.net 账户。
一个密钥只能用于一个域名。从站点移除密钥不会释放域名名额，请在您的 vibefox.net 账户中释放名额。
没有有效密钥时，Delhivery 不会在结账时向客户显示。已登录的商店管理员仍可看到它，并带有标记 (unlicensed — visible to admins only)，以便您在购买密钥前设置和测试插件。插件页面和 WooCommerce 页面会显示提醒。现有订单不受影响。
许可证到期后，插件仍可继续工作，但更新和支持需要续费。状态会在后台自动重新检查。
故障排除
Delhivery 没有出现在结账页面：请检查许可证是否有效、Enable/Disable 是否开启，以及该方式是否已添加到客户所在国家的区域（或 Ignore zones 已开启且该国家在允许列表中）。检查重量限制、Show from subtotal 和 Excluded shipping classes。没有实时运费时，需要设置国家价格或 Fallback price。
实时运费不显示：请检查 API 令牌、有效的 Origin pincode，以及在非 INR 商店中的汇率。客户必须输入有效的 6 位印度 PIN 码。开启 Debug log，然后打开 WooCommerce > Status > Logs，来源 vfd_delhivery，查看 API 错误，例如某个 PIN 码不在服务范围内。
运费被重复征税：Delhivery 的总金额已含 GST。请将 Rate amount 设为 Gross amount (excluding GST)，或将 Tax status 设为 None。
测试：将 Environment 设为 Staging，并使用 Delhivery 测试令牌。
修改后运费显示过期：保存设置页面。这会清除缓存的 Delhivery 运费。
许可证区块显示错误：请按照区块中的提示操作。例如，如果该密钥已在其他域名上使用，请在 vibefox.net 账户中释放名额，然后点击 Check now。如果站点地址已更改，请点击 Check now，为新域名激活密钥。如果无法连接许可证服务器，插件将继续使用上次已知的状态运行。
卸载
停用插件会保留所有数据。要移除插件，请先停用，然后在 Plugins 页面中删除。本插件的许可证密钥和许可证状态始终会被移除。只有在 Remove data on uninstall 开启时，设置、区域方式和缓存的运费才会被移除；否则将保留，以便日后重新安装。AWB 号码会保留在订单中，现有订单也会保留其配送行。
Delhivery 是其各自所有者的商标。本插件与 Delhivery 无关联，也未获得 Delhivery 的认可。