La huella (hash) de la factura: cómo se calcula
Huella SHA-256 del documento tras eliminar los bloques del sello y del QR y canonicalizarlo, escrita en base64; el sello y la cadena se basan en ella.
La huella es lo que realmente se firma: el sello criptográfico es una firma sobre la huella, no sobre el archivo. También es lo que el documento siguiente lleva como huella de la factura anterior, lo que se envía a FATOORA con cada solicitud y lo que aparece en la etiqueta 6 del QR.
Antes de calcular la huella se eliminan tres bloques, porque aún no están listos o contienen la propia huella: UBLExtensions (el sello), la referencia del QR y cac:Signature. Se suprime la declaración XML, se canonicaliza el texto con C14N 1.1, se calcula el SHA-256 y los 32 bytes se codifican en base64.
Como la huella se calcula sobre el texto del documento, una diferencia en un espacio, en el orden de los atributos o en la codificación de caracteres da una huella distinta. Por eso el texto se canonicaliza primero, y por eso el sello de ZATCA no cambia la huella de una factura autorizada: el sello está en bloques excluidos.
En JooDax
DisponibleLos programas no usan ningún motor C14N: escriben el documento ya en forma canónica (decisión D-01: escapar solo &, < y >, sin tocar las comillas), después recortan los tres bloques del texto, suprimen la declaración y calculan el SHA-256. La huella se toma de un borrador del documento final con marcadores en los bloques excluidos; el validador de ZATCA aceptó el resultado, y 400 casos de referencia (golden) comprueban que coincide con la versión 1.0.
crates/jdx-einvoice-sa/src/xml.rs
Pasos
- Eliminar el bloque ext:UBLExtensions.
- Eliminar el AdditionalDocumentReference cuyo ID es QR.
- Eliminar cac:Signature.
- Suprimir la declaración XML y canonicalizar con C14N 1.1.
- Calcular el SHA-256 y codificar en base64 los 32 bytes.
Preguntas y respuestas
¿Debo esperar a la autorización previa antes de calcular la huella de la factura siguiente?
No. Las directrices técnicas indican que el sello de ZATCA no cambia la huella, así que los documentos pueden emitirse sin esperar.
Páginas relacionadas
- KSA-13 Huella (hash) de la factura anterior (PIH)
- KSA-15 Sello criptográfico
- KSA-14 Código QR
- BR-KSA-26 · La huella de la factura anterior debe ser un SHA-256 en base64 calculado según el método de la norma.
- BR-KSA-61 · Todo documento debe contener la huella de la factura anterior.
Conceptos relacionados
- Canonicalización XML (C14N 1.1) antes de calcular la huellaConvertir el texto XML a una única forma normalizada antes de calcular la huella, para que el mismo documento dé la misma huella en cualquier sistema.
- La huella de la factura anterior (PIH) y la cadena de documentosCada documento lleva la huella del anterior del mismo dispositivo, de modo que los documentos forman una cadena en la que cualquier supresión o modificación queda a la vista.
- El sello criptográfico (firma digital)Firma ECDSA en formato XAdES sobre la huella del documento y las propiedades de firma, realizada con la clave de un dispositivo registrado y un certificado emitido por ZATCA.
La facturación electrónica en Arabia Saudí (FATOORA)
Fuentes
- Electronic Invoice XML Implementation Standard to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
- Security Features Implementation Standards to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
- E-invoicing Detailed Technical Guidelines (vVersion 2) — ZATCA
Revisado el: 4 de noviembre de 2026. Lo que atañe a JooDax procede del propio código de los programas.