API y webhooks para conectar FichMe con tus sistemas
Tu gestoría, tu ERP o tu cuadro de mando leen los fichajes, las jornadas y las ausencias de FichMe sin que exportes nada a mano. Cada clave lleva solo los permisos que elijas, caduca y la puedes revocar cuando quieras.
Una plantilla de permisos para cada uso
Cada clave, con los permisos justos
Al crear una clave empiezas por una plantilla y quitas o añades permisos. El DNI, el número de la Seguridad Social y los motivos de las ausencias, incluido si son bajas o consultas médicas, solo llegan a una clave con el permiso de datos sensibles. De las plantillas, solo lo lleva «Gestoría / nóminas». Cada clave caduca a los 30, 90 o 365 días, y puedes limitarla a unas IP.
Fichajes, jornadas y ausencias, en JSON
Una API REST con la plantilla, los centros, los fichajes, las jornadas ya calculadas, las correcciones, las ausencias, los saldos, los turnos y los festivos, y la exportación de cualquier informe. Para sincronizar, pides solo lo que ha cambiado desde la última vez.
Por la API se ficha, pero no se reescribe el pasado
El registro diario de jornada tiene que recoger la hora concreta de inicio y de fin de la jornada de cada persona.
Fichar por la API hay que activarlo expresamente. Cada fichaje que llega por ella lleva la hora del servidor y queda marcado como API, y nada de lo ya registrado se edita ni se borra: el pasado se corrige con solicitudes de corrección aprobadas, que quedan en el historial.
Funcionalidades relacionadas
Preguntas frecuentes
¿Qué plan necesito?
La API está en el plan Pro, con 2 claves activas y 10.000 peticiones al día por clave. Business sube a 5 claves y 50.000 peticiones, y añade los webhooks. Enterprise llega a 20 claves y 200.000 peticiones, y permite claves sin caducidad.
¿Hay un entorno de pruebas?
Las claves son siempre reales. Para probar tu integración, usa una cuenta en periodo de prueba: durante esos días tienes la API y los webhooks.
¿Se pueden cambiar o borrar fichajes por la API?
No. Por la API se ficha en tiempo real, con la hora del servidor, y se piden correcciones, pero los fichajes ya registrados no se editan ni se borran.
¿Cómo identifico a la persona al fichar?
Por su identificador, su correo o su DNI; para usar el DNI, la clave necesita el permiso de datos sensibles. Si envías una clave de idempotencia, un reintento no duplica el fichaje.
¿Qué límites tiene?
Hasta 120 peticiones por minuto por clave, más la cuota diaria de tu plan. En la pestaña «Uso» ves las peticiones de cada clave en los últimos 30 días.
¿Dónde está la documentación?
En fichme.com/developers tienes la guía; la referencia completa está en api.fichme.com/v1/docs, y la especificación OpenAPI en api.fichme.com/v1/openapi.json.
¿Qué hago si una clave se filtra?
La revocas al momento desde «Claves de API». Si solo quieres cambiarla, la rotas: la nueva y la vieja conviven hasta 7 días para que actualices tu integración sin cortes.
¿Hay conectores para Zapier o Make?
No hay una app propia en esas plataformas, pero hay una plantilla de permisos «Zapier / Make» para conectarlos con peticiones HTTP a la API.
Conecta FichMe con las herramientas que ya usas
Déjanos tus datos y te enseñamos FichMe con el caso de tu empresa.