Invoice type code
A three-digit code for the kind of document: 388 invoice, 381 credit note, 383 debit note, 386 prepayment invoice.
ZATCA uses just four codes from UN/CEFACT list 1001 (BR-KSA-05). The code alone does not separate a standard from a simplified invoice; that is carried by the first two positions of the name attribute on the same element (KSA-2).
The code is not printed; the document type is printed as its title instead: "Tax Invoice", "Simplified Tax Invoice", "Credit Note" or "Debit Note".
A credit note (381) or debit note (383) is complete only with the original invoice reference (BT-25, BR-KSA-56) and the reason for issuing it (KSA-10, BR-KSA-17). Code 386 is the prepayment invoice that a later final invoice settles.
| Identifier | BT-3 |
|---|---|
| Path in the document | /Invoice/cbc:InvoiceTypeCode |
| Cardinality | 1..1 |
| Data type | Code |
| Applies to | Standard tax invoice and Simplified tax invoice |
In JooDax
Partly builtThe programs write 388 for a simplified invoice and 381 for a simplified credit note. Debit notes (383) and prepayment invoices (386) 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
Subset of UN/CEFACT code list 1001, D.16B (XML Implementation Standard 11.2.1)
| Code | Meaning |
|---|---|
| 388 | Tax invoice |
| 386 | Prepayment invoice |
| 383 | Debit note |
| 381 | Credit note |
Rules that check it
- BR-KSA-05 · The invoice type code must be one of the Saudi subset: 388, 386, 383 or 381.
- BR-CL-01 · The document type code must come from UNTDID 1001.
- BR-KSA-17 · A credit or debit note must state the reason it was issued.
- BR-KSA-56 · Credit notes (381) and debit notes (383) must carry the billing reference ID.
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.