API

Funcionalidades Principales

PQRSF

CRUD completo, radicado único, expiración días hábiles, token público, emails.

Seguimiento

Notas internas y externas con notificación automática a usuarios.

Usuarios

CRUD completo con roles (Admin, User, Client, Super) y autenticación JWT.

Correo

Envío automático vía Microsoft Graph OAuth2 con plantillas HTML.

Notificaciones

Notificaciones internas, notificador diario de vencimiento, SSE tiempo real.

Etiquetas

CRUD etiquetas para categorizar PQRSF.

Roles

CRUD roles con permisos por tabla.

Logs

Audit trail automatizado de todas las acciones.

Integración IA

Clasificación automática, emails personalizados y tracking con OpenAI.

Ley 1755 de 2015

Cumplimiento completo: respuesta motivada, réplica, prórroga, defensor del pueblo.

Estadísticas Públicas

Endpoint público Art. 39 para que los ciudadanos conozcan la gestión.

Cadena de Custodia

Auditoría inmutable SHA-256, evidencia de cada acción sobre PQRSF.

Endpoints Disponibles

Todas las rutas requieren autenticación Bearer token excepto las marcadas.

Método	Ruta	Descripción	Auth
POST	/pqr	Crear PQRSF	No
POST	/pqrtracking	Agregar seguimiento	No
POST	/contacto	Enviar contacto	No
POST	/login	Autenticar usuario	No
POST	/forgot-password	Solicitar restablecimiento	No
POST	/reset-password	Restablecer con token	No
GET	/consultar?token=	Consulta pública por token	No
GET	/consultar/{token}/seguimientos	Seguimientos de una PQR	No
GET	/uploads/pqr/{file}	Descargar archivo	No
POST	/consultar/{token}/replica	Presentar réplica (Art. 28)	No
GET	/consultar/{token}/replica-info	Info para réplica	No
GET	/consultar/{token}/info-request	Solicitud de información	No
POST	/consultar/{token}/provide-info	Proporcionar información (Art. 16)	No
GET	/consultar/{token}/expired	Estado de vencimiento	No
GET	/estadisticas	Estadísticas públicas (Art. 39)	No
Autenticados (requieren Bearer token)
GET	/pqr	Listar PQRSF	Sí
GET	/pqr/{id}	Obtener PQRSF	Sí
PUT	/pqr/{id}	Actualizar PQRSF	Sí
DELETE	/pqr/{id}	Eliminar PQRSF	Sí
GET	/pqr/export	Exportar PQRSF a CSV	Sí
POST	/pqr/{id}/upload-response	Subir archivo de respuesta	Sí
POST	/pqr/{id}/request-info	Solicitar información (Art. 16)	Sí
POST	/pqr/{id}/extend	Prorrogar plazo (Art. 18)	Sí
POST	/pqr/check-expired	Detectar vencidas (Art. 14)	Sí
GET	/pqr/expired	Listar vencidas	Sí
GET	/pqr/{id}/evidence	Cadena de custodia	Sí
GET	/pqr/{id}/emails	Emails enviados	Sí
GET	/pqrtracking	Listar seguimientos	Sí
GET	/pqrtracking/{pqr_id}	Seguimientos de PQR	Sí
GET	/pqrtracking/client/{pqr_id}	Seguimientos para cliente	Sí
PUT	/pqrtracking/{id}	Actualizar seguimiento	Sí
DELETE	/pqrtracking/{id}	Eliminar seguimiento	Sí
GET	/usuario	Listar usuarios	Sí
GET	/usuario/{id}	Obtener usuario	Sí
GET	/usuario/username/{username}	Obtener por username	Sí
PUT	/usuario/{id}	Actualizar usuario	Sí
DELETE	/usuario/{id}	Eliminar usuario	Sí
PUT	/usuario/password/{id}	Restablecer contraseña	Sí
GET	/perfil	Obtener perfil propio	Sí
PUT	/perfil	Actualizar perfil propio	Sí
POST	/usuario/change-password	Cambiar contraseña propia	Sí
POST	/usuario/avatar	Subir foto de perfil	Sí
GET	/uploads/avatar/{file}	Servir archivo de avatar	No
GET	/notificacion	Listar notificaciones	Sí
POST	/notificacion/read	Marcar como leídas	Sí
POST	/notificacion/notify-expiring	Notificador diario	Sí
GET	/notificacion/stream	SSE notificaciones	Sí
GET	/logs	Listar logs	Sí
POST	/etiqueta	Crear etiqueta	Sí
GET	/etiqueta	Listar etiquetas	Sí
GET	/etiqueta/{id}	Obtener etiqueta	Sí
PUT	/etiqueta/{id}	Actualizar etiqueta	Sí
DELETE	/etiqueta/{id}	Eliminar etiqueta	Sí
POST	/roles	Crear rol	Sí
GET	/roles	Listar roles	Sí
PUT	/roles/{id}	Actualizar rol	Sí
DELETE	/roles/{id}	Eliminar rol	Sí
GET	/dashboard/stats	Indicadores de gestión	Sí
GET	/dashboard/export	Exportar Excel/PDF	Sí
POST	/dashboard/monthly-report	Enviar reporte mensual	Sí
POST	/centro-costo	Crear centro de costo	Sí
GET	/centro-costo	Listar centros de costo	Sí
GET	/centro-costo/tree	Listar jerarquía	Sí
GET	/centro-costo/{id}	Obtener centro de costo	Sí
PUT	/centro-costo/{id}	Actualizar centro de costo	Sí
DELETE	/centro-costo/{id}	Eliminar centro de costo	Sí
POST	/ai/classify/{id}	Forzar clasificación IA	Sí
GET	/ai/classification/{id}	Obtener clasificación IA	Sí
POST	/ai/classify-batch	Clasificar múltiples PQRSF	Sí
POST	/ai/apply-suggestion/{id}	Aplicar sugerencia IA	Sí
POST	/ai/generate-motivation	Generar fundamentación (Art. 17)	Sí
POST	/ai/suggest-complementary-data	Sugerir info faltante	Sí

API

API REST para Gestión de PQRSF