Incidencias

El sistema de incidencias permite a las entidades comunicarse con el Comisionado de Transparencia para reportar problemas técnicos, solicitar aclaraciones o comunicar cualquier incidencia durante el proceso de evaluación.

Flujo de una incidencia

stateDiagram-v2
    [*] --> Abierta: Entidad crea
    Abierta --> EnProceso: Comisionado asigna responsable
    Abierta --> Abierta: Entidad o Comisionado comenta
    EnProceso --> EnProceso: Comentarios cruzados
    Abierta --> Cerrada: Entidad o Comisionado cierra
    EnProceso --> Cerrada: Entidad o Comisionado cierra
    Cerrada --> Abierta: Entidad reabre
    Cerrada --> [*]

Estados

Código	Estado	Descripción
0	Abierta	Incidencia reportada, pendiente de atención
1	EnProceso	El Comisionado la ha asignado a un responsable
2	Cerrada	Resuelta o descartada. Puede reabrirse

Tipos de incidencia

Código	Tipo	Descripción
0	Otros	Incidencias generales no clasificadas
1	PublicidadActiva	Dudas o problemas relacionados con obligaciones de publicidad activa
2	SoporteWeb	Problemas con el portal de transparencia de la entidad
3	Técnicas	Errores técnicos en la plataforma (acceso, rendimiento, bugs)
4	Usuarios	Gestión de usuarios, permisos y credenciales
5	TransparenciaVoluntaria	Consultas sobre el régimen voluntario
6	DerechoAcceso	Dudas sobre solicitudes de derecho de acceso

Prioridad

Código	Prioridad
0	Baja (por defecto al crear)
1	Media
2	Alta

La prioridad la asigna el Comisionado durante la revisión; las entidades no pueden cambiarla directamente.

Endpoints disponibles

Método	Endpoint	Descripción
GET	/incidencias	Listar incidencias (paginado, filtros)
GET	/incidencias/{id}	Detalle completo de una incidencia
POST	/incidencias	Crear nueva incidencia
POST	/incidencias/{id}/comentario	Añadir comentario
POST	/incidencias/{id}/cerrar	Cerrar incidencia
POST	/incidencias/{id}/reabrir	Reabrir incidencia cerrada
POST	/incidencias/{id}/adjuntos	Subir adjuntos a un mensaje
GET	/incidencias/adjuntos/{idAdjunto}	Descargar un adjunto

Flujo típico

sequenceDiagram
    participant E as Entidad (API)
    participant C as Comisionado

    E->>C: POST /incidencias (crear)
    Note over E: Respuesta incluye id + idhistorico
    E->>C: POST /incidencias/{id}/adjuntos (opcional)
    Note over C: Comisionado recibe notificación SignalR
    C->>E: Responde
    Note over E: Webhook incidencia.respuesta
    E->>C: POST /incidencias/{id}/comentario
    C->>E: Responde de nuevo
    E->>C: POST /incidencias/{id}/cerrar
    Note over E: Puede reabrirse con POST .../reabrir

Campo usuarioId obligatorio

Al crear una incidencia o añadir un comentario es obligatorio indicar el usuarioId del usuario que reporta. Debe ser un ID válido de un usuario de la entidad autenticada (obtener con GET /usuarios). Esta validación garantiza la trazabilidad: cada acción queda asociada a un humano concreto, no a un usuario genérico.

Si no se envía usuarioId, la API devuelve 400 Bad Request con el mensaje "usuarioId es obligatorio".

Notificaciones por webhook

Si tiene webhooks registrados con los eventos incidencia.respuesta e incidencia.cerrada, recibirá notificaciones automáticas cuando el Comisionado responda o cierre una incidencia.

Notificaciones en tiempo real al Comisionado

Al crear una incidencia, añadir un comentario o reabrir una cerrada, el Comisionado recibe una notificación en tiempo real (campanita SignalR en el panel de administración). No es necesario que refresque la pantalla para ver la novedad.