Canonicalización XML (C14N 1.1) antes de calcular la huella
Convertir 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.
Un mismo documento puede escribirse como muchos textos distintos: orden de los atributos, tipo de comillas, declaraciones de espacios de nombres, elementos vacíos. La canonicalización (Canonical XML 1.1) los convierte todos en un único texto, y la huella se calcula sobre él.
ZATCA la fija en el bloque de firma: tres transformaciones XPath que eliminan UBLExtensions, cac:Signature y la referencia del QR y, después, la transformación http://www.w3.org/2006/12/xml-c14n11. El mismo método sirve para calcular la huella de la factura anterior.
Efectos prácticos para las facturas en árabe: el texto está en UTF-8; las comillas dentro del texto no se escapan, mientras que &, < y > sí; y los espacios en blanco de línea alrededor de los bloques eliminados permanecen en el texto.
En JooDax
DisponibleLos programas no incluyen ningún canonicalizador. En su lugar, escriben el documento en forma canónica desde el principio (decisión D-01: escapar solo &, < y > y dejar las comillas, a diferencia de la versión 1.0), de modo que el texto escrito es el texto canónico y la huella se calcula directamente sobre él. Esto depende de que cada carácter del generador permanezca fijo; 400 casos de referencia (golden) comprueban que coincide con la versión 1.0.
crates/jdx-einvoice-sa/src/xml.rs
Páginas relacionadas
- KSA-13 Huella (hash) de la factura anterior (PIH)
- KSA-15 Sello criptográfico
- 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.
Conceptos relacionados
- La huella (hash) de la factura: cómo se calculaHuella 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.
- 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
- Security Features Implementation Standards to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
- Electronic Invoice XML Implementation Standard 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.