CSV para JSON: o cuidado com acentos, zeros e números de planilha

Uma loja exporta produtos em CSV para integrar o estoque a outro sistema. O arquivo abre normalmente na planilha, mas os códigos que começam com zero desaparecem quando são tratados como números. Conversão de formato é também uma decisão sobre tipos de dados.

Descubra o separador correto

CSV pode usar vírgula, ponto e vírgula ou outros delimitadores. Uma descrição com vírgulas dentro de aspas precisa continuar sendo um único campo. Antes de usar Converter CSV JSON, verifique se os cabeçalhos foram interpretados como colunas e se as linhas contêm a mesma quantidade de valores esperados.

Em arquivos brasileiros, a vírgula decimal pode complicar a interpretação. Valores financeiros precisam ter convenção clara; simplesmente trocar pontuação no conteúdo inteiro pode corromper descrições e endereços.

Identificadores não são quantidades

CEP, matrícula e código de produto podem parecer números, mas muitas vezes devem permanecer como texto. Preserve zeros à esquerda e confira células vazias: vazio, null e a ausência da propriedade são situações diferentes para uma API.

Verifique por amostragem inteligente

Em vez de conferir apenas a primeira linha, compare registros no início, no meio e no fim. Escolha também um registro com acento, um com aspas e outro com campos faltando. Conte quantos itens existem no JSON final e compare com as linhas válidas do CSV. Guarde o CSV de origem para poder repetir a conversão após corrigir uma regra.

Verifique as linhas que fogem do padrão

Uma tabela pequena parece converter perfeitamente porque as primeiras linhas são simples. O problema aparece no registro que contém uma descrição entre aspas, uma quebra de linha dentro da célula ou um nome com acento. Esses casos são o verdadeiro teste de um importador de CSV. Depois de converter, selecione exemplos atípicos e compare o conteúdo completo, inclusive espaços e pontuação que tenham significado.

Se a primeira coluna é um identificador como “000184”, não permita que uma conversão automática a transforme em 184. Para importações repetidas, documente o separador, a codificação de texto e a interpretação de valores vazios. Um pequeno arquivo de amostra com situações difíceis ajuda a validar ajustes futuros. Antes de substituir os dados em produção, faça uma importação de teste que possa ser descartada sem afetar registros existentes.