ℹ️ Este artículo está pensado para ayudar con la configuración específica de este proveedor, si aún no has leído el artículo de configuración de la integración nativa, empieza por él haciendo clic aquí.
Ofrecemos una integración de colaboradores a través de SFTP. A través de ella, la base se actualiza en la Plataforma cada vez que envías un único archivo en formato csv (no se aceptan otros formatos) con la información de tu base completa de colaboradores que debe estar en Qulture. Ten en cuenta que cada sincronización entiende que la fuente de verdad de los usuarios activos es este csv, es decir, si hoy envías a Juan y a María y mañana envías sólo a María, Juan será inactivado. Esta integración funciona a las 12:30 y a las 2 diariamente.
Esta integración es un poco diferente de las demás porque no integra directamente nuestra plataforma con el sistema de origen, bien porque este sistema no tiene una API REST que podamos integrar, bien porque Qulture no puede tener este acceso. Así, su empresa creará un programa que ponga un csv con los usuarios en una carpeta en AWS y nuestra sincronización leerá de esa carpeta.
En resumen:
-
Tu programa lee del SOURCE, prepara un csv y lo sube a la carpeta vía SFTP
-
Qulture toma este archivo, crea una importación y elimina el archivo
🤓 SFTP son las siglas de Secure File Transfer Protocol.
Este protocolo ayuda a aumentar la seguridad al transferir ese csv. Con él, tu empresa genera una doble contraseña: una tuya (secreta) y otra nuestra (pública). Creamos una carpeta con la nuestra y tu sistema puedes reproducir el archivo en ella con la contraseña privada.
⚙️ ¿Cómo se configura?
Utilizamos el servicio AWS Transfer for SFTP (https://aws.amazon.com/pt/sftp/) para la transferencia segura de archivos.
Para ponerlo en marcha en tu empresa, necesitamos tu ayuda.
1. Ustedes: Crea la plantilla csv (lee este artículo sobre la asignación de campos)
2. Ustedes: Genera una clave SSH (https://docs.aws.amazon.com/pt_br/transfer/latest/userguide/key-management.html#sshkeygen)
3. Ustedes: Crea un zip que contenga esta información y envíenoslo de forma segura a integrations@qulture.rocks copiando a tu gerente de cuenta (CSM)
I. archivo txt con la clave pública
II. archivo csv con los datos de los colaboradores que deseas sincronizar
4. Qulture: Responda a este correo electrónico después de que hayamos configurado un entorno de prueba para que podamos probar el flujo contigo y hacer los ajustes necesarios.
5. Ustedes: Responda a este correo electrónico cuando se apruebe la integración de la prueba.
6. Qulture: ¡Migrar el entorno a producción y comenzar la integración de la base de forma efectiva! 🤘
👀 Algunas notas importantes
-
El nombre del archivo tiene que ser siempre el mismo para cada importación, por lo que necesitamos que siempre envíes con el formato users.csv
-
La codificación del archivo debe ser UTF-8
-
El separador de archivos debe ser un punto y coma (";")
-
Poner las cabeceras de las columnas con palabras sin caracteres especiales y separadas por subrayado, ej: poner "matricula_del_lider" en lugar de "Matricula del Líder".
-
La importación de los datos se realiza dos veces al día (a las 2:00 y al mediodía). Cuando el sistema termina de importar los datos, cambia el nombre del archivo que has utilizado, añadiendo el sufijo "_backup".