Um programador, uma API de cobrança (Stripe, Shopify, Firebase) ou uma exportação de banco de dados lhe entregou um arquivo `.json` cheio de chaves `{}` e objetos aninhados. O financeiro ou a diretoria pede com urgência essas informações em uma planilha do Microsoft Excel, com colunas limpas e os acentos no lugar.
Transparência Radical DataKorex: Na equipe de engenharia da DataKorex, criamos cada utilitário com execução 100% no cliente. Em uma consultoria de dados, sabemos que enviar um JSON com vendas, e-mails de clientes ou transações bancárias a um conversor externo é uma falha grave de segurança. Este mecanismo achata e converte o seu JSON em CSV 100% dentro da memória RAM do seu navegador, por $0 USD.
Como usar JSON para CSV passo a passo?
- 1. Cole o seu JSON ou envie um arquivo .json: Aceita tanto listas de objetos quanto objetos individuais com propriedades aninhadas.
- 2. Escolha o separador (vírgula ou ponto e vírgula): Use ponto e vírgula (;) para o Excel em português do Brasil ou vírgula (,) para o padrão internacional.
- 3. Baixe o arquivo .CSV ou copie a tabela: Veja a prévia das colunas e baixe o arquivo com codificação UTF-8 BOM para que o Excel respeite os acentos.
A conta dos passos: método tradicional vs. KorexTools
Tentar abrir um JSON no Excel ou programar um script (4 dores de cabeça)
- Abrir o Excel > Dados > Obter Dados > De JSON.
- Descobrir que as colunas aninhadas aparecem como `[Record]` ou `[List]` e ter de expandi-las uma a uma no Power Query.
- Ou usar um conversor web básico que baixa um CSV em que "São Paulo" aparece como "São Paulo" ao abrir no Excel.
- Expor dados privados dos clientes da sua empresa no servidor de um terceiro.
Com o Converter JSON para CSV Online do KorexTools (2 segundos e Excel perfeito)
- Cole a sua lista ou resposta JSON na caixa superior.
- Clique em "Converter JSON → CSV (Excel)" para ver a tabela achatada na hora.
- Clique em "Baixar Arquivo .CSV (Excel)", com codificação UTF-8 BOM pronta para o duplo clique.
Por que você nunca deve enviar arquivos JSON de clientes a conversores na nuvem
Quando você exporta dados de uma API, de um banco MongoDB, do Firebase, da Shopify ou do Stripe em formato JSON, o arquivo costuma conter nomes, e-mails, telefones e valores de cobrança. Colar essas informações em sites tradicionais envia os seus registros a servidores de terceiros.
O conversor de JSON para CSV do KorexTools processa 100% do arquivo na memória local do seu navegador. Além disso, achata automaticamente objetos aninhados (`cliente.endereco.cidade`) em colunas individuais e injeta a marca UTF-8 BOM para que, ao abrir o CSV no Microsoft Excel em português, todos os acentos e cedilhas apareçam perfeitos.
Recursos avançados para analistas e desenvolvedores
- Achatamento automático (flattening) de objetos JSON com vários níveis.
- Seletor de delimitador: vírgula (,), ponto e vírgula (;) para o Excel em português ou tabulação (TSV).
- Codificação UTF-8 com BOM integrada para evitar caracteres quebrados no Excel.
O critério que quase ninguém avalia: por que o Excel quebra os acentos ("ã") se o CSV não leva os 3 bytes do BOM UTF-8
A maioria dos conversores de JSON para CSV criados por programadores nos Estados Unidos exporta o arquivo em UTF-8 puro, sem cabeçalho. Quando você abre esse arquivo com duplo clique no Microsoft Excel em português, o Excel presume a codificação antiga Windows-1252 e destrói todas as palavras com acento ou cedilha (mostrando `"Ação"` ou `"São Paulo"`). Na DataKorex injetamos no início do arquivo a marca de ordem de bytes `\uFEFF` (UTF-8 BOM), que manda o Excel abrir a tabela com acentuação perfeita desde o primeiro segundo.
Conversor de JSON para CSV na nuvem vs. KorexTools local
| Característica | Conversores na nuvem | KorexTools local |
|---|---|---|
| Privacidade de bases de dados (LGPD) | Risco alto (envio a servidor) | 100% seguro (nenhum envio) |
| Acentos e ç ao abrir no Excel | Costuma sair distorcido (ç) | Perfeito graças ao UTF-8 BOM |
| Limite de linhas ou megabytes | Limitado a 1 MB ou 500 linhas | Sem limites artificiais |
O que o Converter JSON para CSV Online NÃO resolve (honestidade radical)
- Não corrige erros de sintaxe em um JSON quebrado: se faltar fechar uma chave `}` ou sobrar uma vírgula no final, você precisa corrigir para que seja um JSON válido.
- Se um objeto contém uma lista interna de objetos complexos, ela é serializada como texto JSON dentro da célula, para não duplicar as linhas da tabela principal.
- Não cria fórmulas nem gráficos dinâmicos `.xlsx`: entrega o arquivo universal `.csv`, compatível com Excel, Google Planilhas, Power BI e bancos SQL.
Riscos de privacidade e erros comuns que você deve evitar
Os despejos JSON de APIs costumam incluir tokens, e-mails, telefones e valores de compra (dados regulados pela LGPD). Ao executar `JSON.parse()` localmente na sua aba, nenhum servidor externo tem acesso à estrutura dos seus dados.
- Colar um trecho de código JavaScript com comentários `//` ou chaves sem aspas duplas: lembre que o padrão JSON exige aspas duplas nos nomes das propriedades (`"id": 1`).
- Abrir o CSV em um bloco de notas antigo e salvá-lo de novo mudando a codificação antes de abrir no Excel.
Perguntas frequentes
Por que no Excel em português as colunas aparecem todas juntas se uso vírgula?
Porque no Windows configurado em português do Brasil, o Excel usa o ponto e vírgula (;) como separador de colunas. Selecione a opção "Ponto e vírgula (;)" na nossa ferramenta e o arquivo abrirá separado automaticamente.
O que acontece se o meu JSON tiver objetos dentro de objetos?
O nosso algoritmo os achata automaticamente usando notação de ponto (por exemplo, `usuario.nome` e `usuario.cidade`), para que cada dado tenha a sua própria coluna.
O que eu faria se estivesse no seu lugar
«Na DataKorex trabalhamos com integrações de dados todos os dias. Colocamos o cabeçalho UTF-8 BOM e o achatador recursivo de chaves aninhadas nesta ferramenta porque cansamos de ver o Excel quebrar os acentos ou deixar `[object Object]` nas células.» — Equipe de Engenharia da DataKorex.