La integración mediante API Key en el módulo de Beneficios existe como un puente seguro y estructurado que permite a tus sistemas internos o externos comunicarse directamente con nuestra plataforma. Este elemento resuelve la necesidad de consultar y extraer información sobre el uso de beneficios de manera automática, eliminando el trabajo manual de traspasar datos entre distintos softwares. Es clave dentro de tu ecosistema tecnológico porque optimiza el tiempo de tu equipo, asegura la coherencia de los datos y te permite centralizar el análisis del bienestar corporativo en las herramientas propias de tu organización.
Funcionamiento general
Opera mediante una llave de acceso única (API Key), la cual actúa como una credencial de seguridad que tú autorizas para que otros sistemas puedan leer la información alojada en Buk de forma protegida. Funciona habilitando puntos de conexión (endpoints) específicos para la gestión del bienestar. A través de ellos, tu sistema puede consultar el listado de todas las solicitudes de beneficios realizadas por tus equipos, obtener el detalle específico de una solicitud en particular, o revisar la información de las distintas versiones de un beneficio disponible. Trabaja bajo una lógica de control total para tu empresa: eres tú quien define qué sistema externo se conecta y qué nivel de permisos posee esta llave para acceder a la información de los beneficios.
Alcance y límites
Corresponde utilizar esta integración cuando tu organización cuenta con plataformas de desarrollo propio (como una intranet corporativa, un ERP interno o paneles de Business Intelligence) y necesitas extraer la información de las solicitudes y versiones de beneficios para visualizarla o procesarla en dichos sistemas externos. No es necesario utilizarlo si tu equipo de Personas y tus colaboradores gestionan, solicitan y aprueban la totalidad de los beneficios directamente desde el portal de Buk, ya que la plataforma por sí sola centraliza toda esta operatividad sin requerir desarrollos técnicos adicionales. En cuanto a sus límites, esta API de Beneficios no realiza la creación, edición o eliminación de beneficios desde un sistema externo, ni aprueba solicitudes automáticamente desde afuera. Actualmente, su alcance está diseñado exclusivamente para la consulta y extracción (lectura) de los datos de solicitudes y versiones.
Relación y diferencias con otros elementos
Se relaciona de manera directa con las Solicitudes de Beneficios y las Versiones de Beneficios, ya que son las entidades principales cuya información viaja a través de esta integración. Asimismo, interactúa con la configuración de Accesos API de la plataforma, que es el espacio central donde se administran y protegen estas credenciales. Frecuentemente suele confundirse con las Integraciones Nativas o Partners (como los convenios con servicios externos preconfigurados). La diferencia exacta radica en que las integraciones nativas son conexiones listas para usar con servicios específicos; en cambio, la API Key es una herramienta técnica abierta que permite a tu equipo de desarrolladores construir una conexión a la medida con tus propios sistemas internos.