Saltar al contenido

Convertidor de JSON a CSV

Transforma JSON a CSV con copia, vista previa y descarga inmediata.

Usar Convertidor de JSON a CSV

Preparando herramienta de archivos...

Qué puedes resolver con esta herramienta

  • Junta todas las claves que aparecen, aunque no estén en todos los objetos.
  • Escapa comas, comillas y saltos de línea para que el CSV no se rompa.
  • Sin subir archivos: todo ocurre en el navegador.

Antes de empezar

La transformación del contenido se hace localmente en la página. Revisa el resultado antes de descargarlo, copiarlo o importarlo en otros sistemas.

Qué hace Convertidor de JSON a CSV

Convierte una lista de objetos JSON en un CSV listo para abrir en Excel o Google Sheets. Las columnas salen de las claves de los objetos y los valores con comas o comillas se escapan.

Casos de uso habituales

  • Abrir en Excel la respuesta de una API.
  • Pasar un export de una base de datos NoSQL a una tabla.
  • Compartir datos con alguien que no trabaja con JSON.
Guía editorial Calcliq

Guía técnica de aplanamiento e interoperabilidad: De JSON heterogéneo a CSV tabular (RFC 4180)

Domina las técnicas de inferencia de esquemas, unión de claves heterogéneas, normalización de arrays y codificación UTF-8 compatible con Excel.

Desafíos de la transformación de grafos jerárquicos a matrices bidimensionales

Mientras que el estándar JSON (JavaScript Object Notation, RFC 8259) está diseñado para representar árboles de datos jerárquicos, estructuras anidadas y colecciones de objetos donde cada entidad puede tener propiedades distintas o polimórficas, el formato CSV requiere una matriz bidimensional estricta con un número idéntico de columnas para cada una de las filas. En la práctica, al extraer datos de APIs web modernas, bases de datos orientadas a documentos (MongoDB, Firestore) o logs de eventos en tiempo real, es muy habitual encontrar arrays de objetos con claves heterogéneas (por ejemplo, clientes registrados con correo y teléfono frente a clientes corporativos con razón social y CIF). Para transformar estos datos a CSV sin pérdida de información, el algoritmo de Calcliq ejecuta una unión de esquemas previa: analiza la totalidad de los objetos del array, extrae el superconjunto único de claves para la fila de cabecera y rellena con celdas vacías aquellos campos que falten en registros específicos, garantizando una alineación tabular perfecta.
Serialización y reglas de escape de tipos de datos JSON a celdas CSV
Tipo de dato en JSONEjemplo de origenRepresentación en celda CSVRegla de escape aplicadaInterpretación en hoja de cálculo
Cadena simple"Calcliq Tools"Calcliq ToolsSin comillas (directo)Texto sin formato
Cadena con delimitador"Madrid, España""Madrid, España"Entrecomillado obligatorioSe conserva íntegro en una sola celda
Cadena con comillas"Pantalla 24"""Pantalla 24"""Escape por duplicación ("")Muestra comilla tipográfica sin romper columnas
Número entero / flotante450.75450.75Directo (punto decimal)Reconocido como número flotante internacional
Booleano / Nulotrue / nulltrue / (vacío)Literal o celda en blancoBooleano nativo o celda sin valor
Array u Objeto anidado["admin", "ventas"]"[""admin"", ""ventas""]"Serialización JSON entrecomilladaTexto estructurado legible sin fragmentar filas

Fórmulas de inferencia de esquema, completitud y codificación UTF-8

El proceso de normalización de colecciones JSON calcula de forma dinámica el conjunto de cabeceras y evalúa la densidad de la matriz resultante:
Algoritmo de unión de esquemas y métrica de densidad de matriz
Fórmula matemática
Conjunto de cabeceras: K_total = Keys(O_1) ∪ Keys(O_2) ∪ ... ∪ Keys(O_n)
Densidad de matriz (% celdas con datos): D = (Total_valores_definidos / (N_objetos × |K_total|)) × 100
Codificación de salida: UTF-8 con soporte para tildes y caracteres especiales

Una colección de 100 objetos con un superconjunto de 10 claves define una matriz de 1.000 celdas teóricas. Si los objetos contienen 850 valores reales, la densidad de datos es del 85 %, asignando 150 celdas vacías delimitadas adecuadamente sin desplazar ninguna columna.

Ejemplo práctico: Conversión de transacciones de pagos con propiedades heterogéneas

Las plataformas de cobro online (como Stripe o PayPal) devuelven objetos JSON donde los metadatos o los detalles del método de pago varían según el cliente.
Aplanamiento de transacciones bancarias heterogéneas a CSV contable
Ejemplo práctico

Situación: Se desea exportar a CSV para el departamento de contabilidad un lote de tres transacciones JSON donde unas se pagaron con tarjeta (con campo 'tarjeta') y otras por transferencia (con campo 'iban'): [ {"id": "TX-01", "importe": 95.0, "metodo": "tarjeta", "tarjeta": "4242"}, {"id": "TX-02", "importe": 150.0, "metodo": "banco", "iban": "ES1234", "nota": "Factura, urgente"} ]

Paso 1: Extracción del superconjunto de claves únicas: ["id", "importe", "metodo", "tarjeta", "iban", "nota"].
Paso 2: Generación de la línea de cabecera: id,importe,metodo,tarjeta,iban,nota
Paso 3: Fila 1: el campo 'iban' y 'nota' no existen en TX-01, por lo que se generan vacíos:
TX-01,95,tarjeta,4242,,
Paso 4: Fila 2: el campo 'tarjeta' no existe, y 'nota' contiene una coma, por lo que se entrecomilla:
TX-02,150,banco,,ES1234,"Factura, urgente"

Resultado final: El archivo CSV generado tiene exactamente 6 columnas y 2 filas de datos alineadas, listo para importar en Excel o Google Sheets sin errores de formato.

Qué debes tener en cuenta

Estas notas ayudan a interpretar el resultado con prudencia y a evitar usos poco fiables.

Los objetos anidados se escriben como texto JSON dentro de la celda; no se aplanan.
El separador de salida es la coma. Si Excel en español lo abre en una sola columna, usa Datos > Texto en columnas.

Herramientas relacionadas

Preguntas frecuentes sobre Convertidor de JSON a CSV

¿Qué forma tiene que tener el JSON?

Un array de objetos, por ejemplo [{"nombre":"Ana","rol":"SEO"}]. Cada objeto es una fila y cada clave, una columna.

¿Qué pasa si un objeto no tiene una clave?

Esa celda queda vacía en el CSV.

¿Por qué Excel me muestra todo en una columna?

Porque en español espera punto y coma. Abre el archivo con Datos > Desde texto/CSV y elige la coma como delimitador.