La API de control horario y RRHH de HorasClaras permite conectar la información de tu empresa con un ERP, un software interno, una herramienta de business intelligence o cualquier otro sistema que necesite consultar datos de recursos humanos sin mantener copias manuales.
La integración se realiza mediante una clave propia de cada empresa. Esa clave limita el acceso a los datos de la organización que la ha generado y puede regenerarse desde el panel cuando sea necesario.
Integrar HorasClaras con tu ERP, BI o software propio
Una pyme puede utilizar HorasClaras para gestionar la operativa diaria del equipo y, al mismo tiempo, necesitar esos datos en otro sistema. La API evita que la integración dependa de exportaciones manuales, hojas de cálculo o procesos duplicados.
Por ejemplo, un ERP puede consultar las vacaciones y ausencias de un periodo antes de generar planificación interna; un cuadro de mando puede incorporar los días no laborables del calendario de empresa; y un software desarrollado a medida puede utilizar la información de disponibilidad del equipo dentro de sus propios procesos.
La API resulta especialmente útil cuando HorasClaras forma parte de un ecosistema mayor y la empresa quiere conservar sus sistemas actuales en lugar de sustituirlos.
Qué datos puedes consultar desde la API de HorasClaras
La API pública de integración disponible actualmente es de solo lectura. Los sistemas externos pueden consultar la información publicada por HorasClaras, pero no crear, modificar ni eliminar registros.
GET /integration/v1/vacations Vacaciones de empleados que coinciden total o parcialmente con el rango de fechas solicitado.
GET /integration/v1/absences Ausencias de empleados que se solapan con el periodo indicado.
GET /integration/v1/calendar Eventos del calendario laboral de la empresa, incluidos los registros marcados como festivos.
Todas las consultas se realizan por rango de fechas mediante los parámetros from y to en formato YYYY-MM-DD. El intervalo incluye ambos extremos.
API de vacaciones para empleados
El endpoint de vacaciones permite consultar qué empleados tienen vacaciones registradas dentro de un periodo. Cada registro incluye su identificador, fechas de inicio y fin, estado, observaciones y los datos básicos del empleado asociado.
Esto permite integrar las vacaciones gestionadas en HorasClaras con calendarios internos, ERPs, herramientas de planificación o desarrollos propios sin volver a introducir la información.
GET /integration/v1/vacations?from=2026-01-01&to=2026-01-31
x-api-key: TU_CLAVE_APIAPI de ausencias de empleados
La API de ausencias sigue el mismo modelo. El sistema externo solicita un intervalo de fechas y obtiene las ausencias que coinciden con ese periodo junto con la persona empleada asociada.
Esta información puede utilizarse para planificación, disponibilidad de equipos, herramientas internas, cuadros de mando o cualquier flujo que necesite conocer quién estará ausente en unas fechas determinadas.
GET /integration/v1/absences?from=2026-01-01&to=2026-01-31
x-api-key: TU_CLAVE_APIAPI de calendario laboral y festivos
El calendario laboral también puede consultarse desde sistemas externos. Cada registro incluye el nombre del evento, sus fechas, observaciones y la indicación de si se trata de un festivo.
Una integración puede utilizar estos datos para que un ERP, un sistema de planificación o una aplicación interna tenga en cuenta los días definidos por la empresa sin mantener un calendario paralelo.
GET /integration/v1/calendar?from=2026-01-01&to=2026-01-31
x-api-key: TU_CLAVE_APIIntegrar control horario y RRHH con otros sistemas
HorasClaras reúne control horario, vacaciones, ausencias y calendario dentro del mismo entorno. La API de integración permite conectar esa operativa de RRHH con los sistemas que ya utiliza la empresa.
Actualmente, los endpoints públicos documentados cubren vacaciones, ausencias y calendario laboral. Los fichajes y registros de jornada continúan gestionándose dentro de HorasClaras. Esta arquitectura permite mantener una única fuente de información para el equipo y ampliar progresivamente las integraciones externas según las necesidades reales de las empresas.
Para una pyme, esto evita tener que elegir entre utilizar una herramienta sencilla de control horario o mantener su ERP y sus desarrollos internos: ambos entornos pueden convivir.
Clave API independiente para cada empresa
La API utiliza una clave propia para cada empresa. Un administrador puede generarla o regenerarla desde Configuración de empresa → Integraciones / API. La clave solo se muestra en el momento de generarla y, cuando se regenera, la anterior deja de funcionar.
La autenticación se realiza enviando la clave en la cabecera x-api-key. Cada clave queda limitada a los datos de su propia empresa.
La clave debe almacenarse en el servidor que realiza la integración. No debe incluirse en URLs, aplicaciones cliente ni código público.
Ejemplo sencillo de integración con la API
La URL base de producción de la API es https://europe-west1-naiad-6bff1.cloudfunctions.net/api.
Una consulta de vacaciones para enero de 2026 puede realizarse con una petición como esta:
curl -H "x-api-key: TU_CLAVE_API" \
"https://europe-west1-naiad-6bff1.cloudfunctions.net/api/integration/v1/vacations?from=2026-01-01&to=2026-01-31"Cuando existen registros, la respuesta devuelve un objeto data con los elementos encontrados. Si no hay resultados para el rango solicitado, la petición sigue siendo válida y devuelve {"data":[]}.
Las fechas se devuelven en formato YYYY-MM-DD. En vacaciones y ausencias, cada elemento incluye también el identificador, nombre completo y email del empleado asociado.
Qué puedes construir con una API de RRHH
API para pequeñas empresas sin cambiar todo su software
HorasClaras está pensado para pequeñas empresas que quieren simplificar la gestión de personas sin desplegar una suite de recursos humanos compleja. Una API abierta a integraciones permite mantener ese enfoque sencillo sin convertir la herramienta en un sistema aislado.
La empresa puede seguir utilizando su ERP, su software sectorial o sus aplicaciones internas y utilizar HorasClaras allí donde aporta valor: control horario, vacaciones, ausencias y gestión diaria del equipo.
Si estás evaluando herramientas, también puedes consultar nuestra guía de software RRHH para pymes.
Consultar la documentación pública de la API →
Preguntas frecuentes sobre la API de HorasClaras
¿Qué es una API de control horario y RRHH?
Es una forma de conectar un sistema de control horario o recursos humanos con otros programas para que puedan consultar información automáticamente en lugar de duplicarla de forma manual.
¿Qué endpoints ofrece actualmente HorasClaras?
La documentación pública incluye endpoints GET para vacaciones, ausencias y calendario laboral.
¿Puedo conectar HorasClaras con mi ERP?
Sí. Un ERP o cualquier sistema capaz de realizar peticiones HTTP puede consumir la API utilizando la clave de la empresa.
¿La API permite escribir datos?
No en la versión pública documentada actualmente. La integración es de solo lectura.
¿Cómo se protege la información de cada empresa?
Cada clave API solo permite consultar los datos de la empresa a la que pertenece. Si un administrador regenera la clave, la anterior queda revocada.
¿Dónde está la documentación técnica?
La documentación pública de la API de HorasClaras incluye los endpoints, parámetros, ejemplos de respuesta y errores.