Saltar a contenido

Detalle de evaluación

Obtener detalle completo

GET /apientidades/v1/evaluaciones/{idevaluacion}

Devuelve el detalle completo de una evaluación incluyendo calendario de fases y prórrogas concedidas a la entidad.

Parámetros de ruta

Parámetro Tipo Descripción
idevaluacion int ID de la evaluación

Ejemplo de petición

curl -s "https://apientidades-pro.transparenciacanarias.org/apientidades/v1/evaluaciones/10" \
  -H "Authorization: Bearer $TOKEN" | jq .

import requests

BASE_URL = "https://apientidades-pro.transparenciacanarias.org/apientidades/v1"
headers = {"Authorization": f"Bearer {token}"}

response = requests.get(f"{BASE_URL}/evaluaciones/10", headers=headers)
evaluacion = response.json()

print(f"Evaluación: {evaluacion['evaluacion']}")
print(f"Estado declaración: {evaluacion['estado']}")
print(f"Carga de datos: {evaluacion['calendario']['cargaInicio']} - {evaluacion['calendario']['cargaFin']}")

var response = await client.GetAsync($"{baseUrl}/evaluaciones/10");
var json = await response.Content.ReadAsStringAsync();
var evaluacion = JsonConvert.DeserializeObject<EvaluacionDetalle>(json);

Console.WriteLine($"Evaluación: {evaluacion.Evaluacion}");
Console.WriteLine($"Período: {evaluacion.Calendario.PeriodoInicio} - {evaluacion.Calendario.PeriodoFin}");

Respuesta exitosa (200)

{
  "evaluacionId": 10,
  "evaluacion": "Evaluacion ITCanarias 2024",
  "declaracionId": 5001,
  "estado": "NoPresentada",
  "estadoCodigo": 1,
  "ultimaPuntuacion": 72.5,
  "denominacionMapa": "ITCanarias",
  "estadoEvaluacion": "Abierta",
  "calendario": {
    "periodoInicio": "2024-01-01T00:00:00Z",
    "periodoFin": "2024-12-31T23:59:59Z",
    "cargaInicio": "2025-01-15T00:00:00Z",
    "cargaFin": "2025-03-15T23:59:59Z",
    "alegacionesInicio": null,
    "alegacionesFin": null,
    "preparacionInicio": null,
    "preparacionFin": null,
    "calificacionesProvisionales": null,
    "calificacionesDefinitivas": null
  },
  "prorrogas": [
    {
      "id": 1,
      "fechaInicio": "2025-03-16",
      "fechaFin": "2025-04-15"
    }
  ]
}

Campos de la respuesta

Campo Tipo Descripción
evaluacionId int Identificador único de la evaluación
evaluacion string Título descriptivo
declaracionId int ID de la declaración de la entidad
estado string Estado de la declaración
estadoCodigo int Código numérico del estado (0-6)
ultimaPuntuacion decimal Última puntuación obtenida
denominacionMapa string Nombre corto del indicador
estadoEvaluacion string Estado de la evaluación global
calendario object Fechas clave de la evaluación
prorrogas array Prórrogas concedidas a la entidad

Campos del objeto calendario

Campo Tipo Descripción
periodoInicio datetime Inicio del período evaluado
periodoFin datetime Fin del período evaluado
cargaInicio datetime Inicio del plazo de carga de datos
cargaFin datetime Fin del plazo de carga de datos
alegacionesInicio datetime? Inicio del período de alegaciones (null si no aplica)
alegacionesFin datetime? Fin del período de alegaciones
preparacionInicio datetime? Inicio de la fase de preparación
preparacionFin datetime? Fin de la fase de preparación
calificacionesProvisionales datetime? Fecha de publicación de calificaciones provisionales
calificacionesDefinitivas datetime? Fecha de publicación de calificaciones definitivas

Campos del objeto prorroga

Campo Tipo Descripción
id int Identificador de la prórroga
fechaInicio date Fecha de inicio de la prórroga (YYYY-MM-DD)
fechaFin date Fecha de fin de la prórroga (YYYY-MM-DD)

Campos nulos en el calendario

Los campos del calendario que aún no tienen fecha asignada devuelven null. Esto es normal: el Comisionado va definiendo las fechas a medida que avanza la evaluación.

Errores posibles

Código Descripción
401 Token ausente, expirado o inválido
404 La evaluación no existe o la entidad no participa en ella

Calendario de una evaluación

GET /apientidades/v1/evaluaciones/{idevaluacion}/calendario

Devuelve únicamente las fechas clave de la evaluación, sin el resto de información del detalle. Útil para consultas rápidas del calendario.

Ejemplo de petición

curl -s "https://apientidades-pro.transparenciacanarias.org/apientidades/v1/evaluaciones/10/calendario" \
  -H "Authorization: Bearer $TOKEN" | jq .

response = requests.get(
    f"{BASE_URL}/evaluaciones/10/calendario",
    headers=headers
)
calendario = response.json()

if calendario["cargaFin"]:
    print(f"Plazo de carga hasta: {calendario['cargaFin']}")

Respuesta exitosa (200)

{
  "periodoInicio": "2024-01-01T00:00:00Z",
  "periodoFin": "2024-12-31T23:59:59Z",
  "cargaInicio": "2025-01-15T00:00:00Z",
  "cargaFin": "2025-03-15T23:59:59Z",
  "alegacionesInicio": null,
  "alegacionesFin": null,
  "preparacionInicio": null,
  "preparacionFin": null,
  "calificacionesProvisionales": null,
  "calificacionesDefinitivas": null
}

La estructura de campos es idéntica al objeto calendario del detalle de evaluación (ver tabla anterior).

Uso recomendado

Use este endpoint para verificaciones rápidas de plazos (por ejemplo, comprobar si el período de carga sigue abierto) sin necesidad de obtener todo el detalle de la evaluación.