Criterios y valores admitidos

GET /apientidades/v1/declaraciones/{iddeclaracion}/pa/criterios

Devuelve los criterios de autoevaluación con sus valores discretos admitidos para la evaluación concreta a la que pertenece la declaración.

Los valores discretos pueden variar entre evaluaciones. Este endpoint es la fuente de verdad: consulte siempre los valores aquí antes de enviarlos en el PUT.

Parámetros de ruta

Parámetro	Tipo	Descripción
iddeclaracion	int	ID de la declaración

Ejemplo de petición

curlPythonC#

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

import requests

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

criterios = requests.get(f"{BASE_URL}/declaraciones/5001/pa/criterios", headers=headers).json()
for c in criterios:
    valores = [f"{v['valor']} ({v['descripcion']})" for v in c['valores']]
    print(f"[{c['idcriterio']}] {c['criterio']} (peso {c['peso']}%): {', '.join(valores)}")

var response = await client.GetAsync($"{baseUrl}/declaraciones/5001/pa/criterios");
var json = await response.Content.ReadAsStringAsync();
var criterios = JsonConvert.DeserializeObject<List<PaCriterioDto>>(json);

foreach (var c in criterios)
{
    var vals = string.Join(", ", c.Valores.Select(v => $"{v.Valor} ({v.Descripcion})"));
    Console.WriteLine($"[{c.Idcriterio}] {c.Criterio} (peso {c.Peso}%): {vals}");
}

Respuesta exitosa (200)

[
  {
    "idcriterio": 1,
    "criterio": "Contenido",
    "peso": 40,
    "valores": [
      { "valor": 0,   "descripcion": "Nada" },
      { "valor": 15,  "descripcion": "Casi nada" },
      { "valor": 50,  "descripcion": "Parcial" },
      { "valor": 85,  "descripcion": "Casi todo" },
      { "valor": 100, "descripcion": "Total" }
    ]
  },
  {
    "idcriterio": 3,
    "criterio": "Última fecha de actualización publicada en la URL",
    "peso": 30,
    "valores": [
      { "valor": 0,   "descripcion": "No hay fecha visible en el portal" },
      { "valor": 50,  "descripcion": "Anterior al 1 de octubre de 2025" },
      { "valor": 100, "descripcion": "Último trimestre de 2025 o posterior" }
    ]
  },
  {
    "idcriterio": 7,
    "criterio": "Reutilización",
    "peso": 20,
    "valores": [
      { "valor": 0,   "descripcion": "Formato no reutilizable (PDF escaneado, JPG, PNG...)" },
      { "valor": 25,  "descripcion": "Formato poco reutilizable (PDF editable, HTML)" },
      { "valor": 50,  "descripcion": "Formato reutilizable propietario (XLS, XLSX, DOC, PPT...)" },
      { "valor": 100, "descripcion": "Formato reutilizable abierto (ODS, ODT, XML, JSON, CSV, TXT...)" }
    ]
  },
  {
    "idcriterio": 2,
    "criterio": "Forma de publicación",
    "peso": 5,
    "valores": [
      { "valor": 0,   "descripcion": "No se puede acceder desde el portal o requiere conocimientos específicos" },
      { "valor": 50,  "descripcion": "Indirecta (el portal enlaza a otra web donde hay que seguir buscando)" },
      { "valor": 100, "descripcion": "Directa (publicado en el portal o enlace a la página concreta)" }
    ]
  },
  {
    "idcriterio": 4,
    "criterio": "Accesibilidad",
    "peso": 5,
    "valores": [
      { "valor": 0,   "descripcion": "Más de 12 clics desde la portada del portal de transparencia" },
      { "valor": 10,  "descripcion": "12 clics" },
      { "valor": 20,  "descripcion": "11 clics" },
      { "valor": 30,  "descripcion": "10 clics" },
      { "valor": 40,  "descripcion": "9 clics" },
      { "valor": 50,  "descripcion": "8 clics" },
      { "valor": 60,  "descripcion": "7 clics" },
      { "valor": 70,  "descripcion": "6 clics" },
      { "valor": 80,  "descripcion": "5 clics" },
      { "valor": 90,  "descripcion": "4 clics" },
      { "valor": 100, "descripcion": "Entre 1 y 3 clics" }
    ]
  }
]

Campos de la respuesta

Campo	Tipo	Descripción
idcriterio	int	ID del criterio (usar como referencia)
criterio	string	Nombre del criterio
peso	int	Peso en la nota de autoevaluación (%)
valores	array	Lista de valores discretos admitidos, ordenados de menor a mayor
valores[].valor	int	Valor numérico a enviar en el PUT
valores[].descripcion	string	Descripción legible del nivel

Solo se admiten los valores de este endpoint

El procedimiento de actualización valida que cada valor enviado en el PUT sea exactamente uno de los valores de este listado para esa evaluación. Si se envía un valor no listado (aunque esté entre 0 y 100), la API devolverá un error 400 indicando los valores admitidos.

Flujo recomendado

1. Llame a GET /pa/criterios para obtener los criterios y sus valores admitidos.
2. Para cada obligación, obtenga los id de los ítems de autoevaluación desde GET /pa (campo autoevaluacion[].id).
3. Envíe el PUT con los pares {id, valor} usando solo los valores obtenidos en el paso 1.

Errores posibles

Código	Descripción
401	Token ausente, expirado o inválido
404	La declaración no existe o no pertenece a la entidad