Para comenzar a utilizar las APIs de asistencia, asegúrate de cumplir con lo siguiente:
Contar con un usuario perfil "Autoservicio" en el módulo de Asistencia.
Obtener el API Token de tu empresa (es la clave única necesaria para consumir la información).Debes solicitarla al equipo SAC.
Tener instalado un software para realizar consultas (como Postman) si deseas probar las respuestas del sistema.
- Puedes usar nuestra URL https://app.swaggerhub.com/apis-docs/BUKASISTENCIA/ApiAsistencia/1.0.0#/
Contenido - Paso a Paso
Las APIs funcionan como un puente que permite a tus sistemas internos (como Power BI o herramientas de BI) "preguntar" y obtener datos directamente desde Buk sin registros manuales.
1. Identifica qué información necesitas Cada consulta (endpoint) entrega datos específicos de tu gestión:
-
Asignación de turnos: revisa las jornadas asignadas por cada colaborador.
-
Asistencia por empresa: obtén todas las marcas de asistencia en un periodo filtrado (formato horario UTC).
-
Información de recintos: lista todos los lugares de trabajo asociados a tu empresa.
-
Nómina de colaboradores: descarga la lista completa de trabajadores.
-
Inasistencias y Horas: consulta inasistencias, horas extras aprobadas (en segundos) y horas no trabajadas.
-
Inyección de registros: ingresa marcaciones de forma masiva para que figuren como registros manuales.
2. Realiza la consulta Para usar la API, debes configurar los siguientes parámetros en tu herramienta de conexión:
-
Token: ingresa el identificador único de tu empresa en el botón "Authorize".
-
Fechas: define el rango (desde/hasta) para filtrar la información.
-
Paginación: indica el número de página y la cantidad de resultados que deseas ver por cada una.
3. Valida el resultado
-
Código 200: ¡Éxito! La información se ha entregado correctamente en formato JSON.
-
Error 400: Revisa los datos ingresados; es probable que falte un campo obligatorio.
Error 500: Existe un problema temporal en el servidor. Reintenta en unos minutos.
Consideraciones importantes
Información histórica: puedes validar datos de colaboradores desvinculados y sus fechas de vigencia en los recintos.
Seguridad: la información es privada y solo accesible mediante el token de tu empresa.
Consumo de datos: recuerda que la API sirve para extraer información como base de datos, pero no funciona como una integración bidireccional con otros softwares externos.
Tags
#APIs #Asistencia #Integraciones #Administradores #Configuración #Endpoints
💡¿Aún tienes dudas?
Si este artículo no responde completamente tu consulta o necesitas apoyo en un caso particular, nuestro equipo está disponible a través de los canales de atención.
Chat | Teléfono | Correo
🎓 ¿Te interesa certificarte en Buk?
Te invitamos a realizar un curso de tu interés en Buk Academy, donde encontrarás contenidos guiados para profundizar en el uso de la plataforma y fortalecer tus conocimientos.