Converter CSV
para JSON

O RFC 4180 é o mais perto que existe de uma especificação de CSV, mas a maioria dos arquivos CSV reais foge dela. As regras oficiais: separador vírgula, fim de linha CRLF, aspas duplas em campos com vírgulas ou quebras de linha, e uma aspa dupla dentro de um campo entre aspas é escapada com duas aspas ("").

O BOM (byte order mark, EF BB BF no UTF-8) é adicionado pelo Excel ao salvar CSV em UTF-8 e quebra parsers simples com frequência — o nome da primeira coluna vira \uFEFFid em vez de id. Se a primeira chave aparecer estranha no JSON, salve o CSV de novo como UTF-8 sem BOM ou renomeie essa chave depois de converter.

Codificação: o Excel no Windows costuma usar Windows-1252 ou UTF-16 LE, não UTF-8. Salvar um CSV com acentos no Excel e importar em uma API que só aceita UTF-8 é a origem clássica do texto quebrado João. Converta para UTF-8 no Excel em Salvar Como → CSV UTF-8 ou abra o arquivo em um bom editor de texto para confirmar a codificação antes de converter. No Brasil, o Excel costuma salvar com ponto e vírgula como separador — a detecção automática resolve isso.

Fim de linha varia: ferramentas do Windows usam \r\n e o Unix usa \n. O ConverterUp aceita os dois e ignora linhas vazias, então arquivos de qualquer ferramenta atual convertem sem problema.

Com cabeçalhos ativados, a primeira linha vira nome das propriedades e cada linha seguinte vira um objeto: [{"id":"1","nome":"Ana"},…]. É o formato padrão que a maioria das APIs espera. Com cabeçalhos desativados, cada linha vira um array ([["1","Ana"],…]) — útil para dados por posição ou quando o CSV não tem cabeçalho.

Os nomes das colunas são usados como estão, sem os espaços das pontas. Se você precisa de chaves em camelCase ou snake_case, passe a linha de cabeçalho pelo conversor de maiúsculas e minúsculas antes.

Dados CSV são planos por natureza; quem consome JSON muitas vezes quer objetos aninhados. O ConverterUp gera objetos planos — uma coluna chamada endereco.cidade vira a chave "endereco.cidade" — então monte estruturas aninhadas no seu código ou com uma ferramenta como o jq depois de converter.

Todos os valores saem como string, o que preserva zeros à esquerda (CEPs, telefones, SKUs) e evita a armadilha do 0.1 + 0.2 no JavaScript. Converta números, booleanos e datas no seu código depois de carregar os dados, quando você já sabe o tipo real de cada coluna.

Vírgulas dentro dos valores: "Silva, João" precisa estar entre aspas duplas. Se o CSV de origem tem vírgulas sem aspas dentro dos valores (um erro comum em arquivos editados à mão e em exportações antigas), cada linha fica com o número de colunas errado — experimente o delimitador ponto e vírgula ou tabulação, comuns em exportações brasileiras.

Quebras de linha dentro de células: valores com várias linhas (endereços, comentários) são CSV válido entre aspas, mas o ConverterUp lê o arquivo linha por linha, então uma quebra dentro da célula começa uma nova linha. Troque essas quebras por espaço na planilha antes de exportar.

Aspas sem escape: um valor com uma " dentro precisa duplicá-la ("Ele disse ""oi"""). Alguns exportadores usam barra invertida ("Ele disse \"oi\""), o que é inválido no RFC 4180 — exporte de novo com aspas padrão se os valores saírem cortados ou errados.