La serialización canónica de un documento según la ETA
Antes de calcular el hash, el documento se convierte en una sola línea de texto según reglas fijas: los nombres de campo en mayúsculas y entre comillas, los valores tal cual, y el nombre de la matriz delante de cada elemento.
El método de serialización de documentos («Document Serialization Approach») indica que la serialización empieza en la raíz del documento y sigue el orden en que aparecen los elementos. Cada nombre de campo se escribe en mayúsculas invariantes respecto de la referencia cultural, entre comillas dobles, y cada valor simple entre comillas dobles exactamente como llegó, sin procesar: 0.0 sigue siendo 0.0, no 0 ni 0.00.
En JSON, el nombre de una matriz se escribe una vez delante de ella y otra vez delante de cada elemento; en XML, cada elemento va precedido de su propio nombre en singular. Los espacios y saltos de línea entre elementos no importan, ya que solo entran los nombres y los valores. Después se calcula el hash del texto con SHA-256.
En la práctica, el JSON enviado y el texto del que se calcula el hash deben llevar los mismos números carácter por carácter; de lo contrario, el hash será distinto.
En JooDax
DisponibleJooDax construye el documento como un árbol que conserva el orden de los campos y el texto de cada número, de modo que el JSON y la forma canónica salen del mismo árbol. Una prueba reproduce el ejemplo de la matriz carácter por carácter, y otra verifica que unas comillas dentro de un valor siguen escapadas, de modo que dos documentos distintos nunca se serializan igual.
crates/jdx-einvoice-eg/src/lib.rs; crates/jdx-einvoice-eg/src/tests.rs
Preguntas y respuestas
¿Qué aspecto tiene una matriz serializada?
El ejemplo JSON de la ETA para la matriz de conceptos gravados: "TAXABLEITEMS""TAXABLEITEMS" y luego el elemento 1, después "TAXABLEITEMS" y el elemento 2, y así sucesivamente.
Páginas relacionadas
Conceptos relacionados
- La cadena de UUID: cómo se enlaza cada recibo con el anteriorEl UUID de cada recibo es el SHA-256 de su contenido, y ese contenido incluye el UUID del recibo anterior del mismo punto de venta, de modo que los recibos forman una cadena de la que no puede desaparecer ningún eslabón sin que se note.
- La firma de la factura electrónica egipcia (CAdES-BES)El emisor firma la factura con una firma CAdES-BES sobre el hash de su serialización, usando un certificado emitido a su nombre y alojado en un dispositivo criptográfico o en un sello electrónico.
Recibo y factura electrónicos en Egipto
Fuentes
- Document Serialization Approach — Egyptian Tax Authority (ETA) – eInvoicing & eReceipt SDK
Revisado el: 4 de noviembre de 2026. Lo que atañe a JooDax procede del propio código de los programas.