Esta guía describe las reglas de formato para importar CSV/XLSX que debes seguir antes de subir archivos al sistema. Aprenderás qué estructura debe tener tu data, qué campos son obligatorios y cómo deben formatearse los valores para que se reconozcan correctamente durante la importación. Seguir estas reglas ayuda a evitar problemas habituales como columnas faltantes, tipos de datos no válidos o errores inesperados de mapeo. Utiliza este artículo como una checklist para validar tu archivo y garantizar una importación rápida y fiable cada vez.
Actualmente, la aplicación permite subir data desde dos tipos de archivo:
CSV
XLSX
Tu archivo debe utilizar uno de los separadores estándar. De lo contrario, el archivo puede ser rechazado.
Opciones permitidas:
coma (,)
punto y coma (;)
tabulación
Evita:
Comas dobles (,,)
Comas en lugares irregulares
Caracteres de separación poco habituales
Si utilizas la coma como separador, no puedes usarla dentro de los valores. Por ejemplo, «Baker street, 20» no está permitido en el atributo «Dirección».
La codificación es el método utilizado para representar el texto como data digital. Define cómo el sistema almacena y muestra letras, números, símbolos y caracteres especiales. Elegir la codificación correcta es esencial para preservar la exactitud del texto, especialmente cuando trabajas con contenido multilingüe. Si se selecciona una codificación incorrecta, los caracteres pueden aparecer dañados o ilegibles, un problema conocido a menudo como mojibake.
Entre las opciones más utilizadas, UTF-8 es el estándar moderno. Admite una amplia variedad de caracteres de distintos sistemas de escritura y es muy recomendable para contenido internacional por su compatibilidad y flexibilidad.
Cirílico (Windows-1251) es una codificación heredada que se utiliza habitualmente para textos escritos en idiomas basados en el alfabeto cirílico, sobre todo en entornos Windows antiguos. Cirílico (ISO-8859-5) es otro estándar antiguo para texto cirílico, aunque hoy en día es menos común que Windows-1251 o las codificaciones basadas en Unicode.
Para los idiomas de Europa Central y Oriental, Europa del Este (Windows-1250) se utiliza a menudo en aplicaciones heredadas de Windows. Admite idiomas que usan alfabetos latinos con signos diacríticos adicionales, como el polaco, el checo y el húngaro. De forma similar, Europa del Este (ISO-8859-2) es un estándar internacional más antiguo diseñado para el mismo grupo de idiomas, aunque ha sido sustituido en gran medida por Unicode en los sistemas modernos.
Por último, US ASCII es una de las codificaciones más antiguas y limitadas. Incluye únicamente letras básicas del inglés, números y signos de puntuación, por lo que solo es adecuada para contenido simple de texto plano sin caracteres acentuados o no latinos.
En la mayoría de los casos de uso modernos, UTF-8 es la opción más segura y universal, mientras que las codificaciones heredadas siguen siendo útiles principalmente para mantener la compatibilidad con archivos y sistemas antiguos.
Cada encabezado de columna debe representar un atributo y cada celda debe contener solo el valor correspondiente a ese atributo.
Si dejas valores adicionales en una fila que no coinciden con ningún atributo, el importador puede intentar combinar los valores y tratarlos como un único campo. Esto puede provocar errores de validación engañosos (por ejemplo, un mensaje de «last_name demasiado largo» aunque el apellido parezca correcto).
Checklist
Cada columna tiene un encabezado claro (nombre del atributo).
Cada valor pertenece a un atributo existente (o a uno que planeas crear).
No hay valores «adicionales» después de la última columna prevista.
El formato correcto es importante porque el motor de importación valida los tipos de valor.
Antes de crear nuevos atributos, consulta qué tipos de atributos hay disponibles:
Tipo | Descripción | Ejemplo |
Boolean | Representa opciones binarias: true / false. | Atributo «Consentimiento de marketing», valor «True» |
Date | Campo para almacenar información sobre una fecha específica. Formato: ISO 8601. | Atributo «Cumpleaños», valor «1996-01-20» |
Datetime | Campo para almacenar detalles específicos de tiempo, como información de registro o última actividad. Requiere el formato ISO 8601. | Atributo «Última visita», valor «2016-08-03 12:00:00+00:00» |
Fixed choice | Conjunto de opciones posibles que limitan los valores de un campo específico. Estos atributos también pueden incluir la variante «Permitir varias opciones». Si esta opción está activada, puedes introducir más de un valor en la celda, separándolos con el símbolo «|». | Atributo «Idioma preferido», valor «Inglés», «Polaco», «Español» |
Floating-point number | Data numérica que admite decimales, adecuada para representar precios o medidas estadísticas. | Atributo «Valor de vida», valor «1000,59» |
Integer | Data numérica que incluye solo números enteros. | Atributo «Número total de pedidos», valor «9» |
Formato de archivo JSON | Funciona para valores más largos que no pueden colocarse en otros formatos de datos. No disponible para eventos de producto. | Atributo «Información adicional del pedido», valor (objeto JSON válido): «key»: «value» |
Number | Solo para eventos (!). Este campo se utiliza específicamente para atributos de eventos. Cubre tanto opciones de números enteros como de números con decimales. | Atributo «Puntos acumulados», valor «15» |
String | Cualquier cadena de caracteres limitada a 255 elementos. Es perfecta para información basada en texto, incluidos nombres, direcciones de email o cualquier otro dato textual. | Atributo «Plan de suscripción», valor «Standard» |
Los campos booleanos deben contener valores booleanos válidos:
- Utiliza TRUE o FALSE
- No dejes los campos booleanos en blanco (los valores vacíos pueden generar errores de validación)
Puedes leer más sobre atributos aquí.
Algunos campos esperan valores concretos y predefinidos. Asegúrate de utilizar el formato correcto.
Atributo | Descripción | Valores requeridos |
Género (atributo de contacto) | Atributo estándar que puedes actualizar con tus valores personalizados. Vacío por defecto. |
|
Número de teléfono (atributo de contacto) | Atributo estándar que puedes actualizar con tus valores personalizados. Vacío por defecto. Formato recomendado y compatible con todos los proveedores: E.164 | Formato E.164. Ejemplo: +44754123434 |
Estado (atributo de oportunidad) | Este campo define el estado de tu oportunidad. |
|
Estado de la tarea (atributo de oportunidad) | Definen el estado de tu tarea. |
|
Asignado a (atributo de contacto) | Define a qué usuario está asignado el contacto. | Debe coincidir con el ID de un usuario existente o con el nombre de un usuario/grupo (según la configuración de tu sistema). |
Estado (atributo de ticket) | Este campo define el estado del ticket. |
|
Para saber más sobre cómo importar objetos específicos a la aplicación, consulta la sección dedicada en nuestro centro de ayuda: Importación y exportación de datos
