La cadena de UUID: cómo se enlaza cada recibo con el anterior
El 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.
Los pasos de la ETA: incluir todos los campos, entre ellos el UUID del recibo anterior del mismo punto de venta (y, en una devolución, la referencia al recibo original); dejar vacío el UUID del propio recibo; serializar el recibo en una sola línea; calcular su hash con SHA-256; convertir los 32 bytes en 64 caracteres hexadecimales; y escribirlos en el campo.
El primer recibo de un punto de venta tiene el previousUUID vacío, y cada uno de los siguientes lleva el UUID de su predecesor. Si se cambia un carácter de un recibo antiguo, su hash cambia y deja de coincidir con lo que registró el recibo siguiente.
Un recibo rechazado no rompe la cadena: en el ejemplo de la ETA se rechaza R2, situado entre R1 y R3; se corrige como R2* con un UUID nuevo, conserva R1 como predecesor, añade un referenceOldUUID que apunta a R2, y R3 queda como estaba.
En JooDax
DisponibleJooDax calcula el hash siguiendo estos pasos y lo escribe en el recibo, y hay pruebas que cubren el hash y la cadena. El módulo no almacena el último UUID de cada punto de venta y no genera ni referenceOldUUID ni la referencia de devolución. El comentario del código califica de no confirmado el vaciado del campo, mientras que los pasos de la ETA lo establecen expresamente.
crates/jdx-einvoice-eg/src/lib.rs; crates/jdx-einvoice-eg/src/tests.rs
Pasos
- Ponga en previousUUID el UUID del recibo anterior del mismo punto de venta (vacío en el primero).
- Deje vacío el campo uuid.
- Serialice el recibo en una sola línea según las reglas de la ETA.
- Calcule el hash del texto con SHA-256 y conviértalo en 64 caracteres hexadecimales.
- Ponga el resultado en uuid y guárdelo como previousUUID del recibo siguiente.
Preguntas y respuestas
¿Qué ocurre si se rechaza un recibo en mitad de la cadena?
Se corrige y recibe un UUID nuevo, conservando su predecesor y añadiendo un referenceOldUUID al recibo rechazado; una rectificación que remite a un recibo invalidado se acepta dentro de las 96 horas, y una sin referencia coincidente dentro de las 72, salvo que la cubra una solicitud de envío tardío.
Páginas relacionadas
Conceptos relacionados
- La serialización canónica de un documento según la ETAAntes 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.
- Emisión sin conexión y la ventana de 24 horasEl recibo se emite y se comprueba localmente, y después se envía en un plazo de 24 horas; lo que llegue más tarde necesita una solicitud de envío tardío.
Recibo y factura electrónicos en Egipto
Fuentes
- Receipt Issuance FAQ — Egyptian Tax Authority (ETA) – eInvoicing & eReceipt SDK
- Receipt v1.2 (v1.2) — Egyptian Tax Authority (ETA) – eInvoicing & eReceipt SDK
- 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.