Cuestionarios

Los cuestionarios son formularios estructurados que las entidades deben cumplimentar como parte de la evaluación de transparencia. Evalúan aspectos como las obligaciones de publicidad activa (ICIO), el soporte web (ICS), la transparencia voluntaria (ITV) y el derecho de acceso.

Estructura de un cuestionario

graph TD
    A["Cuestionario"] --> B["Sección / Grupo 1"]
    A --> C["Sección / Grupo 2"]
    B --> D["Pregunta 1"]
    B --> E["Pregunta 2"]
    D --> F["Componente: checkbox"]
    D --> G["Componente: texto (URL)"]
    E --> H["Componente: selector"]

Nivel	Descripción
Cuestionario	Formulario completo (ej: "Cuestionario ICS")
Sección / Grupo	Agrupación temática de preguntas
Pregunta	Pregunta individual que la entidad responde
Componente	Campo de respuesta tipado (checkbox, texto, número, fecha, selector, etc.)

Tipos de cuestionarios

Los cuestionarios más habituales en una evaluación son:

Tipo	Sigla	Descripción
Obligaciones de Publicidad Activa	ICIO	Evalúa el cumplimiento de las obligaciones de publicidad activa
Soporte Web	ICS	Evalúa la calidad del soporte web y accesibilidad del portal de transparencia
Transparencia Voluntaria	ITV	Evalúa la publicación proactiva de información adicional no obligatoria
Derecho de Acceso	—	Evalúa los mecanismos y datos de solicitudes de acceso a la información pública

Tipos de componentes de respuesta

Cada pregunta contiene uno o más componentes con un tipo específico:

Tipo	Valor esperado	Ejemplo
checkbox	true / false	Marcar si cumple
texto	String (URL, texto corto)	"https://portal.es/datos"
entero	Número entero	42
decimal	Número decimal	75.5
fecha	String ISO (YYYY-MM-DD)	"2024-06-15"
memo	String largo (multilínea)	"Texto extenso..."
selector	Entero (opción seleccionada)	1

Endpoints disponibles

Método	Endpoint	Descripción
GET	/declaraciones/{id}/cuestionarios	Listar todos los cuestionarios
GET	/declaraciones/{id}/cuestionarios/{idcuest}	Obtener un cuestionario
PUT	/declaraciones/{id}/cuestionarios/{idcuest}	Enviar respuestas

Flujo de trabajo

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

    S->>API: GET /declaraciones/{id}/cuestionarios
    API-->>S: Lista de cuestionarios con estructura
    Note over S: Identificar cuestionario a rellenar
    S->>API: GET /declaraciones/{id}/cuestionarios/{idcuest}
    API-->>S: Estructura completa con preguntas
    Note over S: Modificar valorcampo de cada componente
    S->>API: PUT /declaraciones/{id}/cuestionarios/{idcuest}
    API-->>S: N respuestas actualizadas

Formato de respuesta

Las respuestas se envían como un array JSONB por pregunta. La API acepta tanto el formato completo (todos los campos del componente) como el formato compacto {id, valor, validado}. Ver enviar respuestas para detalles.

Recálculo automático de notas

Al enviar respuestas, las notas parciales (ICS, ITV) se recalculan automáticamente. Puede consultar las nuevas notas con GET /declaraciones/{id}/analisis.