Glosario de errores de carga masiva
Al momento de realizar una carga masiva de datos, hay varios errores que pueden surgir. En este artículo verás el significado de cada uno de ellos.
Cuando realizas una carga masiva, Moonflow te enviará un correo con el resultado del proceso. En este correo podrás ver si la carga fue exitosa o si hubo errores.
Estos pueden ser los siguientes:
En caso de que se reporten errores, el correo estará estructurado de la siguiente manera:
- Detalle de la carga: Indica cuántas filas se procesaron correctamente y cuántas tienen errores.
- Archivo con el detalle de errores: Puedes descargar un archivo XLSX que muestra qué registros fallaron y la causa del error.
- Listado de errores: Se muestra un resumen con el número de fila del excel en la que ocurrió el error y, al lado, su descripción.
En el archivo figurará en la columna Row la fila en la que ocurrió el error y en Error detail, el detalle del inconveniente:

Para solucionar estos errores, revisa el detalle de errores en el archivo XLSX y corrige la información en la plantilla antes de volver a subirla. A continuación, te explicamos los errores más comunes y cómo solucionarlos.
📌 Importante: Las siguientes listas se encuentran ordenadas alfabéticamente. De todas formas, recuerda que presionando CTRL+F te figurará el buscador para que encuentres con más facilidad la solución del error que te figura.
Errores en la carga de clientes
Nombre | Descripción |
---|
AdviserId ..... not found | El ID del asesor asignado no corresponde a un ID existente en la plataforma. |
Cellphone is Invalid | El número de teléfono es inválido; no debe incluir caracteres especiales, espacios ni el LADA del país. Si no tienes un número de celular, ingresa "1" en el campo de teléfono para que no quede vacío. |
Client Already Deleted | El cliente que se intenta cargar está eliminado lógicamente. |
Client with ........... already exists | Ya existe un cliente con ese campo único. |
DocumentNumber is Invalid | El número de documento utilizado para el cliente es inválido; no puede incluir caracteres especiales. |
DocumentType is Invalid | El tipo de documento es inválido; en la plantilla proporcionada por Moonflow encontrarás la codificación correspondiente a cada país. |
Email is Invalid | El correo ingresado es inválido; no puede contener comas, espacios o caracteres especiales. Cada celda solo debe contener un correo electrónico; si no tienes un correo, usa una dirección genérica. |
Name is Invalid | El nombre es inválido; suele suceder cuando el campo está vacío. |
Status is Invalid | El estado del cliente es inválido. Recuerda que sigue una codificación específica. |
Errores en la carga de órdenes de pago
Nombre | Descripción |
---|
Amount cannot be null | El monto no puede estar vacío. |
Amount is invalid Amount must not contain a comma | El monto es inválido; debe ser mayor a 0. No es posible cargar montos distintos en un mismo registro según los días de atraso. Ten en cuenta que los decimales se separan con un punto y no deben contener comas. Por ejemplo: 1200.36 |
Can't add payment order to inactive customer | El cliente al que se le está cargando la orden de pago está inactivo. |
Can't change payment order for deleted customer | No se puede modificar la orden de pago de un cliente eliminado lógicamente. |
Client doesn't exist | El número de documento no corresponde a ningún cliente registrado. |
DeletedField is Invalid | El valor en la columna "Anulada" es inválido; sigue una codificación que puedes encontrar en la plantilla de Moonflow. |
Discount is Invalid | El valor del descuento es inválido; debe ser un número y los decimales deben expresarse con "." |
DueDate is invalid | La fecha de vencimiento es inválida; debe seguir el formato mapeado. |
Identifier Needed for Client | El número de documento está vacío. |
PaymentCode is Invalid | El código de pago es inválido; no puede contener caracteres especiales ni espacios. Debe ser único e irrepetible para evitar errores en la asociación con pagos recibidos. |
Quota is Invalid | El número de cuota es inválido; debe ser un valor numérico sin caracteres especiales. |
Currency is Invalid | El tipo de moneda es inválido; sigue la codificación ISO. |
AttachmentUrl is Invalid | La URL cargada para descargar el archivo es inválida; sucede cuando Moonflow no puede descargarlo. |
Errores en las novedades de pago
Nombre | Descripción |
---|
Action is invalid: PastDue / Fallido | El campo es inválido o no está mapeado. |
Amount cannot be null | El monto no puede estar vacío. |
Amount is invalid Amount must not contain a comma | El monto es inválido; debe ser mayor a 0. Ten en cuenta que los decimales se separan con un punto y no deben contener comas. Por ejemplo: 1200.36 |
Document Number is invalid | El número de documento del cliente es inválido; no puede contener espacios ni caracteres especiales. |
ExternalClientId is invalid | El ID de cliente externo es inválido; debe ser alfanumérico y no contener espacios ni caracteres especiales. |
Identifier needed for client | El campo ID de Cliente está vacío. |
Invalid Currency | El tipo de moneda es inválido; sigue la codificación ISO. |
Max Value for Payment Date is dd/mm/aa | La fecha de pago es inválida; el máximo permitido es el día en que se realiza la carga. |
OriginCommunicationChannel is invalid | El canal de origen del pago es inválido; este campo es alfanumérico y está codificado en la plantilla bajo la pestaña "Ayuda". |
PAYMENT_ORDER.ERROR.CURRENCY_NOT_MATCH | La moneda del pago recibido no coincide con la moneda de la orden de pago. |
Payment Code is invalid | El código de pago es inválido; no puede contener caracteres especiales ni espacios. Debe coincidir con el que se utilizó en la carga de órdenes de pago. |
PaymentEntity is Invalid | La entidad de pago no existe en el país configurado o no está mapeada. |
Payment order is annulled | La orden de pago está anulada. |
PaymentOrder is Already Paid | La orden de pago ya se encuentra pagada. |
PaymentOrder not found | El código de la orden de pago no corresponde a ninguna orden registrada en tu sistema. |
PaymentDate is invalid | La fecha de pago es inválida; debe seguir el formato establecido en el mapeo. |
Reference is already used | La referencia ingresada ya se ha utilizado en otra transacción. Para evitar duplicidades, cada transacción debe contar con una referencia única. |