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

El código QR de la factura electrónica

Código cuadrado impreso en la factura que contiene sus datos clave y su sello en TLV codificado en base64, para que el comprador pueda verificarlo con un teléfono.

Desde la fase 1 (4 de diciembre de 2021), una factura simplificada debe llevar un código QR de cinco etiquetas: nombre del vendedor, número de IVA, marca de tiempo, total con IVA y total del IVA. La fase 2 hizo obligatorio el código en todos los documentos y añadió cuatro etiquetas: la huella del documento, su firma, la clave pública y, en los documentos simplificados, la firma de ZATCA sobre el certificado del dispositivo.

Cada etiqueta consta de tres partes contiguas: un byte para el número de etiqueta, un byte para la longitud del valor y, a continuación, el valor en UTF-8. Las etiquetas se concatenan en una única secuencia de bytes, que se codifica en base64, y la imagen se dibuja a partir de ese texto. La norma de seguridad limita el texto a 700 caracteres.

En un documento simplificado, el dispositivo del vendedor genera todo el código, ya que es él quien sella. En un documento estándar, la plataforma FATOORA añade o actualiza el código en la autorización previa. El bloque QR del XML queda excluido de la huella, ya que la contiene.

Los documentos de ZATCA difieren en un punto que conviene conocer: la norma de seguridad describe la etiqueta 6 como 32 bytes (una huella binaria), mientras que el ejemplo resuelto de las directrices técnicas pone texto base64 en las etiquetas 6 y 7 (44 caracteres para la huella). Los ejemplos de ZATCA también terminan la marca de tiempo con Z, aunque la norma admite la hora local sin ella.

En JooDax

Disponible

La caja imprime un código de nueve etiquetas en cada documento simplificado, con las etiquetas 6 y 7 como texto base64, como en el ejemplo de las directrices técnicas. Las facturas A4 de Books imprimen el código de cinco etiquetas de la fase 1, sin firmar. Los programas rechazan cualquier etiqueta de más de 255 bytes, pero no comprueban el límite de 700 caracteres.

crates/jdx-einvoice-sa/src/xml.rs

Pasos

  1. Reunir los valores: nombre, número de IVA, marca de tiempo, total, IVA y, en la fase 2, la huella, la firma, la clave pública y la firma de ZATCA.
  2. Para cada valor, escribir el byte de la etiqueta, después un byte de longitud (el número de bytes en UTF-8) y, por último, el valor.
  3. Concatenar las etiquetas sin separadores y codificar en base64 toda la secuencia.
  4. Poner el texto en el elemento QR del XML y dibujar a partir de él la imagen en la copia impresa.

Las etiquetas del código QR

EtiquetaNombreFaseSignificado
1Nombre del vendedor1Nombre registrado del vendedor en UTF-8, como en el campo del nombre del vendedor (BT-27).
2Número de IVA del vendedor1Número de IVA de 15 dígitos del vendedor (BT-31).
3Marca de tiempo de la factura (fecha y hora)1Fecha y hora de emisión en ISO 8601; el ejemplo de la norma de seguridad es 2022-02-21T12:13:57Z. En la fase 2, los programas escriben la hora local sin Z, reflejando los campos de fecha y hora; su código de la fase 1 usa UTC con Z.
4Total de la factura (con IVA)1Total con IVA incluido (BT-112), como texto numérico.
5Total del IVA1Total del IVA; la versión 1.2 de la norma de seguridad aclaró que es el valor de BT-110.
6Huella (hash) de la factura XML2Huella del documento. La norma de seguridad indica una longitud de 32 bytes, mientras que el ejemplo resuelto de las directrices técnicas lleva el texto base64 de 44 caracteres, como hacen los programas.
7Firma ECDSA de la huella del XML2Firma ECDSA de la huella del documento: la realiza el dispositivo del vendedor en los documentos simplificados y la plataforma de ZATCA en los estándar. Los programas la escriben como texto base64, como en el ejemplo de las directrices técnicas.
8Clave pública ECDSA2Clave pública correspondiente a la clave de firma. Los programas escriben el SubjectPublicKeyInfo DER completo (88 bytes para secp256k1), como en el ejemplo de las directrices técnicas.
9Firma ECDSA de la clave pública del sello criptográfico por la autoridad de certificación técnica de ZATCA2Solo en los documentos simplificados y sus notas: la firma de la autoridad de certificación de ZATCA sobre el certificado del dispositivo, copiada del propio certificado. En el modo de prueba local es una autofirma, no la de ZATCA.

Preguntas y respuestas

¿Por qué la aplicación de ZATCA muestra el nombre árabe con caracteres ilegibles?

Normalmente, porque el nombre no se codificó en UTF-8, o porque la longitud contó letras en lugar de bytes; una letra árabe ocupa dos bytes.

¿Basta con el código de la fase 1 tras incorporarse a la fase 2?

No. Tras la integración, el documento debe llevar las etiquetas de la fase 2; la etiqueta 9 solo se aplica a los documentos simplificados y sus notas.

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. E-invoicing Detailed Technical Guidelines (vVersion 2) — ZATCA
  3. الضوابط والمتطلبات والمواصفات الفنية والقواعد الإجرائية اللازمة لتنفيذ أحكام لائحة الفوترة الإلكترونية (قرار المحافظ رقم 62738 وتاريخ 1443/11/23هـ) (vfile dated 20230519 (decision 62738)) — ZATCA
  4. 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.