JSON a Excel

JSON a Excel: hacer los datos legibles

JSON es el lenguaje nativo de las APIs modernas, de los sistemas NoSQL, del intercambio cliente-servidor. Pero para análisis humano, reporting y comunicación con stakeholders, Excel sigue reinando. La conversión JSON → XLSX es el puente que permite que data sistémica llegue como planilla legible al gerente, el contador, el auditor.

Qué estructura de JSON esperamos

El JSON ideal para convertir a Excel es tabular:

• Array de objetos: [{...},{...},...]. Cada objeto es una fila, sus claves son headers. Natural para respuestas de APIs REST.
• Array de arrays: [[headers],[row1],[row2]]. Más compacto, menos común pero igualmente válido.

Qué pasa con anidamiento

CSV y XLSX son planos: una celda, un valor. JSON soporta anidamiento arbitrario. Al convertir, los campos que son objetos o arrays se serializan como texto JSON dentro de la celda. Ejemplo:

// JSON:
[{ "id": 1, "direccion": { "ciudad": "Santiago" } }]

// En la celda de Excel:
// columna "direccion" → {"ciudad":"Santiago"}

Funciona pero es feo. Si necesitas datos anidados aplanados, hay dos caminos:

1. Aplanar con script externo antes. Usar jq, Python (pandas.json_normalize) o Node (flatten-js) para convertir direccion.ciudad en columna independiente, y después pasar el JSON plano al conversor.
2. Separar sub-arrays en hojas. Si un objeto tiene productos: [...], puedes hacer una hoja para los objetos principales y otra para los productos con referencia por ID. Este modelado requiere un script con SheetJS que combine lógica propia.

Claves heterogéneas

JSON permite que objetos del array tengan claves distintas:

[
  { "id": 1, "nombre": "Ana", "email": "ana@test.cl" },
  { "id": 2, "nombre": "Luis" }
]

En Excel no hay filas con columnas dinámicas. Nuestra solución: unir todas las claves como headers. El XLSX tendráid, nombre, email; la segunda fila tendrá email vacío.

Preserva toda la información. Si el dataset tiene muchas claves raras en solo algunos objetos, vas a obtener un XLSX con muchas columnas y filas sparse — señal de que el JSON origen no es realmente tabular.

Tipos preservados

Al pasar a Excel:

• Números: como números (sumables). 150 en JSON → número 150 en Excel.
• Booleanos: como TRUE/FALSE (el tipo booleano de Excel).
• null: celda vacía.
• Strings: texto literal, Unicode preservado.
• Fechas en ISO 8601: se exportan como string. Si necesitas que Excel las trate como fecha, selecciona la columna y aplica formato “Fecha”.

Casos de uso

Reportes desde APIs internas. Un dashboard consume una API que devuelve JSON. Para un reporte mensual al CEO conviene un XLSX con los datos en crudo que puedan revisar en Excel sin depender del dashboard.

Datos de Firestore/MongoDB para análisis. Estas DB devuelven JSON nativamente. El equipo de analítica quiere Excel. Conversión directa.

Exportación de formularios web. Un formulario JSON-based (Typeform, Tally, Google Forms export) entrega respuestas en JSON. Para revisar con el equipo comercial, XLSX es el formato.

Debug de respuestas de API. Querés inspeccionar 500 respuestas de una API de integración. JSON crudo es ilegible. En XLSX con filtros y ordenamiento, los patrones saltan a la vista.

Reportes regulatorios. Para reportar a la CMF, SII o SBIF, el formato esperado es a veces Excel. Si tu pipeline trabaja en JSON, la conversión al final es el paso obligado.

Casos en Chile

Responses de APIs bancarias. APIs de BCI, Banco Estado, SBIF exponen JSON. Para reportería interna o envío a auditoría, XLSX es el formato esperado por las áreas de control.

Integraciones con MercadoPago o Transbank.Estas pasarelas devuelven transacciones en JSON. El equipo contable las revisa en Excel para conciliación bancaria.

Datos del SII vía API. Algunos servicios exponen JSON para consulta de DTEs, contribuyentes, documentos. Para cruzar con planillas contables, XLSX es el formato práctico.

Exports de sistemas ERPnext/Odoo. Estos ERPs modernos tienen APIs que devuelven JSON. Para dashboards internos en Excel, la conversión es el paso directo.

Errores comunes

JSON inválido. Si el archivo tiene sintaxis rota (coma extra, llave sin cerrar), nuestro parser falla. Validalo primero con formatear-json.

JSON no es array. Necesitamos array en el nivel raíz. Un objeto suelto {"data":[...]} no funciona directamente — extrae el array interno y pasa solo eso.

Valores anidados como texto feo. Si ves celdas con {"ciudad":...}, tu JSON tiene anidamiento. Aplanalo con script antes.

Fechas como string ISO. Excel las muestra como texto, no como fecha. Selecciona la columna y aplica formato fecha.

Privacidad

Todo el proceso corre en tu navegador. El JSON con tokens de API, respuestas de sistemas internos, datos personales de clientes — ningún byte se envía al servidor. Para cumplir con Ley 19.628, mantener el procesamiento local es parte responsable de la custodia de datos.

Relacionadas

• Excel a JSON — ruta inversa.
• JSON a CSV — si el destino es texto plano.
• Formatear JSON — validar antes de convertir.
• Combinar CSVs — si necesitás unir múltiples datasets.