本文详解如何通过 woocommerce_cart_calculate_fees 钩子为 WC()->cart->add_to_cart() 手动加入的商品自动应用预设税类（Tax Class），确保订单后台显示税额、结账流程合规，避免税额丢失或不显示问题。
本文详解如何通过 `woocommerce_cart_calculate_fees` 钩子为 `wc()->cart->add_to_cart()` 手动加入的商品自动应用预设税类（tax class），确保订单后台显示税额、结账流程合规，避免税额丢失或不显示问题。
在 WooCommerce 中，使用 WC()->cart->add_to_cart() 手动添加商品时，系统默认不会自动触发税额重算逻辑——即使该商品在后台已配置了正确的税类（如 “Standard”、“Reduced Rate” 或自定义税类），其税额也不会自动计入购物车总额，导致订单管理界面（ACP）的“Tax”列为空、发票无税项、结算金额异常。
根本原因在于：WooCommerce 的税额计算依赖于完整的购物车生命周期钩子（如 woocommerce_before_calculate_totals 和 woocommerce_cart_calculate_fees），而单纯调用 add_to_cart() 仅完成商品入仓，并未主动触发后续的税费推导与挂载流程。
✅ 正确解决方案是：利用 woocommerce_cart_calculate_fees 钩子，在每次购物车刷新/重算时，显式调用 WC_Cart::add_fee() 并指定税类参数，从而让 WooCommerce 将该费用识别为可征税项目（而非免税杂费）。
以下为推荐实现方式（兼容 WooCommerce 6.0+，支持前后台一致性）：
add_action( 'woocommerce_cart_calculate_fees', 'add_taxed_cart_fee_for_manual_items' );
function add_taxed_cart_fee_for_manual_items() {
// 仅在前台/结账流程中执行税额计算（排除后台管理页干扰）
if ( is_admin() && ! defined( 'DOING_AJAX' ) ) {
return;
}
$cart = WC()->cart;
// 示例：为所有含特定产品 ID 的手动添加项补税（可按需扩展逻辑）
foreach ( $cart->get_cart() as $cart_item_key => $cart_item ) {
$product = $cart_item['data'];
$tax_class = $product->get_tax_class(); // 获取商品实际设置的税类
// 若商品有非空税类且尚未被标记为已处理，可在此处动态触发税额关联
// ⚠️ 注意：WooCommerce 不允许直接为单个商品“手动设税”，而是通过 fee + tax_class 参数交由系统统一计算
if ( ! empty( $tax_class ) && $tax_class !== 'zero-rate' ) {
// 关键：使用 add_fee 并传入第4个参数 'true'（$taxable = true）和第5个参数 $tax_class
// 这将使该费用参与税率计算，而非作为固定免税附加费
$cart->add_fee(
sprintf( 'Tax for %s', $product->get_name() ),
0, // 金额设为 0，由系统根据税率和商品价格自动计算 → 实际应通过 totals 机制联动
true, // taxable: true 是关键！
$tax_class // 指定税类，确保匹配店铺税率规则
);
}
}
}
⚠️ 重要说明与最佳实践：
- 不要尝试用 set_tax_class() 直接修改 $cart_item['data']：WC_Product 对象在购物车中是只读副本，修改后不会触发重新计税。
- add_fee() 的第四个参数必须为 true：若传 false（默认值），该费用将被视作免税项，完全绕过税率引擎。
- 金额建议设为 0 并配合 true + tax_class：WooCommerce 会根据当前购物车中该税类对应的有效税率（基于用户位置、商品类型等）自动计算应缴税额，确保合规性。
- 务必添加 is_admin() && ! DOING_AJAX 判断：避免在订单管理后台（如编辑订单页面）重复触发，造成数据污染或 PHP Notice。
- 若需对特定手动添加的商品强制应用税（例如通过 AJAX 添加后立即生效），可在添加后调用 $cart->calculate_totals()，但仍需依赖上述钩子完成最终税额挂载。
最终效果：订单详情页、电子邮件通知、后台订单列表（Orders → Edit Order）中的 “Tax” 列将正确显示计算出的税额，报表与税务申报数据保持一致。
简言之：WooCommerce 的税额不是“附加”出来的，而是“推导”出来的；你只需确保商品携带正确的税类上下文，并在 woocommerce_cart_calculate_fees 钩子中声明其可税性，系统自会完成其余工作。
