Base URL https://api.afer.pro Referencia aferapp.com Reservar demo
Referencia de la API

Equipo y control horario

Plantilla, contratos, turnos, ausencias y fichajes. Solo lectura.

10 endpoints GET · 10 Solo lectura

Todo el control horario en modo consulta, para volcarlo a un BI, cuadrarlo con la gestoría o alimentar un asistente que responda sobre la plantilla.

El registro de jornada es un libro legal, así que la API no lo escribe. No hay —ni habrá— endpoints para crear, modificar o borrar fichajes: solo se alimenta desde la app y el circuito interno. Aquí puedes leer la plantilla (empleados, contratos, departamentos), la organización del tiempo (turnos, planificación, calendario laboral, ausencias) y lo realmente registrado (fichajes y el resumen de horas fichadas frente a planificadas).

Flujo típico

Un recorrido habitual por esta área, de principio a fin.

  1. /api/v1/employees Obtienes la plantilla y sus ids
  2. /api/v1/employees/times/summary Comparas fichado contra planificado
  3. /api/v1/employees/times Bajas al apunte concreto

Endpoints del área 10

GET /api/v1/employees
Listar empleados
Las personas dadas de alta en tu cuenta con su departamento. Por defecto solo las activas.
GET /api/v1/employees/{id}
Obtener empleado
La ficha de una persona con su departamento y su contrato vigente.
GET /api/v1/employees/contracts
Contratos laborales
Los contratos de la plantilla: tipo, fechas, período de prueba y jornada pactada.
GET /api/v1/departments
Departamentos
Los departamentos de tu cuenta con el número de empleados activos de cada uno.
GET /api/v1/shifts
Turnos configurados
El maestro de turnos: la plantilla horaria de semana completa que se aplica a la planificación.
GET /api/v1/schedules
Planificación de turnos
Qué turno tiene asignado cada persona cada día de un período, con sus tramos y sus horas previstas.
GET /api/v1/work-calendar
Calendario laboral
Los días no laborables de un período: los de la empresa y, si pides una persona, también los suyos.
GET /api/v1/time-off
Ausencias y vacaciones
Las ausencias que solapan un período, con su tipo, si están autorizadas y cuántos días caen dentro.
GET /api/v1/employees/times
Fichajes del período
Los registros de jornada entre dos fechas: entrada, salida y horas de cada apunte.
GET /api/v1/employees/times/summary
Horas fichadas vs planificadas
Por persona y período: horas fichadas, horas planificadas y su desviación.
Antes de empezar

Todos estos endpoints comparten el mismo formato de llamada, autenticación por API key y envelope de respuesta: los tienes en Primeros pasos.