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

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

Disponible

Los 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

Conceptos relacionados

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

Fuentes

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