Aller au contenu
Reçu et facture électroniques en Égypte

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

Disponible

JooDax 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

Reçu et facture électroniques en Égypte

Sources

  1. 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.