Convertir CSV
a JSON

El RFC 4180 es lo más parecido a una especificación de CSV, pero la mayoría de archivos CSV reales se desvían de él. Las reglas canónicas: separador de coma, finales de línea CRLF, comillas dobles alrededor de campos que contienen comas o saltos de línea, y una comilla doble literal dentro de un campo entre comillas se escapa como dos comillas dobles ("").

El BOM (byte order mark, EF BB BF para UTF-8) lo añade Excel al guardar CSV con codificación UTF-8, y rompe con frecuencia parsers sencillos: el primer nombre de columna acaba siendo \uFEFFid en lugar de id. Si la primera clave se ve rara en el JSON, vuelve a guardar el CSV como UTF-8 sin BOM o renombra esa clave después de convertir.

Codificación: Excel en Windows suele usar Windows-1252 o UTF-16 LE por defecto, no UTF-8. Guardar un CSV con caracteres acentuados desde Excel e importarlo a una API solo UTF-8 es la fuente clásica del mojibake João. Convierte a UTF-8 con BOM en Excel mediante Guardar como → CSV UTF-8, o abre el archivo en un editor de texto real para confirmar la codificación antes de parsear.

Los finales de línea varían: las herramientas de Windows producen \r\n y las de Unix \n. ConverterUp acepta ambos e ignora las líneas vacías, así que los archivos de cualquier herramienta actual se convierten sin problemas.

Con las cabeceras activadas, la primera fila se convierte en los nombres de propiedad y cada fila siguiente se emite como objeto: [{"id":"1","name":"Ana"},…]. Es el formato estándar que esperan la mayoría de APIs. Con las cabeceras desactivadas, cada fila se emite como array ([["1","Ana"],…]), útil para datos posicionales o cuando el CSV no tiene línea de cabecera.

Los nombres de columna se toman tal cual, sin los espacios de los extremos. Si necesitas claves en camelCase o snake_case, pasa antes la fila de cabecera por el conversor de mayúsculas y minúsculas.

Los datos CSV son planos por naturaleza; los consumidores de JSON a menudo quieren objetos anidados. ConverterUp genera objetos planos (una columna llamada address.city se convierte en la clave "address.city"), así que construye las estructuras anidadas en tu código o con una herramienta como jq después de convertir.

Todos los valores salen como cadena, lo que conserva los ceros a la izquierda (códigos postales, números de teléfono, SKUs) y evita la trampa de coma flotante 0.1 + 0.2 de JavaScript. Convierte números, booleanos y fechas en tu código después de cargar los datos, cuando ya conoces el tipo real de cada columna.

Comas dentro de los valores: "Smith, John" debe ir entre comillas dobles. Si tu CSV de origen tiene comas sin entrecomillar dentro de valores (un bug habitual en archivos editados a mano y en algunas exportaciones heredadas), cada línea tendrá un recuento de columnas incorrecto: prueba con el delimitador punto y coma o tabulación, habituales en exportaciones de Excel en español.

Saltos de línea dentro de las celdas: los valores multilínea (direcciones, comentarios) son CSV válido entre comillas dobles, pero ConverterUp lee el archivo línea por línea, así que un salto dentro de una celda empieza una fila nueva. Sustituye esos saltos por espacios en la hoja de cálculo antes de exportar.

Comillas sin escapar: un valor que contiene un " literal debe duplicarlo ("Dijo ""hola"""). Algunos exportadores usan barra invertida ("Dijo \"hola\""), que no es válido en RFC 4180: vuelve a exportar con comillas estándar si los valores salen cortados o mal.