Aller au contenu
La facturation électronique en Arabie saoudite (FATOORA)

L'empreinte de la facture : comment elle est calculée

Empreinte SHA-256 du document, calculée après retrait des blocs du cachet et du QR et après canonicalisation, écrite en base64 ; le cachet et la chaîne reposent sur elle.

C'est l'empreinte qui est réellement signée : le cachet cryptographique est une signature de l'empreinte, et non du fichier. C'est aussi elle que le document suivant porte comme empreinte de la facture précédente, elle qui est envoyée à FATOORA avec chaque demande, et elle qui figure dans la balise QR 6.

Avant le calcul, trois blocs sont retirés, parce qu'ils ne sont pas encore prêts ou qu'ils contiennent l'empreinte elle-même : UBLExtensions (le cachet), la référence QR et cac:Signature. La déclaration XML est supprimée, le texte est canonicalisé en C14N 1.1, le SHA-256 est calculé et les 32 octets sont encodés en base64.

Comme l'empreinte porte sur le texte du document, une différence d'espace, d'ordre des attributs ou d'encodage des caractères donne une empreinte différente. C'est pourquoi le texte est d'abord canonicalisé, et pourquoi le cachet de la ZATCA ne modifie pas l'empreinte d'une facture validée : le cachet se trouve dans des blocs exclus.

Dans JooDax

Disponible

Les programmes n'utilisent aucun moteur C14N : ils écrivent le document directement sous forme canonique (décision D-01 : n'échapper que &, < et >, laisser les guillemets), puis retirent les trois blocs du texte, suppriment la déclaration et calculent le SHA-256. L'empreinte est calculée sur un brouillon du document final, avec des valeurs provisoires dans les blocs exclus ; le validateur de la ZATCA a accepté le résultat, et 400 cas de référence (golden) le figent dans sa version 1.0.

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

Étapes

  1. Retirer le bloc ext:UBLExtensions.
  2. Retirer l'élément AdditionalDocumentReference dont l'ID est QR.
  3. Retirer cac:Signature.
  4. Supprimer la déclaration XML et canonicaliser en C14N 1.1.
  5. Calculer le SHA-256 et encoder les 32 octets en base64.

Questions et réponses

Dois-je attendre la validation préalable avant de calculer l'empreinte de la facture suivante ?

Non. Les lignes directrices techniques précisent que le cachet de la ZATCA ne modifie pas l'empreinte : les documents peuvent donc être émis sans attendre.

Pages liées

Notions liées

La facturation électronique en Arabie saoudite (FATOORA)

Sources

  1. Electronic Invoice XML Implementation Standard to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
  2. Security Features Implementation Standards to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
  3. E-invoicing Detailed Technical Guidelines (vVersion 2) — ZATCA

Vérifié le: 4 novembre 2026. Ce qui concerne JooDax est tiré du code même des programmes.