RF63: Sistema genera declaración anual
Descripción
El sistema genera un borrador de declaración anual para el usuario, consolidando sus ingresos, gastos deducibles y facturas (CFDI) del ejercicio fiscal, para facilitar su presentación ante el SAT.
Es una herramienta de apoyo: produce un cálculo estimado y un resumen, no sustituye la presentación oficial ni constituye asesoría fiscal formal. Requiere RFC (RF13) y facturas analizadas (RF64). Los datos fiscales son personales y se cifran en reposo.
| Campo | Valor |
|---|---|
| Módulo | Accounting Module |
| Actor | Sistema (job disparado por el usuario o programado) |
| Endpoint | POST /accounting/annual-return (genera) |
| Precondiciones | RFC registrado; facturas del ejercicio ingresadas y analizadas |
| Prioridad | Baja (post-MVP) |
| Etapa | Por definirse |
| Requisitos relacionados | RF13, RF64, RF65, RF66 |
Reglas de negocio
- RN-63.1 — Solo se genera para usuarios con RFC y datos fiscales válidos.
- RN-63.2 — El cálculo se basa en ingresos, gastos deducibles y facturas válidas del ejercicio seleccionado.
- RN-63.3 — El resultado es un borrador estimado con descargo de responsabilidad (no es la declaración oficial).
- RN-63.4 — Se identifican facturas inválidas/canceladas para excluirlas del cálculo.
- RN-63.5 — El borrador se persiste cifrado y es consultable (RF65); se puede regenerar si cambian los datos.
Validaciones de entrada
| Campo | Reglas | Mensaje de error |
|---|---|---|
fiscalYear | Obligatorio. Año fiscal válido (no futuro). | "Selecciona un ejercicio fiscal válido." |
| RFC | Debe existir y ser válido (RF13). | "Registra un RFC válido para generar tu declaración." |
Criterios de aceptación
Escenario 1: Generación de borrador exitosa
Dado que tengo RFC válido y facturas analizadas del ejercicio, Cuando solicito generar la declaración anual, Entonces el sistema consolida ingresos, gastos deducibles y facturas válidas, Y produce un borrador estimado con descargo de responsabilidad, Y lo persiste cifrado y disponible para consulta (RF65).
Escenario 2: RFC o datos fiscales faltantes
Dado que no tengo RFC registrado,
Cuando intento generar la declaración,
Entonces el sistema responde 400 con "Registra un RFC válido para generar tu declaración".
Escenario 3: Sin datos suficientes
Dado que no tengo facturas ni movimientos del ejercicio, Cuando intento generar, Entonces el sistema informa que no hay datos suficientes para el cálculo.
Escenario 4: Facturas inválidas excluidas
Dado que tengo facturas canceladas o inválidas, Cuando se genera el borrador, Entonces esas facturas se excluyen del cálculo y se listan como observaciones.
Criterios no funcionales
- Datos fiscales cifrados en reposo; descargo de responsabilidad visible.
- Generación asíncrona si el volumen es alto; comunicación TLS 1.2+.