Guia · Tempo de leitura: 4 minutos

Por que os dados podem mudar quando você converte CSV e JSON

Proteja zeros à esquerda, vírgulas entre aspas, valores aninhados e importações de planilhas.

Editorial Tierify · 18 de novembro de 2026

001 é um número ou um identificador?

CSV não declara tipos de valor da mesma forma que JSON. Um analisador não pode saber se 001 é uma quantidade ou um código de produto. Tierify CSV a JSON mantém cada célula como uma string para que os zeros à esquerda sejam retidos.

Se você precisar de aritmética posteriormente, converta apenas as colunas relevantes no aplicativo receptor. Abrir um CSV em uma planilha pode acionar a inferência de tipo novamente. Importe colunas de identificadores explicitamente como texto quando sua representação exata for importante.

Vírgulas e quebras de linha dentro de uma célula

A divisão do texto em cada vírgula quebra as células que contêm vírgulas entre aspas. Tierify usa um analisador CSV que entende valores entre aspas e células multilinhas. Uma aspa literal dentro de um campo CSV entre aspas deve ser escapada de acordo com as regras do CSV.

A primeira linha precisa de nomes de colunas distintos e não vazios. Quando as linhas têm contagens de colunas diferentes, os valores podem mudar para os campos errados. O conversor para e relata a incompatibilidade em vez de produzir silenciosamente uma tabela ambígua.

Estruturas aninhadas e números inteiros grandes

CSV é uma tabela retangular, enquanto JSON pode armazenar arrays e objetos dentro de outros valores. Tierify JSON a CSV aceita uma matriz de objetos plana. Achate você mesmo as estruturas aninhadas antes de exportar para poder escolher colunas significativas e evitar a perda de relacionamentos.

JavaScript não pode representar exatamente todos os números inteiros grandes. Mantenha números de pedido e identificadores longos como strings JSON. As chaves JSON repetidas retêm apenas o último valor, portanto, verifique os dados em sua origem antes de confiar em um resultado convertido.

Valores que uma planilha trata como fórmulas

Uma célula CSV começando com caracteres como =, +, - ou @ pode ser interpretada como uma fórmula de planilha. Tierify JSON a CSV adiciona um apóstrofo aos valores que correspondem às suas regras de escape de fórmula.

Esta proteção pode adicionar um caractere à representação exportada. Verifique o sistema receptor antes de usar a saída como troca de dados entre máquinas. Revise o conteúdo da planilha não confiável, independentemente de qual conversor gerou o arquivo.