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

Alta de un dispositivo y su CSID

Có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.

El certificado (CSID; los controles lo llaman identificador del sello criptográfico) vincula un dispositivo de facturación con el número de IVA del contribuyente. El proceso empieza en el portal FATOORA, donde el contribuyente genera un OTP (hasta 100 por solicitud, cada uno válido durante una hora; no existe API para los OTP).

El dispositivo genera un par de claves y una solicitud PKCS#10 que lleva el nombre común de la unidad, un número de serie con la forma «1-fabricante|2-modelo|3-serie», el número de IVA, el nombre de la sucursal, el nombre del contribuyente, el país, un mapa de cuatro dígitos de los tipos de factura (1100 = estándar y simplificada), la ubicación y el sector. Enviada con el OTP, la solicitud devuelve un certificado de conformidad.

Con el certificado de conformidad, el dispositivo envía documentos de muestra para su comprobación; las directrices técnicas indican tres por tipo (factura, nota de débito, nota de crédito). Cuando se superan, solicita el certificado de producción con el ID de la solicitud de conformidad y, a partir de entonces, lo usa para sellar y notificar. El certificado tiene una validez de hasta 60 meses; la renovación requiere un nuevo OTP y una nueva clave.

Los controles exigen que la clave de firma esté marcada como no exportable o, cuando la guarda un software, que el disco esté cifrado; trasladar la clave a otro dispositivo es una función prohibida.

En JooDax

En parte

El alta está implementada: los programas generan ellos mismos la clave y la CSR, solicitan el certificado de conformidad, comprueban un documento de muestra (una factura simplificada) y después solicitan el certificado de producción, lo que ha funcionado en el entorno de pruebas para desarrolladores. Sin embargo, solicitan el tipo de factura 1100 (estándar y simplificada) aunque las facturas estándar no están implementadas, y comprueban una muestra en lugar de tres por tipo; esto no se ha probado en simulación ni en producción, donde la plataforma puede denegar el certificado de producción hasta que se completen las comprobaciones. Los campos de la CSR siguen la configuración de ejemplo de ZATCA (SN, UID, title en el nombre alternativo) y no la tabla de la norma de seguridad (organizationIdentifier). La renovación no está implementada. La clave se guarda dentro del archivo de datos cifrado.

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

Pasos

  1. Generar un OTP en el portal FATOORA.
  2. Generar en el dispositivo una clave privada y una CSR con la plantilla del entorno de destino.
  3. Enviar la CSR y el OTP a /compliance para obtener un certificado de conformidad y un secreto.
  4. Enviar documentos de muestra firmados a /compliance/invoices hasta que se superen.
  5. Enviar el ID de la solicitud de conformidad a /production/csids para obtener el certificado de producción.

Preguntas y respuestas

¿Funciona en producción un certificado del portal para desarrolladores?

No. Los certificados del portal para desarrolladores son solo para pruebas y no funcionan en el entorno real.

¿Qué ocurre con los certificados de un contribuyente cuando se incorpora a un grupo de IVA?

Se revocan automáticamente, y los dispositivos deben darse de alta de nuevo con el número del grupo.

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. Developer Portal Manual (vVersion 3) — ZATCA
  4. FATOORA Portal User Manual (vVersion 3) — ZATCA
  5. Integration Sandbox API pages (Swagger): reporting, clearance, compliance, production CSID, renewal (ve-Invoicing Sandbox Release 2.1.0 (page lists 2.1.1 as latest)) — ZATCA
  6. الضوابط والمتطلبات والمواصفات الفنية والقواعد الإجرائية اللازمة لتنفيذ أحكام لائحة الفوترة الإلكترونية (قرار المحافظ رقم 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.