Tax/VAT

From WHMCS Documentation

Revision as of 17:18, 8 March 2018 by Nate (talk | contribs) (Sum of Taxable Line Items)

Setting up Tax Rules

In order to charge tax, you must first enable Tax charges in WHMCS. To do this, go to Setup > Payments > Tax Rules and then tick the checkbox at the top of the page labelled Tax Enabled and click Save Changes. Tax is now enabled in WHMCS. Now, you can proceed to setup your tax zones. This is done as follows:

  1. Click the Add New Tax Rule tab on the Tax Setup page
  2. In the Name field, enter a name for the tax zone which allows you to identify it
  3. Next, for the Country, choose where this tax rate applies to all countries or whether it only applies to a selected country
  4. For the state, again you can choose whether it applies to all states in the selected country or only a selected state
  5. Finally, enter the tax rate as a percentage, for example 17.5 and then click the Save Changes button

For example, if you were a UK business you would setup the system to charge VAT. In the country field, you would choose "United Kingdom" and for the state you would leave it set at "Apply Rule to All States". You would then enter the tax rate of "20.0" and click the Save Changes button. You can setup an unlimited number of tax rules.

Inclusive/Exclusive Tax

By default, tax is exclusive. What this means is that the prices you enter into WHMCS need to have tax added onto them at the rates you've set. The alternative is inclusive tax. Oppositely, this means that the prices you enter into WHMCS already have tax included in them and WHMCS needs to work backwards to calculate the amount of tax being charged based on the rates you've set. You can choose the tax method you want to use in Setup > Payments > Tax Rules.

  • Exclusive Tax > Tax Amount = Item Price x ( Tax Rate / 100 )
  • Inclusive Tax > Tax Amount = ( Item Price / ( 100 + Tax Rate ) ) x Tax Rate

Tax Calculation Method

This page describes a feature available in version 7.5 and above

The Tax Calculation Method setting determines how taxable invoice items will have the order's tax calculated. The options are Per Line Item or Sum of Taxable Line Items:

Tax calc method.png

Per Line Item

By selecting this option, tax will calculate on each individual line item in an invoice. For example, if there are 4 line items for 1.00 and tax set to 20%, each 1.00 item will have 20% tax calculated against it. The total will then reflect these calculated amounts for the client to pay.

Sum of Taxable Line Items

Selecting this option will calculate tax based on the subtotal of each line item that is taxable. For example, if you have 4 line items for 1.00 and tax set to 20%, each line item will be sumed together (for a total of 4.00) and then tax will be calculated against the subtotal. The total will the reflect this calculated amount for the client to pay.

Setting Taxed Items

The flexible tax system in WHMCS allows you to set individually which items apply for tax. By default in WHMCS, a product is set to not be taxed. What this means is that even though you have tax rules setup, no tax would be charged for it. So for example you might charge tax on the products you offer but not on services.

Setting a Product/Service as Taxable

  1. Go to Setup > Products/Services > Products/Services
  2. Click the edit icon next to the product you wish to set to be taxable
  3. Tick the checkbox next to the item labelled "Tax Product"
  4. Save your changes to the product

Setting Domains as Taxable

You can set if tax should be applied to domains in Setup > Payments > Tax Rules - there is a tick box at the top of the page for this.

Setting Billable Items as Taxable

By ticking this option you can set billable items to be taxed under Setup > Payments > Tax Rules.

Setting Late Fees as Taxable

You can set if late fees on invoices should be taxed also in Setup > Payments > Tax Rules.

Setting Custom Invoices as Taxable

With this option ticked one-time custom invoices (ie. those not tied to a product or addon) will have tax applied.

Compound Tax

A compound tax is one that is calculated after and on top of a primary tax. If you require the Level 2 tax to be added on top of the Level 1 tax, tick this option.

Showing your Tax ID/VAT Number on Invoices

When charging your customers tax, it is often a requirement for you to display your companies Tax or VAT Number on all invoices. To do this in WHMCS, simply add a line to the bottom of your company address in the General Settings page containing the number - eg. VAT Number XXXXXXXX

Setting Clients as Tax Exempt

You may have clients where you don't want to charge any tax. If this is the case, you need to set them as Tax Exempt. This is done by ticking the tax exempt checkbox on the clients profile page in the admin area.

Automatic VAT Number Validation

WHMCS can be setup to check the VAT number a user supplies during the order process - to validate it and automatically set tax exempt status for the client. To use this feature, you'll need to setup a custom field in Setup > Custom Client Fields as demonstrated below and then activate & configure the Official EU VAT Addon Module per these instructions: http://docs.whmcs.com/EU_VAT_Addon

Vat validation.png

Changing the Tax Rate

From time-to-time governments change the sales tax rates, this is significant as you must also update your rates accordingly. Instructions for changing the tax rate in WHMCS can be found in our How To Guides.


Common Problems

Tax Not Applied to Invoices

If tax is not being applied to an invoice to which it should this indicates tax rules are not configured correctly or the client does not meet them. Troubleshooting steps are available on the Invoicing Issues page.