La canonicalisation XML (C14N 1.1) avant le calcul de l'empreinte
Mise du texte XML sous une forme standard unique avant le calcul de l'empreinte, afin qu'un même document donne la même empreinte sur tous les systèmes.
Un même document peut s'écrire de multiples façons : ordre des attributs, style des guillemets, déclarations d'espaces de noms, éléments vides. La canonicalisation (Canonical XML 1.1) ramène toutes ces variantes à un texte unique, sur lequel l'empreinte est calculée.
La ZATCA la fixe dans le bloc de signature : trois transformations XPath qui retirent UBLExtensions, cac:Signature et la référence QR, puis la transformation http://www.w3.org/2006/12/xml-c14n11. La même méthode sert à calculer l'empreinte de la facture précédente.
Conséquences pratiques pour les factures en arabe : le texte est en UTF-8, les guillemets à l'intérieur du texte ne sont pas échappés alors que &, < et > le sont, et les espaces de ligne autour des blocs retirés restent dans le texte.
Dans JooDax
DisponibleLes programmes n'embarquent aucun canonicaliseur. Ils écrivent plutôt le document sous forme canonique dès le départ (décision D-01 : n'échapper que &, < et > et laisser les guillemets, contrairement à la version 1.0) : le texte écrit est donc le texte canonique, et l'empreinte est calculée directement sur lui. Cela suppose que chaque caractère produit par le module d'écriture reste figé ; 400 cas de référence (golden) le figent dans sa version 1.0.
crates/jdx-einvoice-sa/src/xml.rs
Pages liées
- KSA-13 Empreinte de la facture précédente (PIH)
- KSA-15 Cachet cryptographique
- BR-KSA-26 · L'empreinte de la facture précédente doit être un SHA-256 en base64, calculé selon la méthode de la norme.
Notions liées
- L'empreinte de la facture : comment elle est calculéeEmpreinte 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.
- 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
- Security Features Implementation Standards to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
- Electronic Invoice XML Implementation Standard to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
- 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.