- Centro de ayuda
- Integraciones
Campos obligatorios con envío de saldo pendiente en órdenes de pago
Si informas 2 interfases, debes cargar datos tanto de Clientes como de Órdenes de pago con saldo pendiente. En este artículo encontrarás los datos obligatorios en cada caso y recomendaciones para realizar la carga correctamente.
Aprende más sobre las diferencias entre informar 2 o 3 interfases en el siguiente artículo: Configuración de interfases para la gestión del saldo.
A continuación, aprende más sobre los campos obligatorios de esta interfaz:
¿Cuáles son los campos obligatorios de Clientes? +
1. Tipo de documento o Tipo ID: Es el tipo de identificación de tus clientes. Si tus clientes tienen distintos tipos de documento, puedes seleccionar Otros en el mapeo inicial.
2. Número de documento o Número ID Fiscal: Debe ser único e irrepetible para identificar correctamente al cliente. El identificador único del cliente no puede ser el nombre debido a la homonimia.
⚠ En este campo, puedes utilizar códigos internos para identificar al cliente.
3. Medio de contacto:
• Si tus clientes son personas el dato mandatorio es su celular. Colócalo sin espacios, guiones ni prefijos de país. Si cargas números de distintos países, colócalo en la columna Celular_1 código país.
✅ Por ejemplo, el número 584141234567 iría de la siguiente manera: En la columna Celular_1: 4141234567. Si lo deseas, agrega la columna opcional Celular_1 código país y coloca: 58.
Importante: Si no tienes un número de celular, ingresa 1 en el campo de teléfono para que no quede vacío. Si tienes más de un celular, no los incluyas en una misma celda, usa las columnas Celular_2, Celular_3, etc.
• Si tus clientes son empresas el dato mandatorio es su correo. Coloca la dirección de correo electrónico del contacto o grupo de correo. No debe tener ñ, espacios ni caracteres especiales.
Importante: Los correos deben ser solo uno por celda. Si no tienes un correo disponible, ingresa una dirección genérica. Si tienes más de una dirección de correo, no los incluyas en una misma celda, usa las columnas Correo_2, Correo_3, etc.
📌 Asegúrate de contar con al menos un medio de contacto para una gestión de cobranza efectiva.
¿Cuáles son los campos obligatorios de Órdenes de pago? +
1. Tipo de documento o Tipo ID: Debe coincidir con el dato cargado en el archivo de clientes.
💡 Mantén coherencia en el tipo de documento en todos los puntos de integración: Clientes y Órdenes de pago. Por ejemplo, si en tu integración mapeas el tipo de documento del cliente como DNI, pero al enviar Órdenes de pago usas otro valor como Otros, Moonflow no reconocerá la coincidencia y mostrará el error: Cliente no existe.
2. Número de documento o Número ID Fiscal: Debe coincidir con el que usaste en el archivo de clientes, ya que es el dato que vincula la orden de pago con el cliente correspondiente.
3. Código de pago: Código que identifica el pago. Puede ser el número de cuenta del cliente, el número de crédito, la factura de venta u otro documento de cobro.
💡 Si la deuda está dividida en cuotas, utiliza el mismo Código de pago para todas ellas. Para diferenciarlas, puedes hacerlo de dos formas:
• Generación automática del número de cuota: Activa esta opción para que Moonflow genere el número de cuota automáticamente. En ese caso, solo debes cargar los registros con sus diferentes fechas de vencimiento. Disponible para integraciones por archivo o SFTP. Aprende cómo activarla aquí .
• Informa el número de cuota: Utiliza la columna opcional Cuota para especificar que cada vencimiento corresponde a una cuota diferente (1, 2, etc.).
4. Monto (OP): Es el monto de la órden de pago original, sin cargos ni intereses. Los decimales se separan con un punto.
Ejemplo: 10000.12.
5. Fecha de vencimiento: Obligatoria para calcular el tramo de mora y para que el sistema active las comunicaciones automáticas. Si no tienes una fecha precisa, usa la fecha a partir de la cual el pago se considera vencido. Por ejemplo, 30 días después de emitida la factura.
6. Saldo pendiente: Monto pendiente de pago de la orden de pago, incluyendo cargos, intereses y descuentos. Cuando un cliente paga o se suman intereses, simplemente actualizas el monto en este campo (por ejemplo, coloca "0" si ya se canceló la deuda).
💡 Recomendaciones importantes +
• Evita cargar datos innecesarios o colocar "0" en campos vacíos opcionales. Déjalos en blanco.
• Verifica que cada cliente exista y esté activo antes de cargar órdenes de pago.
• Usa siempre los mismos valores. Si cargas datos en archivos diferentes, asegúrate de que cada identificador coincida entre clientes y órdenes.
• Usa los campos opcionales Nombres y Apellidos. Recomendamos que los coloques separados, en sus respectivas columnas. Si están juntos, colócalos en el campo Nombres.
Preguntas frecuentes
¿Cómo activar la Generación automática del número de cuota? +
📌 Aplica únicamente si te integras por archivos o SFTP.
1. Haz clic en Ajustes (ícono del engranaje en la parte superior derecha del dashboard).
2. Ingresa en Otras configuraciones.
3. En la pestaña Pagos, encontrarás la sección Generación automática del número de cuota.
4. Activa la opción. ¡Listo!
¿Cómo considerar como pagada una orden cuando deje de ser informada? +
⚠️ Al activar esta función, es importante tener en cuenta que, si por algún error se deja de informar la orden de pago, al marcarla como pagada, se interrumpirá la comunicación con el cliente sobre el pago pendiente. Asegúrate de que la información se actualice correctamente antes de activar esta opción para evitar inconvenientes con la notificación del pago.
📌 Aplica únicamente si te integras por archivos o SFTP.
1. Haz clic en Ajustes (ícono del engranaje en la parte superior derecha del dashboard).
2. Ingresa en Otras configuraciones.
3. En la pestaña Pagos, encontrarás la sección Considerar como pagada una orden cuando deje de ser informada.
4. Activa la opción. ¡Listo!
¿Cómo agregar cargos e intereses? +
Solo debes actualizar el saldo (balance) directamente en la Orden de pago, incorporando los cargos e intereses ya calculados fuera de Moonflow.
📌 Si utilizas dos interfases, no podrás usar el módulo de Cargos e intereses ni el campo específico de intereses.