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.
| Identifier | Name | Cardinality | In JooDax |
|---|---|---|---|
| BT-23 | Business process type | 0..1 | Built |
BG-3 Preceding invoice reference
Links a credit or debit note to the invoice or invoices it corrects, by their sequential numbers.
| Identifier | Name | Cardinality | In JooDax |
|---|---|---|---|
| BT-25 | Billing reference (original invoice number) | 1..n | Built |
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.
| Identifier | Name | Cardinality | In JooDax |
|---|---|---|---|
| BT-29 | Seller identification (other seller ID) | 0..* | Partly built |
| BT-35 | Seller street name | 0..1 | Partly built |
| KSA-17 | Seller building number | 0..1 | Partly built |
| KSA-3 | Seller district | 0..1 | Partly built |
| BT-37 | Seller city | 0..1 | Partly built |
| BT-38 | Seller postal code | 0..1 | Partly built |
| BT-40 | Seller country code | 1..1 | Built |
| BT-31 | Seller VAT registration number | 1..1 | Built |
| BT-27 | Seller name | 1..1 | Built |
BG-7 Buyer
The buyer's name and VAT number or other ID: mandatory on standard invoices, conditional on simplified ones.
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.
BG-13 Delivery information
The supply date where it differs from the issue date; mandatory on every standard invoice.
| Identifier | Name | Cardinality | In JooDax |
|---|---|---|---|
| KSA-5 | Supply date | 0..1 | Not built |
BG-16 Payment instructions
The payment means code; on notes it also holds the reason for the note.
| Identifier | Name | Cardinality | In JooDax |
|---|---|---|---|
| BT-81 | Payment means code | 1..n | Partly 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.
| Identifier | Name | Cardinality | In JooDax |
|---|---|---|---|
| BT-106 | Sum of invoice line net amounts | 1..1 | Built |
| BT-109 | Invoice total amount without VAT | 1..1 | Built |
| BT-110 | Invoice total VAT amount | 1..1 | Built |
| BT-111 | Invoice total VAT amount in accounting currency | 1..1 | Built |
| BT-112 | Invoice total amount with VAT | 1..1 | Built |
| BT-113 | Prepaid amount | 0..1 | Not built |
| BT-114 | Rounding amount | 0..1 | Not built |
| BT-115 | Amount due for payment | 1..1 | Built |
BG-23 VAT breakdown
One breakdown per VAT category and rate: taxable amount, tax, category, rate and exemption reason where relevant.
| Identifier | Name | Cardinality | In JooDax |
|---|---|---|---|
| KSA-21 | Tax scheme identifier | 1..1 | Built |
| BT-116 | VAT category taxable amount | 1..1 | Built |
| BT-117 | VAT category tax amount | 1..1 | Partly built |
| BT-118 | VAT category code | 1..1 | Partly built |
| BT-119 | VAT category rate | 1..1 | Built |
| BT-121 | VAT exemption reason code | 0..1 | Partly built |
| BT-120 | VAT exemption reason text | 0..1 | Partly built |
BG-25 Invoice line
Each line: its number, quantity, unit and net amount, with its VAT and total with VAT.
BG-29 Price details
The net unit price, with gross price, price discount and base quantity where needed.
| Identifier | Name | Cardinality | In JooDax |
|---|---|---|---|
| BT-146 | Item net price | 1..1 | Partly built |
BG-30 Line VAT information
The VAT category and rate on the line itself.
BG-31 Item information
The description of the goods or service and its optional identifiers.
| Identifier | Name | Cardinality | In JooDax |
|---|---|---|---|
| BT-153 | Item name | 1..1 if its parent exists | Built |
Other fields
| Identifier | Name | Cardinality | In JooDax |
|---|---|---|---|
| BT-1 | Invoice number | 1..1 | Built |
| KSA-1 | Unique invoice identifier (UUID) | 1..1 | Built |
| BT-2 | Invoice issue date | 1..1 | Built |
| KSA-25 | Invoice issue time | 1..1 | Built |
| BT-3 | Invoice type code | 1..1 | Partly built |
| KSA-2 | Invoice transaction code | 0..1 | Partly built |
| BT-5 | Invoice currency code | 0..1 | Partly built |
| BT-6 | Tax currency code | 0..1 | Built |
| KSA-16 | Invoice counter value (ICV) | 0..1 | Built |
| KSA-13 | Previous invoice hash (PIH) | 0..1 | Built |
| KSA-14 | QR code | 0..1 | Built |
| KSA-15 | Cryptographic stamp | 0..1 | Built |
| KSA-24 | Supply end date | 0..1 | Not built |
| KSA-10 | Reason for issuing a credit or debit note | 0..* | Partly built |
| KSA-11 | Line VAT amount | 1..1 if its parent exists | Built |
| KSA-12 | Line amount with VAT | 0..1 | Built |
Sources
- Electronic Invoice Data Dictionary to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
- Electronic Invoice XML Implementation Standard to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
- Detailed Guidelines for E-Invoicing (vVersion 2) — ZATCA
- الدليل الإرشادي التفصيلي للفوترة الإلكترونية (vالنسخة الثانية) — ZATCA
- اللائحة التنفيذية لنظام ضريبة القيمة المضافة (vالنسخة العاشرة (آخر تعديل بقرار 24-06-01 في 2024-11-19)) — ZATCA
- E-invoicing Detailed Technical Guidelines (vVersion 2) — ZATCA
- الضوابط والمتطلبات والمواصفات الفنية والقواعد الإجرائية اللازمة لتنفيذ أحكام لائحة الفوترة الإلكترونية (قرار المحافظ رقم 62738 وتاريخ 1443/11/23هـ) (vfile dated 20230519 (decision 62738)) — ZATCA
- Security Features Implementation Standards to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
- تحمّل الدولة ضريبة القيمة المضافة المستحقة على الخدمات التعليمية الأهلية المقدمة إلى المواطنين (vالإصدار الثاني) — ZATCA
Checked on: 4 November 2026. What concerns JooDax is taken from the programs’ own code.