Cuando carga una lista de contactos y ve un mensaje de 'log de errores' en el log de Acciones, significa que algo en su lista de contactos es incorrecto.
Motivos que pueden causar un log de errores:
• Archivo de contacto (CSV) con formato incorrecto*
• Número incorrecto de columnas de encabezado
• Muy pocas columnas en una línea determinada (o faltan separadores de campo)
• Una o más direcciones de email no tienen el formato: nombre@web.com
• Direcciones de email duplicadas (la dirección duplicada será descartada)
• No se ha podido convertir el valor (formatos de fecha incorrectos)
• Importación abortada por el sistema debido a un error "crítico"
Para descargar el log de errores, haz clic en el botón «Descargar log de errores». Revisa los mensajes de error del archivo de log y corrige tu lista de contactos. Nota: Si no hay errores en tu próxima importación, el log de errores desaparecerá.
* Para obtener información sobre cómo crear un fichero CSV para cargar sus contactos, por favor lea nuestra FAQ.
Explicación de los logs de errores
El número de propiedades de contacto supera el límite de X
Tu importación de CSV está intentando crear/asignar más propiedades de contacto (campos personalizados) de las que permite el sistema. El límite máximo es de 200 (incluido el campo de Email).
Ejemplo típico
El límite es de 200 propiedades, pero tu archivo tiene 260 columnas personalizadas:
email,field_01,field_02,field_03,...,field_260 john@ejemplo.com,a,b,c,...,z
→ El importador necesitaría 260 propiedades (una por columna), lo que supera el límite → El número de propiedades de contacto supera el límite de 200.
Solución: Elimina/fusiona columnas o realiza varias importaciones, especificando diferentes propiedades en cada archivo:
- CSV 1: propiedades de la 1 a la 199
- CSV 2: propiedades de la 200 a la 260
No se ha encontrado la columna de Email
Significa que el sistema de importación no ha podido identificar ninguna columna de tu CSV como el campo de Email, por lo que no sabe qué valor utilizar como identificador único del contacto.
Esto suele ocurrir en uno de estos casos:
1) El archivo no tiene ninguna columna de Email
Encabezado:
firstname,lastname,city
Simplemente, no hay ninguna columna que contenga emails → No se ha encontrado la columna de Email.
Solución: añade una columna de Email:
email,firstname,lastname,city
2) El archivo tiene emails, pero no se reconoce el nombre del encabezado
El encabezado del ejemplo utiliza un nombre no estándar:
contact_address,firstname,lastname john@ejemplo.com,John,Doe
El importador solo detecta automáticamente los encabezados como email / Email → No se ha encontrado la columna de Email.
Solución: cambia el nombre del encabezado a email.
3) El archivo no tiene fila de encabezado (la primera fila contiene datos)
john@ejemplo.com,John,Doe jane@ejemplo.com,Jane,Doe
Si el importador espera una fila de encabezado, no puede «ver» una columna de Email → No se ha encontrado la columna de Email.
Solución: añade una fila de encabezado:
email,firstname,lastname john@ejemplo.com,John,Doe
4) Un delimitador incorrecto hace que el encabezado no se pueda leer
El encabezado está separado por punto y coma, pero el resto del CSV utiliza la coma como separador (o viceversa):
email;firstname;lastname john@ejemplo.com,John,Doe
Esto hace que las filas se analicen de forma diferente al encabezado y provoca un error.
Solución: utiliza un solo delimitador en todo el archivo (encabezado + todas las filas).
Importación cancelada
Normalmente, cuando se encuentran demasiados errores (1000 errores o el 10 % de la lista importada, lo que sea mayor).
Caracter UTF-8 no válido en la línea X
El archivo no es UTF-8 válido (codificación incorrecta o caracteres dañados) en esa línea.
Ejemplo 1 (típico): archivo guardado en Windows-1252 que contiene «comillas tipográficas»
Puede que la línea de tu CSV parezca correcta en Excel, pero las comillas son «curvas»:
john@ejemplo.com,John,«Equipo de marketing»
Esas comillas curvas (« ») son habituales cuando el texto se copia desde Word/Outlook y el archivo no se guarda como UTF-8. El importador marca entonces: Caracter UTF-8 no válido en la línea X.
Solución: vuelve a exportar como CSV UTF-8 (o ábrelo en un editor de texto y guárdalo como UTF-8).
Ejemplo 2 (habitual con cirílico): archivo guardado en Windows-1251 que contiene caracteres cirílicos
ivan@ejemplo.com,Иван,София
Si el archivo está en Windows-1251 pero el importador espera UTF-8, los bytes de Иван / София no se descodificarán correctamente y obtendrás: Caracter UTF-8 no válido en la línea X.
Solución: guarda/exporta el CSV como UTF-8.
Ejemplo 3 (byte dañado): aparece un «carácter de sustitución» o un símbolo extraño
john@ejemplo.com,John,ACME Ltd
El suele indicar que hay bytes dañados o no válidos durante la conversión. Esa fila puede desencadenar el error de UTF-8.
Solución: elimina/sustituye el símbolo incorrecto y guarda como UTF-8.
Demasiadas columnas en la línea X
Esa línea tiene más valores de los que requiere el encabezado, normalmente por falta de delimitadores o por comillas/saltos de línea rotos.
Cómo se ve en la práctica
Encabezado (espera 3 columnas, separadas por comas):
email,firstname,lastname
Fila incorrecta (, de más → 4 columnas):
john@ejemplo.com,John,,Doe
Si el valor del medio no es intencionado, corrígelo:
john@ejemplo.com,John,Doe
Si es un campo intermedio vacío que sí es intencionado, entonces tu encabezado/mapeo también debe incluir esa columna.
Muy pocas columnas en la línea X
Esa línea tiene menos valores de los que requiere el encabezado, normalmente por falta de delimitadores o por comillas/saltos de línea rotos.
Cómo se ve en la práctica
Encabezado (espera 4 columnas):
email,firstname,lastname,city
Fila incorrecta (solo 3 columnas → «muy pocas columnas»):
john@ejemplo.com,John,Sofia
Aquí falta el valor de lastname (o falta un delimitador), por lo que la fila solo tiene 3 campos en lugar de 4.
Formato de email incorrecto (campo: email)
El valor del email en esa fila no es una dirección de correo electrónico válida (falta el signo @, hay espacios, caracteres no válidos, múltiples emails, etc.).
Ejemplos comunes que lo disparan
Falta el signo @:
john.example.com
Falta la parte del dominio:
john@
Espacios (a menudo al copiar/pegar):
john @ejemplo.com
Espacios al principio o al final (pueden ser invisibles):
" john@ejemplo.com "
Caracteres no válidos:
john<>@ejemplo.com
Dos emails en una celda:
john@ejemplo.com; jane@ejemplo.com
Nombre para mostrar en lugar de la dirección sin formato:
John Doe
Cómo solucionarlo
Asegúrate de que la celda contenga un solo email en el formato estándar:
john@example.com
(Elimina los espacios, quita los nombres/paréntesis y divide los emails múltiples en filas separadas).
Email duplicado (campo: email)
El mismo email aparece más de una vez en el archivo subido.
La parte local es demasiado larga (campo: email)
La parte anterior al signo @ es más larga de lo permitido, a menudo por un mapeo de columnas incorrecto o datos no válidos en la columna del email. Mapea la columna de email correcta y corrige el valor.
El dominio es demasiado largo (campo: email)
La parte posterior al signo @ es más larga de lo permitido, a menudo por un mapeo incorrecto o valores de email con formato incorrecto. Mapea correctamente y corrige el email.
No se ha podido convertir el valor (FieldName)
Estos errores significan que la propiedad existe, pero el valor de la fila no se puede almacenar porque no coincide con el tipo de la propiedad en la base de datos. Formatea el valor correctamente (p. ej., fechas válidas, números solo numéricos).
Ejemplo (propiedad de tipo entero)
Propiedad: age es un entero
La fila del CSV contiene:
email,age john@ejemplo.com,abc
→ la conversión falla porque abc no es un entero.
Solución:
john@ejemplo.com,43
Ejemplo (propiedad de fecha)
Propiedad: birthdate espera una fecha
email,birthdate john@ejemplo.com,today
→ formato/valor de fecha no válido.
Solución (usa el formato esperado):
john@ejemplo.com,2026-03-06
Error de validación de la propiedad (FieldName)
Este error significa que el nombre de la propiedad de contacto tomado del encabezado de tu CSV no está permitido, por lo que el sistema no puede crear/mapear esa propiedad.
1) Carácter no válido en el nombre en la posición N: X
Significado: el nombre de la propiedad (encabezado de la columna) contiene un carácter prohibido en la posición N.
Ejemplo (encabezado incorrecto):
email,first-name john@ejemplo.com,John
Si - no está permitido → carácter no válido.
Solución: cambia el nombre del encabezado utilizando caracteres permitidos (normalmente letras/guion bajo):
email,first_name
2) No se pueden usar números como nombres: X
Significado: el nombre de la propiedad no puede ser solo numérico (o no puede empezar por un número, dependiendo de las reglas).
Ejemplo (encabezado incorrecto):
email,123 john@ejemplo.com,test
Solución:
email,field_123
3) Nombre no válido: X es una palabra reservada.
Significado: el encabezado coincide con una palabra clave reservada que el sistema no permite como nombre de propiedad.
Ejemplo (encabezado incorrecto):
email,class john@ejemplo.com,A
Solución: cambia el nombre del encabezado:
email,customer_class
El encabezado mapeado tiene menos columnas que el encabezado del archivo
Al importar un archivo CSV, el sistema lee primero la fila del encabezado, es decir, los nombres de las columnas que están en la parte superior del archivo. A continuación, en la pantalla de importación, intenta hacer coincidir cada columna con una propiedad de contacto existente, o sugiere crear una nueva con un tipo de datos apropiado.
Este proceso se denomina encabezado mapeado. Define cómo se corresponden las columnas del archivo CSV con los campos que Mailjet utilizará durante la importación.
Si el encabezado mapeado no coincide con el encabezado real del archivo, la importación no puede continuar y se detendrá inmediatamente.
Si te encuentras con este error, ponte en contacto con nuestro equipo de Asistencia para obtener más ayuda.
El encabezado mapeado tiene más columnas que el encabezado del archivo
Al importar un archivo CSV, el sistema lee primero la fila del encabezado, es decir, los nombres de las columnas que están en la parte superior del archivo. A continuación, en la pantalla de importación, intenta hacer coincidir cada columna con una propiedad de contacto existente, o sugiere crear una nueva con un tipo de datos apropiado.
Este proceso se denomina encabezado mapeado. Define cómo se corresponden las columnas del archivo CSV con los campos que Mailjet utilizará durante la importación.
Si el encabezado mapeado no coincide con el encabezado real del archivo, la importación no puede continuar y se detendrá inmediatamente.
Si te encuentras con este error, ponte en contacto con nuestro equipo de Asistencia para obtener más ayuda.