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.
- Select Add tax configuration.
- In Tax type, choose Tourism Levy.
- In Currency, choose ZAR.
- Enter the name
Tourism Levy. - In Rate, enter
Tourism Levy. - Select Change beside Tax period and Payment due to set each schedule.
- Select Save.
- 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
- Which tax types, in which currencies. The platform ships no rows of its own. A new tenant gets the rows its regime sets up.
- The rate each row names, and the percentage on each date.
- The names, tax period and payment dates.
From the LedgerTM product guide, as shipped with the software and written with it. Copied from the platform repository on 2026-11-11.