API de Kabal Attendance
El API de Kabal Attendance deja que su propio sistema lea los reportes de asistencia de su empresa: los mismos números que la app muestra en Reportes y pone en su Excel, calculados en el momento en que los pide.
Es de solo lectura. Con una llave se leen dos reportes y nada más: ninguna llave cambia una marca, un empleado ni un horario, ve una foto o llega a otra empresa.
Qué se puede leer
| Reporte | Ruta | Qué es |
|---|---|---|
| Resumen | GET /api/v1/reports/summary/ | Una fila por empleado con los totales de un rango de fechas: días y minutos esperados, tardanzas, salidas tempranas, ausencias, minutos trabajados, ordinarios y extra, días libres. |
| Detalle | GET /api/v1/reports/daily/ | Cada día de cada empleado del rango, con el turno que se esperaba, las marcas que leyó el motor y lo que decidió. Paginado por empleado. |
Los dos reciben los mismos filtros que la página de reportes de la app (fechas, sedes, departamentos, puestos, empleados) y hasta 92 días por llamada.
Para quién es
Para una empresa con su propio sistema de planilla o de RRHH que quiere los números de Kabal ahí sin que nadie copie un Excel. El uso típico es el cierre mensual: en los primeros días del mes, el sistema de planilla pide el Resumen del mes que terminó, calcula lo que debe cada persona (expected_minutes - ordinary_minutes, ver Reportes) y aplica sus propias reglas, como un descuento de bono por tardanzas.
Está hecho para ese ritmo: unas pocas llamadas por empresa al mes, no un sondeo continuo.
Quién puede usarlo
El API viene con los planes de pago; cada plan dice cuántas llaves puede tener una empresa. Un administrador de la empresa crea la llave en la app y se la entrega a sus programadores. Ver Autenticación.
Por dónde empezar
- Primeros pasos: crear una llave y hacer la primera llamada.
- Reportes: qué significa cada columna y cuándo pedir un mes.
- Límites y Errores: qué esperar cuando algo no está bien.
- La Referencia: cada parámetro y cada campo, generados desde el propio API. Está en inglés.