Integración · Recursos humanos
Conectar Buk a Igniten
Conecte Buk para consultar nombre, correo laboral, puesto, área y jefe; ausencias sin motivos y liquidación neta con permiso separado. Cada persona necesita un permiso vigente en Igniten. La conexión usa el acceso del proveedor y nunca amplía lo que ese acceso permite. La escritura laboral requiere una tarjeta de confirmación: Igniten le muestra el cambio y sólo lo hace si toca Confirmar. Hace falta además una clave distinta de la de lectura.
Qué lee Igniten, y qué no
Lee
- nombre, correo laboral, puesto, área y jefe; ausencias sin motivos y liquidación neta con permiso separado
No lee
- Documentos, datos bancarios, domicilio, salud y evaluaciones; no se guardan en el directorio.
- No se escribe nómina ni se dan altas o bajas de empleados.
Cómo se conecta
3 pasos · ≈ 12 min
-
Cree la clave de lectura
En Buk: Administración → Accesos API
- Entre como administrador. Arriba a la derecha abra Administración → Accesos API → Crear nueva API Key. Ponga Igniten lectura como nombre.
- En Permisos de empleados elija Lectura, sin lectura sensible. Habilite la lectura de ausencias y áreas que use su cuenta, dejando fuera remuneraciones y documentos. Toque Crear API Key y copie el Token (contraseña larga para conectar aplicaciones).
Salió bien si Ve Igniten lectura en Accesos API y puede copiar su Token.
-
Separe la clave que puede modificar áreas
Vuelva a Administración → Accesos API
- Para acciones cree otra API Key llamada Igniten acción. Según la documentación de Buk, cambiar el nombre de un área no exige un permiso especial, así que no va a encontrar una casilla «modificar áreas». Esta clave puede cambiar más cosas en Buk que la de lectura: guárdela con cuidado y que la revise un administrador antes de conectarla.
- Igniten limita esa clave a cambiar el nombre de un área existente, con una tarjeta de confirmación: Igniten le muestra el cambio y sólo lo hace si toca Confirmar. No crea ni elimina áreas. Para compensación, cree una tercera API Key en Administración → Accesos API → Crear nueva API Key y no la reutilice para Personas. La ayuda de Buk no nombra una casilla «lectura de liquidaciones». En ese formulario, lo que documentan para leer el sueldo es «Permitir ver información sensible» (a veces figura como «Datos sensibles») en Sí, con «Permisos de empleados» en Lectura. Si no la ve, o no alcanza para las liquidaciones, pregúntele a su contacto de Buk qué casilla marcar.
Salió bien si Tiene claves separadas; conoce el alcance amplio de la clave de acción.
-
Copie la dirección de Buk de su empresa
En Igniten: Conexiones → Buk
- Mire la barra del navegador al entrar a Buk. Si dice https://acme.buk.cl/admin, pegue https://acme.buk.cl en Dirección del proveedor. Cambie acme por el nombre que ve en su cuenta. Esta conexión admite Buk Chile.
- Pegue el Token en Clave de lectura, sin comillas ni texto extra. Elija Personas y toque Guardar. Permite ver directorio, áreas y ausencias de toda la empresa autorizada por la clave, con restricciones de Igniten. La clave de compensación y su permiso van por separado.
Salió bien si Ve Buk conectada con Personas y la dirección de su propia empresa.
Qué permisos pide
| Permiso | Para qué | Cuándo hace falta |
|---|---|---|
Permisos de empleados: Lectura | Para resolver las personas de la empresa. | Siempre |
Permisos de áreas: Lectura | Para ver la organización de áreas. | Siempre |
Permisos de asistencia: Lectura | Para leer ausencias sin motivos médicos. | Siempre |
Empleados: Lectura e información sensible: Sí (clave separada) | Sólo para compensación, en vivo y con un permiso explícito que ningún rol recibe por defecto. | Siempre |
Escritura laboral con clave separada | Para nombre de un área existente. Igniten le va a pedir confirmación cada vez antes de cambiar algo. | Siempre |
Los dos niveles de permiso que recomendamos, y qué habilita cada uno, están en Permisos recomendados.
Qué puede salir mal
- Clave inválida (código 401): el proveedor no acepta la contraseña
-
Por qué La clave venció o fue revocada.
Qué hacer En el proveedor, cree otra clave y péguela en Conexiones.
- Permiso insuficiente (código 403): el proveedor no permite esta consulta
-
Por qué La cuenta del proveedor no tiene el permiso solicitado.
Qué hacer Pídale al administrador que revise sólo los permisos de la información que quiere consultar.
- No hay una aplicación concedida
-
Por qué Su persona no tiene una concesión vigente en Igniten.
Qué hacer Pídale al administrador de Igniten que le dé acceso a Personas.
- La escritura está apagada
-
Por qué La escritura todavía no está habilitada.
Qué hacer Puede leer; la escritura se prende después de la revisión y siempre muestra una tarjeta.
- La dirección no pertenece al proveedor
-
Por qué La dirección pertenece a otro sitio.
Qué hacer Copie la dirección indicada en el paso 3, sin páginas adicionales ni contraseñas.
Los límites, dichos
- Listados acotados: hasta 50 resultados y 8 llamadas por pedido por omisión, con tope global compartido.
- La escritura todavía no está habilitada.
- El directorio cifra sólo nombre, puesto, área, jefe y correo laboral; se activa después de la migración del integrador.
Preguntas frecuentes
¿Quién ve qué?
Con Personas ve el directorio laboral y las ausencias de toda la empresa que alcance la clave. El administrador de Igniten puede limitar los registros; sin una restricción de registros, Personas incluye a todos. Compensación exige su propio permiso explícito y una clave distinta; ningún rol la recibe por defecto.
¿Puede borrar o pagar?
No hay bajas, altas de empleados, pagos ni cambios de nómina. La tarjeta es obligatoria para toda escritura laboral permitida.
¿Cómo lo desconecto?
En Igniten, entre a Conexiones, abra esta aplicación y toque Desconectar. Revoque también la clave en el proveedor para cortar el acceso.
¿Cuánto tarda?
Reserve 12 minutos. Lo tiene que hacer alguien con permiso de administrador; si no es usted, mándele este enlace.
¿Qué pasa si pego un secreto en la ayuda?
La ayuda se detiene y no guarda lo que pegó. Revoque esa clave en el proveedor y cree otra.
¿Qué pasa con salud y documentos?
Igniten descarta documentos, cuenta bancaria y domicilio aunque el proveedor los devuelva. La ausencia sale como ausente (licencia); el motivo médico nunca aparece ni se indexa.