Integración · Recursos humanos
Conectar Deel a Igniten
Conecte Deel para consultar directorio laboral, ausencias sin motivos y compensación por identificador de contrato 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
- directorio laboral, ausencias sin motivos y compensación por identificador de contrato 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
-
Genere una clave de empresa
En Deel: More → Developer → Access Tokens
- Entre como administrador a More (más) → Developer (herramientas de conexión) → Access Tokens → Generate new token. Llámelo Igniten lectura y elija Organization token (clave de empresa), no Personal token.
- En permisos marque únicamente people:read (directorio laboral) y time-off:read (ausencias). Deje desactivados los datos sensibles. Toque Generate y copie la contraseña larga que aparece una sola vez.
Salió bien si Tiene un Organization token con dos permisos de lectura.
-
Cree otras claves sólo si las necesita
Repita Access Tokens → Generate new token
- Para acciones, cree otro Organization token llamado Igniten acción con time-off:write y worker:write. Ambos son necesarios para pedir una ausencia. worker:write permite cambios más amplios en el proveedor: trate esa clave como acceso sensible. Igniten sólo la usa para ausencias, con una tarjeta de confirmación: Igniten le muestra el cambio y sólo lo hace si toca Confirmar.
- Para compensación, cree un tercer Organization token llamado Igniten compensación con contracts:read (leer contratos). Puede leer información de contratos en Deel; Igniten devuelve sólo compensación con permiso explícito. Copie cada clave por separado.
Salió bien si Lectura, acción y compensación usan claves diferentes con sus permisos indicados.
-
Pegue las claves en sus campos
En Igniten: Conexiones → Deel
- La dirección https://api.letsdeel.com ya está preparada. Pegue sólo la contraseña generada en Clave de lectura; tal cual la copió, sin agregar palabras ni comillas. Elija Personas y toque Guardar.
- Personas permite ver el directorio laboral y las ausencias de toda la empresa autorizada por la clave, con las restricciones dadas en Igniten. Para pedir su ausencia, su correo laboral en Deel debe coincidir con el de Igniten. Pedir por un compañero requiere además el permiso de acción Gestionar ausencias y una tarjeta.
Salió bien si Ve Deel conectada con Personas; las claves opcionales quedan en campos separados.
Qué permisos pide
| Permiso | Para qué | Cuándo hace falta |
|---|---|---|
people:read | Para leer el directorio laboral. | Siempre |
time-off:read | Para ver fechas de ausencia sin guardar causas. | Siempre |
contracts:read | Sólo para compensación, en vivo y con un permiso explícito que ningún rol recibe por defecto. | Siempre |
time-off:write y worker:write | Para pedir ausencias se necesitan ambos permisos. worker:write es amplio y puede permitir otros cambios en Deel; Igniten sólo lo usa para ausencias y pide una tarjeta cada vez. | 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
¿Puedo pedir una ausencia por un compañero?
Por defecto sólo puede pedirla para usted: el correo laboral de la persona debe coincidir con el suyo en Igniten. Para otra persona necesita además el permiso de acción Gestionar ausencias; se comprueban sus restricciones al preparar la tarjeta y al confirmarla.
¿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.