Convertidor online gratuito de JSON a CSV

Una hoja de cálculo, un importador de bases de datos o un sistema de generación de informes puede requerir un CSV tabular en lugar de un JSON estructurado. Convertir los datos facilita la edición de registros planos en Excel o LibreOffice Calc y proporciona el diseño esperado por muchas herramientas de importación masiva.

Qué es JSON

JSON (JavaScript Object Notation) es un formato de texto compuesto por objetos, matrices, pares clave-valor, números, cadenas, valores booleanos y null. Las API web, las aplicaciones de navegador, los sistemas de configuración, las bases de datos y los lenguajes de programación suelen producir archivos con la extensión .json.

JSON puede almacenar objetos y matrices anidados, por lo que un registro puede contener varios niveles de datos relacionados. Esta flexibilidad no se adapta directamente a una tabla plana de hoja de cálculo. Un archivo JSON Lines o NDJSON, en el que cada línea es un objeto JSON independiente, también requiere un procedimiento de importación diferente al de un documento JSON estándar.

Qué es CSV

CSV (comma-separated values) representa registros tabulares como filas, con un campo por columna. La primera fila suele contener los nombres de las columnas. Un campo que contenga un delimitador, una comilla o un salto de línea debe escribirse entre comillas; las comillas dentro de un campo entrecomillado normalmente se representan mediante dos comillas.

Excel, LibreOffice Calc, los importadores de bases de datos, el software estadístico y los scripts de procesamiento de datos admiten CSV. Funciona bien para listas planas, filtrado, ordenación e importaciones masivas, pero no conserva de forma nativa objetos anidados, matrices, tipos de datos, fórmulas ni formato de celdas. Las implementaciones de CSV pueden utilizar un punto y coma o una tabulación en lugar de una coma, por lo que se debe comprobar el requisito de delimitador del destino.

Cómo convertir el archivo

Para una conversión puntual, utilice el convertidor de JSON a CSV de 101convert.com de forma gratuita y sin instalar software:

1. Abra el convertidor y cargue el archivo .json o pegue un documento JSON.
2. Si hay opciones de selección o aplanamiento de campos, elija la matriz que contiene los registros y los campos que deben convertirse en columnas.
3. Inicie la conversión y descargue el archivo .csv resultante.
4. Abra el CSV en LibreOffice Calc, Excel u otra aplicación de hoja de cálculo y verifique el delimitador, la codificación de caracteres, los encabezados, el número de filas y algunos valores representativos.

No cargue datos confidenciales o regulados a menos que el servicio esté aprobado para esos datos.

Para conversiones repetibles o privadas, los módulos json y csv de la biblioteca estándar de Python evitan tener que instalar un paquete adicional. Este ejemplo espera una matriz de objetos en el nivel superior:

import csv
import json

with open("input.json", encoding="utf-8") as source:
    records = json.load(source)

if not isinstance(records, list) or any(not isinstance(record, dict) for record in records):
    raise ValueError("Expected a top-level array of objects")

columns = list(dict.fromkeys(
    key for record in records for key in record
))

with open("output.csv", "w", newline="", encoding="utf-8-sig") as target:
    writer = csv.DictWriter(
        target, fieldnames=columns, extrasaction="ignore"
    )
    writer.writeheader()
    writer.writerows(records)

Guarde el código como json_to_csv.py y ejecútelo con python json_to_csv.py. El script conserva el orden en el que aparecen las claves por primera vez, escribe celdas vacías para las claves ausentes y deja sin modificar los valores anidados, que no son adecuados para una conversión a CSV plano. La codificación utf-8-sig añade una marca de orden de bytes UTF-8 que ayuda a algunas versiones de Excel para Windows a detectar texto Unicode; utilice utf-8 sin modificaciones cuando el sistema receptor no acepte una marca de orden de bytes.

Algunas versiones de Microsoft Excel pueden importar JSON mediante Data → Get Data → From File → From JSON. En Power Query, expanda la lista o el registro del nivel superior, expanda los registros anidados en columnas y, a continuación, utilice Close & Load; exporte la tabla resultante con File → Save As y seleccione CSV. Si la versión instalada de Excel no incluye este conector, convierta primero el archivo y abra el CSV mediante su cuadro de diálogo de importación. En LibreOffice Calc, utilice File → Open para abrir el CSV resultante y seleccione UTF-8, el separador requerido y el carácter de comillas correcto.

Limitaciones de calidad y compatibilidad

La entrada más sencilla es una matriz en el nivel superior, como [{"id":1,"name":"A"},{"id":2,"name":"B"}]. Un objeto en el nivel superior puede representar un solo registro, un contenedor que incluye la matriz de registros real o metadatos no relacionados. El convertidor debe identificar la matriz prevista antes de generar filas significativas.

Los objetos y las matrices anidados requieren una política explícita. Se pueden aplanar en columnas como address.city, serializar como texto JSON dentro de un campo CSV entrecomillado o excluir. Los valores de las matrices pueden unirse como texto. Cada convertidor utiliza políticas diferentes, por lo que se deben inspeccionar los campos anidados y varias filas de salida en lugar de comprobar únicamente los encabezados.

CSV no cuenta con una distinción nativa fiable entre números, fechas, valores booleanos y cadenas. El software de hojas de cálculo puede convertir automáticamente identificadores, ceros iniciales, números enteros largos o fechas ISO. Importe las columnas como texto cuando deba conservarse sin cambios su representación original y confirme que los valores vacíos, null y los campos ausentes tengan el significado requerido.

Utilice UTF-8 para los caracteres no ASCII y confirme si el destino espera comas, puntos y comas, tabulaciones, finales de línea CRLF o una marca de orden de bytes. Considere que un CSV no confiable puede ser potencialmente peligroso en el software de hojas de cálculo: los valores que comienzan por =, +, - o @ pueden interpretarse como fórmulas. Inspeccione o neutralice dichos valores antes de abrir el archivo.