Manual de Integración Nómina Global Rankmi - Vita Wallet

1. Introducción a la integración

Bienvenido al manual de integración entre Rankmi Contrato Global y la billetera digital de Vita Wallet.

Esta integración tiene como propósito simplificar y automatizar el proceso de pago de nómina a tus empleados, permitiendo realizar la dispersión de salarios de manera directa y eficiente, sin tener que salir del entorno de Rankmi.

2. Requisitos y preparación del entorno

Antes de iniciar la configuración, asegúrate de cumplir con los siguientes requisitos:

• En Rankmi: Debes tener acceso con rol de administrador en el módulo de Nómina.
• En Vita Wallet: Debes tener acceso a la cuenta empresarial de la billetera y a la sección de Integraciones.

3. Detalles técnicos de la integración

La integración funciona a través de una consulta automatizada a las APIs de Vita Wallet. Este proceso se realiza por demanda, lo que significa que la conexión y las acciones se activan en el momento que tú lo necesitas, desde la interfaz de Rankmi.

Esta conexión permite:

• Consultar el estado de la cuenta.
• Lanzar procesos de cotización de monedas.
• Realizar la dispersión de los pagos de salarios.

4. Paso a paso de configuración y uso

Para configurar la integración, sigue estos pasos:

1. Obtén tus credenciales en Vita Wallet:
2. • Ingresa a tu cuenta de Vita Wallet y ve a la sección de Integraciones.
   • Haz clic en el botón "enviar credenciales" dentro de Vita Business > Integraciones. Este proceso de envío por correo es una medida de seguridad para evitar que usuarios no autorizados obtengan información sensible que podría ser utilizada para realizar operaciones vía API.
   • Se enviará un correo electrónico a la dirección asociada con la cuenta. Dentro del correo, encontrarás un botón que te redirigirá a una pantalla donde se muestran las credenciales.
   • En esta pantalla, podrás ver las credenciales fijas. Los campos de Vita Wallet corresponden a los de Rankmi de la siguiente manera:
   • • UUID: Es el campo "Billetera de origen" en Rankmi.
     • x-Login: Es el campo "Llave de login" en Rankmi.
     • X-Trans: Es el campo "Llave de transferencia" en Rankmi.
     • Secret: Es el campo "Llave secreta" en Rankmi.
   • El orden en el formulario de Vita Wallet es el mismo que en Rankmi, lo que facilita el proceso de copiar y pegar.
   • Guarda estas claves, ya que las necesitarás en el siguiente paso.
3. Configura la integración en Rankmi:
4. • Accede al módulo de Nómina en Rankmi.
   • Ve a Configuración general > Interfaces.
   • Haz clic en Acciones > Nueva Interfaz.
   • En el modal que aparece, completa los siguientes campos:
   • • Razón social: Selecciona tu empresa del menú desplegable.
     • Alias: Asigna un nombre que te ayude a identificar la integración (ej: "Vita Wallet - Nómina").
     • Proveedor: Selecciona "Vita Wallet".
     • Campos de claves: Una vez que selecciones el proveedor, aparecerán los campos para agregar las credenciales. Copia y pega la Billetera Origen, la Llave de Login, la Llave de Transferencia y la Llave Secreta que obtuviste de Vita Wallet.
5. Guarda y usa la integración:
6. • Haz clic en Guardar.

¡Listo! La integración ha sido creada y está preparada para ser utilizada. Ahora, cuando realices pagos de nómina en tus periodos, la conexión se hará de forma automática por demanda.

5. Mapeo de datos y atributos

La comunicación entre Rankmi y Vita Wallet es muy específica para asegurar la correcta ejecución de cada proceso.

6. Solución de problemas comunes

Aquí te presentamos algunas situaciones que podrías enfrentar y cómo resolverlas.

• Problema: No se puede realizar el pago.
• • Causa común: La cuenta de Vita Wallet no tiene fondos suficientes.
  • Solución: Debes asegurar que haya fondos disponibles en tu cuenta de Vita Wallet para cubrir el monto total de la nómina.
• Problema: No se puede realizar la cotización o el pago.
• • Causa común: Las credenciales de la API son incorrectas.
  • Solución: Revisa que hayas copiado y pegado correctamente la Billetera Origen, la Llave de Login, la Llave de Transferencia y la Llave Secreta en los campos de configuración de Rankmi.
• Problema: Un pago no se procesa para un empleado en particular.
• • Causa común: El empleado no tiene una cuenta activa en Vita Wallet.
  • Solución: Asegúrate de que el empleado haya completado el proceso de registro y activación de su cuenta en la billetera de Vita Wallet.

7. Preguntas Frecuentes (FAQ)

• ¿La integración se activa de forma automática?
• • No. Una vez que guardas la configuración, la integración está lista. Las consultas y pagos se activan de forma manual y por demanda, cuando tú inicias el proceso de pago de nómina en Rankmi.
• ¿Qué tipo de datos se transfieren?
• • Para la cotización, solo el monto total de la nómina. Para los pagos, se transfiere la cuenta del empleado y su número de documento.