Skip to content
BT-118

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).

IdentifierBT-118
Path in the document/Invoice/cac:TaxTotal/cac:TaxSubtotal/cac:TaxCategory/cbc:ID
Cardinality1..1
Data typeCode
Applies toStandard tax invoice and Simplified tax invoice
GroupBG-23 VAT breakdown

In JooDax

Partly built

The 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 invoiceDebit noteCredit noteSimplifiedSimplified debitSimplified credit
MandatoryMandatoryMandatoryMandatoryMandatoryMandatory

Allowed values

VAT category codes (subset of UN/CEFACT 5305, D.16B; XML Implementation Standard 11.2.4)

CodeMeaning
SStandard rate
ZZero rated goods
EExempt from Tax
OServices 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

  1. Electronic Invoice XML Implementation Standard to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
  2. 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.