Consultar Historial de Checadas

Consultar Historial de Checadas

Obtiene el historial completo de checadas de un usuario con filtros opcionales.

Endpoint

POST /api/v2/incidents/check_logs

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)
type	string	❌	Tipo de checada: in, out, break_in, break_out
until	string	❌	Fecha final para rango en formato Y-m-d (debe ser >= date)

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

Opciones de Filtrado

Por Fecha Específica

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

Por Tipo de Checada

{
  "type": "in"
}

Por Rango de Fechas

{
  "date": "2024-01-01",
  "until": "2024-01-31"
}

Sin Filtros (Todo el Historial)

{}

Ejemplo de Solicitud

POST /api/v2/incidents/check_logs
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9...
Content-Type: application/json

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

Respuestas

✅ Historial Encontrado (200)

{
  "success": true,
  "message": "Registros encontrados exitosamente",
  "data": {
    "logs": [
      {
        "id": 7891,
        "date": "2024-01-15 09:30:00",
        "user_id": 123,
        "longitude": -99.1332,
        "latitude": 19.4326,
        "address": "Oficina Central - Ciudad de México",
        "comment": "Checada de entrada",
        "compare_time": null,
        "type": "in",
        "arrive_status": "ontime",
        "type_info": {
          "name": "Entrada",
          "description": "Registro de entrada al trabajo"
        }
      },
      {
        "id": 7892,
        "date": "2024-01-15 18:00:00",
        "user_id": 123,
        "longitude": -99.1332,
        "latitude": 19.4326,
        "address": "Oficina Central - Ciudad de México",
        "comment": "",
        "compare_time": null,
        "type": "out",
        "arrive_status": "ontime",
        "type_info": {
          "name": "Salida",
          "description": "Registro de salida del trabajo"
        }
      }
    ]
  }
}

❌ Datos Inválidos (422)

{
  "success": false,
  "message": "Datos de entrada inválidos",
  "error": {
    "type": ["El tipo debe ser: in, out, break_in, break_out"],
    "date": ["El formato de fecha debe ser Y-m-d"],
    "until": ["La fecha final debe ser mayor o igual que la fecha inicial"]
  },
  "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
id	integer	ID único del registro
date	string	Fecha y hora de la checada
user_id	integer	ID del usuario
longitude	float	Coordenada longitudinal
latitude	float	Coordenada latitudinal
address	string	Dirección donde se registró
comment	string	Comentario del usuario
compare_time	string	Hora esperada (puede ser null)
type	string	Tipo: in, out, break_in, break_out
arrive_status	string	Estado: ontime, late, early
type_info	object	Información descriptiva del tipo

Estados de Llegada

• ontime: En horario
• late: Retardo
• early: Temprano

Casos de Uso

1. Reportes de asistencia: Consultar historial mensual
2. Verificación de puntualidad: Análisis de llegadas tardías
3. Auditoría: Comparar registros con horarios establecidos
4. Aplicaciones móviles: Dashboard personal de usuario
5. Integración: Sistemas externos de nómina

Optimizaciones

• Los resultados se ordenan por fecha ascendente
• Se incluye información descriptiva del tipo
• Solo se devuelven campos necesarios para rendimiento
• Soporte para paginación implícita en rangos de fechas