Código QR
Cadena base64 de etiquetas TLV con los datos clave y el sello de la factura, impresa como imagen QR que el comprador puede verificar.
El código es obligatorio en todos los documentos (BR-KSA-27) y debe ser visible en la copia impresa. En la fase 2 contiene nueve etiquetas: nombre del vendedor, número de IVA, marca de tiempo, total con IVA y total del IVA; después, la huella del documento, su firma y la clave pública. La etiqueta 9, solo para documentos simplificados, es la firma de ZATCA sobre el certificado del dispositivo.
Cada etiqueta consta de un byte para el número, un byte para la longitud y, a continuación, el valor en UTF-8; toda la secuencia se codifica en base64, y la norma de seguridad limita el resultado a 700 caracteres. Los errores típicos son escribir la longitud como texto en lugar de como byte, o codificar un nombre árabe en algo distinto de UTF-8.
El bloque QR queda excluido de la huella y de la firma, ya que contiene la propia huella. En una factura estándar, ZATCA añade o actualiza el QR al autorizarla; en una simplificada, el dispositivo escribe el código completo.
| Identificador | KSA-14 |
|---|---|
| Ruta en el documento | /Invoice/cac:AdditionalDocumentReference[cbc:ID='QR']/cac:Attachment/cbc:EmbeddedDocumentBinaryObject |
| Cardinalidad | 0..1 |
| Tipo de dato | Binary (base64) |
| Se aplica a | Factura fiscal (estándar) y Factura fiscal simplificada |
En JooDax
DisponibleLos programas generan las nueve etiquetas y rechazan cualquier etiqueta de más de 255 bytes, pero no comprueban el total de 700 caracteres. Las etiquetas 6 y 7 se escriben como texto base64, como en el ejemplo resuelto de las directrices técnicas, mientras que la norma de seguridad describe la etiqueta 6 como 32 bytes. La etiqueta 3 es la hora local sin Z.
crates/jdx-einvoice-sa/src/xml.rs
Se aplica a
| Factura fiscal | Nota de débito | Nota de crédito | Simplificada | Débito simplificado | Crédito simplificado |
|---|---|---|---|---|---|
| Obligatorio | Obligatorio | Obligatorio | Obligatorio | Obligatorio | Obligatorio |
Reglas que lo comprueban
- BR-KSA-27 · El documento debe contener un código QR codificado como base64Binary.
Campos relacionados
Campos — La facturación electrónica en Arabia Saudí (FATOORA)
Fuentes
- Electronic Invoice XML Implementation Standard to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
- 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
Revisado el: 4 de noviembre de 2026. Lo que atañe a JooDax procede del propio código de los programas.