¿Cómo realizar la integración por SFTP?
Puedes cargar información en Moonflow a través de un protocolo para transferencia de archivos, es decir, un SFTP (Secure File Transfer Protocol). Este método te permite transferir archivos sin necesidad de ingresar manualmente a la plataforma para subir cada archivo.
Paso 1. Prepara tu archivo y realiza el mapeo.
1. Haz clic en el ícono de Ajustes (⚙️), en la esquina superior derecha del dashboard.
2. Entra en la sección Integraciones.
3. Luego, en la pestaña Métodos de integración, selecciona la opción SFTP y luego Mapear archivo.

4. Primero deberás cargar tu archivo.
💡 Hay campos que son obligatorios. Para más detalle, puedes descargar la plantilla; allí encontrarás una pestaña de Ayuda donde hay más información sobre datos mandatorios y opcionales y sus formatos de carga.
💡 Una vez completado el mapeo de un archivo:
-
No cambies los nombres de columnas; no agregues ni elimines columnas. Incluye ahora todos los campos que vayas a utilizar para comunicarte con tus clientes o para segmentarlos.
-
No se permiten saldos negativos. Si tu sistema los genera, corrígelos antes de la carga.
-
Los campos obligatorios no pueden estar vacíos.
💡 Sigue las recomendaciones que encontrarás en estos artículos:
- Si te conectas por 2 interfases, haz clic aquí.
- Si te conectas por 3 interfases, haz clic aquí.
💡 Puedes crear nuevas variables desde la plataforma e incluirlas en tu archivo, en caso de que necesites agregas otros campos. Aprende más sobre esto en el siguiente artículo: ¿Cómo agregar variables auxiliares?
6. Una vez que tu archivo esté listo, arrástralo o haz clic en el recuadro que verás en el centro de la pantalla para seleccionarlo.
7. La plataforma analizará automáticamente el contenido del archivo. Corrobora este análisis y haz clic en Confirmar.

8. Mapea primero los datos requeridos. Si no se pueden mapear correctamente, se marcan en rojo.

9. Mapea los datos opcionales. Puedes mapearlos o descartarlos, según los datos que vayas a utilizar para tus cobranzas.

💡 Durante el mapeo, también puedes agregar valores personalizados y asociarlos con los de la plataforma.
Por ejemplo, puedes asociar un valor específico a un determinado tipo de documento y cuando coloques ese valor en el campo Tipo de documento, se cargará de forma automática como ese tipo.

10. Haz clic en Confirmar y finaliza el mapeo.
Paso 2. Ingresa al SFTP.
1. Haz clic en Ajustes (ícono del engranaje en la esquina superior derecha de la pantalla).
2. Selecciona Integraciones.
3. Selecciona la opción SFTP. Se abrirá por defecto la pestaña de SFTP.
4 Copia estos datos: Servidor, usuario y contraseña. Guárdalos porque los vas a necesitar.
5. Configura tu cliente SFTP. Puedes usar uno de estos programas:
– FileZilla (recomendado)
– WinSCP
– Cyberduck
– Transmit (Mac)
6. En tu cliente, ingresa:
– Servidor, usuario y contraseña que copiaste.
– Protocolo: Selecciona SFTP – SSH File Transfer Protocol.
– Puerto: Si te lo solicita, usa el 22 (por defecto).
7. Cuando te conectes, vas a ver estas carpetas:
– Upload: Aquí debes subir los archivos.
– Backup: Guarda copias de archivos ya procesados (solo para consulta).
– Download: No se utiliza usualmente.
8. Ingresa en Upload. Allí, verás tres subcarpetas:
– Customers: Para archivos de clientes.
– Payment Orders: Para órdenes de pago.
– Payment Notifications: Para novedades de pago.
Paso 3. Carga tu archivo.
💡 Si bien puedes cargar archivos en cualquier momento, te recomendamos hacerlo fuera del horario laboral para evitar demoras o congestión en el procesamiento.
1. Arrastra tu archivo a la subcarpeta correspondiente. Espera que se transfiera completo antes de cerrar el programa.
💡 Si cuentas con un solo archivo con toda la información, súbelo en cada subcarpeta correspondiente. Por ejemplo, si trabajas con 2 interfases y el archivo incluye datos de clientes y órdenes de pago con saldo pendiente, súbelo 2 veces: una en Customers y otra en Payment Orders.
2. No necesitas esperar a que la carga de un archivo termine para subir el siguiente. Solo asegúrate de cargarlos en el orden correcto para que la información se procese correctamente.
👉 Si solo te conectas por 2 interfases, no debes subir nada en Payment Notifications.
3. Cuando Moonflow procese tu archivo, verás si la carga fue exitosa ingresando en el módulo de Cuentas por cobrar y haciendo clic en la pestaña Log de procesos.
¿Cuáles son sus ventajas? +
• Puedes cargar múltiples archivos a la vez, sin ingresar a cada sección de la plataforma.
• Permite automatizar la carga si tu ERP genera reportes compatibles. Estos archivos pueden depositarse automáticamente en la carpeta SFTP, evitando intervención manual.
• Es ideal para programar cargas fuera del horario laboral, reduciendo la posibilidad de errores y facilitando procesos continuos.