Converter JSON para XLSX

É essa a distinção inteira em relação a converter para CSV, e ela decide tudo mais. Um programa quer CSV: ele transmite em fluxo, toda rotina de importação lê, e não carrega formatação nenhuma no caminho. Uma pessoa quer uma planilha que abre com as colunas na largura certa, os cabeçalhos já numa linha de cabeçalho, e os tipos já corretos.

Se o dado vai para um banco de dados, um script ou um pipeline de análise, CSV é a resposta melhor e esta é a página errada. Se vai para um colega que vai olhar, ordenar e acrescentar uma coluna, esta é a certa.

Um CSV não tem tipo nenhum. O Excel abre um chutando um tipo para cada coluna, e é aí que o dano conhecido acontece: zeros à esquerda somem de CEPs e códigos de produto, qualquer coisa parecida com data vira data, e identificadores com mais de quinze dígitos perdem os últimos por causa de ponto flutuante.

Um XLSX declara o que cada célula é, então nada é inferido e nada é reescrito na abertura. Essa única diferença elimina uma categoria inteira de dor de cabeça de suporte, e é o motivo de valer a pena o passo extra em vez de mandar um CSV com uma explicação junto.

Cada registro vira uma linha e cada chave vira uma coluna, com a linha de cabeçalho tirada das próprias chaves. Registros que não compartilham todas as mesmas chaves são reconciliados construindo o conjunto completo de colunas em todo o arquivo e deixando célula vazia onde um registro não tinha nada para colocar.

Essa reconciliação vale conhecer porque explica uma surpresa comum. Converter dez registros para um teste pode produzir uma planilha mais estreita que converter a exportação inteira, simplesmente porque a amostra não continha por acaso os campos mais raros.

O JSON descreve uma árvore e uma planilha é uma grade, então um objeto aninhado é achatado juntando os nomes das chaves no cabeçalho da coluna. Um nível produz uma planilha que qualquer um consegue ler; dois níveis geralmente ainda vai bem.

Além disso degrada de um jeito óbvio assim que você olha: os cabeçalhos ficam longos, a planilha fica muito larga, e a maioria das células na maioria das linhas fica vazia, porque registros diferentes se aninham de forma diferente. Se uma conversão produz sessenta colunas a partir do que parecia uma exportação simples, isso é a forma do dado, não um defeito — e um sinal de que o JSON provavelmente deveria continuar sendo JSON.

Um pedido com cinco itens de linha, um post com uma lista de tags, uma pessoa com vários endereços anteriores — nenhum desses tem uma representação correta numa linha só. As três respostas disponíveis são uma coluna por posição, uma coluna com os valores unidos, ou uma linha por elemento, e cada uma quebra alguma coisa.

Quando arrays carregam o significado, faça o que um banco de dados faria: produza uma planilha para os registros pai e outra para os filhos, ligadas por um identificador. É mais trabalho que uma conversão só, e é a única versão que quem usa planilha consegue de fato entender.

O arquivo que o ChatGPT, o Claude ou um painel de API entrega é JSON porque é isso que uma máquina lê, e a maioria de quem recebe um não tem ferramenta nenhuma que abra de forma útil. Uma planilha é a resposta realista: o XLSX declara seus tipos, então timestamps continuam timestamps e IDs numéricos longos não são silenciosamente reescritos em notação científica do jeito que um CSV aberto no Excel reescreveria.

Funciona bem para as partes planas — registros de uso, linhas de cobrança, listas de mensagens com uma entrada por linha. Funciona mal para o próprio arquivo da conversa, que é uma árvore de nós de mensagem em vez de uma tabela, e achatar isso produz colunas com nomes de caminho que ninguém quer ler. Converta a parte que você realmente precisa em vez da exportação inteira.

Olhe a planilha, rapidamente. Duas coisas valem conferir sempre: se as colunas de identificador leem como texto em vez de terem sido formatadas em número, e se as colunas de data parecem datas em vez de números de cinco dígitos.

E confira o que de fato tem ali. Uma exportação JSON de uma API contém todo campo que a API retorna, inclusive identificadores internos, flags e ocasionalmente campos que ninguém sabia que existiam. Uma planilha torna tudo isso visível de um jeito que um arquivo JSON não torna, o que é bom de descobrir antes de o arquivo sair da sua organização, não depois.

A conversão roda na aba do navegador, no seu próprio processador. O arquivo nunca é enviado a lugar nenhum, não há conta nem limite diário, e o teto é 100 MB por arquivo.

Isso é mais relevante aqui do que na maioria das conversões. Uma exportação JSON quase sempre é a saída bruta de um sistema — registro de cliente, pedido, envio de formulário, conta de usuário — e entregar isso a um conversor de terceiros significa entregar exatamente o dado pelo qual uma organização responde. Não enviar a lugar nenhum é a forma mais simples de não ter que confiar em ninguém com isso.