Consultar Incidentes

Consultar Incidentes del Usuario

Obtiene información sobre incidentes relacionados con tiempo trabajado del usuario.

Endpoint

POST /api/v2/incidents/check_incidents

Headers

Authorization: Bearer {token}
Content-Type: application/json

Parámetros de Entrada

Campo	Tipo	Requerido	Descripción
date	string	❌	Fecha específica en formato Y-m-d (ej: 2024-01-15)

Nota: El user_id se obtiene automáticamente del token de autorización. No es necesario enviarlo como parámetro.

Tipos de Incidentes

El sistema busca eventos que tengan:

• ✅ Beneficio de tipo time (relacionado con tiempo)
• ✅ Estados: accepted, processing, processed
• ✅ Fechas de inicio/fin válidas

Ejemplos de Búsqueda

Consulta Completa (Sin Fecha)

{}

Por Fecha Específica

{
  "date": "2024-01-15"
}

Ejemplo de Solicitud

POST /api/v2/incidents/check_incidents
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJF...
Content-Type: application/json

{
  "date": "2024-01-15"
}

Respuestas

✅ Incidente Encontrado (200)

{
  "success": true,
  "message": "Incidencia encontrada",
  "data": {
    "title": "Permiso Médico",
    "benefit": "Tiempo Extra Acumulado",
    "start": "15/01/2024",
    "end": "15/01/2024",
    "time": "0.5"
  }
}

✅ Sin Incidentes (200)

{
  "success": true,
  "message": "No se encontraron incidencias",
  "data": null
}

❌ Datos Inválidos (422)

{
  "success": false,
  "message": "Datos de entrada inválidos",
  "errors": {
    "date": ["El formato de fecha debe ser Y-m-d"]
  },
  "data": null
}

❌ Token Inválido (401)

{
  "success": false,
  "message": "Token de autorización inválido o faltante",
  "data": null
}

Campos de Respuesta

Campo	Tipo	Descripción
title	string	Título del incidente
benefit	string	Nombre del beneficio relacionado
start	string	Fecha de inicio (formato dd/mm/yyyy)
end	string	Fecha de fin (formato dd/mm/yyyy)
time	string	Cantidad de tiempo afectado

Tipos de Beneficios Relacionados

El sistema filtra por beneficio tipo time:

• ✅ Tiempo Extra: Horas adicionales trabajadas
• ✅ Permisos: Ausencias justificadas
• ✅ Compensaciones: Tiempo compensado
• ✅ Suspensiones: Tiempo suspendido temporalmente

Estados de Incidentes Soportados

Estado	Descripción
accepted	Incidente aceptado por administración
processing	En proceso de revisión
processed	Procesado completamente

Casos de Uso

1. Validación de horarios: Verificar si hay eventos que modifiquen el horario normal
2. Cálculo de nómina: Considerar tiempo especial en salarios
3. Reportes administrativos: Análisis de ausencias y permisos
4. Aplicaciones móviles: Mostrar estado de solicitudes del usuario
5. Auditoría: Verificar cumplimiento de políticas de tiempo

Lógica de Filtrado

Sin Fecha Específica

• Busca cualquier incidente activo del usuario
• Devuelve el más reciente encontrado

Con Fecha Específica

• Filtra incidentes que incluyan esa fecha específica
• Considera rango completo del incidente (start ≤ date ≤ end)
• Prioriza eventos que afecten el día consultado

Ejemplos de Incidentes

Permiso Médico

{
  "title": "Permiso Médico - Consulta",
  "benefit": "Permiso Personal",
  "start": "15/01/2024",
  "end": "15/01/2024",
  "time": "2"
}

Tiempo Extra Autorizado

{
  "title": "Tiempo Extra - Proyecto Especial",
  "benefit": "Horas Extraordinarias",
  "start": "15/01/2024",
  "end": "19/01/2024",
  "time": "15"
}

Integración con Otros Endpoints

Este endpoint complementa:

• get_hours_labor: Considerar tiempo especial en cálculos
• check_logs: Validar checadas contra incidentes activos
• save_check: Evaluar si el día permite registro normal