API de Cloxo: conecta tu reloj de fichaje con tu otro software
Con la API de Cloxo, tu caja, tu planificación o tu programa de nóminas ficha la entrada y la salida de los empleados y obtiene las horas, la presencia y los informes mensuales. La API está incluida en todos los planes, también durante la prueba.
Cloxo registra quién trabaja y cuándo. Esas horas a menudo las necesitas también en otro sitio: en tu caja, en tu planificación o para las nóminas. Con la API de Cloxo, tu otro software habla directamente con tu reloj de fichaje, sin volver a teclear y sin enviar archivos de un lado a otro.
En resumen
- API REST con JSON sobre HTTPS, descrita en un archivo OpenAPI
- Fichar entradas, salidas y pausas desde tu propio software
- Obtener empleados, presencia, fichajes e informes mensuales
- Servidor MCP para asistentes de IA
- Incluida en todos los planes y en la prueba gratuita
- Una clave creada en un minuto, revocable cuando quieras
¿Eres desarrollador? Lee la documentación de la API (en inglés).
Qué haces con ella
| Quieres | Así lo hace la API |
|---|---|
| Fichar desde tu caja o tu control de accesos | Tu software envía un fichaje en cuanto alguien se identifica. Cloxo lo convierte en un registro. |
| Ver quién está ahora | Una sola petición devuelve el estado de cada empleado: fichado, en pausa o fuera. |
| Pasar las horas a nóminas | Obtén los fichajes de un periodo o el informe mensual por empleado, también en PDF. |
| Comparar tu planificación con la realidad | Compara las horas previstas con las trabajadas, por día y por persona. |
| Añadir nuevos empleados | Tu software crea un empleado, que después ficha con un código PIN. |
Cómo funciona
- Crea una clave. En Cloxo, en Configuración → API e integraciones. Eliges qué puede hacer la clave: leer datos, fichar entradas y salidas o añadir empleados.
- Entrega la clave a tu proveedor de software o a tu desarrollador. Él lee la documentación y construye la integración.
- Listo. Los fichajes llegan a Cloxo junto a los de la app, el código QR y la tablet. Las correcciones y los informes funcionan como siempre.
Así es un fichaje:
curl -X POST "https://app.cloxo.app/api/public/v1/clock-events" \
-H "Authorization: Bearer cloxo_live_…" \
-H "Content-Type: application/json" \
-d '{"action":"clock_in","employee_id":"7c1d6a52-3f0e-4c9b-9a51-2f6f3f1f0b11"}'
La referencia completa, con todas las posibilidades, los códigos de error y ejemplos, está en la documentación para desarrolladores (en inglés). También hay un archivo OpenAPI para cargar en Postman o generar un cliente.
Para asistentes de IA: MCP
Cloxo también tiene un servidor MCP. Con él, un asistente de IA trabaja directamente con tu reloj de fichaje. Preguntas «¿Quién está trabajando ahora?» o «¿Cuántas horas trabajó Sofie en octubre?» y el asistente busca la respuesta por sí mismo.
Conectas el asistente con la misma clave. Si le das solo permiso de lectura, el asistente no puede cambiar nada. El servidor MCP funciona con programas que pueden enviar una clave, como Claude Code y Cursor.
Una configuración segura
- Una clave pertenece a una sola empresa y nunca puede ver los datos de otra.
- Eliges los permisos de cada clave y, si quieres, una fecha de caducidad.
- Revocas una clave en un clic. Deja de funcionar al instante.
- Cloxo guarda únicamente una huella de la clave. La clave en sí la ves una sola vez, al crearla.
- Todo el tráfico va cifrado y los datos están en servidores europeos.
Lo que la API no es
La API es una pieza de construcción. No hay integraciones listas para usar con un programa de nóminas concreto: la integración la construye tu proveedor de software o un desarrollador. ¿Prefieres no construir nada? Entonces la exportación en PDF o CSV sigue siendo el camino más corto hacia tu asesoría.
Preguntas frecuentes
¿Tiene Cloxo una API?
Sí. Cloxo tiene una API REST con la que otro software puede fichar la entrada y la salida de los empleados y obtener los empleados, la presencia, los fichajes y los informes mensuales. La documentación está en app.cloxo.app/developers.
¿La API tiene un coste adicional?
No. La API está incluida en todos los planes y funciona también durante la prueba gratuita. Necesitas una suscripción activa o una prueba en curso.
¿Puedo conectar Cloxo con mi programa de nóminas o mi asesoría?
No hay una integración lista para usar por programa. Tienes dos caminos: la exportación en PDF o CSV, que reenvías en un clic, o la API, con la que tu proveedor de software obtiene las horas automáticamente.
¿Necesito un desarrollador?
Para la integración en sí, sí: alguien tiene que conectar tu software con la API. La clave la creas tú mismo en un minuto, en Configuración.
¿Es seguro dar una clave API a un proveedor?
Sí, si la tratas como una contraseña. Una clave pertenece a una sola empresa, recibe solo los permisos que eliges y se revoca en un clic. Cloxo guarda únicamente una huella de la clave, nunca la clave en sí.
¿Funciona Cloxo con asistentes de IA?
Sí, mediante el servidor MCP. Un asistente compatible con MCP que pueda enviar una clave, como Claude Code o Cursor, consulta la presencia, las horas y los informes y puede, si lo permites, fichar entradas y salidas.
Para empezar
Crea una cuenta, añade un empleado y crea tu primera clave. Durante la prueba, la API funciona por completo, sin datos de pago. El coste de un plan está en la página de precios; las preguntas prácticas están en la ayuda.