Restricciones por estado

Las operaciones permitidas dependen del estado actual de la declaración. Esta tabla muestra qué puede hacer la entidad a través de la API en cada estado.

Tabla de permisos

Operación	SinAbrir (0)	NoPresentada (1)	PendienteRevision (2)	Revisada (3)	AlegacionesAbiertas (4)	PendRevAlegaciones (5)	Finalizada (6)
Consultar estado	Sí	Sí	Sí	Sí	Sí	Sí	Sí
Inicializar	Sí	Sí	No	No	No	No	No
Ver PA	No	Sí	Sí	Sí	Sí	Sí	Sí
Actualizar PA	No	Sí	No	No	Sí	No	No
Ver cuestionarios	No	Sí	Sí	Sí	Sí	Sí	Sí
Enviar respuestas	No	Sí	No	No	Sí	No	No
Ver DA	No	Sí	Sí	Sí	Sí	Sí	Sí
Actualizar DA	No	Sí	No	No	Sí	No	No
Actualizar DA general	No	Sí	No	No	Sí	No	No
Ver análisis	No	Sí	Sí	Sí	Sí	Sí	Sí
Descargar borrador	No	Sí	Sí	Sí	Sí	Sí	Sí
Ver notas	No	No	No	No	Sí	Sí	Sí
Descargar informes (¹)	No	No	Cond.	Cond.	Cond.	Cond.	Sí
Ver documentos	No	Sí	Sí	Sí	Sí	Sí	Sí
Descargar documentos	No	Sí	Sí	Sí	Sí	Sí	Sí

Estados que permiten escritura

Solo dos estados permiten operaciones de escritura (actualizar PA, cuestionarios, DA):

stateDiagram-v2
    state "Permite escritura" as escritura {
        NoPresentada: NoPresentada (1)
        AlegacionesAbiertas: AlegacionesAbiertas (4)
    }
    state "Solo lectura" as lectura {
        SinAbrir: SinAbrir (0)
        PendienteRevision: PendienteRevision (2)
        Revisada: Revisada (3)
        PendRevAlegaciones: PendRevAlegaciones (5)
        Finalizada: Finalizada (6)
    }

Estado	Escritura	Motivo
SinAbrir (0)	No	La declaración no está inicializada, no hay estructura donde escribir
NoPresentada (1)	Sí	Fase de carga de datos: la entidad rellena la declaración
PendienteRevision (2)	No	La declaración fue presentada, está en revisión
Revisada (3)	No	El Comisionado ha revisado, esperando alegaciones
AlegacionesAbiertas (4)	Sí	La entidad puede alegar y modificar datos
PendRevAlegaciones (5)	No	Las alegaciones fueron presentadas, en revisión
Finalizada (6)	No	Evaluación completada, datos inmutables

¹ Informes: disponibilidad condicional

Los informes (GET /declaraciones/{id}/informes) están disponibles cuando se cumple alguna de estas condiciones:

• La declaración está en estado Finalizada (6): siempre disponibles.
• La evaluación está en fase EvaluandoLaDeclaracion (3), EvaluandoLasAlegaciones (5) o Cerrada (6): disponibles en cualquier estado de declaración.

En la práctica, los informes aparecen cuando el Comisionado entra en fase de revisión. Ver GET /declaraciones/{id}/informes.

Error al escribir en estado incorrecto

Si intenta una operación de escritura en un estado que no lo permite:

{
  "type": "https://api.evaluax.es/errores/estado-no-permite-operacion",
  "title": "Operación no permitida",
  "status": 400,
  "detail": "La declaración está en estado 'PendienteRevision' y no permite modificaciones.",
  "instance": "/apientidades/v1/declaraciones/5001/pa/7001"
}

Verificar estado antes de escribir

Antes de enviar datos, verifique el estado de la declaración con GET /declaraciones/{id}. Si el estadoCodigo no es 1 ni 4, no intente operaciones de escritura.

Lectura siempre permitida

Las operaciones de lectura (GET) están permitidas en todos los estados, excepto en SinAbrir (0) donde no hay datos que consultar para PA, cuestionarios ni DA.

Flujo temporal

gantt
    title Fases de una evaluación
    dateFormat  YYYY-MM-DD
    section Escritura
    Carga de datos (NoPresentada)     :active, carga, 2025-01-15, 2025-03-15
    Alegaciones (AlegacionesAbiertas) :active, aleg, 2025-07-01, 2025-07-31
    section Solo lectura
    Revisión                          :revision, 2025-03-16, 2025-06-30
    Revisión alegaciones              :revaleg, 2025-08-01, 2025-08-31
    Publicación definitiva            :final, 2025-09-01, 2025-09-15