Tax configurations

A tax configuration tells the system how to treat one tax type in one currency. The Tax configurations page under Settings › Tax lists them. It has two tabs: Configurations and Rate differences.

What a row tells you

Column What it tells you
Tax name The name people read on statements, such as VAT
Tax type The tax type’s key, such as vat
Currency The currency the tax is charged or withheld in
Rate The name of the rate that sets the percentage
Tax period How often the tax is totalled up
Payment due How often the total falls due to the tax authority

A tax type has at most one row for each currency. Each tax type keeps its own tax account. Withholding and value-added tax never share a liability.

Add a configuration

Example: Alex sets up the Woodgrove Bank tourism levy in rand.

  1. Select Add tax configuration.
  2. In Tax type, choose Tourism Levy.
  3. In Currency, choose ZAR.
  4. Enter the name Tourism Levy.
  5. In Rate, enter Tourism Levy.
  6. Select Change beside Tax period and Payment due to set each schedule.
  7. Select Save.
  8. Submit the staged change from the bar to publish it.

To change a row, select Edit. You can change the name, the rate and the schedules. The tax type and the currency are the row’s identity, so they cannot change.

Where the percentage comes from

The row names a rate. It holds no percentage itself. The percentage comes from that rate on the transaction’s value date.

A rate that changes on a future date applies from that date. See rates and rate types.

Rate differences

A rate can be corrected back-dated. Tax already posted at the old rate then differs from the rate that now applies on its value date. The Rate differences tab lists each posted tax amount like that, so you can review it.

Example: Alex charges a service fee with value date 20 October 2026. It carries VAT of 6.75 at 15.00%. Later, the VAT rate is corrected to 15.50% from 1 October 2026.

Value date Recorded rate Current rate Difference
2026-10-20 15% 15.5% 0.5%

The posted VAT stays 6.75. Correcting the rate posts nothing. To correct a customer, reverse the fee and charge it again. Once rebilled, the fee leaves the tab. A reversed amount and its reversal are not listed. Select a row to open the account.

What happens with no row

If a currency has no row for a tax type, that tax is not charged in that currency. The tax rules page shows a note on each rule this affects.

An amount in that currency shows no tax line. It does not show 0%, which would read as a zero-rated country.

Worked example

The South African retail template (za-retail) loads the za-tax regime. That regime sets up two rows in ZAR.

Tax name Tax type Rate Tax period Payment due
VAT vat Tax Monthly (day end) Monthly (day 25)
Withholding Tax withholding-tax Withholding.Interest.Statutory Monthly (day end) Monthly (day end)

Alex posts a ZAR fee that carries VAT. The system reads the VAT row. It takes the percentage from the Tax rate on the fee’s value date.

“Day end” means the last day of the month. “Day 25” means the 25th.

Withholding

A withholding row is for tax held back on interest paid. The statutory rate and any treaty rate are separate settings. Treaty relief needs declared evidence. See withholding regime.

The platform follows the shape of Article 11 of the OECD Model Tax Convention. Its register row is OECD Model Tax Convention Article 11, status Partial. The treaty rates the template ships are demonstration values. They are not a maintained treaty table.

What your organisation configures

From the LedgerTM product guide, as shipped with the software and written with it. Copied from the platform repository on 2026-11-11.