Publicidad activa

La publicidad activa (PA) es el núcleo de la evaluación de transparencia. Comprende todas las obligaciones de información que las entidades deben publicar proactivamente en sus portales de transparencia.

Estructura del árbol de PA

La información de publicidad activa se organiza en una jerarquía de tres niveles:

graph TD
    A["Declaración"] --> B["Tipo 1: Información institucional"]
    A --> C["Tipo 2: Información económica"]
    A --> D["Tipo 3: Información jurídica"]
    B --> E["Categoría 1.1: Organización"]
    B --> F["Categoría 1.2: Planificación"]
    E --> G["Obligación: Organigrama"]
    E --> H["Obligación: Funciones y competencias"]
    G --> I["Enlaces publicados"]
    G --> J["Aclaraciones"]
    G --> K["Autoevaluación por criterio"]

Nivel	Descripción	Ejemplo
Tipo	Agrupación principal de obligaciones	"Información institucional y organizativa"
Categoría	Subagrupación temática	"Información sobre la institución"
Obligación	Ítem individual que la entidad debe cumplir	"Organigrama actualizado"

Qué contiene cada obligación

Cada obligación en el árbol de PA contiene:

• Enlaces: URLs donde la entidad publica la información (máximo 10)
• Aclaraciones: Texto libre con explicaciones de la entidad
• Opción de publicación: Indica si publica, no publica por tipo de actividad, otra razón, etc.
• Autoevaluación: Valores por criterio de evaluación (puntuación que la entidad se asigna)

Endpoints disponibles

Método	Endpoint	Descripción
GET	/declaraciones/{id}/pa	Obtener árbol completo de PA
PUT	/declaraciones/{id}/pa/{id}	Actualizar una obligación
PUT	/declaraciones/{id}/pa	Actualización masiva (hasta 500 ítems)

Opciones de publicación

Código	Descripción
0	Publica información — La entidad publica esta obligación y proporciona enlaces
1	No publica por tipo de actividad — La obligación no aplica al tipo de entidad
2	No publica por otra razón — No publica pero por una razón diferente
3	No publica por carecer de la información — No dispone de la información

Flujo típico

sequenceDiagram
    participant S as Sistema externo
    participant API as API T-Canaria

    S->>API: GET /declaraciones/{id}/pa
    API-->>S: Árbol completo con IDs y estado actual
    Note over S: Recorrer árbol, obtener IDs de obligaciones
    S->>API: PUT /declaraciones/{id}/pa (bulk)
    Note right of S: Enviar hasta 500 ítems
    API-->>S: N obligaciones actualizadas
    S->>API: GET /declaraciones/{id}/analisis
    API-->>S: Porcentaje PA y nota estimada

IDs de obligaciones

Al actualizar PA, use el campo id de cada obligación del árbol devuelto por GET /declaraciones/{id}/pa. No confundir con el idobligacion que es el ID del catálogo de obligaciones de la evaluación.

Autoevaluación

La autoevaluación es opcional. Si se proporcionan valores, deben corresponder a criterios válidos de la obligación y estar dentro del rango 0 al valor máximo del criterio. Ver autoevaluación para más detalle.