基于自定义税类修改购物车总计中的默认价格

需求 #

当使用custom-tax-class税类的商品加入购物车时，税费计算需基于售价与采购价的差额，而非商品售价本身。

原有尝试代码 #

add_filter('woocommerce_calc_tax', 'modify_price_for_tax_calculation_v4', 10, 5);
function modify_price_for_tax_calculation_v4( $taxes, $price, $rates, $price_includes_tax, $suppress_rounding ) {

    if ( is_admin() && ! defined( 'DOING_AJAX' ) ) {
        return;
    }
    // 获取全局购物车
    $cart = WC()->cart;
    if (!$cart) return $taxes; // 确保购物车存在

    // 遍历每个购物车商品
    foreach ($cart->get_cart() as $cart_item_key => $cart_item) {
        $product = $cart_item['data'];

        // 检查商品是否使用自定义税类
        if ( 'custom-tax-class' === $product->get_tax_class() ) {
            // 获取采购价（替换'_purchase_price'为实际元键）
            $purchase_price = 100;

            // 确保商品价格为浮点数
            $product_price = floatval( $product->get_price() );
            
            $quantity = intval($cart_item['quantity']);

            // 计算差额（商品价格-采购价）
            $margin = max(($product_price - $purchase_price) * $quantity, 0); // 确保差额非负

            // 对差额而非商品价格应用税率
            foreach ( $rates as $rate_id => $rate ) {
            
                // 遍历每个购物车商品（原代码注释残留）
            
                $rate_percentage = floatval( $rate['rate']); // 将税率转换为小数
                $modified_price = round( $margin * $rate_percentage, 2 ); // 基于差额计算税费

                // 设置修改后的税费金额
                $taxes[$rate_id] = $modified_price;
            }
        }
    }

    return $taxes; // 返回修改后的税费值
}

遇到的问题 #

• 错误修改了标准税类商品的税费，而非仅针对自定义税类商品生效
• 计税结果错误：示例中商品售价$200、采购价$100（差额$100），自定义税类税率10%，应缴税费应为$10，但实际显示$20
• 更新后的代码仅在添加1件商品时有效，多件商品加入购物车时失效

更新说明 #

1. 需要过滤计税时使用的$price变量（即应税金额），而非直接修改$taxes数组，通过将计税基数替换为售价与采购价的差额，来修正购物车总计中的税费计算
2. 需解决多件商品场景下的失效问题，确保批量商品的计税逻辑正确

修复后的代码 #

add_filter('woocommerce_cart_item_taxable_amount', 'custom_tax_class_taxable_amount', 10, 2);
function custom_tax_class_taxable_amount( $taxable_amount, $cart_item ) {
    // 仅在前台或AJAX请求中生效，避免后台操作受影响
    if ( is_admin() && ! defined( 'DOING_AJAX' ) ) {
        return $taxable_amount;
    }

    $product = $cart_item['data'];
    
    // 检查商品是否使用目标自定义税类
    if ( 'custom-tax-class' === $product->get_tax_class() ) {
        // 获取采购价（替换为实际存储采购价的元键，例如'_purchase_price'）
        $purchase_price = floatval( get_post_meta( $product->get_id(), '_purchase_price', true ) );
        // 若采购价未设置，使用默认值0
        $purchase_price = $purchase_price ?: 0;

        $product_price = floatval( $product->get_price() );
        $quantity = intval( $cart_item['quantity'] );

        // 计算单商品差额，确保非负后乘以数量得到总应税金额
        $unit_margin = max( $product_price - $purchase_price, 0 );
        $taxable_amount = $unit_margin * $quantity;
    }

    return $taxable_amount;
}

代码说明 #

• 使用woocommerce_cart_item_taxable_amount钩子，精准针对单个购物车项修改应税金额，不会影响其他税类的商品
• 关联当前购物车项的商品，仅对custom-tax-class税类的商品生效
• 正确处理采购价的获取（替换为实际元键），并确保差额非负
• 自动适配多件商品场景，通过单商品差额乘以数量得到总应税金额，解决多件商品失效问题
• 保留后台判断，避免后台订单操作时计税逻辑异常

内容的提问来源于stack exchange，提问作者user2589071