Validation préalable (clearance) des factures standard
Envoi d'une facture standard ou d'une note à FATOORA avant que l'acheteur ne la reçoive ; la plateforme la renvoie cachetée, avec un code QR.
Les règles de contrôle définissent la validation préalable comme le contrôle par la ZATCA des factures standard et de leurs notes, l'apposition de son cachet sur celles qui sont conformes et la notification de l'émetteur avant qu'elles ne parviennent au client. En phase 2, une facture standard n'est valable qu'avec le cachet de la ZATCA.
Le vendeur envoie le document en XML (et non en PDF/A-3) à l'API de validation préalable, avec son empreinte et son UUID. S'il est valide ou accepté avec avertissements, la plateforme le renvoie cacheté, avec un code QR ; s'il est rejeté, elle renvoie les erreurs, et le document corrigé repart comme un nouveau document, avec une nouvelle valeur de compteur et un nouvel UUID.
Dans le cadre d'un dispositif d'autofacturation approuvé, c'est l'acheteur qui soumet le document. Lorsque la ZATCA désactive la validation préalable, l'API répond 303 et le document standard passe par l'API de déclaration : il est contrôlé mais non cacheté. En cas de panne du système, la défaillance est signalée via le service de notification des pannes de la ZATCA, et les documents sont envoyés une fois le problème résolu.
Dans JooDax
Non disponibleNon implémentée. Le document ne porte ni numéro de TVA ni adresse de l'acheteur, qu'exige une facture standard, et les programmes ne font aucun appel à l'API de validation préalable.
crates/jdx-einvoice-sa/src/api.rs
Étapes
- Émettre le document standard, éventuellement cacheté.
- L'envoyer à /invoices/clearance/single avec son empreinte et son UUID.
- En cas de réponse 200 ou 202, récupérer le document cacheté (clearedInvoice) et le remettre à l'acheteur.
- En cas de réponse 400, le corriger et émettre un nouveau document.
Questions et réponses
L'empreinte change-t-elle après l'apposition du cachet de la ZATCA sur la facture ?
Non ; le cachet et le code QR se trouvent dans des blocs exclus de l'empreinte.
Pages liées
- KSA-2 Code de transaction de la facture
- KSA-15 Cachet cryptographique
- KSA-14 Code QR
- BR-KSA-06 · L'attribut name du type de facture doit être présent et suivre la structure NNPNESB.
Notions liées
- Déclaration des factures simplifiées dans les 24 heuresEnvoi à FATOORA, dans les 24 heures suivant l'émission, d'une facture simplifiée ou d'une note déjà cachetée et remise à l'acheteur.
- Factures fiscales standard et simplifiéesLes factures standard s'adressent aux entreprises et passent par la validation préalable avant leur remise ; les factures simplifiées s'adressent surtout aux consommateurs, sont cachetées localement et déclarées dans les 24 heures.
- Le cachet cryptographique (signature numérique)Signature ECDSA au format XAdES portant sur l'empreinte du document et les propriétés de signature, réalisée avec la clé d'un appareil enregistré et un certificat délivré par la ZATCA.
La facturation électronique en Arabie saoudite (FATOORA)
Sources
- الضوابط والمتطلبات والمواصفات الفنية والقواعد الإجرائية اللازمة لتنفيذ أحكام لائحة الفوترة الإلكترونية (قرار المحافظ رقم 62738 وتاريخ 1443/11/23هـ) (vfile dated 20230519 (decision 62738)) — ZATCA
- 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
- E-invoicing Detailed Technical Guidelines (vVersion 2) — ZATCA
- Detailed Guidelines for E-Invoicing (vVersion 2) — ZATCA
- 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
Vérifié le: 4 novembre 2026. Ce qui concerne JooDax est tiré du code même des programmes.