API REST & Integraciones

INTEGRA TU SOFTWARE
CON ARJ.

API REST completa para conectar el registro de jornada laboral y control horario con tus herramientas. Claves API con permisos granulares, Webhooks en tiempo real e integraciones listas para usar.

API REST

API de control horario y fichaje digital

Accede a todos los datos de registro de jornada de tu empresa mediante una API REST estándar. Autenticación por API Key, respuestas en JSON y permisos configurables por recurso.

Recursos de la API

schedule

Fichajes y jornadas

Consulta, crea y corrige fichajes de entrada, salida y pausas. Accede al detalle de cada jornada con verificación de integridad SHA-256.

GET /api/v1/clockings · POST /api/v1/clockings
group

Empleados

Lista de empleados activos, estado actual (trabajando, pausa, descanso, vacaciones), horario asignado y nivel de cumplimiento.

GET /api/v1/employees · GET /api/v1/employees/{id}
description

Informes

Genera informes de jornada en PDF o Excel con filtros por fecha, empleado o equipo. Totales de horas, pausas, vacaciones y bajas.

GET /api/v1/reports · GET /api/v1/reports/{id}/download
beach_access

Vacaciones y ausencias

Gestiona vacaciones, bajas médicas, permisos, teletrabajo y otros tipos de ausencia. Soporte para medio día.

GET /api/v1/absences · POST /api/v1/absences
warning

Incidencias

Consulta incidencias automáticas (retrasos, fichajes omitidos), nivel de cumplimiento y exoneraciones.

GET /api/v1/incidents · GET /api/v1/incidents/{id}
edit_note

Correcciones

Solicita correcciones de fichaje y consulta su estado (pendiente, aprobada, rechazada). Flujo de aprobación completo.

GET /api/v1/corrections · POST /api/v1/corrections

Ejemplo rápido

Obtener fichajes del día
# Obtener los fichajes de hoy
GET /api/v1/clockings?date=today
Authorization: Bearer {tu_api_key}
Accept: application/json
Respuesta JSON
{
  "data": [
    {
      "id": 4521,
      "employee_id": 87,
      "type": "clock_in",
      "datetime": "2026-04-01T08:02:14Z",
      "latitude": 36.7266,
      "longitude": -4.5595,
      "address": "PTA, Campanillas, Málaga",
      "hash_sha256": "a1b2c3d4e5...",
      "verified": true
    }
  ],
  "meta": { "total": 1, "page": 1 }
}
Registrar fichaje con cURL
# Registrar fichaje de entrada
curl -X POST https://core.arj.es/api/v1/clockings \
  -H "Authorization: Bearer {api_key}" \
  -H "Content-Type: application/json" \
  -d '{
    "employee_id": 87,
    "type": "clock_in",
    "latitude": 36.7266,
    "longitude": -4.5595
  }'
Seguridad

API Keys con permisos granulares

Cada clave API tiene permisos configurables por recurso. Define exactamente qué puede leer o escribir cada integración.

vpn_key

Claves API por usuario

Cada usuario puede generar claves de acceso desde su perfil. Los administradores controlan qué usuarios tienen acceso a la API.

tune

Permisos por recurso

Asigna permisos específicos: fichajes (lectura/escritura), informes (solo lectura), vacaciones, empleados, incidencias. Cada clave accede solo a lo que necesita.

shield

Seguridad ISO 27001

Comunicaciones cifradas con HTTPS/TLS. Autenticación Bearer Token. Desarrollado bajo el Sistema de Gestión de Seguridad de la Información ISO 27001.

Eventos en tiempo real

Webhooks para tu control horario

Recibe notificaciones HTTP en tiempo real cuando ocurren eventos en ARJ. Configura URLs de destino para cada tipo de evento y procesa los datos en tu sistema automáticamente.

Eventos disponibles

login clocking.created
edit_note correction.requested
thumb_up correction.approved
warning incident.created
beach_access absence.created
person employee.updated
Ejemplo de payload del webhook
// POST a tu URL configurada
{
  "event": "clocking.created",
  "timestamp": "2026-04-01T08:02:14Z",
  "data": {
    "id": 4521,
    "employee": {
      "id": 87,
      "name": "Ana García"
    },
    "type": "clock_in",
    "location": {
      "lat": 36.7266,
      "lng": -4.5595,
      "address": "PTA, Málaga"
    },
    "integrity": {
      "sha256": "a1b2c3...",
      "verified": true
    }
  }
}
Conecta tus herramientas

Integraciones de fichaje con software externo

ARJ se conecta con las aplicaciones que tu empresa ya usa. Cada integración tiene un panel dedicado con registro de actividad.

sync

Dolibarr

Activa

Sincronización bidireccional de vacaciones y ausencias entre ARJ y Dolibarr ERP. Cuando se registra una ausencia en cualquiera de los dos sistemas, se sincroniza automáticamente.

Vacaciones · Bajas · Permisos
forum

Zulip Chat

Activa

Notificaciones automáticas en Zulip: resumen de jornada al salir, avisos de incidencias, alertas de cumplimiento, recordatorio de vacaciones y contraseñas.

Bot interactivo: los empleados pueden consultar su estado, horario y jornada enviando mensajes al bot.

Notificaciones · Bot · Alertas
call

Centralitas VoIP

Activa

Integración con centralitas telefónicas VoIP (IP4Business y compatibles). Fichaje por llamada y registro de presencia vinculado al estado telefónico del empleado.

IP4Business · SIP · VoIP
nfc

RFID y NFC

Activa

Compatible con lectores de tarjetas RFID y dispositivos NFC para fichaje físico. Ideal para fábricas, almacenes, obras y entornos donde el fichaje móvil no es práctico.

Tarjetas · Lectores · Hardware
webhook

Webhooks

Activa

Conecta ARJ con cualquier sistema externo mediante HTTP callbacks. Recibe notificaciones en tiempo real de fichajes, correcciones, incidencias y ausencias.

HTTP POST · JSON · Tiempo real
Próximamente
chat

WhatsApp y Telegram

Notificaciones y consultas de estado de fichaje y jornada a través de WhatsApp y Telegram. Los empleados podrán interactuar con ARJ desde su app de mensajería.

Notificaciones · Bot · Mensajería
Casos de uso

Qué puedes construir con la API de fichaje

dashboard_customize

Dashboard personalizado

Construye un panel de control horario a medida con los datos de fichaje de ARJ. Integra gráficos de horas trabajadas, comparativas por equipo y alertas de cumplimiento en tu intranet.

calculate

Sincronización con nóminas

Exporta las horas trabajadas, pausas y ausencias a tu software de nóminas. Automatiza el cálculo de horas ordinarias y extraordinarias sin doble entrada de datos.

door_sensor

Control de acceso físico

Conecta lectores RFID/NFC o sistemas de control de acceso con la API de fichaje. Cuando un empleado pasa la tarjeta, se registra automáticamente la entrada en ARJ.

monitoring

Alertas y automatizaciones

Usa los Webhooks para disparar automatizaciones: notificación en Slack cuando alguien ficha tarde, alerta en tu sistema de RRHH cuando se crea una incidencia, o resumen diario por email.

Integra el control horario en tu software

API REST, Webhooks, RFID, NFC y más. Conecta el registro de jornada laboral con las herramientas que tu equipo ya usa.