Tax Configuration

WHMCS can gather necessary taxes when you make sales.

You can access this feature at Configuration () > System Settings > Tax Configuration.

Enabling Tax Support

To configure and start charging taxes:

  1. Select Tax Support.
  2. Click Save Changes.
  3. Set the desired settings below.
  4. Click Save Changes again.

General Settings

You can configure the following settings in the General Settings tab:

Tax/VAT ID NumberEnter your company tax or VAT ID. Invoices will display this under the company address in the Client Area and on PDF printable invoices.
Inclusive/Exclusive TaxSelect whether you want to use Exclusive or Inclusive tax.
  • Exclusive tax adds tax onto the prices that you enter in WHMCS at the rate that you entered:
    Exclusive Tax > Tax Amount = Item Price x ( Tax Rate / 100 )
  • Inclusive tax requires you to include tax in the amount that you set for prices in WHMCS. WHMCS then works backwards to calculate the amount of tax to charge based on the rates that you set:
    Inclusive Tax > Tax Amount = ( Item Price / ( 100 + Tax Rate ) ) x Tax Rate
Custom Invoice NumberingIf you set this to ON, the configured custom invoice numbering will apply to invoices that you generate.
The system will not alter invoice numbering for invoices that it has already generated.
Custom Invoice Numbering FormatEnter the format of the custom invoice number to apply to the invoices WHMCS generates.
  • The default value of this is {NUMBER}, which will contain only the value from Next Invoice Number.
  • The format can contain any text in the invoice number that the client will see.
You can also enter tags that the system will replace when it generates the invoice. For more information, see Invoice Numbering Format Tags.
Next Invoice NumberThe number that the system will assign to the next invoice that it generates.
Only enter a value if you want to change the number of the next invoice. Only increase this number; do not decrease it.
Auto Reset NumberingThis setting allows you to automatically reset the invoice number periodically. The automatic invoice numbering reset occurs when the automation cron runs on the last day of the month or year.
We recommend that you configure the cron job to run late at night in Configuration () > System Settings > Automation Settings.

VAT Settings

You can configure the following settings in the VAT Settings tab:

VAT ModeToggle VAT Mode to ON to set your VAT label display name. Enter a name and then click Create Rules.
Auto Configure VAT Tax RulesIf you accidentally delete a rule or need to recreate or change the name of a rule, click Auto Configure VAT Tax Rules. Follow the prompts, using the appropriate VAT rate for each EU country.
Custom Field MigrationIf a WHMCS installation previously used the EU VAT Addon and a custom field to contain the client VAT number, this option will display to perform a migration of the tax numbers from the custom field to store them in the client table.
VAT Number ValidationToggle this to ON to enable validation of VAT numbers during registration and checkout. WHMCS uses VIES to validate EU VAT numbers and HMRC to validate UK VAT numbers.
Auto Tax ExemptCheck this to set clients as tax exempt when their VAT number successfully validates.
  • When you save a client’s profile, WHMCS will revalidate their VAT number with the relevant authority (VIES for EU VAT numbers and HMRC for UK VAT numbers).
  • If the VAT number is invalid, the client will lose their tax exempt status, and the system will apply tax to all newly-generated invoices accordingly.
Your Home CountrySelect the country for your main business location.
Home Country ExclusionCheck this to always charge VAT if the customer’s billing address is in the country that you selected for Your Home Country.
Proforma Invoicing/Sequential Paid Invoice NumberingToggle this to ON to enable the invoice numbering format that you set below.
For more information, see Enable Proforma Invoicing.
Sequential Invoice Number FormatEnter a format for invoice numbering.
You can also enter tags that the system will replace when it generates the invoice. For more information, see Invoice Numbering Format Tags.
Next Paid Invoice NumberEnter a number to use to number the next invoice that WHMCS generates.
Auto Reset NumberingSelect the frequency with which WHMCS should automatically reset invoice numbering. Select Never if you do not want to automatically reset numbering.
Set Invoice Date on PaymentCheck this to set the invoice date to the current date when applying payment.

Tax Rules

You must configure tax rules in order to automatically charge tax in the cart. You can set up an unlimited number of tax rules.

Add a Tax Rule

To add a rule:

  1. For Name, enter an identifiable name for the tax zone.
  2. For Country, choose whether this tax rate applies to all countries or only applies to a selected country.
  3. For the state, choose whether it applies to all states in the selected country or only a selected state.
  4. Finally, enter the tax rate as a percentage (for example, 17.5). WHMCS supports tax rates with up to three decimal places and currency values up to 99 trillion.
  5. Click Add Rule.

The system will create the tax rule and automatically add it to the appropriate table for Level 1 or Level 2 rules.

For example, a UK business would set up the system to charge VAT. For Country, you would choose United Kingdom and for the state you would choose Apply Rule to All States. You would then enter the tax rate of 20.0.

Updating Tax Rules

Sales tax rates generally change over time. To change a tax rate in WHMCS, delete the existing rule and then create a new rule using the new rate and exactly the same name, country, and state.

For more information, see Update Tax Rates.

Advanced Settings

The Advanced Settings tab in Tax Configuration

You can configure the following settings in the Advanced Settings tab:

Taxed ItemsThe flexible tax system in WHMCS allows you to set, individually, which items apply for tax. Select whether you want to automatically apply taxes to domains, billable items, late fees, and custom invoices.
WHMCS sets products as untaxed by default. Even if you have tax rules set up, the system won’t charge tax for them. For steps to enable taxes on a product, see Enable Taxes for a Product.
Calculation ModeChoose how the system calculates taxes:
  • Calculate individually per line item — Calculate taxes on a per-line-item basis. When you select this, the system will calculate tax for each line item and round it to 2 decimal places. It will also calculate the total tax using the sum of the tax calculation for each individual line item.
  • Calculate based on collective sum of the taxable line items — Calculate taxes using the sum of the taxable line items on an invoice. When you select this, the system totals the individual taxable line items and calculates tax on the sum total of those taxable line items.
For more information on how these calculations work, see Calculation Mode below.
Compound TaxThe system calculates compound tax after and in addition to a primary tax. If you need to add the Level 2 tax to the Level 1 tax, enable Compound Tax.
Deduct Tax AmountIf Tax Type is Inclusive and the client’s country and state or province selections result in them not meeting any of the configured tax rules, deduct an amount from the order.

Base this on the total amount for taxable items on the order and the percentage of tax that would apply to the default country in the Localisation tab at Configuration () > System Settings > General Settings.

It will deduct the percentage that applies to the first applicable Level 1 and Level 2 tax rules.

Calculation Mode

Due to rounding for tax calculation modes and the calculation amounts, the resulting tax amounts may differ:

Calculation Mode SettingTax Calculation for 11 Line Items at $2.21 Each
Calculate individually per line item(2.21 x 20%) + (2.21 x 20%) + (2.21 x 20%) +
(2.21 x 20%) + (2.21 x 20%) + (2.21 x 20%) +
(2.21 x 20%) + (2.21 x 20%) + (2.21 x 20%) +
(2.21 x 20%) + (2.21 x 20%) = $4.84
Calculate based on collective sum of the taxable line items(24.31 x 20%) = $4.86

Last modified: June 24, 2024