Exemplo: pedidos de uma loja com dados de entrega
Uma loja fictícia baixa os pedidos da API da plataforma. Cada pedido traz o cliente aninhado e uma lista de etiquetas; um deles não tem telefone.
[
{"id": 3301, "total": 189.9, "cliente": {"nome": "Paula Mendes", "tel": "+5511900000006"}, "etiquetas": ["presente", "frete grátis"]},
{"id": 3302, "total": 59, "cliente": {"nome": "Caio Prado"}}
]id;total;cliente.nome;cliente.tel;etiquetas 3301;189.9;Paula Mendes;+5511900000006;"presente; frete grátis" 3302;59;Caio Prado;;
Como converter
Cole o JSON
O normal é uma lista de objetos. Um objeto só também funciona e vira uma linha.
Escolha se quer achatar
A opção vem ligada:
{"cliente": {"email": ...}}vira a colunacliente.email. Desligue para deixar cada objeto aninhado como texto JSON numa célula só.Escolha o separador
Para Excel configurado em português, escolha ponto e vírgula, que é o separador que ele espera. Vírgula serve para Google Planilhas e programas em inglês.
Confira e salve
A observação mostra quantas linhas e quais colunas foram encontradas. Copie o CSV ou baixe data.csv. Se o JSON for inválido, o erro diz onde a leitura parou.
Como os casos difíceis são tratados
- Objetos aninhados
- Cada chave interna vira coluna, com o caminho separado por pontos:
cliente.endereco.cidade. - Listas de valores
- Uma lista simples, como etiquetas, é juntada numa célula separada por ponto e vírgula; com o separador ponto e vírgula, a célula vai entre aspas.
- Listas de objetos
- Viram colunas numeradas:
itens.0.produto,itens.1.produtoe assim por diante. - Chaves faltando
- Se um registro não tem uma chave que outros têm, a célula fica vazia; nenhuma coluna se perde.
Perguntas frequentes
Como converter JSON aninhado em CSV?
Deixe ligada a opção de achatar. Cada chave aninhada vira uma coluna, com o nome formado pelo caminho separado por pontos.
Por que dá erro no JSON?
O texto não é JSON válido, e a mensagem mostra onde a leitura parou. Os motivos comuns são aspas simples no lugar de duplas, vírgula sobrando no fim de uma lista ou texto copiado pela metade.
No Excel ficou tudo numa coluna, e agora?
Gere de novo com ponto e vírgula, ou importe pelo menu Dados, Obter Dados, De Texto/CSV, escolhendo vírgula como delimitador e UTF-8 como codificação.
Para onde vão os seus dados
A conversão acontece no seu navegador. O JSON colado, com os dados pessoais que tiver, não sai do seu computador.
Conferido com a ferramenta em