Convertir JSON a CSV

Cómo convertir un JSON a CSV

1. Pegar o soltar el JSON. Vale una respuesta pegada, un archivo .json o un NDJSON con un objeto por línea. No se envía nada.
2. Comprobar qué array ha leído. Si la respuesta envuelve los registros, la clave que se ha usado aparece encima de la tabla.
3. Revisar las columnas. Lo anidado sale en columnas con punto, como cliente.nombre; una lista de etiquetas va en una sola celda.
4. Descargar. CSV para un script o una importación a base de datos; .xlsx si lo siguiente es abrirlo en Excel.

Los registros casi nunca están arriba del todo

Un CSV es un rectángulo: columnas fijas y una fila por registro. Una respuesta de API rara vez lo es. Lo normal es {"data": [ … ]}, {"resultados": [ … ]} o un sobre con paginación donde las filas están una clave más abajo. Si se convierte el sobre tal cual, sale una sola fila larguísima.

Esta página busca, entre las claves de primer nivel, el primer array cuyos elementos son objetos, y escribe encima de la tabla el nombre de la clave que ha usado. Da igual cómo se llame en tu API: datos, items o pedidos. Si no hay ningún array, el objeto se trata como un único registro.

Lo anidado se convierte en columnas

• Objetos dentro de objetos. {"cliente": {"nombre": "Lucía", "provincia": "Sevilla"}} da dos columnas, cliente.nombre y cliente.provincia, en vez de una celda con [object Object]. No hay límite de profundidad.
• Listas de valores sueltos. ["urgente","b2b"] se une en una celda: urgente; b2b.
• Listas de objetos. Cada elemento recibe su índice en el nombre de columna: lineas.0.sku, lineas.1.sku. Así cada valor sigue teniendo su sitio.
• Registros con campos distintos. Las columnas son la unión de todos los campos, en el orden en que aparecen por primera vez; lo que falta queda en blanco y nada se corre de columna.

El separador: comas, no punto y coma

El CSV que descarga esta página va siempre separado por comas, con punto decimal y en UTF-8 sin BOM. Es el formato que esperan un script, una base de datos o Google Sheets. No hay opción para cambiarlo.

El Excel configurado en español, en cambio, usa el punto y coma como separador de listas. Si abres ese CSV con doble clic, lo normal es que todo acabe en la columna A y que las tildes salgan rotas, porque sin BOM Excel no sabe que es UTF-8. Dos salidas que funcionan:

• Descarga el .xlsx desde la misma página. Es un libro de Excel de verdad: no hay separador que interpretar y los números llegan como números.
• Si necesitas el CSV, impórtalo desde Datos → Desde el texto/CSV eligiendo coma como delimitador y UTF-8 como origen, en vez de abrirlo con doble clic.

NDJSON también

Los logs y muchos exports masivos son NDJSON: un valor JSON completo por línea, sin array que los envuelva. Como documento entero no es JSON válido; si el texto no se puede analizar de una vez, cada línea se analiza por separado, y encima de la tabla se indica que se ha leído como NDJSON.

Lo que no hace

• No escribe CSV con punto y coma ni con coma decimal.
• No reparte una lista de etiquetas en varias columnas: van juntas en una celda.
• No acepta JSON5: comentarios, comillas simples y comas finales dan error, con la posición.
• La vista previa enseña 200 filas; la descarga las lleva todas.

Cuando es el mismo export cada semana

Las dos o tres primeras veces, una pestaña basta. Cuando el mismo endpoint tiene que acabar en la misma hoja cada periodo, y alguien tiene que darse cuenta de que un campo ha desaparecido, ya no es una conversión. TableDI 2 es una aplicación de escritorio para el trabajo con archivos que se repite cada periodo: guarda tus fuentes, tus reglas y la entrega como un trabajo, y el mes que viene pones los archivos nuevos y lo vuelves a ejecutar. Todo funciona en tu propio equipo.