Conversor de JSON a CSV

CSV (Comma-Separated Values) es un formato tabular sencillo en el que cada fila es un registro y cada columna un campo separado por comas. Convertir JSON a CSV transforma un array de objetos en esa estructura de filas y columnas, lista para abrirse en una hoja de cálculo.

La necesidad aparece cuando tienes datos en JSON, normalmente desde una API, y quieres analizarlos en Excel o Google Sheets, o cargarlos en una base de datos que importa CSV. También sirve para entregar datos a personas que prefieren las hojas de cálculo al código.

La diferencia estructural es importante: JSON es jerárquico y admite objetos anidados, mientras que CSV es plano y bidimensional. El conversor salva esa distancia detectando las claves del JSON como cabeceras y colocando cada valor en su celda correspondiente.

El conversor recorre el array de objetos JSON y detecta automáticamente las cabeceras a partir de las claves. Cada objeto se convierte en una fila y cada clave en una columna, de modo que los valores quedan alineados bajo su campo.

Cuando un objeto contiene otro objeto anidado, el conversor lo aplana usando notación de puntos. Así, una clave direccion con un campo ciudad se convierte en la columna direccion.ciudad. Observa el cambio con un ejemplo:

El conversor también aplica el escapado correcto de CSV: si un valor contiene una coma, comillas o un salto de línea, lo rodea de comillas dobles para que no rompa la estructura de columnas. El resultado es un CSV válido que cualquier hoja de cálculo abre sin errores.

Convertir JSON a CSV resuelve tareas muy frecuentes. La más común es exportar datos de una API a Excel o Google Sheets para analizarlos, filtrarlos o crear gráficos sin escribir código.

También es útil para generar informes a partir de datos JSON. Un CSV se importa con facilidad en herramientas de reporting y en bases de datos, lo que agiliza la carga masiva de registros.

Otro escenario es la migración de datos entre sistemas. Cuando una plataforma exporta en JSON pero otra solo acepta CSV, el conversor hace de puente. Además, acerca los datos a perfiles no técnicos que se manejan mejor con hojas de cálculo que con estructuras de código.

Si necesitas el camino inverso, el conversor de CSV a JSON devuelve los datos a JSON. Y para otro formato jerárquico, el conversor de JSON a XML transforma el mismo origen en XML.

El reto principal al pasar de JSON a CSV es que JSON es jerárquico y CSV es plano. El conversor resuelve esa diferencia aplanando los objetos anidados con notación de puntos, de modo que cada campo profundo obtiene su propia columna sin perder información.

Los arrays dentro de un valor se gestionan agrupando sus elementos en una sola celda, ya que CSV no admite estructuras dentro de una columna. Así se conserva el contenido en una forma que la hoja de cálculo puede mostrar.

Los caracteres especiales reciben un tratamiento cuidadoso. Si un valor incluye una coma, esta se interpretaría como separador de columnas, así que el conversor rodea ese valor de comillas. Las comillas internas se duplican y los saltos de línea se mantienen dentro del campo entrecomillado. Este escapado siguiendo el estándar CSV evita que los datos se desalineen al abrirlos en Excel o Google Sheets.

Convertir JSON a CSV conserva todos los valores, pero implica un cambio de modelo que conviene entender. JSON es jerárquico y CSV es plano, así que la estructura anidada se aplana en columnas con notación de puntos. La información permanece, aunque su forma cambia.

Esto significa que la conversión no es perfectamente reversible de manera automática. Un CSV no distingue por sí solo entre una columna direccion.ciudad y una clave llamada literalmente así, por lo que reconstruir el anidamiento original requiere reglas. Aun así, los valores en sí no se pierden.

Los arrays que se agrupan en una celda y los tipos de dato, que en CSV se guardan como texto, son otros puntos a tener en cuenta. Si tu objetivo es ida y vuelta sin fricción, conviene mantener los datos lo más planos posible. Para volver a JSON puedes usar el conversor de CSV a JSON y luego validar el resultado con el formateador de JSON.