3. Módulo Fiscal
Modelos, validación, simulación, workflow de aprobación y presentación con evidencias.
ModelosIVA/IRPF/IS
ControlValidación + aprobación
DiferencialSimulación
Visión del módulo
Gestión integral de impuestos: preparación, validación, aprobación, presentación telemática y archivo de evidencias. Con simulación y control de riesgos.
Objetivos
- Automatizar cálculo desde contabilidad/facturas minimizando intervención manual.
- Evitar presentaciones con errores mediante reglas y prevalidación.
- Implementar workflow de revisión/aprobación por rol supervisor.
- Guardar justificantes (CSV) y evidencias vinculadas a periodo/modelo.
- Proveer simulación (previsión) para informar al cliente.
Alcance
- Modelos IVA/IRPF/IS/Informativos con periodificación.
- Reglas por régimen y configuración por cliente (prorrata, RE, etc.).
- Gestión de borradores y versiones (si se recalcula).
- Presentación asíncrona con reintentos y logs.
- Cuadro de mando: vencimientos, pendientes, incidencias, riesgos.
Personas y roles
| Rol | Necesidad / uso principal |
|---|---|
| Gestor fiscal | Preparar modelos rápido con validaciones, checklist y simulación. |
| Supervisor | Aprobar modelos y controlar riesgo antes de presentar. |
| Cliente | Ver previsión, resultado y justificante. |
Diseño funcional
Flujos principales
Preparación de un modelo (ej.: 303)
Cierre de trimestre o liquidación mensual.
- Seleccionar empresa + periodo + modelo.
- Cargar datos: contabilidad + facturas + ajustes manuales permitidos.
- Calcular borrador con desglose (bases/cuotas).
- Ejecutar validaciones (cuadres, coherencia, checklist documental).
- Transición a 'En revisión' y asignación de revisor.
Salida: Borrador listo para revisión con desglose y evidencias.
Aprobación y presentación
Borrador revisado, checklist completo.
- Supervisor revisa puntos críticos y acepta (o devuelve con comentarios).
- Al aprobar, se encola la presentación telemática.
- Sistema recibe respuesta, guarda CSV/justificante y logs.
- Cierra el modelo como 'Presentado' y notifica al cliente.
Salida: Modelo presentado con justificante y trazabilidad.
Simulación / previsión
Cliente pide estimación antes del cierre.
- Elegir periodo o rango de fechas.
- Calcular previsión con datos actuales + reglas.
- Mostrar escenarios (con/sin facturas pendientes, con ajustes).
- Generar informe para cliente.
Salida: Previsión clara para decisiones y liquidez.
Pantallas (UI)
- Pantalla modelo: desglose, validaciones, checklist y comentarios.
- Vista calendario fiscal: vencimientos por cliente y estado.
- Dashboard fiscal: pendientes, incidencias, riesgos, variaciones.
Diseño técnico
Entidades y modelo de datos (mínimo)
| Entidad | Campos principales / notas |
|---|---|
| TaxModel | id, model_code, period, company_id, status, totals, breakdown, version |
| TaxAdjustment | id, tax_model_id, type, amount, reason, attachments[] |
| TaxValidation | id, tax_model_id, rule_code, severity, message, status |
| Filing | id, tax_model_id, channel, payload_ref, response_ref, csv, filed_at |
| DueDate | company_id, model_code, period, due_at, status |
Permisos y seguridad (RBAC)
- Gestor puede crear/editar borradores; Supervisor aprueba; ejecución separada.
- Cliente solo lectura de resultado y justificantes.
- Edición de modelos 'Presentados' bloqueada; solo rectificativas por workflow.
Validaciones y reglas
- Cuadres: bases y cuotas vs contabilidad; alertas por variaciones anómalas.
- Checklist requerido completo antes de permitir aprobar.
- Idempotencia en presentación (evitar doble envío).
- Bloqueo de periodo cerrado: solo mediante reapertura con motivo.
APIs sugeridas (API-first)
GET /api/v1/tax/models?company_id=...&period=...
POST /api/v1/tax/models/calculate # {model_code, period, company_id}
PATCH /api/v1/tax/models/{id} # ajustes permitidos
POST /api/v1/tax/models/{id}/validate
POST /api/v1/tax/models/{id}/submit # encola presentación
GET /api/v1/tax/filings/{id} # estado + evidencias
GET /api/v1/tax/simulations # previsión
Eventos y auditoría
- tax.model.calculated
- tax.model.validated
- tax.model.approved
- tax.filing.submitted / tax.filing.completed / tax.filing.failed
Impacto de negocio
Beneficio para la gestoría
- Reduce sanciones al bloquear errores antes de presentar.
- Aumenta productividad con cálculo automático y validaciones.
- Mejor control de calidad con aprobación supervisor.
Beneficio para el cliente
- Previsión de impuestos para planificar tesorería.
- Acceso a justificantes y estado sin llamadas.
Riesgos / puntos críticos
- Cambios normativos requieren actualizaciones rápidas de reglas.
- Integración telemática debe ser robusta (colas, reintentos, logs).
- Manejo de rectificativas/correcciones debe estar bien definido.