Tipos de Incidencia¶

Valores posibles para el campo incidentType en las incidencias de fichaje.

Incidencias de Fichaje (al fichar con errores)¶

Creadas automáticamente cuando el empleado ficha con un error y decide continuar.

Valor	Label (Frontend)	Descripción
`early_exit`	Salida anticipada	Empleado sale antes de que termine su última clase
`out_of_schedule`	Fuera de horario	Entrada fuera del rango de tolerancia
`no_schedule`	Sin clases programadas	No hay eventos/clases para ese día
`out_of_range`	Fuera de rango permitido	Fichaje desde ubicación fuera del radio del centro

Incidencias Automáticas (cron)¶

Generadas automáticamente por el sistema cuando detecta fichajes faltantes.

Valor	Label (Frontend)	Descripción
`missing_checkin_entry`	Falta fichaje de entrada	Tenía clase pero no fichó entrada
`missing_checkin_exit`	Falta fichaje de salida	Fichó entrada pero no salida
`missing_checkin_both`	Falta entrada y salida	No fichó ni entrada ni salida
`no_exit_registered`	Salida no registrada	El cron cerró automáticamente un fichaje abierto
`missingClockIn`	Fichaje faltante	Verificación detectó fichaje faltante

Otros Tipos¶

Valor	Label (Frontend)	Descripción
`no_events_today`	Sin eventos hoy	Incidencia manual creada por el empleado
`general_issue`	Problema general	Valor por defecto si no se especifica tipo

Uso en Frontend¶

Para mostrar el label correcto en el frontend:

const INCIDENT_TYPE_LABELS: Record<string, string> = {
  early_exit: "Salida anticipada",
  out_of_schedule: "Fuera de horario",
  no_schedule: "Sin clases programadas",
  out_of_range: "Fuera de rango permitido",
  missing_checkin_entry: "Falta fichaje de entrada",
  missing_checkin_exit: "Falta fichaje de salida",
  missing_checkin_both: "Falta entrada y salida",
  no_exit_registered: "Salida no registrada",
  missingClockIn: "Fichaje faltante",
  no_events_today: "Sin eventos hoy",
  general_issue: "Problema general",
};

function getIncidentLabel(type: string): string {
  return INCIDENT_TYPE_LABELS[type] || type;
}

Filtrar por Tipo¶

Para filtrar incidencias por tipo en la API:

curl -X GET "$HOST/api/v2/incident/?incidentType=early_exit" \
  -H "Authorization: Bearer $TOKEN"