Conversor de CSV para JSON financeiro
Converta tabelas CSV coladas em registos JSON, preservando texto entre aspas, cabeçalhos originais e valores numéricos incertos.
Como funciona
Cole uma tabela com uma linha de cabeçalhos e linhas de dados. O analisador verifica os separadores suportados e processa separadores citados, aspas escapadas e quebras de linha dentro de células entre aspas.
O conversor associa apenas aliases normalizados exatos para data, símbolo, tipo, quantidade, preço e valor. Os outros cabeçalhos permanecem inalterados. Aliases repetidos que corresponderiam ao mesmo campo mantêm os cabeçalhos originais e geram um aviso.
Data, símbolo, tipo e outros campos de texto permanecem como cadeias de texto. Os valores de quantidade, preço e valor só se tornam números quando todos os valores não vazios da coluna são decimais simples, finitos e seguros. Caso contrário, a coluna permanece como texto e o conversor explica porquê.
Reveja o resumo das colunas, os avisos e o JSON antes de utilizar o resultado. Esta ferramenta não reconcilia transações, não valida exportações de corretoras, não converte moedas e não interpreta regras de investimento ou fiscais.
Passo a passo
- Cole uma tabela CSV com cabeçalhos e dados
- Reveja as associações das colunas e os avisos
- Verifique e copie os registos JSON
Exemplo resolvido
A entrada apresentada inclui um símbolo com zero inicial e uma coluna de notas com uma vírgula, aspas duplicadas e uma quebra de linha. O teste unitário analisa esta mesma entrada.
O resultado mantém symbol como 00123, converte quantity em 2 e price em 12.5, e preserva a nota exatamente como aparece, incluindo o texto em inglês, a pontuação e a quebra de linha. O conversor não traduz o conteúdo das células.
Quando utilizar este conversor
Use este conversor quando outro programa precisar de registos JSON a partir de uma tabela CSV colada. Foi concebido para converter formatos, não para analisar transações.
Antes de utilizar o resultado, compare o resumo das colunas e o número de linhas com a tabela original e confirme o esquema do sistema de destino.
Erros comuns
Não trate um nome de campo mapeado como verificação dos dados de origem. Por exemplo, um valor mapeado para preço é copiado da coluna de origem correspondente; não é verificado em relação aos preços de mercado.
Não importe o JSON antes de verificar contagens de linhas, cabeçalhos não mapeados, avisos, unidades e o esquema necessário do sistema receptor. Os símbolos de moeda e os separadores decimais de localidade são mantidos como texto em vez de interpretados.
Regras de análise e suposições
Analisar registos respeitando o formato CSV e os campos entre aspas
Escolher um separador compatível: vírgula, ponto e vírgula, tabulação ou barra vertical
Associar aliases exatos e normalizados dos cabeçalhos
Converter uma coluna de quantidade, preço ou valor apenas se todos os valores não vazios forem decimais simples e seguros
Serializar os registos como JSON
Os campos de texto e as colunas desconhecidas são mantidos como texto. Se uma coluna numérica reconhecida contiver um valor que não seja um decimal simples seguro, por exemplo um valor malformado ou com moeda, todos os valores não vazios dessa coluna permanecem como texto e é apresentado um aviso. As células vazias continuam a ser cadeias vazias e não afetam a conversão numérica. Não se infere moeda nem formato local de datas.
Limitações e suposições
O analisador aceita até 1 000 000 de caracteres e 10 000 registos. Suporta campos separados por vírgula, ponto e vírgula, tabulação ou barra vertical, com texto entre aspas. Nem todos os formatos CSV ou ficheiros de corretoras são suportados. É necessária uma linha de cabeçalho com nomes normalizados únicos e o mesmo número de campos em cada registo. Apenas os nomes alternativos exatos são associados aos campos conhecidos. As datas e o texto ficam inalterados. Apenas valores decimais simples são convertidos em números; valores incertos ficam como texto. O conversor não determina moedas ou impostos, nem verifica dados de mercado ou reconcilia transações. O CSV colado fica guardado no navegador deste dispositivo.
Termos chave
- Delimitador
- Uma vírgula, ponto e vírgula, tabulação ou barra vertical que separa campos fora de uma célula entre aspas.
- Cabeçalho mapeado
- Um cabeçalho que corresponde exatamente a um alias após normalizar maiúsculas, espaços e pontuação.
- Valor numérico seguro
- Um valor não vazio aceite como decimal finito com precisão numérica segura.
Perguntas relacionadas
Um analisador CSV converte linhas e colunas em registos JSON, mantendo o texto original disponível. Não reconcilia transações nem calcula o desempenho dos investimentos.
Use este conversor quando precisar de registos JSON para um programa ou para analisar dados. Confirme os nomes dos campos e os tipos de valores esperados pelo sistema de destino antes de importar o resultado.
Perguntas frequentes
Como funciona a detecção de delimitador?
O conversor avalia separadores de vírgula, ponto e vírgula, tabulação e barra vertical, respeitando os campos entre aspas. Um separador dentro de uma célula entre aspas não divide a célula. Quando vários separadores produzem tabelas igualmente plausíveis, o conversor relata ambiguidade em vez de escolher uma silenciosamente.
Como são tratadas aspas e quebras de linha?
Os campos entre aspas podem conter separadores, quebras de linha e aspas escapadas ao duplicar cada aspa. Todos os registos têm de ter o mesmo número de campos. Uma aspa não fechada ou mal colocada, ou uma linha com número diferente de campos, gera um erro com o número da linha.
Quais cabeçalhos são mapeados para campos padrão?
Os aliases exatos dos cabeçalhos são comparados em inglês: Date, Trade Date, Settlement Date, DateTime ou Time correspondem a date; Symbol, Ticker, Instrument ou Security a symbol; Type, Action, Transaction Type ou Side a type; Quantity, Qty, Shares ou Units a quantity; Price, Unit Price, Share Price ou Rate a price; Amount, Total, Value, Proceeds ou Net Amount a amount. Os restantes cabeçalhos mantêm o nome original. A correspondência é exata, por isso Corporate Action não corresponde a price.
Todas as exportações de corretoras são analisadas corretamente?
Não. Este é um analisador geral para tabelas separadas por vírgula, ponto e vírgula, tabulação ou barra vertical com campos entre aspas. Aceita no máximo 1 000 000 de caracteres e 10 000 registros. Ele não reconhece o layout de todos os corretores, não verifica o esquema de um corretor, não reconcilia transações ou aplica regras de conta. Verifique a origem e a saída antes de usar o JSON em outro lugar.
Onde fica guardado o CSV que colei?
A análise do CSV decorre no navegador, e o texto colado fica guardado no armazenamento do navegador deste dispositivo. O analisador desta página não envia o conteúdo do CSV para o servidor da aplicação. Apague o campo se utilizar um dispositivo partilhado.
Ferramentas relacionadas
Esta ferramenta converte um formato de tabela. Uma calculadora de desempenho de portfólio ou ferramenta de lote fiscal responde a uma pergunta diferente e pode exigir dados que este analisador não calcula.