Integración · Recursos humanos
Conectar Personio a Igniten
Conecte Personio para consultar nombre, puesto, área, jefe y correo laboral; ausencias sin motivos; salario fijo u horario 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, puesto, área, jefe y correo laboral; ausencias sin motivos; salario fijo u horario 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 Igniten lectura
En Personio: Marketplace → Connected integrations
- Entre como administrador a Marketplace → Connected integrations (conexiones instaladas) → Create custom integration (crear conexión propia). Escriba Igniten lectura y abra Access rights (permisos).
- Marque Read (leer) en Employees (personas) y Absences o Time off (ausencias), según el idioma de su cuenta. No marque Write (modificar). En Readable employee attributes, elija id, nombre, apellido, correo, puesto, departamento y supervisor. Guarde y copie Client ID (identificador) y Client Secret (contraseña larga).
Salió bien si Ve Igniten lectura y puede copiar su identificador y su contraseña.
-
Separe acciones y compensación
Vuelva a Create custom integration
- Para acciones, repita Marketplace → Connected integrations → Create custom integration. Llámela Igniten acción y marque Employees: Write. Copie su propio Client ID y Client Secret. Igniten sólo modifica puesto y departamento, con una tarjeta de confirmación: Igniten le muestra el cambio y sólo lo hace si toca Confirmar. El permiso del proveedor puede ser más amplio.
- Para compensación, repita el mismo menú y cree Igniten compensación con Employees: Read y sólo los atributos id, fix_salary y hourly_salary (salario fijo y por hora). Copie el tercer identificador y su contraseña. No seleccione documentos ni datos bancarios.
Salió bien si Cada conexión tiene su propio identificador y contraseña; lectura no tiene Write.
-
Pegue los dos datos de lectura
En Igniten: Conexiones → Personio
- La dirección https://api.personio.de ya está preparada por Igniten: no tiene que escribirla. Pegue el texto de Client ID en Identificador de lectura, tal cual lo copió, y Client Secret en Clave de lectura, sin agregar texto. El Client ID no es un número.
- Elija Personas y toque Guardar. Da acceso al directorio y ausencias de todas las personas que permita la conexión, con las restricciones dadas en Igniten. Los pares de acción y compensación van en sus campos opcionales separados; compensación requiere su permiso explícito.
Salió bien si Ve Personio conectada; los dos datos opcionales de cada nivel se completan juntos.
Qué permisos pide
| Permiso | Para qué | Cuándo hace falta |
|---|---|---|
Employees: Read | Para leer sólo los atributos laborales elegidos. | Siempre |
Absences: Read | Para ver fechas de ausencia sin guardar causas. | Siempre |
Compensación: lectura 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 puesto y área de una persona 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.