Skip to content
BT-3

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.

IdentifierBT-3
Path in the document/Invoice/cbc:InvoiceTypeCode
Cardinality1..1
Data typeCode
Applies toStandard tax invoice and Simplified tax invoice

In JooDax

Partly built

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

Allowed values

Subset of UN/CEFACT code list 1001, D.16B (XML Implementation Standard 11.2.1)

CodeMeaning
388Tax invoice
386Prepayment invoice
383Debit note
381Credit 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

  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
  3. الضوابط والمتطلبات والمواصفات الفنية والقواعد الإجرائية اللازمة لتنفيذ أحكام لائحة الفوترة الإلكترونية (قرار المحافظ رقم 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.