Ir al contenido
La facturación electrónica en Arabia Saudí (FATOORA)

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

Disponible

Los 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

  1. Eliminar el bloque ext:UBLExtensions.
  2. Eliminar el AdditionalDocumentReference cuyo ID es QR.
  3. Eliminar cac:Signature.
  4. Suprimir la declaración XML y canonicalizar con C14N 1.1.
  5. 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

Conceptos relacionados

La facturación electrónica en Arabia Saudí (FATOORA)

Fuentes

  1. Electronic Invoice XML Implementation Standard to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
  2. Security Features Implementation Standards to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
  3. 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.