Acceso Permanente y Reporte Mensual al SENIAT
Este anexo describe el modelo mediante el cual la plataforma de imprenta digital de ZENTTO GLOBAL TECHNOLOGY, C.A. garantiza al SENIAT el acceso permanente a la información los 365 días del año, remite mensualmente la información del registro automatizado dentro de los diez (10) días continuos siguientes al cierre de cada mes, y preserva la confidencialidad de los datos, en cumplimiento de los artículos 29.5, 32 y 25.4 de la Providencia Administrativa SNAT/2024/000102.
1. Acceso permanente (Art. 29.5)
La plataforma dispone de un canal de consulta exclusivo y permanente para la Administración
Tributaria, sobre las rutas /seniat/*, protegido por la cabecera
X-Seniat-Key. El acceso está disponible de forma continua, los 365 días del año,
mientras la clave de consulta esté vigente. Las rutas verificadas son:
| Ruta | Función |
|---|---|
GET /seniat/consulta/:ncfd | Consulta de un documento por su número de control, con todos sus datos fiscales y su hash de integridad |
GET /seniat/listado | Listado de documentos por RIF emisor y rango de fechas, con paginación |
GET /seniat/libro-ventas/:rif/:periodo | Libro de ventas por emisor y período (AAAA-MM), con totales de base, IVA, IGTF y total |
Cada consulta queda registrada en la bitácora de acceso inmutable
audit."AccessLog" con tipo de evento SENIAT_QUERY y actor
SENIAT, junto con la dirección IP, el agente de usuario, la ruta solicitada y la
marca temporal, de modo que el propio acceso del SENIAT es trazable y auditable.
2. Modelo de acceso y monitoreo
graph TD
SENIAT["SENIAT — funcionario autorizado"] -->|X-Seniat-Key| API["API de consulta /seniat/*"]
API --> CON["Consulta por número de control"]
API --> LST["Listado por RIF y período"]
API --> LIB["Libro de ventas por período"]
CON --> AUD["audit.AccessLog (SENIAT_QUERY)"]
LST --> AUD
LIB --> AUD
AUD --> TRZ["Trazabilidad permanente de cada acceso"]
3. Reporte mensual del registro automatizado (Art. 32)
El artículo 32 exige remitir al SENIAT, dentro de los diez (10) días continuos siguientes al cierre de cada mes, la información del registro automatizado. La plataforma conserva esta información de forma estructurada y la pone a disposición para su remisión mensual:
| Información del Art. 32 | Fuente |
|---|---|
| RIF de los emisores | "RifEmisor" |
| Fecha de asignación | "FechaEmision" / "CreatedAt" |
| Tipo de documento | "TipoDocumento" |
| Numeración de control consecutiva | "NCFD" / "NumeroControl" |
| Numeración de cada formato | "Serie" / "SerieCorrelativo" |
| Identificación de la factura | "InvoiceId" / "NumeroDocumento" |
| Información adicional requerida | Período, totales y demás campos del registro fiscal |
La información se obtiene del registro automatizado por período mediante la consulta de libro
por mes (GET /seniat/libro-ventas/:rif/:periodo, con período en formato
AAAA-MM) y el listado por rango de fechas. La remisión se efectúa dentro del plazo
de diez (10) días continuos posteriores al cierre del mes correspondiente.
graph LR
MES["Cierre de mes"] --> REG["Consolidación del registro automatizado del período"]
REG --> VAL["Verificación de integridad de la cadena"]
VAL --> REM["Remisión al SENIAT dentro de 10 días continuos"]
REM --> ACK["Constancia y registro de la remisión"]
4. Confidencialidad (Art. 25.4)
El acceso a la información se rige por controles que preservan la confidencialidad exigida por el artículo 25:
- Canal exclusivo del SENIAT. Las rutas
/seniat/*requieren la clave de consultaX-Seniat-Key; si la clave no está configurada o no coincide, la plataforma responde con error y no entrega información. - Acceso por roles. El backoffice administrativo restringe el acceso por rol (
ZENTTO_SUPERADMIN,DISTRIBUIDOR) y, para perfiles no superadministradores, filtra la información a la cartera de empresas autorizada (control server-side anti-IDOR). - Sesión protegida. La sesión del operador se transporta en cookie httpOnly/Secure, no accesible desde el navegador.
- Secretos custodiados. La clave de consulta del SENIAT y las demás credenciales se custodian en HashiCorp Vault, fuera del código fuente.
- Trazabilidad de cada acceso. Cada consulta queda registrada en la bitácora inmutable, de modo que el uso de la información es siempre verificable.
5. Continuidad del servicio
La disponibilidad continua del canal de consulta y del registro automatizado se sostiene en la arquitectura desplegada (servicio en contenedor con reinicio automático, base de datos PostgreSQL 16, verificación de salud del servicio y monitoreo permanente), lo que asegura el acceso del SENIAT los 365 días del año conforme al artículo 29.5. El detalle de los controles de seguridad y monitoreo se desarrolla en el anexo de seguridad, gestión de vulnerabilidades y monitoreo del SENIAT.
ZENTTO GLOBAL TECHNOLOGY, C.A. — RIF J-50849797-0 — Acceso permanente y reporte al SENIAT (Art. 29.5, 32 y 25.4 SNAT/2024/000102) — v1.0.0.