Integración · Recursos humanos
Conectar Rankmi a Igniten
Lee el directorio laboral. El único cambio que prepara es el nombre de un área sin presupuesto, con otra clave y una tarjeta. El permiso Áreas: Registrar también crea áreas: si el área ya no existía, Rankmi crea una nueva y la tarjeta falla para que la revise.
Qué lee Igniten, y qué no
Lee
- Nombre, puesto, área y correo laboral; en vivo con un techo por pedido.
No lee
- Sueldos, documentos, salud, evaluaciones, bancos y dirección particular.
Cómo se conecta
3 pasos · ≈ 12 min
-
Pida que activen la API
Sin ese módulo no aparece Crear credencial
- En Rankmi entre a Administración → Configuración de empresa → Rankmi API.
- Si dice que Integraciones no está activa, pídale a su ejecutivo o a soporte de Rankmi que activen el módulo. Cuando esté activo va a ver el botón Crear credencial.
- Si no administra Rankmi, pásele este paso a quien sí pueda entrar a Configuración de empresa.
Salió bien si En Rankmi API se ve el botón Crear credencial.
-
Cree dos claves distintas
Consultar no alcanza para cambiar un nombre
- Toque Crear credencial y elija Personalizado. En People marque Colaboradores: Consultar y Áreas: Consultar. No marque Nómina, Desempeño ni Eliminar. Copie el ID de empresa y la contraseña larga de esa credencial: es la de lectura.
- Para cambiar el nombre de un área, cree otra credencial sólo con Áreas: Registrar. Ese permiso también crea áreas: si el área ya no existe, Rankmi da de alta una nueva. Por eso la clave de acción va aparte y cada cambio pide una tarjeta.
- Tiene que salir de esa pantalla con dos contraseñas distintas y el ID de empresa. Rankmi no vuelve a mostrar la contraseña.
Salió bien si Tiene el ID de empresa, una contraseña que sólo consulta y otra que sólo tiene Áreas: Registrar.
-
Pegue las claves en Igniten
La dirección de Rankmi ya viene puesta
- En Igniten abra Conexiones → Rankmi. La dirección de servicios ya está completa: https://rankmi-api.rankmi.com. No la escriba ni la cambie.
- Pegue el ID de empresa, la contraseña de lectura en «Contraseña o clave de lectura» y, si va a cambiar nombres de área, la otra contraseña en «Contraseña o clave de acción». Elija Personas y toque Guardar.
- Reserve unos 12 minutos desde que activaron Integraciones hasta que Guardar deja la conexión visible.
Salió bien si Igniten muestra la conexión de Rankmi en Personas y no pide que escriba la dirección.
Qué permisos pide
| Permiso | Para qué | Cuándo hace falta |
|---|---|---|
master:users:show | Colaboradores: Consultar. Ver nombre, puesto, área y correo laboral. | Siempre |
master:areas:show | Áreas: Consultar. Ver nombre y código de las áreas. | Siempre |
master:areas:create | Áreas: Registrar. Cambia el nombre de un área y también crea áreas si el código ya no existe. Va en la clave de acción y siempre con tarjeta. | Siempre |
Los dos niveles de permiso que recomendamos, y qué habilita cada uno, están en Permisos recomendados.
Qué puede salir mal
- Rankmi no emitió la clave temporal; revise los permisos.
-
Por qué El ID de empresa o la contraseña no coinciden, o la credencial no tiene Colaboradores: Consultar.
Qué hacer Cree de nuevo la credencial de lectura, copie la contraseña en ese momento y péguela en Contraseña o clave de lectura.
- Las claves de lectura y acción deben ser distintas.
-
Por qué Pegó la misma contraseña en los dos campos.
Qué hacer La de lectura sólo consulta. La de acción es la otra, la de Áreas: Registrar.
- No se modifica un área con presupuesto; elija un área sin presupuesto.
-
Por qué Esa área tiene un monto cargado y esta integración no lo toca.
Qué hacer Elija un área sin presupuesto, o saque el monto en Rankmi si corresponde cambiar el nombre.
- el área ya no existía y Rankmi creó una nueva; revísela en Rankmi.
-
Por qué Áreas: Registrar crea un área cuando el código ya no está. La tarjeta no queda hecha.
Qué hacer En Rankmi busque el área nueva y bórrela si no la quería. Después pida el cambio sobre un área que siga existiendo.
- No se pudo verificar el resultado; revíselo en Rankmi.
-
Por qué Rankmi contestó sin el identificador del área. No se sabe si el cambio quedó hecho.
Qué hacer Abra el área en Rankmi y fíjese si el nombre cambió antes de pedir otra tarjeta.
- Revise los campos de la conexión; no se envió la credencial.
-
Por qué Falta el ID de empresa o la contraseña no es la de esa credencial. La dirección https://rankmi-api.rankmi.com ya viene puesta: no la escriba.
Qué hacer Vuelva a Conexiones, pegue el ID de empresa y la contraseña de lectura, y toque Guardar.
Los límites, dichos
- Hasta el límite de registros y llamadas; no es un total del negocio.
- La lectura no da permiso para escribir; toda escritura lleva tarjeta.
Preguntas frecuentes
¿Quién lo puede conectar?
Lo conecta el administrador de Rankmi, que puede crear una credencial de la empresa. No use una cuenta personal de acceso total.
¿Cuánto tarda?
Reserve 12 minutos después de que Integraciones esté activo. Si el módulo sigue apagado, el ejecutivo de Rankmi tiene que habilitarlo antes.
¿Qué ve cada persona?
Hay una sola clave de empresa, con Colaboradores: Consultar. No es una cuenta restringida por persona. Cada persona ve lo que esa clave ve, recortado por sus permisos en Igniten. Sin concesión no hay consultas.
¿Puede borrar o cambiar sueldos?
No. No hay bajas, altas de empleados, borrado ni escritura de nómina. Áreas: Registrar puede crear un área si el código ya no existe; no crea empleados.
¿Cómo lo desconecto?
En Igniten, abra Conexiones y toque Desconectar. En Rankmi, revoque las dos credenciales de la empresa.
¿Dónde pongo la clave?
En Conexiones, en el campo Contraseña o clave de lectura. Nunca en el chat ni en la ayuda. Si la compartió, revóquela en Rankmi y cree otra.
¿Me muestra un error de permisos?
Si dice que Rankmi no emitió la clave temporal, la contraseña no coincide o la credencial no tiene Colaboradores: Consultar vigente.
¿Qué pasa si un cambio falla?
Mire el área en Rankmi antes de pedir otra tarjeta. Igniten no reintenta una escritura que pudo haberse realizado. Si el mensaje dice que Rankmi creó una nueva, bórrela allá si no la quería.