Tutorial · Archivos y datos

Cómo validar un archivo CSV antes de importarlo

Importar un CSV defectuoso a tu tienda online, tu base de datos o tu herramienta de email puede duplicar clientes, romper precios o mezclar columnas enteras. Y lo peor: el daño se descubre días después, cuando revertirlo cuesta diez veces más que haberlo evitado.

Validar un CSV antes de importarlo significa comprobar su estructura (codificación, delimitador, columnas) y su contenido (tipos de datos, duplicados, valores imposibles). Es un control de calidad de quince minutos que protege horas de trabajo.

En esta guía verás la lista de comprobación completa, los problemas más frecuentes con ejemplos, cómo validar con una hoja de cálculo y qué hacer cuando el archivo viene mal de origen.

Por qué validar: lo que está en juego

Un CSV mal formado puede importar 10.000 productos con el precio en la columna del stock, o suscribir a tu newsletter a direcciones truncadas. Los importadores automatizados rara vez avisan: asumen que el archivo está bien y ejecutan.

Los errores se clasifican en dos tipos: estructurales (el archivo no se parsea bien: delimitadores, comillas, codificación) y de contenido (se parsea, pero los datos son incorrectos: fechas imposibles, emails sin @, duplicados). Hay que cazar ambos.

Regla de oro: nunca importes directamente a producción. Haz siempre una primera importación en un entorno de prueba o con una muestra pequeña, valida el resultado y solo entonces importa el archivo completo.

Lista de comprobación estructural

1) Codificación: abre el CSV en un editor de texto. Si las tildes y eñes se ven bien, la codificación es compatible; si ves «Ã©», hay un desajuste entre UTF-8 y ANSI que debes resolver antes de importar.

2) Delimitador: identifica el carácter separador (coma, punto y coma, tabulación) y confirma que el importador espera ese mismo. 3) Cabecera: la primera fila debe tener los nombres de columna exactos que espera el destino, sin espacios extra ni mayúsculas distintas.

4) Número de columnas constante: cada fila debe tener el mismo número de campos que la cabecera. Una fila con un campo de más o de menos indica un delimitador dentro de un texto sin comillas, o un salto de línea mal cerrado.

Comillas, saltos de línea y caracteres especiales

Los campos que contienen el delimitador, comillas o saltos de línea deben ir entre comillas dobles: «Calle Mayor, 5» es un campo; Calle Mayor, 5 sin comillas son dos. Verifica que los textos con comas vengan entrecomillados.

Una comilla dentro del campo se escapa duplicándola: «dijo ««hola»»» representa dijo «hola». Si ves comillas sueltas sin duplicar, el archivo puede romperse al importar: revísalo en un editor antes.

Los saltos de línea dentro de un campo (una dirección en dos líneas) son legales si el campo va entrecomillado, pero muchos importadores simples los parten. Si tu destino es básico, elimina los saltos de línea internos antes de importar.

Validación de contenido con una hoja de cálculo

Abre el CSV en Excel o Google Sheets (importando, no con doble clic) y aplica filtros a cada columna: los valores atípicos saltan a la vista (un precio de 0, una fecha del año 1900, un email sin @).

Duplicados: ordena por la columna clave (email, SKU, DNI) y busca repetidos, o usa la función de «quitar duplicados» sobre una copia. Un CSV con 200 emails duplicados genera 200 envíos dobles.

Tipos y rangos: verifica que las columnas numéricas no contengan texto («N/D», «-»), que las fechas sean fechas de verdad y que los códigos (postales, teléfonos) conserven sus ceros a la izquierda tratándolos como texto.

Casos reales: qué revisar según el destino

Tienda online (productos): precios mayores que 0, stock numérico, SKU únicos, URLs de imagen accesibles, categorías existentes en la tienda. Un SKU duplicado puede fusionar dos productos distintos.

Email marketing (contactos): emails con formato válido, sin duplicados, columna de nombre separada del apellido si la plantilla la usa, y consentimiento documentado. Nunca importes listas compradas: además de ineficaz, es ilegal en la UE.

Base de datos o CRM: claves únicas, fechas en formato ISO, campos obligatorios sin vacíos y longitud máxima respetada (un nombre de 200 caracteres romperá un campo de 100). Pide al destino su plantilla o especificación antes de preparar el archivo.

Si el archivo viene mal de origen

Cuando el CSV lo genera otro sistema y viene roto (delimitadores inconsistentes, codificación mezclada), no lo arregles a mano fila por fila: pide al origen que lo regenere con los parámetros correctos (UTF-8, delimitador definido, entrecomillado estándar).

Si no puedes pedirlo, repara con herramientas: un editor como VS Code detecta y convierte codificaciones; OpenRefine limpia y normaliza datos masivamente; y un script corto puede re-delimitar un archivo consistente.

Documenta los defectos encontrados y la reparación aplicada. Si el archivo se regenera cada semana (un feed de productos, por ejemplo), automatiza la validación para no repetir el trabajo manual cada vez.

Herramientas gratuitas mencionadas

Preguntas frecuentes

¿Cuál es el error más frecuente en un CSV?

El delimitador incorrecto o inconsistente: el archivo usa comas pero el importador espera punto y coma, o algún campo contiene el delimitador sin ir entre comillas. Se detecta abriendo el archivo en un editor de texto y contando los separadores por línea.

¿Cómo detecto filas con distinto número de columnas?

Importa el CSV en una hoja de cálculo y busca filas donde los datos «se desplazan» a columnas vecinas. Muchos importadores también informan de la línea problemática si activas su modo de validación antes de la importación real.

¿Debo validar también un CSV que genero yo?

Sí, sobre todo la primera vez que lo importas a un destino nuevo. Tu generador puede usar una codificación o un formato de fecha distinto al esperado. Una validación de diez minutos evita una importación fallida.

¿Qué hago si la importación falla a mitad?

No reintentes a ciegas: primero averigua cuántas filas se importaron y elimínalas o márcalas para no duplicarlas al reimportar. Luego corrige el archivo, valida de nuevo e importa solo lo que falte, o limpia todo y empieza de cero.

En resumen

Validar un CSV es recorrer la lista: codificación, delimitador, cabecera, columnas constantes, comillas, tipos, duplicados y prueba en muestra. Quince minutos de control evitan días de limpieza posterior.

Y si necesitas combinar varios CSV validados en uno solo antes de importarlo, la herramienta gratuita de Tótem los une en segundos: usatotem.com/herramientas-archivos/unir-csv/

Artículos relacionados

Privacidad por diseño. Tus archivos no salen de tu navegador.