Convertir CSV a JSON: guía práctica y errores a evitar

CSV es el idioma de las hojas de cálculo; JSON es el idioma de las aplicaciones web y las API. Tarde o temprano tendrás que pasar datos de uno a otro: para importar un listado de productos, cargar una base de datos o alimentar un script. La conversión parece trivial, pero hay algunos detalles que deciden si tus datos llegan intactos.

Cómo un CSV se convierte en JSON

Un archivo CSV es una tabla. La primera fila suele contener los nombres de las columnas:

id,name,city,zip
1,Ana,Vilnius,01100
2,Ben,Austin,73301

La estructura JSON más habitual es un array de objetos: un objeto por fila, con los nombres de las columnas como claves:

[
  { "id": 1, "name": "Ana", "city": "Vilnius", "zip": "01100" },
  { "id": 2, "name": "Ben", "city": "Austin", "zip": "73301" }
]

Eso es lo que genera por defecto el convertidor de CSV a JSON.

Error 1: números que no son números

Fíjate en que id se convirtió en número, pero zip se quedó como texto. Es intencionado. Los códigos postales, los números de teléfono, los números de cuenta y los códigos de producto empiezan a menudo por cero. Si tratas 01100 como un número, se convierte sin avisar en 1100: un fallo que puede pasar desapercibido durante meses.

FileCrafty decide los tipos por columna: una columna solo se convierte en números si todos sus valores son números limpios. En cuanto un valor tiene un cero a la izquierda o no es numérico, toda la columna se queda como texto.

Error 2: el delimitador equivocado

Los archivos «separados por comas» no siempre se separan con comas. Excel, en muchas configuraciones regionales europeas y latinoamericanas, guarda los CSV con punto y coma, porque allí la coma es el separador decimal. Los archivos separados por tabulaciones (TSV) también son habituales. El convertidor detecta el delimitador automáticamente, así que 1;Ana;Vilnius se divide correctamente.

Error 3: comas y comillas dentro de los valores

Un valor como "Smith, John" contiene una coma, por eso va entre comillas en el CSV. Las comillas dentro de un valor se duplican: "He said ""hi""". Las conversiones ingenuas que simplemente separan por comas rompen estas filas. Un analizador de CSV como es debido —como el del convertidor— gestiona los campos entre comillas, las comas incrustadas e incluso los saltos de línea dentro de una celda.

Error 4: celdas vacías

Una celda vacía puede significar «sin valor» o «texto vacío». En JSON son cosas distintas: null frente a "". Averigua cuál espera el sistema al que vas a importar los datos y revisa algunos registros después de convertir.

En sentido contrario

¿Necesitas convertir la respuesta de una API en una hoja de cálculo? JSON a CSV aplana los objetos anidados en columnas como address.city, y JSON a Excel te da directamente un archivo .xlsx. Para revisar u ordenar un JSON antes de usarlo, pégalo en Formatear JSON: te indica la línea y la columna exactas de cualquier error de sintaxis.

Tus datos siguen siendo privados

Los listados de clientes y las exportaciones suelen contener datos personales. El convertidor funciona por completo en tu navegador, así que el archivo nunca se sube a ningún servidor.

Respuesta rápida

Suelta tu archivo en CSV a JSON, revisa la vista previa y descárgalo. Los ceros a la izquierda, los puntos y coma y las comas entre comillas se gestionan por ti.