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.
El sello prueba dos cosas: que el documento procede de un dispositivo que su titular registró ante ZATCA y que no ha cambiado desde entonces. La huella se calcula con SHA-256, la firma se realiza con ECDSA y una clave de 256 bits, y es una firma XAdES envuelta (enveloped) de nivel B-B.
La firma contiene dos referencias: la huella del documento tras las transformaciones y la huella del bloque SignedProperties, que lleva la hora de firma, el resumen del certificado, su emisor y su número de serie. A continuación se firma SignedInfo y se adjuntan la firma y el certificado.
Un documento simplificado lo sella el dispositivo del vendedor antes de entregarlo. Un documento estándar lo sella la plataforma de ZATCA en la autorización previa; si el vendedor también lo sella, la plataforma añade un segundo sello. El código QR queda excluido de la firma.
Los textos de ZATCA no están del todo alineados: la tabla de la norma de seguridad incluye SigningCertificateV2, una política de firma y la cadena completa de certificados, y su perfil de certificado ilustrativo indica P-256, mientras que los ejemplos y las herramientas oficiales usan secp256k1 (los comandos de OpenSSL de las directrices técnicas).
En JooDax
DisponibleLos programas sellan con una clave secp256k1 (k256) y escriben el bloque de propiedades firmadas exactamente en la forma que acepta el validador de ZATCA, con los resúmenes del certificado y de las propiedades como base64 de la cadena hexadecimal. Difieren de la tabla de la norma de seguridad en lo siguiente: SigningCertificate de versión 1; ni política de firma ni propiedades de objetos de datos; solo se adjunta el certificado de firma; y el Type de la segunda referencia (xmldsig#SignatureProperties en lugar de 01903#SignedProperties). El paso 5 de las directrices técnicas describe la huella de las propiedades como base64 de los bytes tras eliminar los espacios, mientras que los programas calculan la huella de un bloque con sangría fija y codifican el texto hexadecimal. El validador de ZATCA aceptó esta forma en la fase de prueba.
crates/jdx-einvoice-sa/src/xml.rs
Pasos
- Calcular la huella del documento (véase la página sobre la huella de la factura).
- Firmar la huella con la clave privada del dispositivo mediante ECDSA.
- Calcular el resumen del certificado y completar las propiedades firmadas: hora de firma, resumen, emisor y número de serie.
- Calcular la huella de las propiedades firmadas.
- Completar UBLExtensions con la firma, el certificado y ambas referencias, y añadir cac:Signature y el bloque QR.
Preguntas y respuestas
¿El sello firma todo el archivo?
Abarca todo el documento salvo el bloque QR y el propio bloque del sello.
Páginas relacionadas
- KSA-15 Sello criptográfico
- KSA-13 Huella (hash) de la factura anterior (PIH)
- KSA-14 Código QR
- BR-KSA-28 · El ID de la información de firma del sello debe ser urn:oasis:names:specification:ubl:signature:1.
- BR-KSA-29 · El ID de firma referenciado y el ID de firma deben ser urn:oasis:names:specification:ubl:signature:Invoice.
- BR-KSA-30 · El método de firma debe ser urn:oasis:names:specification:ubl:dsig:enveloped:xades.
- BR-KSA-60 · El sello criptográfico es obligatorio en los documentos simplificados y sus notas.
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.
- Alta de un dispositivo y su CSIDCómo obtiene un dispositivo de facturación su certificado de sellado de ZATCA: clave, solicitud de certificado, OTP, comprobaciones de conformidad y, por último, el certificado de producción.
- 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 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
- E-invoicing Detailed Technical Guidelines (vVersion 2) — ZATCA
- الضوابط والمتطلبات والمواصفات الفنية والقواعد الإجرائية اللازمة لتنفيذ أحكام لائحة الفوترة الإلكترونية (قرار المحافظ رقم 62738 وتاريخ 1443/11/23هـ) (vfile dated 20230519 (decision 62738)) — ZATCA
- Electronic Invoice XML Implementation Standard to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
Revisado el: 4 de noviembre de 2026. Lo que atañe a JooDax procede del propio código de los programas.