Convertidor de Excel a JSON

Por qué convertir XLSX a JSON no es lo mismo que exportar a CSV

Al hablar de extraer datos de Excel, la mayoría piensa en CSV: un formato plano donde cada fila es una línea de texto y los valores van separados por comas. Pero XLSX no es un fichero de texto, sino un contenedor ZIP que almacena varias hojas de cálculo en XML, junto con metadatos, tipos de celda (número, texto, fecha, booleano), fórmulas y formato enriquecido. Al convertirlo a JSON, el resultado no es una cadena plana, sino una estructura tipada que puede representar números, booleanos y nulos tal cual, sin forzarlos a comillas. Mientras que CSV pierde toda la información de tipo (todo acaba siendo texto), JSON conserva: un 3 en una celda numérica se convierte en un número JSON (3), un VERDADERO booleano en true, y una celda vacía en "". Esto es crucial cuando el destino es una API o un front‑end que necesita tipos reales, no cadenas que después hay que parsear.

Además, JSON organiza los datos como un array de objetos, donde cada fila es un objeto y los nombres de columna se convierten en claves. Así se evita la ambigüedad de las cabeceras en CSV (¿la primera fila tiene nombres? ¿Hay que escapar comas?). Pero ojo: el XLSX original no tiene jerarquía intrínseca — una tabla es plana — por lo que el JSON generado también lo será. No se crean automáticamente estructuras anidadas (como objetos dentro de objetos). Si necesitas anidación, deberás procesar el JSON después.

Cómo funciona la conversión en el navegador

A diferencia de muchas herramientas online que envían tu archivo a un servidor, este conversor trabaja completamente en el lado del cliente. Cuando seleccionas o arrastras un archivo XLSX, el navegador procesa el primer worksheet. No se sube nada a ningún servidor. Esto tiene dos ventajas prácticas: la privacidad de los datos (ideal si trabajas con información sensible, como nóminas o datos de clientes) y la velocidad, ya que no hay latencia de red. El límite de tamaño y de número de filas/columnas se aplica localmente: si el archivo supera el tamaño máximo permitido, el mensaje que verás es «Este archivo es demasiado grande. Usa un archivo inferior a 8 MB.». De forma similar, si la tabla tiene más filas o columnas de las permitidas, aparecerán errores específicos. El proceso es instantáneo en archivos pequeños, pero si se alarga demasiado, la herramienta mostrará «Esta conversión está tardando demasiado. Prueba con un archivo más pequeño.».

Una vez convertido, puedes previsualizar el JSON resultante, ver el número de filas y columnas, el tamaño del archivo de salida y descargarlo. Todo sin abandonar la página.

Limitaciones y reglas importantes

• Solo la primera hoja de cálculo: el conversor ignora cualquier otra hoja del libro. Si tu archivo tiene varias pestañas, solo se procesa la primera. Para convertir otras, deberás extraerlas manualmente o usar otro método.
• Los valores visibles son los que cuentan: las fórmulas no se recalculan. El valor que se exporta es el que tenía la celda la última vez que se guardó el archivo. Por ejemplo, si una celda contiene =A1+B1 y al guardar daba 15, el JSON recibirá 15, no la fórmula. Si modificas A1 después de guardar, el resultado no se actualizará. Esto es un comportamiento esperado, dado que la herramienta no ejecuta el motor de cálculo de Excel.
• El formato visual se pierde: colores de fondo, bordes, negritas, combinación de celdas (merge), anchos de columna, todo desaparece. Solo importan los valores de las celdas. Las celdas combinadas pueden dar lugar a filas con valores faltantes inesperados; conviene revisar el resultado.
• Errores comunes: si el archivo no se puede parsear, verás «Este archivo Excel no se pudo abrir.». Si la primera hoja no contiene filas de datos, aparece «Este archivo no tiene filas de tabla.». Si seleccionas un formato que no sea CSV, JSON o XLSX, el error es «Elige un archivo CSV, JSON o XLSX.». También hay mensajes para casos generales: «No se pudo convertir este archivo.», «Conversión cancelada.».
• Límites de tamaño y de estructura: el archivo no puede exceder 8 MB, y la tabla no puede tener más de 10.000 filas o 200 columnas. Si se supera alguno, verás el error correspondiente.

Mapeo de tipos de celda: de Excel a JSON

Excel almacena cada celda con un tipo. La conversión aprovecha esa información para generar valores JSON con tipos nativos:

Las fechas se convierten a una cadena ISO con la zona horaria UTC. Esto puede no coincidir con el formato regional que veías en Excel. Para mantener la coherencia, conviene tenerlo en cuenta si después vas a trabajar con fechas en JavaScript. El resto de tipos (errores, celdas con fórmula no evaluada) se tratan como texto o se descartan.

Casos problemáticos y cómo evitarlos

• Celdas combinadas (merged cells): Al fusionar varias celdas, solo la superior izquierda conserva el valor; las demás quedan vacías. El conversor no las propaga automáticamente. Si tu tabla usa combinaciones en cabeceras o en columnas de categorías, el JSON resultante tendrá valores nulos donde esperabas datos repetidos. Solución: descombina las celdas antes de convertir, o rellena manualmente los valores en el Excel original.
• Filas completamente vacías: Si una fila no contiene ningún dato, el conversor la omite. Pero si contiene algunos valores sí y otros no, se incluye con null en las celdas vacías. No obstante, una fila que solo tenga espacios en blanco podría ser omitida según la implementación; es mejor limpiar el archivo.
• Columnas ocultas: Las columnas ocultas en Excel no se filtran; se exportan exactamente igual que las visibles. Si el JSON debe contener solo ciertas columnas, hay que ocultarlas en el original o eliminarlas antes.
• Cabeceras con múltiples filas: El conversor asume que la primera fila del worksheet contiene los nombres de columna. Si tienes dos filas de cabecera (una con el título general y otra con los nombres), solo se tomará la primera como nombres, lo que puede dar claves indeseadas como "Ventas" en vez de "Enero". Solución: reducir las cabeceras a una sola fila antes de convertir.
• Formato numérico con separadores: Excel puede mostrar 1.234,56 (formato español), pero el valor subyacente es un número sin formato. El JSON usará la representación decimal estándar 1234.56. No te preocupes por los separadores de miles o decimales; el número es correcto.

Preguntas frecuentes

¿Puedo convertir una hoja que no sea la primera?
No. El conversor procesa exclusivamente la primera hoja del libro. Si necesitas otra, deberás copiar los datos a una nueva hoja que sea la primera o usar otra herramienta.

¿Se conservan las fórmulas o solo el resultado calculado?
Solo el último resultado guardado. Las fórmulas no se evalúan; el valor que tenía la celda en el momento de guardar el archivo es lo que aparece en el JSON.

¿Cómo sé qué límites tiene mi archivo?
La interfaz muestra mensajes claros si el archivo supera el tamaño máximo (8 MB), el número máximo de filas (10.000) o el de columnas (200). Si ves el error, reduce el archivo.

¿Puedo convertir JSON a Excel en la misma página?
Esta página está pensada solo para la conversión XLSX → JSON.

¿Se puede arrastrar un archivo o solo seleccionarlo con el botón?
Ambos métodos están disponibles: arrastrar el archivo al área indicada o usar el selector de archivos. El proceso es el mismo.

¿Qué pasa si mi Excel tiene macros o tablas dinámicas?
Las macros no se ejecutan y las tablas dinámicas se ignoran. Solo se leen los datos estáticos de la primera hoja. Si tu archivo depende de macros para generar valores, deberás precalcularlos y guardar los resultados en celdas normales antes de convertir.