Saltar a contenido

Notas y puntuaciones

Una vez que el Comisionado de Transparencia publica las calificaciones provisionales (estado AlegacionesAbiertas, código 4), la entidad puede consultar sus notas a través de dos endpoints:

  • GET /notas — resumen de puntuaciones (nota final, ranking, medias)
  • GET /notas/detalle — desglose completo por criterio, sección y pregunta

Disponibilidad

Estos endpoints solo están disponibles a partir del estado AlegacionesAbiertas (4). En estados anteriores devuelven 400.

Consultar resumen de notas

GET /apientidades/v1/declaraciones/{iddeclaracion}/notas

Devuelve un resumen con la nota final, desglose por índice (ICIO, ICS, ITV), posición en el ranking y medias comparativas.

Respuesta exitosa (200)

{
  "entidad": "AYUNTAMIENTO DE EJEMPLO",
  "evaluacion": "Evaluación 2024",
  "estado": "AlegacionesAbiertas",
  "notas": {
    "notaFinal": 7.85,
    "notaIcio": 8.20,
    "notaIcs": 7.40,
    "notaItv": 7.50
  },
  "ranking": {
    "posicion": 12,
    "total": 88
  },
  "notasMedias": {
    "mediaCanaria": 6.95,
    "mediaNacional": 6.40
  },
  "notasAnteriores": [
    { "evaluacion": "Evaluación 2023", "notaFinal": 7.10 },
    { "evaluacion": "Evaluación 2022", "notaFinal": 6.80 }
  ]
}
Campo Tipo Descripción
entidad string Nombre de la entidad
evaluacion string Título de la evaluación
estado string Estado actual de la declaración
notas.notaFinal decimal Nota global (0–10)
notas.notaIcio decimal Índice de Contenidos de Información Obligatoria (ICIO)
notas.notaIcs decimal Índice de Cuestionarios Sectoriales (ICS)
notas.notaItv decimal Índice de Transparencia en la Valoración (ITV)
ranking.posicion int Posición de la entidad entre todas las evaluadas
ranking.total int Total de entidades evaluadas
notasMedias object Medias comparativas (canaria y nacional)
notasAnteriores array Notas de evaluaciones anteriores (historial)

Notas provisionales vs. definitivas

  • Estados 4 y 5 (AlegacionesAbiertas, PendRevAlegaciones): las notas son provisionales.
  • Estado 6 (Finalizada): las notas son definitivas.

El campo estado de la respuesta indica en qué fase se encuentran.

Consultar desglose detallado

GET /apientidades/v1/declaraciones/{iddeclaracion}/notas/detalle

Devuelve la estructura completa con las notas desglosadas por sección, criterio y pregunta. Útil para identificar qué áreas han obtenido mejor o peor puntuación.

La respuesta incluye los mismos datos del resumen más los arrays detallados:

  • ics[] — secciones de cuestionarios con sus preguntas y puntuaciones individuales
  • itv[] — ítems de transparencia en la valoración
  • icio[] — obligaciones de publicidad activa agrupadas por tipo, con puntuación por criterio

Ejemplo de uso

curl -s \
  "https://apientidades-pro.transparenciacanarias.org/apientidades/v1/declaraciones/5001/notas/detalle" \
  -H "Authorization: Bearer $TOKEN" | jq '.notas'

resp = requests.get(
    f"{API_URL}/declaraciones/{id_declaracion}/notas/detalle",
    headers={"Authorization": f"Bearer {token}"}
)
detalle = resp.json()

# Acceder al desglose ICS
for seccion in detalle.get("ics", []):
    print(f"Sección: {seccion['nombre']} — Nota: {seccion['nota']}")

Errores posibles

Código Tipo Descripción
400 peticion-incorrecta La declaración no está en un estado con notas disponibles (estado < 4)
401 no-autorizado Token ausente, expirado o inválido
404 recurso-no-encontrado La declaración no existe o no pertenece a la entidad 
{
  "type": "https://api.evaluax.es/errores/peticion-incorrecta",
  "title": "Peticion incorrecta",
  "status": 400,
  "detail": "Las notas no están disponibles en estado 'NoPresentada'. Las notas se publican a partir del periodo de alegaciones (estado 4).",
  "instance": "/apientidades/v1/declaraciones/5001/notas"
}

Flujo recomendado

Consulte el estado de la declaración con GET /declaraciones/{id} antes de intentar ver las notas. Si estadoCodigo es menor que 4, las notas aún no están publicadas.