Ir al contenido

Puntos de acceso

NombreMétodoRuta en el documentoFinalidadLo usa JooDax
Compliance CSIDPOST/complianceEnvía la CSR con un OTP del portal FATOORA y devuelve el certificado de conformidad (binarySecurityToken), su secreto y el ID de la solicitud.Sí
Compliance invoice checkPOST/compliance/invoicesComprueba documentos de muestra firmados con el certificado de conformidad antes de que se emita el certificado de producción. Las directrices técnicas indican tres documentos por tipo: factura, nota de débito y nota de crédito.Sí
Production CSID (onboarding)POST/production/csidsCanjea el ID de la solicitud de conformidad por el certificado de producción (PCSID), que se usa a partir de entonces para sellar y notificar.Sí
Production CSID (renewal)PATCH/production/csidsRenueva el certificado de producción con una nueva CSR y un nuevo OTP; el certificado anterior se revoca.No
Reporting (single)POST/invoices/reporting/singleNotifica un documento simplificado firmado (factura o nota): 200 aceptado, 202 aceptado con advertencias, 400 rechazado, 409 ya notificado.Sí
Clearance (single)POST/invoices/clearance/singleSomete un documento estándar a autorización previa; la plataforma lo devuelve sellado y con código QR (clearedInvoice). Devuelve 303 cuando ZATCA ha desactivado la autorización previa, en cuyo caso el documento se envía por la vía de notificación.No

Entornos

EntornoFinalidad
Developer portal (Integration Sandbox)https://gw-fatoora.zatca.gov.sa/e-invoicing/developer-portalEntorno de pruebas para desarrolladores; nada de lo que se envía allí tiene efectos ante ZATCA, y sus certificados no funcionan en producción. Las páginas de la API muestran OTP de ejemplo (como 123345), pero no indican que se acepte cualquier OTP.
Simulationhttps://gw-fatoora.zatca.gov.sa/e-invoicing/simulationEntorno opcional para pruebas de extremo a extremo antes de producción, con dispositivos dados de alta por separado de producción y un OTP del portal de simulación de FATOORA válido durante una hora.
Production (core)https://gw-fatoora.zatca.gov.sa/e-invoicing/coreEntorno real para la notificación y la autorización previa. Los OTP se obtienen en el portal FATOORA (hasta 100 por solicitud, cada uno válido durante una hora); no existe API para ellos.

Fuentes

  1. 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

Revisado el: 4 de noviembre de 2026. Lo que atañe a JooDax procede del propio código de los programas.