Obligaciones de publicidad activa

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

Devuelve el árbol completo de obligaciones de publicidad activa definidas para la evaluación. Este árbol representa la estructura jerárquica que la entidad debe cumplimentar: tipos contienen categorías, y las categorías contienen obligaciones (ítems).

Parámetros de ruta

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

Ejemplo de petición

curlPythonC#

curl -s "https://apientidades-pro.transparenciacanarias.org/apientidades/v1/evaluaciones/10/obligaciones" \
  -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/obligaciones",
    headers=headers
)
arbol = response.json()

# Recorrer el árbol: tipos -> categorías -> obligaciones
for tipo in arbol:
    print(f"\nTipo: {tipo['nombre']}")
    for cat in tipo.get("categorias", []):
        print(f"  Categoría: {cat['nombre']}")
        for ob in cat.get("obligaciones", []):
            print(f"    - [{ob['id']}] {ob['nombre']}")

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

foreach (var tipo in arbol)
{
    Console.WriteLine($"Tipo: {tipo.Nombre}");
    foreach (var cat in tipo.Categorias)
    {
        Console.WriteLine($"  Categoría: {cat.Nombre}");
        foreach (var ob in cat.Obligaciones)
        {
            Console.WriteLine($"    - [{ob.Id}] {ob.Nombre}");
        }
    }
}

Respuesta exitosa (200)

[
  {
    "id": 1,
    "nombre": "Información institucional y organizativa",
    "orden": 1,
    "categorias": [
      {
        "id": 10,
        "nombre": "Información sobre la institución",
        "orden": 1,
        "obligaciones": [
          {
            "id": 100,
            "nombre": "Organigrama actualizado",
            "descripcion": "Organigrama que identifique a los responsables...",
            "orden": 1,
            "criterios": [
              {
                "id": 500,
                "criterio": "Existe",
                "valorMaximo": 5
              },
              {
                "id": 501,
                "criterio": "Actualizado",
                "valorMaximo": 3
              }
            ]
          },
          {
            "id": 101,
            "nombre": "Funciones y competencias",
            "descripcion": "Información sobre las funciones que desarrolla...",
            "orden": 2,
            "criterios": [
              {
                "id": 502,
                "criterio": "Existe",
                "valorMaximo": 5
              }
            ]
          }
        ]
      }
    ]
  }
]

Estructura jerárquica

graph TD
    A["Árbol de obligaciones"] --> B["Tipo 1: Información institucional"]
    A --> C["Tipo 2: Información económica"]
    A --> D["Tipo N: ..."]
    B --> E["Categoría 1.1"]
    B --> F["Categoría 1.2"]
    E --> G["Obligación 1.1.1"]
    E --> H["Obligación 1.1.2"]
    G --> I["Criterio: Existe (max 5)"]
    G --> J["Criterio: Actualizado (max 3)"]

Campos del tipo

Campo	Tipo	Descripción
id	int	Identificador del tipo
nombre	string	Nombre del tipo de publicidad activa
orden	int	Orden de presentación
categorias	array	Categorías dentro de este tipo

Campos de la categoría

Campo	Tipo	Descripción
id	int	Identificador de la categoría
nombre	string	Nombre de la categoría
orden	int	Orden de presentación
obligaciones	array	Obligaciones dentro de esta categoría

Campos de la obligación

Campo	Tipo	Descripción
id	int	Identificador de la obligación
nombre	string	Nombre descriptivo de la obligación
descripcion	string	Descripción detallada de lo que se evalúa
orden	int	Orden de presentación
criterios	array	Criterios de evaluación aplicables

Campos del criterio

Campo	Tipo	Descripción
id	int	Identificador del criterio
criterio	string	Nombre del criterio (ej: "Existe", "Actualizado")
valorMaximo	int	Puntuación máxima que se puede obtener en este criterio

Uso de los IDs

Los IDs de las obligaciones de este árbol son los que se usan como referencia para entender la estructura. Sin embargo, al actualizar publicidad activa con PUT /declaraciones/{id}/pa/{id}, el obligacionId que se envía es el campo id del árbol de PA de la declaración (endpoint GET /declaraciones/{id}/pa), no de este árbol de evaluación.

Caché local

El árbol de obligaciones de una evaluación no cambia durante su vigencia. Es seguro cachearlo localmente para evitar peticiones repetidas.

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