WooCommerce：程序化创建订单时修改税类并重新计算

Hey there! I get your frustration—WooCommerce's tax handling can be tricky when you're creating orders programmatically instead of relying on the frontend cart flow. Let's break down why your previous attempts didn't work and fix this step by step.

Why Your Existing Code Failed #

• The woocommerce_product_get_tax_class filters work great for frontend product displays and cart calculations, but they often don’t fire during programmatic order creation—the order calculation flow skips some product-level hooks. Also, using priority 1 might mean your code gets overridden by other plugins or WooCommerce's default logic.
• Calling $woocommerce->customer->set_is_vat_exempt(true) only works if you set it before creating the order, and you also need to ensure the customer's billing/shipping country and VAT ID are properly saved. Without that context, WooCommerce won't recognize the exemption.

Working Solutions #

1. Set VAT Exemption Before Creating the Order #

This is the cleanest approach if you want WooCommerce to handle tax calculations automatically based on your rules. Here’s how to implement it:

// First, define your tax eligibility logic
function should_exempt_vat($customer_country, $vat_id, $shop_country) {
    $eu_countries = WC()->countries->get_european_union_countries();
    // Check: EU country + valid VAT ID + not same as shop's country
    return in_array($customer_country, $eu_countries) 
           && !empty($vat_id) 
           && $customer_country !== $shop_country;
}

// Get or initialize your customer object (adjust $user_id as needed)
$user_id = get_current_user_id(); // Use a specific ID if creating for a guest/known user
$customer = new WC_Customer($user_id);

// Set customer's country (replace with actual customer country code, e.g., 'DE')
$customer_country = 'DE';
$customer->set_billing_country($customer_country);
$customer->set_shipping_country($customer_country);

// Set customer's VAT ID (if provided)
$vat_id = 'DE123456789'; // Replace with the actual VAT ID from your data
$customer->set_vat_number($vat_id);

// Get your shop's base country (from WooCommerce settings)
$shop_country = WC()->countries->get_base_country();

// Apply VAT exemption if conditions are met
if (should_exempt_vat($customer_country, $vat_id, $shop_country)) {
    $customer->set_is_vat_exempt(true);
} else {
    $customer->set_is_vat_exempt(false);
}

// Save the customer's updated data
$customer->save();

// Now create the order
$order_data = array(
    'customer_id' => $user_id,
    'status' => 'pending', // Adjust order status as needed
    // Add other order meta (like notes) if required
);

$order = wc_create_order($order_data);

// Add products to the order (replace $product_id and quantity)
$product = wc_get_product($product_id);
$order->add_product($product, 1);

// Calculate totals (this applies the correct tax based on exemption status)
$order->calculate_totals();

2. Manually Set Tax Class on Order Items #

If you need more direct control, modify the tax class of each order item after adding it to the order:

// Create the order first (adjust order data for your use case)
$order = wc_create_order(array(
    'customer_id' => get_current_user_id(),
    'status' => 'pending',
));

// Add product to the order
$product = wc_get_product($product_id);
$item = $order->add_product($product, 1);

// Define your tax class logic here
$tax_class = 'Zero rate'; // Use '' for default tax class if exemption doesn't apply

// Set the tax class for the order item
$item->set_tax_class($tax_class);
$item->save();

// Recalculate totals to apply the new tax class
$order->calculate_totals();

3. Hook into Order Item Tax Class Retrieval #

For a hook-based solution that works specifically for order items, use this filter (it fires when order items fetch their tax class):

add_filter('woocommerce_order_item_get_tax_class', 'custom_order_item_tax_class', 10, 2);
function custom_order_item_tax_class($tax_class, $item) {
    // Get order and customer data
    $order = $item->get_order();
    $customer_country = $order->get_billing_country();
    $vat_id = $order->get_meta('_vat_number'); // Assuming VAT ID is stored as order meta
    $shop_country = WC()->countries->get_base_country();

    // Apply your tax rules
    $eu_countries = WC()->countries->get_european_union_countries();
    if (in_array($customer_country, $eu_countries) && !empty($vat_id) && $customer_country !== $shop_country) {
        return 'Zero rate';
    }

    // Return default tax class if conditions aren't met
    return $tax_class;
}

Key Notes #

• Always call calculate_totals() after making changes to the order or its items—this ensures WooCommerce recalculates taxes correctly.
• Verify that your "Zero rate" tax class exists in WooCommerce's Tax settings (WooCommerce > Settings > Tax > Tax Classes).
• For guest customers, set billing/shipping details directly on the order instead of using a WC_Customer object.

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