ForHosting KIT · Datos y archivos

JSON a Excel

Entregue a sus compañeros un libro de Excel en lugar de un archivo de datos: los nombres de los campos forman la fila de encabezados, cada registro pasa a ser una fila y los números se guardan como números reales, listos para una tabla dinámica. Paga por uso, sin suscripción.

● EstablePor solicitud + por 1000 filas$0.002
Úselo desde WebAPIEmailTelegramApp pronto

Ejecute esto en nuestros servidores con su cuenta. Las herramientas gratuitas corren en su navegador; esta cobra de su saldo del KIT según el precio de arriba.

un XLSX con formato desde sus datos

Por qué un libro de Excel y no un archivo de datos

Entregar a un compañero de negocio un archivo de datos en bruto es un callejón sin salida: necesita algo que pueda abrir, filtrar y pasar a otra persona sin preguntar qué es una llave. Un equipo de finanzas quiere un libro sobre el que montar una tabla dinámica, un cliente espera un informe que se abra en su hoja de cálculo y un responsable de operaciones quiere un archivo para adjuntar a un correo. Un CSV puede llevar los mismos valores, pero no tiene idea de una celda con tipo, de modo que números y texto se ven iguales. Cuando el archivo es para abrirlo y leerlo, y no para que lo procese otro programa, un libro de verdad es el formato que respeta a quien lo recibe.

Qué queda dentro del archivo

Cada nombre presente en los registros se convierte en un encabezado de la primera fila, en el orden en que aparece por primera vez, y cada registro ocupa una fila debajo. Los valores numéricos se guardan como números reales, así que se pueden sumar, ordenar y usar en una tabla dinámica de inmediato; verdadero y falso pasan a celdas de sí o no, y todo lo demás se guarda como texto. El valor que un registro no tiene deja su celda vacía. El resultado es un libro auténtico con una hoja. La herramienta espera registros planos, así que si un registro contiene una sección anidada, aplane los datos antes de convertirlos.

Por qué XLSX específicamente, y no solo CSV

El CSV puede transportar los mismos valores pero elimina todo lo que hace que una hoja se sienta terminada: no tiene celda tipada, ni ancho de columna, ni estilo distinto para la cabecera, ni soporte para varias hojas. El XLSX, como formato estructurado sobre XML en lugar de texto plano, conserva todo eso, lo cual importa cuando el archivo está destinado a una persona y no a otro programa. Cuando el entregable está pensado para abrirse y leerse, no solo para analizarse, el XLSX respeta a quien lo recibe.

Entregables de finanzas y operaciones

Genere libros con columnas numéricas y de fecha correctamente tipadas que un equipo de finanzas puede llevar directo a una tabla dinámica.

¿El archivo XLSX generado tendrá columnas con formato, o solo datos crudos?

El ancho de columna y el estilo de la cabecera se aplican automáticamente según sus datos, así que el archivo se abre luciendo terminado y no como una exportación cruda.

¿Los números se guardan como números reales en el libro?

Sí. Los valores numéricos pasan a celdas numéricas que se pueden sumar, ordenar y usar en una tabla dinámica, verdadero y falso pasan a celdas de sí o no, y todo lo demás se guarda como texto. No hay que convertir nada a mano al abrir el archivo.

¿Qué pasa si mis registros no tienen todos los mismos campos?

Cada nombre que aparece en algún registro recibe una columna en la fila de encabezados, en el orden en que surge por primera vez, y el registro que no tiene ese valor deja la celda vacía. Ningún registro se pierde por faltarle un campo.

¿Por qué enviar un libro de Excel en lugar de un CSV?

Un CSV lleva los mismos valores, pero no distingue el tipo de cada celda, así que los números pueden llegar como texto y hay que arreglarlos. Un libro conserva el tipo de cada valor y se abre directamente en una hoja de cálculo, algo importante cuando el archivo es para una persona.

¿Qué forma deben tener mis datos?

Una lista de registros planos, uno por cada fila que quiera obtener. Los nombres de los registros forman el encabezado y cada registro llena una fila. Una sección anidada dentro de un registro no se reparte en columnas, así que aplane antes los datos anidados.

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

POSThttps://api.kit.forhosting.com/data/json-to-xlsx

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.

curl -X POST https://api.kit.forhosting.com/data/json-to-xlsx \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rows":[{"producto":"Café","precio":3.5,"stock":12}]}'
{
  "rows": [
    {
      "producto": "Café",
      "precio": 3.5,
      "stock": 12
    }
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "data.json_to_xlsx",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

max_mb25
HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Entregarle un archivo JSON a alguien del negocio es un callejón sin salida: necesita algo que pueda abrir, filtrar y pasarle a un colega sin preguntar qué es una llave. Este endpoint toma su JSON y genera un libro XLSX real, con cabeceras de columna reales, celdas correctamente tipadas y formato aplicado automáticamente, en vez de un muro de texto crudo pegado en la columna A.

La brecha entre una respuesta de API y un entregable

La mayoría de los procesos de negocio terminan con alguien abriendo un archivo, no llamando a un endpoint. Finanzas quiere un libro sobre el que armar una tabla dinámica, un cliente espera un reporte que abra directo en su hoja de cálculo, operaciones quiere un archivo que pueda enviar por correo sin explicar qué es JSON. Enviarles la salida cruda de una API no funciona, y escribir a mano un generador de XLSX que se vea intencional —anchos de columna correctos, celdas tipadas, una cabecera que visualmente lo es— implica una cantidad sorprendente de lógica de formato para algo que debería sentirse trivial.

Cómo se ve realmente el archivo generado

El resultado se abre luciendo cuidado, no un volcado crudo. Envíe JSON a POST /data/json-to-xlsx y la respuesta es un libro donde los nombres de campo se vuelven cabeceras, los campos numéricos se guardan como números reales en lugar de texto que solo parece un número, las fechas usan el tipo de fecha nativo de Excel para que ordenar y filtrar funcionen desde el primer momento, y los anchos de columna se ajustan a un valor sensato según el contenido en lugar del ancho diminuto por defecto que hace ver inacabada a cualquier hoja recién creada.

Los datos anidados reciben una respuesta defendible, no una rota

En lugar de fallar o volcar un bloque ilegible dentro de una celda, las estructuras anidadas se aplanan en columnas claramente nombradas usando la misma lógica de notación de punto que aplicaría a mano un analista cuidadoso, así que un pedido con datos anidados de cliente y envío se convierte en una fila coherente en lugar de una cadena inutilizable de caracteres escapados. El JSON anida objetos y arreglos dentro de un registro con frecuencia, y una hoja de cálculo no puede representar eso de forma nativa.

Dónde encaja en un flujo de reportes

Como la tarea corre de forma asíncrona, funciona bien como el paso final de un pipeline de reportes: reúne registros desde su aplicación, genera el libro aquí, y lo entrega directamente a una bandeja de entrada o unidad compartida sin que un script tenga que gestionar la lógica de formato. Recibe un task_id de inmediato al enviar la solicitud, y el archivo XLSX terminado llega por webhook, listo para enviarse tal cual.

Reportes automáticos para clientes

Convierta datos de una API en un reporte XLSX pulido y entregado según un calendario, sin que alguien tenga que armar la hoja de cálculo manualmente cada vez.

Exportaciones de ventas o inventario

Convierta registros JSON anidados, como pedidos con sus líneas de producto, en un libro legible de varias columnas para un equipo de ventas o de almacén.

Entrega a personas no técnicas

Entregue los resultados de una API a un cliente o socio como un archivo de Excel conocido, en vez de un JSON que no tienen forma de abrir.

¿La API de JSON a Excel conserva los tipos de dato como números y fechas?

Sí, los campos numéricos se escriben como números reales y las fechas usan el tipo de fecha nativo de Excel, así que ordenar, filtrar y usar fórmulas funciona correctamente sin reformatear a mano.

¿Cómo maneja los objetos o arreglos anidados dentro del JSON?

Las estructuras anidadas se aplanan en columnas claramente nombradas usando notación de punto, así que un registro con campos anidados se convierte en una fila legible en lugar de un bloque de texto inutilizable.

¿Hay una prueba gratuita para el endpoint de JSON a Excel?

No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.

¿Puedo generar un archivo XLSX a partir de un arreglo JSON grande?

Sí, envíe el arreglo como una sola solicitud asíncrona; se procesa como una única tarea y devuelve un libro completo.

¿Qué pasa si falla la generación de JSON a XLSX?

La tarea se reintenta automáticamente hasta tres veces, y si aun así falla, recibe un error claro sin cargo por el intento.

¿Cómo recibo el archivo de Excel generado?

Mediante un webhook firmado, recomendado para entrega automatizada, o un enlace firmado válido durante 24 horas para descarga manual.

¿Cuánto cuesta generar un archivo XLSX a partir de JSON?

$0.002 por solicitud, cobrado únicamente por archivos generados con éxito.

Ver la documentación completa del KIT →