Skip to content
Saudi Arabia

E-invoicing in Saudi Arabia (FATOORA)

Each page here is a field, a rule or a concept, written from the authority’s own documents (checked on 4 November 2026) and the JooDax programs’ code, saying plainly what is built and what is not.

E-invoicing

Built
Phase 1 of e-invoicing has applied to every resident taxpayer since 4 December 2021; Phase 2 (integration) arrives in waves, and wave 25 covers anyone whose VAT-taxable revenue passed SAR 187,500 in any year from 2022 to 2025, with a deadline of 1 February 2027. JooDax connects to ZATCA directly: UBL 2.1, an ECDSA (secp256k1) stamp, a hash chain with a counter, a TLV QR code and a CSID certificate; B2B invoices are cleared before they go out, and B2C invoices are reported within 24 hours. What is built is the simplified invoice and the credit note: a local test mode, onboarding with a one-time password and reporting in the background, accepted without warnings by ZATCA's developer environment on 27 October 2026. The standard B2B invoice and its clearance are planned, not built.

Sections

Concepts

Fields

  • BT-23 · Business process type
  • BT-1 · Invoice number
  • KSA-1 · Unique invoice identifier (UUID)
  • BT-2 · Invoice issue date
  • KSA-25 · Invoice issue time
  • BT-3 · Invoice type code
  • KSA-2 · Invoice transaction code
  • BT-5 · Invoice currency code
  • BT-6 · Tax currency code
  • BT-25 · Billing reference (original invoice number)
  • KSA-16 · Invoice counter value (ICV)
  • KSA-13 · Previous invoice hash (PIH)
  • KSA-14 · QR code
  • KSA-15 · Cryptographic stamp
  • BT-29 · Seller identification (other seller ID)
  • BT-35 · Seller street name
  • KSA-17 · Seller building number
  • KSA-3 · Seller district
  • BT-37 · Seller city
  • BT-38 · Seller postal code
  • BT-40 · Seller country code
  • BT-31 · Seller VAT registration number
  • BT-27 · Seller name
  • KSA-21 · Tax scheme identifier
  • BT-44 · Buyer name
  • BT-46 · Other buyer ID
  • BT-48 · Buyer VAT registration number
  • BT-50 · Buyer street name
  • KSA-18 · Buyer building number
  • BT-52 · Buyer city
  • BT-53 · Buyer postal code
  • KSA-4 · Buyer district
  • BT-55 · Buyer country code
  • KSA-5 · Supply date
  • KSA-24 · Supply end date
  • BT-81 · Payment means code
  • KSA-10 · Reason for issuing a credit or debit note
  • BT-106 · Sum of invoice line net amounts
  • BT-109 · Invoice total amount without VAT
  • BT-110 · Invoice total VAT amount
  • BT-111 · Invoice total VAT amount in accounting currency
  • BT-112 · Invoice total amount with VAT
  • BT-113 · Prepaid amount
  • BT-114 · Rounding amount
  • BT-115 · Amount due for payment
  • BT-116 · VAT category taxable amount
  • BT-117 · VAT category tax amount
  • BT-118 · VAT category code
  • BT-119 · VAT category rate
  • BT-121 · VAT exemption reason code
  • BT-120 · VAT exemption reason text
  • BT-126 · Invoice line identifier
  • BT-129 · Invoiced quantity
  • BT-130 · Unit of measure code
  • BT-131 · Invoice line net amount
  • KSA-11 · Line VAT amount
  • KSA-12 · Line amount with VAT
  • BT-153 · Item name
  • BT-146 · Item net price
  • BT-151 · Invoiced item VAT category code
  • BT-152 · Invoiced item VAT rate

JooDax programs in Saudi Arabia

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. Security Features Implementation Standards to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
  4. الضوابط والمتطلبات والمواصفات الفنية والقواعد الإجرائية اللازمة لتنفيذ أحكام لائحة الفوترة الإلكترونية (قرار المحافظ رقم 62738 وتاريخ 1443/11/23هـ) (vfile dated 20230519 (decision 62738)) — ZATCA
  5. Controls, Requirements, Technical Specifications and Procedural Rules for Implementing the Provisions of the E-Invoicing Regulation (Decision No. 62738 dated 23/11/1443H) (vfile dated 20230519 (decision 62738)) — ZATCA
  6. Detailed Guidelines for E-Invoicing (vVersion 2) — ZATCA
  7. الدليل الإرشادي التفصيلي للفوترة الإلكترونية (vالنسخة الثانية) — ZATCA
  8. E-invoicing Detailed Technical Guidelines (vVersion 2) — ZATCA
  9. Developer Portal Manual (vVersion 3) — ZATCA
  10. FATOORA Portal User Manual (vVersion 3) — ZATCA
  11. Integration Sandbox API pages (Swagger): reporting, clearance, compliance, production CSID, renewal (ve-Invoicing Sandbox Release 2.1.0 (page lists 2.1.1 as latest)) — ZATCA
  12. اللائحة التنفيذية لنظام ضريبة القيمة المضافة (vالنسخة العاشرة (آخر تعديل بقرار 24-06-01 في 2024-11-19)) — ZATCA
  13. Implementing Regulations of the Value Added Tax Law (unofficial translation) (vEighth Edition 04/04/1443H) — ZATCA
  14. Guideline for Tax Invoicing and Records under VAT Provisions (vVersion 3) — ZATCA
  15. تحمّل الدولة ضريبة القيمة المضافة المستحقة على الخدمات التعليمية الأهلية المقدمة إلى المواطنين (vالإصدار الثاني) — ZATCA
  16. E-Invoicing roll-out phases (vpage last updated 2026-09-01) — ZATCA

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