ZATCA UBL XML Invoice — Auto-Extract to Excel

Overview

ZATCA (Zakat, Tax and Customs Authority) implements Saudi Arabia's e-invoicing mandate in two phases. Phase 1 (Dec 2021) required generation of UBL 2.1 compliant electronic invoices. Phase 2 (Jan 2023 onwards, by turnover tier) introduced clearance model — every invoice must be submitted to the ZATCA portal (Fatoora) for real-time validation before issuance. The ZATCA UBL profile extends standard UBL 2.1 with additional fields for QR code, cryptographic stamp (invoice hash), and PIH (Previous Invoice Hash) for chain integrity.

Technical Specification

Standard Body	ZATCA (Zakat, Tax and Customs Authority) — Saudi Arabia
Namespace URI	urn:oasis:names:specification:ubl:schema:xsd:Invoice-2 (extended with ZATCA PINT SA profile)
Root Element	Invoice
Version	Phase 2 — PINT SA profile on UBL 2.1
Mandatory Since	Phase 1: Dec 2021. Phase 2: Jan 2023–Jan 2024 by turnover tier.
Signature	Cryptographic stamp (invoice hash) + QR code (T LV) + Previous Invoice Hash (PIH) for chain

Fields Extracted by InvoSnap

Invoice UUID (cac:AdditionalDocumentReference/cbc:UUID)

Invoice number (cbc:ID), issue date, actual delivery date

Supplier name, VAT registration number, address (cac:AccountingSupplierParty/cac:Party)

Customer name, VAT number, address (cac:AccountingCustomerParty/cac:Party)

Line extension amount, tax exclusive amount, tax total, payable amount

Currency (SAR — Saudi Riyal)

Line items with quantity, unit price, VAT category, tax amount

QR code payload (T LV — Base64 encoded)

Cryptographic invoice hash

Previous Invoice Hash (PIH) for chain integrity

Frequently Asked Questions

What is the ZATCA clearance model?

Under Phase 2 clearance, every invoice must be sent to the ZATCA Fatoora portal and receive a cryptographic stamp (hash) before it can be issued. This is real-time tax enforcement — the government sees every invoice. InvoSnap extracts data from the stamped invoice XML.

What is the difference between simplified and standard ZATCA invoices?

Simplified invoices (B2C) only require a QR code. Standard invoices (B2B) require QR code + cryptographic stamp + PIH chain. InvoSnap handles both types.

Does InvoSnap validate the ZATCA QR code?

InvoSnap extracts the QR code T LV payload (seller name, VAT, timestamp, total, VAT amount, hash, signature) as structured fields. QR code cryptographic validation is not performed — that is done by the ZATCA Fatoora portal.

ZATCA UBL

Overview

Technical Specification

Fields Extracted by InvoSnap

Frequently Asked Questions

Extract ZATCA UBL Data Now