Para desarrolladores y agentes de IA
Dile a tu agente que lo integre en tu CRM actual
Si ya usas un software para tu equipo (un CRM, un ERP, una app de servicios), no tienes que cambiar nada: tu agente de IA lo conecta con Regitap por la API. Tú das de alta la empresa y guardas la clave en tu software; tu agente hace el resto.
- 1
Da de alta tu empresa
En dos minutos, 30 días gratis y sin tarjeta.
- 2
Pon un tope y crea la clave
En Ajustes → API: el máximo de trabajadores que se podrán dar de alta y una clave de API.
- 3
Guarda la clave en tu software
En sus variables de entorno, como REGITAP_API_KEY (donde lo tengas: Railway, Vercel, tu servidor…). No se la des al agente ni la pegues en un chat: él la leerá de ahí.
- 4
Pégale las instrucciones a tu agente
A Claude o al agente que uses, en el proyecto de tu software. Él da de alta a tu equipo, manda las tareas de cada día y, si tu gente usa tu app, pone los botones de fichar.
El tope es solo un límite de seguridad por si el agente se equivoca: pagas por los trabajadores que tengas, no por el tope. Si pones 40 y tienes 20, pagas 20.
Las instrucciones para tu agente
Estas son (también te salen en Regitap al crear la clave). No llevan la clave: el agente la lee de la variable de entorno REGITAP_API_KEY.
Las instrucciones
Cópialas y pégaselas a tu agente en el proyecto de tu software.
# Integrar Regitap con nuestro software
Regitap es nuestro registro de jornada (obligatorio por el art. 34.9 del Estatuto de los Trabajadores) y nuestras vacaciones. Conéctalo con el software que usamos (CRM, ERP o app de gestión) por su API.
Cómo lo usamos: nuestro software manda los datos y el equipo ficha en la app de Regitap. No hace falta nada más.
## Conexión
- Documentación: https://www.regitap.com/llms.txt · especificación OpenAPI: https://www.regitap.com/openapi.json · guía con ejemplos: https://www.regitap.com/developers/api.md. Léela antes de empezar.
- Base: https://www.regitap.com/api/v1 · JSON · cabecera Authorization: Bearer <clave>.
- Clave: ya está en la variable de entorno REGITAP_API_KEY de nuestro software. Léela de ahí. No me la pidas, no la escribas en el código ni en ningún fichero, y no la muestres. Si no está, dime que la configure.
- Ids: usa los nuestros como {ref}. Los PUT crean o actualizan y se pueden repetir sin duplicar nada.
- Tope: si la API responde 409 worker_cap_reached, para y avísame.
## Llamadas
Trabajadores
- GET /workers — quién hay (con su ref)
- PUT /workers/{ref} — alta o cambios; solo cambia lo que mandes (para crear basta el nombre)
- POST /workers/{ref}/end — baja desde una fecha (no se borra nada)
Tareas del día
- PUT /tasks/{ref} — trabajador, día, título, dirección, hora y duración previstas
- DELETE /tasks/{ref} — cancelar (solo si no ha empezado) · GET /tasks?date=AAAA-MM-DD&worker={ref} — con su estado y horas reales
## Qué hacer, por orden
1. Trabajadores: un PUT /workers/{ref} por persona que deba fichar, con lo que tengamos (nombre, móvil, email…). Lo que falte (DNI, contrato, horas) lo completamos en Regitap: no lo inventes.
2. Tareas: los trabajos de cada persona y día, con PUT /tasks/{ref}; cancélalos si dejan de ser suyos.
3. No pongas botones de fichar: el equipo ficha en la app de Regitap, que les invita, les avisa y les enseña sus tareas.
4. Mantenlo al día: cuando cambie algo de lo anterior, vuelve a mandarlo.
## Reglas
- El registro no se borra ni se edita: los errores se corrigen en Regitap, con motivo y rastro.
- Manda solo los datos que hagan falta. Si algo no encaja con nuestro software, pregúntame antes de inventar.Para agentes y desarrolladores
API REST con JSON, una clave por empresa y tus propios ids en cada recurso (los PUT se pueden repetir sin duplicar nada).
- www.regitap.com/llms.txt · qué es Regitap y dónde leer, para modelos de IA
- www.regitap.com/openapi.json · especificación OpenAPI 3.1
- www.regitap.com/developers/api · guía de la API con ejemplos
- www.regitap.com/developers/api.md · la misma guía en Markdown
Lo que la API hace a su manera (y por qué es bueno)
- Borrar o editar fichajes en silencio: el registro de jornada es inalterable, como pide la ley. Un olvido se corrige con una petición (POST /corrections) que alguien aprueba o rechaza (POST /corrections/{id}/decide), con su motivo y con el nombre de quién la pide y quién la decide; el fichaje original se conserva.
- Poner la hora que quieras: la pone Regitap al recibir el fichaje (sin conexión, la del móvil, marcada).
- Seguir a nadie: la ubicación solo se guarda en el momento de pulsar.
- Pasar del tope de trabajadores: la API responde worker_cap_reached y el agente debe parar y avisarte.