Magento - Apply Tax On Custom Quote Totals Field

Magento - Apply Tax On Custom Quote Totals Field

July 25, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento - Apply Tax On Custom Quote Totals Field

Applying Tax to Custom Quote Totals Field in Magento

You’re on the right track with your custom surcharge module for Magento. You’ve successfully added the surcharge field to the quote and calculated the correct grand total on the checkout page, including tax for products and shipping. However, you’re facing a challenge in applying tax to this custom surcharge so it’s displayed in the tax field.

Let’s break down your issue and find a solution that correctly applies tax to your surcharge field while keeping the code clean and efficient.

Understanding the Tax Calculation Process

In Magento, the tax calculation process involves several steps. It starts with the Mage_Tax_Model_Calculation class, which uses the rate request to determine the appropriate tax rates for a particular item or line item based on the product’s tax class id and the customer group. The calculated tax amount is then added to the total.

Your Current Approach

In your code, you’ve created a custom total model *******_Deposits_Model_Quote_Address_Total_Surcharge that extends Mage_Sales_Model_Quote_Address_Total_Abstract. You’ve successfully implemented the collection and fetch methods to add the surcharge to the quote and display it on the checkout page.

However, your tax calculation approach in the _calculateTax method is slightly off. You’re calculating the tax for the surcharge amount, but you’re not actually applying this calculated tax back to the quote object or the address object. This is why you’re only seeing the product and shipping taxes displayed on the checkout page.

The Correct Approach

To correctly apply tax to your custom surcharge:

  1. Calculate the Tax Amount: You’ve already implemented this in your _calculateTax method. However, ensure you’re using the correct tax calculation method (calcTaxAmount) provided by the Mage_Tax_Model_Calculation class.

  2. Apply the Calculated Tax: This is where the current issue lies. You need to add the calculated tax amount back to the quote or address object so that it’s included in the totals and displayed correctly on the checkout page. You can do this by updating the tax_amount field of the quote item.

Here’s an example of how you can update your _calculateTax method:

protected function _calculateTax(Mage_Sales_Model_Quote_Address $address)
{
    // ...

    $rate = $calculator->getRate($taxRateRequest);

    $baseTax = $tax = $calculator->calcTaxAmount($address->getBaseSurchargePriceAmount(), $rate, $inclTax, true);

    // Apply the calculated tax to the quote item
    foreach ($items as $item) {
        if (isset($item->getData('base_surcharge_price'))) {
            $item->setTaxAmount($tax);
        }
    }

    return $this;
}

In this updated method, we’re looping through the items in the address and applying the calculated tax to each surcharge item using the setTaxAmount method.

Conclusion

Applying tax to custom quote totals fields in Magento requires a deep understanding of the tax calculation process. You’ve made great progress with your current implementation, but you missed the critical step of applying the calculated tax back to the quote or address object.

By updating your _calculateTax method as shown above and ensuring that each surcharge item’s tax_amount field is correctly set, you should be able to display the tax for your custom surcharge field on the checkout page alongside the product and shipping taxes.

Remember to thoroughly test your updated code in a development environment before deploying it to a live Magento store. If you encounter any further issues or need additional guidance, don’t hesitate to explore more resources and tutorials at Laravel Company.

Happy coding!

Checkout Catalog Extensions Customers

Our network