How the South Africa vat calculator is verified

Inputs

InputFieldType
Amountamountnumber
Directiondirectionstring
Taxable supplies per annumannualTurnovernumber
B2B reverse charge appliesreverseChargeboolean

The formula

Each derived value below is computed by the Valem engine from the expression shown, in this order. Nothing else runs — there is no hidden code path.

Derived valueFieldFormula (JSONata)
Raterate$const.standardRate
Effective RateeffectiveRatereverseCharge ? 0 : rate
Net AmountnetAmountdirection = 'remove' ? $round(amount / (1 + effectiveRate), 2) : $round(amount, 2)
Vat AmountvatAmount$round(netAmount * effectiveRate, 2)
Gross AmountgrossAmount$round(netAmount + vatAmount, 2)
Must RegistermustRegisterannualTurnover > $const.registrationThreshold
Registration StatusregistrationStatusannualTurnover > $const.registrationThreshold ? 'required' : annualTurnover > $const.registrationThresholdVoluntary ? 'optional' : 'not available'

Rates and thresholds

The expressions above read these as $const. They are the figures the annual refresh replaces, so they live as data rather than being written into the formulas — which is what makes a year-on-year change a one-line diff instead of an edit to arithmetic.

ConstantValue
standardRate0.15
registrationThreshold2300000
registrationThresholdVoluntary120000

Test vectors (7)

Every case is executed against this model on each build, by the Java engine and independently by a JavaScript one. A mismatch of a single cent fails the build, so the page cannot ship advertising a figure the model no longer produces.

Case 1 — S1 100.00 ZAR net at 15%

given amount100
given directionadd
given reverseChargeno
given annualTurnover0
expect vatAmount15
expect grossAmount115
expect netAmount100

Case 2 — S2 115.00 ZAR gross back to net

given amount115
given directionremove
given reverseChargeno
given annualTurnover0
expect netAmount100
expect vatAmount15

Case 3 — S3 reverse charge: the supplier charges no VAT

given amount100
given directionadd
given reverseChargeyes
given annualTurnover0
expect vatAmount0
expect grossAmount100

Case 4 — S4 above R2.3 million: registration is compulsory

given amount100
given directionadd
given reverseChargeno
given annualTurnover3000000
expect mustRegistertrue
expect registrationStatusrequired

Case 5 — S5 between R120 000 and R2.3 million: voluntary

given amount100
given directionadd
given reverseChargeno
given annualTurnover800000
expect mustRegisterfalse
expect registrationStatusoptional

Case 6 — S6 R1.5 million would have been compulsory before 1 April 2026, and is not now

given amount100
given directionadd
given reverseChargeno
given annualTurnover1500000
expect mustRegisterfalse
expect registrationStatusoptional

Case 7 — S7 below R120 000: registration is not available

given amount100
given directionadd
given reverseChargeno
given annualTurnover90000
expect mustRegisterfalse
expect registrationStatusnot available

Sources

Check it yourself — and reuse it

The whole model as JSON — inputs, outputs, formulas, vectors and sources in one re-runnable document.

This model is published under CC BY 4.0: use it, adapt it, build on it, with attribution. The licence covers the model — the expression of each rule and the arrangement of the catalog. The rates and thresholds are law, and nobody licenses those; the sources above are where they come from.

← Back to the South Africa vat calculator

Built with Valem — a live, verifiable calculator you can fork and embed.