Invoice transaction code
Seven positions, NNPNESB, saying whether the document is standard or simplified and whether it is third-party, nominal, export, summary or self-billed.
The first two positions give the subtype: 01 for a standard tax invoice and its notes, 02 for a simplified one and its notes. That choice decides the whole path: standard documents are cleared before the buyer receives them; simplified ones are stamped by the seller's device and reported within 24 hours.
The next five positions are 0/1 flags, in order: third party, nominal supply, export, summary, self-billed (BR-KSA-06). BR-KSA-07 forbids self-billing on an export invoice, and BR-KSA-31 allows only the third-party, nominal and summary flags on simplified documents.
Self-billing and third-party billing need ZATCA's approval under Annex 2 of the controls. Each flag changes other requirements: an export invoice must not carry a buyer VAT number (BR-KSA-46), and a simplified summary invoice needs the buyer's name and supply start and end dates.
| Identifier | KSA-2 |
|---|---|
| Path in the document | /Invoice/cbc:InvoiceTypeCode/@name |
| Cardinality | 0..1 |
| Data type | Code |
| Applies to | Standard tax invoice and Simplified tax invoice |
In JooDax
Partly builtThe programs always write 0200000: a simplified document with no flags. The standard path (0100000) exists in the writer but is never used, and the third-party, nominal and summary flags are not built.
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 |
Allowed values
Structure NNPNESB (BR-KSA-06)
| Code | Meaning |
|---|---|
| 01 (positions 1-2) | Tax invoice (standard) and its notes |
| 02 (positions 1-2) | Simplified tax invoice and its notes |
| P (position 3) | Third-party invoice |
| N (position 4) | Nominal supply |
| E (position 5) | Export |
| S (position 6) | Summary invoice |
| B (position 7) | Self-billed invoice |
Rules that check it
- BR-KSA-06 · The name attribute on the invoice type must exist with the structure NNPNESB.
- BR-KSA-07 · Self-billing may not be combined with the export flag.
- BR-KSA-31 · On simplified documents only the third-party, nominal and summary flags are accepted.
- BR-KSA-71 · A simplified summary invoice must name the buyer.
- BR-KSA-72 · A simplified summary invoice must carry the supply date and supply end date.
- BR-KSA-46 · An export invoice must not contain a buyer VAT number.
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
- الضوابط والمتطلبات والمواصفات الفنية والقواعد الإجرائية اللازمة لتنفيذ أحكام لائحة الفوترة الإلكترونية (قرار المحافظ رقم 62738 وتاريخ 1443/11/23هـ) (vfile dated 20230519 (decision 62738)) — ZATCA
Checked on: 4 November 2026. What concerns JooDax is taken from the programs’ own code.