Autoevaluación

La autoevaluación permite a la entidad asignar una puntuación a cada criterio de evaluación de una obligación de publicidad activa. Es un campo opcional que complementa la información de enlaces y aclaraciones.

Cómo funciona

Cada obligación del árbol de publicidad activa contiene un array autoevaluacion[]. Cada ítem del array representa un criterio de evaluación ya vinculado a esa obligación en esta declaración concreta. La entidad actualiza el campo valor de cada ítem para indicar su autoevaluación.

No existe un array criterios[] separado

La información de los criterios (nombre, ID de criterio) ya viene incluida dentro del propio array autoevaluacion[] de cada obligación. No hay un campo criterios[] independiente ni un campo valorMaximo por criterio.

graph LR
    A["Obligación: Organigrama"] --> B["autoevaluacion[0]\nid: 949162\nidcriterio: 1\ncriterio: Contenido\nvalor: 0 ← modificar"]
    A --> C["autoevaluacion[1]\nid: 949163\nidcriterio: 2\ncriterio: Actualización\nvalor: 0 ← modificar"]

Obtener los criterios de una obligación

Los criterios de cada obligación se obtienen al consultar el árbol PA. Vienen dentro del campo autoevaluacion[] de la propia obligación:

curl -s "https://apientidades-pro.transparenciacanarias.org/apientidades/v1/declaraciones/5001/pa" \
  -H "Authorization: Bearer $TOKEN" | jq '.[0].categorias[0].obligaciones[0].autoevaluacion'

Respuesta:

[
  {
    "id": 949162,
    "idcriterio": 1,
    "criterio": "Contenido",
    "valor": 0,
    "valorinicial": 0
  },
  {
    "id": 949163,
    "idcriterio": 2,
    "criterio": "Actualización",
    "valor": 0,
    "valorinicial": 0
  }
]

Campo	Tipo	Descripción
`id`	int	ID del ítem a usar en el PUT (identifica el registro en esta declaración)
`idcriterio`	int	ID del criterio de evaluación (solo referencia)
`criterio`	string	Nombre del criterio
`valor`	int	Valor actual asignado (0-100)
`valorinicial`	int	Valor antes de cualquier modificación

Enviar autoevaluación

La autoevaluación se envía como parte del PUT de actualización de la obligación. En el array autoevaluacion[] del body se usa el campo id del ítem (no idcriterio):

curlPython

curl -s -X PUT \
  "https://apientidades-pro.transparenciacanarias.org/apientidades/v1/declaraciones/5001/pa/7001" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "obligacionId": 7001,
    "enlaces": [
      {"url": "https://portal.entidad.es/organigrama", "valida": true, "orden": 0}
    ],
    "aclaraciones": "",
    "opcionPublicacion": 0,
    "noCumple": false,
    "autoevaluacion": [
      {"id": 949162, "valor": 5},
      {"id": 949163, "valor": 3}
    ]
  }' | jq .

import requests

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

# Obtener el árbol PA
arbol = requests.get(f"{BASE_URL}/declaraciones/5001/pa", headers=headers).json()

# Recorrer para encontrar la obligación y construir la autoevaluación
for tipo in arbol:
    for cat in tipo.get("categorias", []):
        for ob in cat.get("obligaciones", []):
            if ob["id"] == 7001:
                # Usar el 'id' de cada ítem de autoevaluación (no idcriterio)
                autoevaluacion = [
                    {"id": item["id"], "valor": 5}  # valor máximo de ejemplo
                    for item in ob.get("autoevaluacion", [])
                ]

                payload = {
                    "obligacionId": ob["id"],
                    "enlaces": [{"url": "https://portal.es/organigrama", "valida": True, "orden": 0}],
                    "aclaraciones": "",
                    "opcionPublicacion": 0,
                    "noCumple": False,
                    "autoevaluacion": autoevaluacion
                }

                response = requests.put(
                    f"{BASE_URL}/declaraciones/5001/pa/{ob['id']}",
                    headers=headers,
                    json=payload
                )
                print(response.json())

Formato del array autoevaluación (body del PUT)

Campo	Tipo	Obligatorio	Descripción
`id`	int	Sí	`id` del ítem del GET (campo `autoevaluacion[].id`, ej: `949162`)
`valor`	int	Sí	Valor discreto para el criterio (ver tabla de criterios y valores admitidos)

Validaciones

Validación	Límite	Error
ID del ítem	Debe ser > 0 y existir en la declaración	400/500
Valor	0 a 100	400 "debe ser 0-100"
Cantidad de ítems	Max 10 por obligación	400 "Máximo 10 criterios"

Solo se admiten valores discretos — la API los valida

La API rechaza valores que no estén en el catálogo de esa evaluación concreta con un error 400. Antes de enviar autoevaluación, consulte GET /pa/criterios para obtener los valores admitidos exactos para su declaración.

Criterios de autoevaluación

Los criterios son los mismos en todas las evaluaciones, aunque los valores discretos admitidos pueden variar entre evaluaciones. Los pesos también pueden ajustarse por evaluación.

A continuación se muestran los criterios y sus valores para la evaluación vigente (entidades públicas 2025):

Criterio 1 — Contenido (peso: 40 %)

Valor	Descripción
`0`	Nada
`15`	Casi nada
`50`	Parcial
`85`	Casi todo
`100`	Total

Criterio 2 — Última fecha de actualización publicada en la URL (peso: 30 %)

Valor	Descripción
`0`	No hay fecha visible en el portal
`50`	Anterior al 1 de octubre de 2025
`100`	Último trimestre de 2025 o posterior

Criterio 3 — Reutilización (peso: 20 %)

Valor	Descripción
`0`	Formato no reutilizable (PDF escaneado, JPG, PNG…)
`25`	Formato poco reutilizable (PDF editable, HTML)
`50`	Formato reutilizable propietario (XLS, XLSX, DOC, PPT…)
`100`	Formato reutilizable abierto (ODS, ODT, XML, JSON, CSV, TXT…)

Criterio 4 — Forma de publicación (peso: 5 %)

Valor	Descripción
`0`	No se puede acceder desde el portal o requiere conocimientos específicos
`50`	Indirecta (el portal enlaza a otra web/plataforma donde hay que seguir buscando)
`100`	Directa (publicado en el portal o enlace a la página concreta de la información)

Criterio 5 — Accesibilidad (peso: 5 %)

Valor	Descripción
`0`	Más de 12 clics desde la portada del portal de transparencia
`10`	12 clics
`20`	11 clics
`30`	10 clics
`40`	9 clics
`50`	8 clics
`60`	7 clics
`70`	6 clics
`80`	5 clics
`90`	4 clics
`100`	Entre 1 y 3 clics

Valores por evaluación

Los valores exactos admitidos y sus descripciones pueden diferir entre evaluaciones. Los mostrados corresponden a «Evaluación de entidades públicas 2025». Para evaluaciones anteriores u otras tipologías (entidades privadas, órganos de relevancia estatutaria), los valores de Contenido pueden ser solo 0 / 50 / 100 en lugar de los cinco niveles de la tabla anterior.

Autoevaluación opcional

La autoevaluación es completamente opcional. Si no se proporcionan valores, la obligación se actualiza igualmente con los enlaces, aclaraciones y opción de publicación. Puede enviar un array vacío [] o simplemente omitir el campo.

Autoevaluación vs. calificación del Comisionado

La autoevaluación es la puntuación que la entidad se asigna a sí misma. La calificación final la realiza el Comisionado de Transparencia durante la fase de revisión y puede diferir de la autoevaluación.

Estrategia recomendada

Consulte primero el árbol PA con GET /pa para obtener los id de los ítems de autoevaluación. Esos IDs (ej: 949162) son los que debe enviar en el PUT. Si envía un id que no existe en la declaración, la API devolverá un error 500.