Guía de integración con SFTP

Creada por Iara Candela Vicente, Modificado el Vie., 31 Jul. a las 11:14 A. M. por Jesica Melo

⭐ Objetivo

Dejar el paso a paso para dejar el archivo de colaboradores en el servidor SFTP de Lara AI, cuando no hay integración directa con el sistema de HR.

⏰ Cuándo aplica esta guía

Cuando tu sistema de HR no tiene integración directa disponible, o cuando la organización prefiere controlar qué datos salen en cada carga.

⚙️ Paso a paso

Datos del servidor: host sftp.meetlara.ai, puerto 22, carpeta de destino employees. Las credenciales las entrega el equipo de Implementaciones de Lara AI.

Antes de la primera carga necesitás generar un par de claves SSH. Tenés tres artículos con el paso a paso según la herramienta que uses: por consola, con WinSCP o con PuTTYgen.

Paso 1: Para conectarse de forma segura a través de SFTP, se necesita crear un par de claves llamado "key-pair" específicamente para SSH (Secure Shell). Este par consta de dos componentes:

Una pública que tendrá una doble encriptación, y es la que se debe compartir con el equipo de Implementations de Lara AI, al correo

secrets@meetlara.ai
.
Una privada SOLO para tu organización, la cual tendrá una llave de seguridad. Es importante que esta clave NO se comparta al equipo de Lara AI.

Este proceso garantiza la autenticación y la seguridad de la conexión SFTP sin tener que compartir contraseñas o credenciales de forma insegura.

Paso 2: Compartir la clave pública generada con el equipo de Implementations de Lara AI.

Paso 3: Crear un archivo csv (con formato UTF-8) que incluya todos los campos que se detallan en este artículo.

Si hay algún campo diferente o nuevo que se desea incluir, es importante que lo compartas con el equipo de Lara AI, para que puedan realizar la parte técnica de la integración.

Paso 4: Una vez que el equipo de Lara AI confirme que ya se encuentra autenticada la clave pública y que la integración se realizó correctamente, se debe dejar el archivo en la carpeta employee (en formato csv., separado por comas) en el servidor SFTP:

URL: sftp.meetlara.ai Puerto: 22

Ten en cuenta que, al momento de leer los datos de los colaboradores, Lara siempre tomará el archivo más actual, es decir el último subido al SFTP. Cada archivo que se suba debe ser único, por lo que el nombre no puede repetirse.

Para automatizar la carga de un archivo nuevo y actualizado todos los días, se debe configurar un flujo automático desde el sistema de HR, de modo que todos los días (o con la periodicidad que se desee) se exporte el archivo con la información de los colaboradores con destino al SFTP.

Paso 5: Avisar al equipo de Lara AI que se encuentra cargado el archivo con la información de los colaboradores.
El equipo técnico revisará la integración y confirmará si quedó todo correctamente configurado, o si es necesario hacer algún ajuste.

Ante cualquier duda o inconveniente, por favor contáctate con soporte@meetlara.ai.

✅ Buenas prácticas

Automatizá la carga con una tarea programada. Una carga manual se olvida.

Usá siempre el mismo nombre de archivo y la misma estructura de columnas.

Después de cada carga, verificá que la cantidad de colaboradores activos coincida con tu nómina.

Guardá la clave privada en el gestor de secretos de tu organización, nunca en una carpeta compartida.

⚠️ Errores frecuentes

Subir el archivo a otra carpeta distinta de employees. La carga no se procesa y no hay aviso.

Cambiar el orden o el nombre de las columnas entre cargas.

Compartir la clave privada por chat o por correo.

Dejar la carga manual a cargo de una sola persona sin respaldo documentado.

❓ Preguntas frecuentes

¿Qué datos del servidor necesito? Host sftp.meetlara.ai, puerto 22 y la carpeta employees. Las credenciales las da el equipo de Implementaciones.

¿Con qué frecuencia hay que subir el archivo? Lo ideal es diario. Cuanto más espaciado, más desfasaje.

¿Cómo sé si la carga se procesó? Revisando en Colaboradores que los cambios se reflejen. Si no, escribí a soporte@meetlara.ai.