La sérialisation canonique d’un document selon l’ETA
Avant le calcul de l’empreinte, le document devient une seule ligne de texte selon des règles fixes : noms de champs en majuscules entre guillemets, valeurs telles quelles, et nom du tableau avant chaque élément.
Le document sur la méthode de sérialisation (« Document Serialization Approach ») indique que la sérialisation part de la racine du document et suit l’ordre d’apparition des éléments. Chaque nom de champ s’écrit en majuscules indépendantes de la culture, entre guillemets doubles, et chaque valeur simple entre guillemets doubles, exactement telle qu’elle est arrivée, sans traitement : 0.0 reste 0.0, et non 0 ou 0.00.
En JSON, le nom d’un tableau s’écrit une fois avant celui-ci, puis à nouveau avant chaque élément ; en XML, chaque élément est précédé de son propre nom au singulier. Les espaces et sauts de ligne entre les éléments sont sans effet, puisque seuls les noms et les valeurs sont pris en compte. Le texte est ensuite haché avec SHA-256.
En pratique, le JSON envoyé et le texte haché doivent porter les mêmes nombres, caractère pour caractère, faute de quoi l’empreinte diffère.
Dans JooDax
DisponibleJooDax construit le document sous forme d’arbre qui conserve l’ordre des champs et le texte de chaque nombre : le JSON et la forme canonique proviennent donc du même arbre. Un test vérifie l’exemple du tableau caractère pour caractère, et un autre qu’un guillemet à l’intérieur d’une valeur reste échappé, de sorte que deux documents différents ne se sérialisent jamais de la même façon.
crates/jdx-einvoice-eg/src/lib.rs; crates/jdx-einvoice-eg/src/tests.rs
Questions et réponses
À quoi ressemble un tableau une fois sérialisé ?
L’exemple JSON de l’ETA pour le tableau des éléments taxables : "TAXABLEITEMS""TAXABLEITEMS" puis l’élément 1, puis "TAXABLEITEMS" puis l’élément 2, et ainsi de suite.
Pages liées
Notions liées
- La chaîne des UUID : comment chaque reçu est relié au précédentL’UUID de chaque reçu est l’empreinte SHA-256 de son contenu, et ce contenu inclut l’UUID du reçu précédent du même point de vente : les reçus forment ainsi une chaîne dont aucun maillon ne disparaît sans que cela se voie.
- La signature de la facture électronique égyptienne (CAdES-BES)L’émetteur signe la facture d’une signature CAdES-BES portant sur l’empreinte de sa sérialisation, avec un certificat délivré à son nom et conservé sur un dispositif cryptographique ou un cachet électronique.
Reçu et facture électroniques en Égypte
Sources
- Document Serialization Approach — Egyptian Tax Authority (ETA) – eInvoicing & eReceipt SDK
Vérifié le: 4 novembre 2026. Ce qui concerne JooDax est tiré du code même des programmes.