Home › E-invoicing reference

The Saudi e-invoicing reference

Rejection codes, terms, waves, penalties and checkers that run on your device. Every line here links to a ZATCA document and the date we checked it.

What is in the reference

Rejection codesType the code you got, or a word from it. Each code shows its official text and severity, every code has a page with its source, and 40 of them have a fix and an example we ran through ZATCA's SDK.GlossaryA short definition of each term you meet on the Fatoora platform and in the invoice file, with its Arabic name and where ZATCA defines it.Integration wavesEach wave with its revenue threshold, the years counted, its date as ZATCA wrote it, and the announcement link. The table is also an open data file.Invoice XML checkerPaste the file or open it from your device. The whole check runs in the browser against 38 rules, and each code it finds links to its fix.VAT number checkerType the number to see whether its format is accepted on an e-invoice. The check runs on your device; to confirm registration we send you to ZATCA's lookup.Penalty calculatorThe amounts are copied from the table in ZATCA's violations classification guide. Pick the offence and the repeat to see the figure and its source.POS comparison20 systems and 15 features, taken from the companies' public pages on 26 October 2026. No ranking and no scores; every cell has a source.Open a restaurant12 steps in order, each with the agency, the service, the fee, the time and the documents as the official pages showed them on 26 October 2026.Open a shop12 steps in order, each with the agency, the service, the fee, the time and the documents as the official pages showed them on 26 October 2026.What we don't doThe limits of this reference, written down so you know what to rely on it for, and when to go to ZATCA or your accountant.MethodologyWhere each fact comes from, how we check it, and what we do when two ZATCA documents disagree.Correct usIf you find a mistake, send it with a link to its source. We review it, update the page and log the change with its date.ChangelogZATCA's e-invoicing updates, our changes to the reference and what it covers today. Every entry has a date and a source.

Tools already on the site

Are you in Wave 25?Enter your revenue for 2022 to 2025 and see whether you are in Wave 25 of e-invoicing Phase 2, and how long is left until the 1 February 2027 deadline.Invoice QR generatorMake a ZATCA e-invoice QR code in TLV format from the five required fields, or paste an existing one and decode it. Free, no sign-up, runs in your browser.

Facts you can quote

Open data

Glossary (JSON)Integration waves (JSON)Rejection codes (JSON)E-invoicing updates (Atom)

The files are open under CC BY 4.0: use and share them as long as you credit the source and the check date.

Frequently asked questions

Who writes this reference?

The team at CashHub, a Saudi POS and e-invoicing system. We write from ZATCA's documents, run the examples through ZATCA's SDK, and give the source and check date under each fact.

Does this replace ZATCA?

No. It is an organised explanation of ZATCA's documents. If something here differs from a newer official document, the document wins, and you can tell us on the Correct us page.

Do the tools send my files anywhere?

No. The XML checker, the VAT number checker and the penalty calculator run inside your browser and send nothing to any server.

Last updated: 26 October 2026 · What we don't do · Methodology · Correct us · Changelog

First published 2026-10-26 · Archived copy

First 500 restaurants, cafés, bakeries and sweet shops: a SAR 99 monthly cap.

Instead of SAR 149, per branch, for a full year. Free to join, no commitment.

Reserve your seat