VAT category code
A letter for the VAT category of a breakdown: S standard, Z zero-rated, E exempt, O out of scope.
ZATCA uses only four codes from UN/CEFACT list 5305 (BR-KSA-18). A document needs at least one breakdown (BR-CO-18), and every category used on a line needs one (BR-Z-01, BR-E-01, BR-O-01).
The category decides what follows: S carries no exemption reason (BR-S-10), while Z, E and O need a reason code and text from ZATCA's list (BR-KSA-CL-04, BR-KSA-83).
| Identifier | BT-118 |
|---|---|
| Path in the document | /Invoice/cac:TaxTotal/cac:TaxSubtotal/cac:TaxCategory/cbc:ID |
| Cardinality | 1..1 |
| Data type | Code |
| Applies to | Standard tax invoice and Simplified tax invoice |
| Group | BG-23 VAT breakdown |
In JooDax
Partly builtThe programs write S, Z or E from the item's tax class. Category O is never produced: there is no "out of scope" item class.
crates/jdx-einvoice-sa/src/lib.rs
Applies to
| Tax invoice | Debit note | Credit note | Simplified | Simplified debit | Simplified credit |
|---|---|---|---|---|---|
| Mandatory | Mandatory | Mandatory | Mandatory | Mandatory | Mandatory |
Allowed values
VAT category codes (subset of UN/CEFACT 5305, D.16B; XML Implementation Standard 11.2.4)
| Code | Meaning |
|---|---|
| S | Standard rate |
| Z | Zero rated goods |
| E | Exempt from Tax |
| O | Services outside scope of tax / Not subject to VAT |
Rules that check it
- BR-KSA-18 · The VAT category code must be S, Z, E or O.
- BR-CO-18 · An invoice shall have at least one VAT breakdown group.
- BR-CL-18 · VAT categories must come from UNCL5305.
- BR-S-10 · A category S breakdown shall not have an exemption reason code or text.
- BR-KSA-83 · A breakdown with category E, Z or O must carry a reason text from ZATCA's list.
- BR-KSA-CL-04 · With category Z, E or O, a reason code from the Saudi list must exist.
- BR-Z-01 · An invoice with a zero-rated line, allowance or charge shall have a Z breakdown.
- BR-E-01 · An invoice with an exempt line, allowance or charge shall have an E breakdown.
- BR-O-01 · An invoice with a not-subject-to-VAT line shall have an O breakdown.
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.