Skip to content

Fields — E-invoicing in Saudi Arabia (FATOORA)

BG-2 Process control

Holds the business process type, which in Saudi Arabia is the fixed value reporting:1.0.

IdentifierNameCardinalityIn JooDax
BT-23Business process type0..1Built

BG-3 Preceding invoice reference

Links a credit or debit note to the invoice or invoices it corrects, by their sequential numbers.

IdentifierNameCardinalityIn JooDax
BT-25Billing reference (original invoice number)1..nBuilt

BG-5 Seller

The seller's name, VAT number, additional identifier and national address. The data dictionary files all of them under BG-5, while rule BR-08 uses the code for the seller postal address.

IdentifierNameCardinalityIn JooDax
BT-29Seller identification (other seller ID)0..*Partly built
BT-35Seller street name0..1Partly built
KSA-17Seller building number0..1Partly built
KSA-3Seller district0..1Partly built
BT-37Seller city0..1Partly built
BT-38Seller postal code0..1Partly built
BT-40Seller country code1..1Built
BT-31Seller VAT registration number1..1Built
BT-27Seller name1..1Built

BG-7 Buyer

The buyer's name and VAT number or other ID: mandatory on standard invoices, conditional on simplified ones.

IdentifierNameCardinalityIn JooDax
BT-44Buyer name1..1 if its parent existsPartly built
BT-46Other buyer ID0..*Not built
BT-48Buyer VAT registration number1..1 if its parent existsNot built

BG-8 Buyer postal address

The buyer's address: at least street, city and country on a standard invoice, the full national address for a Saudi buyer; optional on simplified documents.

IdentifierNameCardinalityIn JooDax
BT-50Buyer street name0..1Not built
KSA-18Buyer building number0..1Not built
BT-52Buyer city0..1Not built
BT-53Buyer postal code0..1Not built
KSA-4Buyer district0..1Not built
BT-55Buyer country code1..1 if its parent existsNot built

BG-13 Delivery information

The supply date where it differs from the issue date; mandatory on every standard invoice.

IdentifierNameCardinalityIn JooDax
KSA-5Supply date0..1Not built

BG-16 Payment instructions

The payment means code; on notes it also holds the reason for the note.

IdentifierNameCardinalityIn JooDax
BT-81Payment means code1..nPartly built

BG-22 Document totals

The totals: line nets, totals without and with VAT, VAT total in invoice currency and in riyals, prepaid amount, rounding and amount due.

IdentifierNameCardinalityIn JooDax
BT-106Sum of invoice line net amounts1..1Built
BT-109Invoice total amount without VAT1..1Built
BT-110Invoice total VAT amount1..1Built
BT-111Invoice total VAT amount in accounting currency1..1Built
BT-112Invoice total amount with VAT1..1Built
BT-113Prepaid amount0..1Not built
BT-114Rounding amount0..1Not built
BT-115Amount due for payment1..1Built

BG-23 VAT breakdown

One breakdown per VAT category and rate: taxable amount, tax, category, rate and exemption reason where relevant.

IdentifierNameCardinalityIn JooDax
KSA-21Tax scheme identifier1..1Built
BT-116VAT category taxable amount1..1Built
BT-117VAT category tax amount1..1Partly built
BT-118VAT category code1..1Partly built
BT-119VAT category rate1..1Built
BT-121VAT exemption reason code0..1Partly built
BT-120VAT exemption reason text0..1Partly built

BG-25 Invoice line

Each line: its number, quantity, unit and net amount, with its VAT and total with VAT.

IdentifierNameCardinalityIn JooDax
BT-126Invoice line identifier1..1Built
BT-129Invoiced quantity0..1Partly built
BT-130Unit of measure code0..1Partly built
BT-131Invoice line net amount1..1Built

BG-29 Price details

The net unit price, with gross price, price discount and base quantity where needed.

IdentifierNameCardinalityIn JooDax
BT-146Item net price1..1Partly built

BG-30 Line VAT information

The VAT category and rate on the line itself.

IdentifierNameCardinalityIn JooDax
BT-151Invoiced item VAT category code1..1Partly built
BT-152Invoiced item VAT rate1..1Built

BG-31 Item information

The description of the goods or service and its optional identifiers.

IdentifierNameCardinalityIn JooDax
BT-153Item name1..1 if its parent existsBuilt

Other fields

IdentifierNameCardinalityIn JooDax
BT-1Invoice number1..1Built
KSA-1Unique invoice identifier (UUID)1..1Built
BT-2Invoice issue date1..1Built
KSA-25Invoice issue time1..1Built
BT-3Invoice type code1..1Partly built
KSA-2Invoice transaction code0..1Partly built
BT-5Invoice currency code0..1Partly built
BT-6Tax currency code0..1Built
KSA-16Invoice counter value (ICV)0..1Built
KSA-13Previous invoice hash (PIH)0..1Built
KSA-14QR code0..1Built
KSA-15Cryptographic stamp0..1Built
KSA-24Supply end date0..1Not built
KSA-10Reason for issuing a credit or debit note0..*Partly built
KSA-11Line VAT amount1..1 if its parent existsBuilt
KSA-12Line amount with VAT0..1Built

Sources

  1. Electronic Invoice Data Dictionary to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
  2. Electronic Invoice XML Implementation Standard to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
  3. Detailed Guidelines for E-Invoicing (vVersion 2) — ZATCA
  4. الدليل الإرشادي التفصيلي للفوترة الإلكترونية (vالنسخة الثانية) — ZATCA
  5. اللائحة التنفيذية لنظام ضريبة القيمة المضافة (vالنسخة العاشرة (آخر تعديل بقرار 24-06-01 في 2024-11-19)) — ZATCA
  6. E-invoicing Detailed Technical Guidelines (vVersion 2) — ZATCA
  7. الضوابط والمتطلبات والمواصفات الفنية والقواعد الإجرائية اللازمة لتنفيذ أحكام لائحة الفوترة الإلكترونية (قرار المحافظ رقم 62738 وتاريخ 1443/11/23هـ) (vfile dated 20230519 (decision 62738)) — ZATCA
  8. Security Features Implementation Standards to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
  9. تحمّل الدولة ضريبة القيمة المضافة المستحقة على الخدمات التعليمية الأهلية المقدمة إلى المواطنين (vالإصدار الثاني) — ZATCA

Checked on: 4 November 2026. What concerns JooDax is taken from the programs’ own code.