Declaraciones

Las declaraciones representan la participación de una entidad en una evaluación concreta. Cada entidad tiene una declaración por evaluación, y a través de ella se remite toda la información: publicidad activa, cuestionarios, derecho de acceso y documentos.

Ciclo de vida de una declaración

Una declaración pasa por diferentes estados a lo largo del proceso de evaluación:

stateDiagram-v2
    [*] --> SinAbrir: Evaluación abierta
    SinAbrir --> NoPresentada: Inicializar
    NoPresentada --> NoPresentada: Rellenar datos
    NoPresentada --> PendienteRevision: Presentar
    PendienteRevision --> Revisada: Comisionado revisa
    Revisada --> AlegacionesAbiertas: Período alegaciones
    AlegacionesAbiertas --> PendienteRevisionAlegaciones: Presentar alegaciones
    PendienteRevisionAlegaciones --> Finalizada: Revisión final
    Revisada --> Finalizada: Sin alegaciones
    Finalizada --> [*]

Estados de la declaración

Código	Estado	Descripción	Qué puede hacer la entidad
0	SinAbrir	La entidad no ha iniciado la declaración	Inicializar
1	NoPresentada	Declaración iniciada, en edición	Editar PA, cuestionarios, DA, presentar
2	PendienteRevision	Presentada, esperando revisión del Comisionado	Solo lectura
3	Revisada	Revisada con calificaciones provisionales	Solo lectura
4	AlegacionesAbiertas	Período de alegaciones abierto	Presentar alegaciones
5	PendienteRevisionAlegaciones	Alegaciones presentadas	Solo lectura
6	Finalizada	Evaluación completada con notas definitivas	Solo lectura

Endpoints disponibles

Método	Endpoint	Descripción
GET	/declaraciones/{id}	Estado actual de la declaración
POST	/declaraciones/{id}/inicializar	Inicializar la declaración
GET	/declaraciones/{id}/analisis	Análisis de completitud
GET	/declaraciones/{id}/borrador	Descargar borrador PDF

Restricciones por estado

La mayoría de operaciones de escritura (actualizar PA, cuestionarios, DA) solo están permitidas cuando la declaración está en estado NoPresentada (1) o AlegacionesAbiertas (4). Consulte la tabla de restricciones por estado para más detalle.

Flujo típico de integración

sequenceDiagram
    participant S as Sistema externo
    participant API as API T-Canaria

    S->>API: GET /evaluaciones
    API-->>S: Lista de evaluaciones
    S->>API: GET /declaraciones/{id}
    API-->>S: Estado actual

    alt Estado = SinAbrir
        S->>API: POST /declaraciones/{id}/inicializar
        API-->>S: Declaración inicializada
    end

    S->>API: GET /declaraciones/{id}/pa
    API-->>S: Árbol de PA con IDs
    S->>API: PUT /declaraciones/{id}/pa (bulk)
    API-->>S: Obligaciones actualizadas

    S->>API: GET /declaraciones/{id}/cuestionarios
    API-->>S: Estructura cuestionarios
    S->>API: PUT /declaraciones/{id}/cuestionarios/{idcuest}
    API-->>S: Respuestas guardadas

    S->>API: GET /declaraciones/{id}/analisis
    API-->>S: Porcentajes y notas parciales

Declaración vs. evaluación

No confundir el ID de la declaración con el ID de la evaluación. La declaración es específica de cada entidad dentro de una evaluación. Use GET /evaluaciones para obtener ambos IDs.