Integración por SFTP

Una de las formas más eficientes de cargar información en Moonflow es a través de una carpeta SFTP (Secure File Transfer Protocol). Este método te permite transferir archivos de manera segura, sin necesidad de ingresar manualmente a la plataforma para subir cada archivo.

¿Qué necesitas para comenzar?

Accede a la sección Integraciones desde el menú Ajustes y desplázate hasta el área SFTP. Allí encontrarás tus credenciales: servidor, nombre de usuario y contraseña.

Con estos datos, puedes configurar tu cliente de transferencia de archivos preferido, como:

  • FileZilla
  • WinSCP
  • Cyberduck
  • Transmit

Dentro de tu carpeta SFTP encontrarás tres subcarpetas:

Upload: aquí debes subir los archivos que quieras procesar. Dentro de esta carpeta verás tres subcarpetas:

  • Customers: para cargar información de clientes.
  • Payment Orders: para cargar órdenes de pago (cuentas por cobrar).
  • Payment Notifications: para cargar novedades de pago.

Backup: aquí se almacenan los últimos archivos procesados por Moonflow.

Download: actualmente no está operativa y está reservada para futuras funcionalidades de reporting.

El formato admitido para la carga es Excel (.xls o .xlsx). Una vez finalizado el procesamiento de los archivos, Moonflow enviará un correo de notificación a los administradores.

💡 Importante: Asegúrate de mantener la misma estructura de columnas que definiste en tu mapeo inicial. Por ejemplo, si configuraste el teléfono de contacto como "Contacto" en el mapeo, debes seguir respetando ese mismo nombre y ubicación de columna en todos los archivos que cargues.

Ventajas de usar SFTP

  • 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.

Errores comunes al cargar datos por SFTP

1. Incompatibilidad entre el archivo y el mapeo

Recuerda que la estructura del archivo debe coincidir exactamente con la configuración definida en el Mapeo de campos. Si cambias el nombre de una columna, agregas o eliminas campos, el archivo no podrá procesarse.

Sugerencia: descarga la Guía de campos desde la pestaña Mapeo de campos para verificar los obligatorios antes de generar tu archivo.

2. Formato incorrecto del archivo

Solo se admiten archivos .xls o .xlsx. Si cargas otro formato, como .csv o .txt, la información no será procesada.

3. Datos negativos sin filtrar

Si tu archivo incluye saldos negativos y no deseas que se carguen, debes filtrar previamente estos valores. Puedes adaptar el archivo para que solo se incluyan montos mayores a cero.

4. Uso incorrecto del campo Referencia

Cuando cargas varios pagos asociados a una misma orden, es fundamental que cada uno tenga una Referencia diferente. Esto evita que Moonflow los detecte como duplicados.

5. Intentar cargar fuera de la carpeta Upload

Asegúrate de colocar los archivos únicamente dentro de la carpeta Upload, en la subcarpeta correspondiente (por ejemplo, Customer, BusinessOrder o PaymentNotification). Las carpetas Download y Backup no están habilitadas para carga.

6. No respetar el tipo de dato esperado

Verifica que cada columna tenga el formato adecuado: fechas con el formato correcto, montos en formato numérico, documentos sin caracteres no permitidos, etc.

7. Carga durante horarios pico

Si bien puedes cargar archivos en cualquier momento, te recomendamos hacerlo fuera del horario laboral para evitar demoras o congestión en el procesamiento.

💡 Consejo final: Antes de automatizar la carga, realiza una prueba con un archivo pequeño. Así podrás verificar que la estructura y los valores son correctos y evitar errores en lote.