Achatar JSON para CSV: Como Lidar com Dados Aninhados

O Problema: JSON Aninhado vs. CSV Plano

JSON permite estruturas hierarquicas — objetos dentro de objetos, arrays de arrays, aninhamento ilimitado. CSV e estritamente plano — linhas e colunas, sem hierarquia. Achatar (flatten) e o processo de transformar essa hierarquia em uma tabela plana.

Considere um JSON de pedidos onde cada pedido tem um cliente (com endereco aninhado) e uma lista de itens. Transformar isso em CSV requer decisoes: cada item vira uma linha? O endereco vira colunas separadas? Arrays viram colunas dinamicas?

Estrategias de Achatamento

• Notacao de ponto: Caminhos aninhados viram nomes de coluna: cliente.endereco.cidade. Simples e legivel, mas colunas podem ficar longas.
• Expansao de arrays: Cada elemento do array vira uma nova linha. Um pedido com 3 itens gera 3 linhas com dados do pedido repetidos.
• Colunas indexadas: Arrays viram colunas numeradas: item_0_nome, item_1_nome. Funciona para arrays de tamanho fixo.
• Concatenacao: Arrays viram uma unica celula com valores separados por delimitador: "item1; item2; item3".

Casos de Uso

Exportar dados de APIs REST para analise em Excel ou Google Sheets. Converter logs de aplicacao (JSON Lines) para importar em ferramentas de BI. Preparar dados de MongoDB (documentos JSON) para migracao para bancos relacionais.

No contexto brasileiro, e comum precisar converter dados de APIs de pagamento (PagSeguro, MercadoPago), e-commerce e sistemas SaaS de JSON para planilhas para analise financeira.

Cuidados na Conversao

Dados perdem contexto no achatamento. Uma relacao pai-filho clara em JSON pode ficar confusa em CSV plano. Documente as convencoes usadas (notacao de ponto, expansao de arrays) para que outros entendam a estrutura resultante.

Campos nulos e arrays vazios precisam de tratamento — celulas vazias, "null" como texto, ou omissao da coluna.

Achate JSON para CSV

Nosso Conversor JSON para CSV achata estruturas aninhadas automaticamente com opcoes de configuracao. Cole o JSON e baixe o CSV — gratis e sem cadastro.