VAT category tax amount
The category's VAT: its taxable amount times its rate, rounded to two decimals.
BR-CO-17 defines it: category taxable amount × rate ÷ 100, rounded to two decimals. For zero-rated, exempt and out-of-scope categories it must be zero (BR-Z-09, BR-E-09, BR-O-09).
These amounts add up to the invoice VAT total (BR-CO-14). Because rounding happens per category, the result can differ by a halala from adding individually rounded line VAT amounts.
| Identifier | BT-117 |
|---|---|
| Path in the document | /Invoice/cac:TaxTotal/cac:TaxSubtotal/cbc:TaxAmount |
| Cardinality | 1..1 |
| Data type | Amount |
| Applies to | Standard tax invoice and Simplified tax invoice |
| Group | BG-23 VAT breakdown |
In JooDax
Partly builtThe programs write the sum of the lines' VAT in the category rather than recomputing taxable amount × rate as BR-CO-17 describes; a one-halala difference can appear when line rounding differs.
crates/jdx-einvoice-sa/src/xml.rs
Applies to
| Tax invoice | Debit note | Credit note | Simplified | Simplified debit | Simplified credit |
|---|---|---|---|---|---|
| Mandatory | Mandatory | Mandatory | Mandatory | Mandatory | Mandatory |
Rules that check it
- BR-CO-17 · Category tax = category taxable amount × rate ÷ 100, rounded to two decimals.
- BR-S-09 · For category S, tax = taxable amount × rate ÷ 100, rounded.
- BR-Z-09 · The tax amount of a Z breakdown shall be 0.
- BR-E-09 · The tax amount of an E breakdown shall be 0.
- BR-O-09 · The tax amount of an O breakdown shall be 0.
- BR-CO-14 · Invoice total VAT = Σ category tax amounts.
- BR-CO-18 · An invoice shall have at least one VAT breakdown group.
Related fields
Fields — E-invoicing in Saudi Arabia (FATOORA)
Sources
- Electronic Invoice XML Implementation Standard to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
- Electronic Invoice Data Dictionary to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
Checked on: 4 November 2026. What concerns JooDax is taken from the programs’ own code.