Skip to content
E-invoicing in Saudi Arabia (FATOORA)

Reporting simplified invoices within 24 hours

Sending a simplified invoice or note, already stamped and handed to the buyer, to FATOORA within 24 hours of issue.

The controls say simplified invoices and their notes, already carrying the cryptographic stamp, are sent to ZATCA within 24 hours of issue. The platform does not stamp simplified documents; the stamp and QR come from the seller's device.

The device sends the XML to the reporting API with the hash and UUID. 200 means accepted, 202 accepted with warnings (not to be resent), 400 rejected, 409 already reported. There is no bulk reporting API.

If a simplified document is rejected after the customer received it, the technical guidelines say there is no need to issue the customer another invoice: correct the error and submit a new document, and keep the transaction in the VAT return. Another answer in the same guidelines suggests cancelling the rejected document with a credit note and issuing a new one, so follow ZATCA's direction for the case at hand.

In JooDax

Built

The programs report waiting documents in the background every few minutes, oldest first, storing the answer as received, and retry later when the network is down. But they treat any answer other than 200 and 202 as a rejection, including 409 (already reported) and 500 server errors, which are not retried. They do not send the Clearance-Status header the API page lists. The developer sandbox accepted an invoice and a credit note without warnings (27 October 2026); that is not certification.

crates/jdx-einvoice-sa/src/unit.rs

Steps

  1. Stamp the simplified document and hand it to the buyer printed with its QR code.
  2. Send it to /invoices/reporting/single within 24 hours.
  3. Record the answer: accepted, accepted with warnings, or rejected.
  4. Handle a rejection with a new document that continues the chain.

Questions and answers

Can a device work offline?

Temporarily: stamping is local, but reporting must happen within 24 hours. Certificate revocation lists are valid for seven days per the Security standard.

Related pages

Related concepts

E-invoicing in Saudi Arabia (FATOORA)

Sources

  1. الضوابط والمتطلبات والمواصفات الفنية والقواعد الإجرائية اللازمة لتنفيذ أحكام لائحة الفوترة الإلكترونية (قرار المحافظ رقم 62738 وتاريخ 1443/11/23هـ) (vfile dated 20230519 (decision 62738)) — ZATCA
  2. 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
  3. E-invoicing Detailed Technical Guidelines (vVersion 2) — ZATCA
  4. Detailed Guidelines for E-Invoicing (vVersion 2) — ZATCA
  5. 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
  6. Security Features Implementation Standards to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA

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