portfolios.tools

Conversor de CSV para JSON financeiro

Converta tabelas CSV coladas em registros JSON, preservando texto entre aspas, cabeçalhos originais e valores numéricos incertos.

Entrada CSV

Cole uma tabela CSV com uma linha de cabeçalho e pelo menos uma linha de dados.

Entrada CSV testada

symbol,quantity,notes,price
00123,2,"Buy, ""reinvested""
fee",12.50
Saída JSON

Resumo das colunas

Cabeçalho de origem: dateCampo associado: dateTipo de saída: Texto
Cabeçalho de origem: symbolCampo associado: symbolTipo de saída: Texto
Cabeçalho de origem: typeCampo associado: typeTipo de saída: Texto
Cabeçalho de origem: quantityCampo associado: quantityTipo de saída: Número
Cabeçalho de origem: priceCampo associado: priceTipo de saída: Número
[
  {
    "date": "2024-01-01",
    "symbol": "AAPL",
    "type": "BUY",
    "quantity": 10,
    "price": 150
  }
]

Como funciona

Cole uma tabela com uma linha de cabeçalho e linhas de dados. O analisador verifica os separadores compatíveis e processa separadores entre aspas, aspas escapadas e quebras de linha dentro de campos 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 strings. 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 o motivo.

Confira o resumo das colunas, os avisos e o JSON antes de usar 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 tributárias.

Passo a passo

  1. Cole uma tabela CSV com cabeçalho e dados
  2. Confira o mapeamento das colunas e os avisos
  3. Confira e copie os registros JSON

Exemplo resolvido

A entrada exibida inclui um símbolo com zero à esquerda e uma coluna de notas com vírgula, aspas duplicadas e quebra de linha. O teste unitário processa essa 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 usar este conversor

Use este conversor quando outro programa precisar de registros JSON a partir de uma tabela CSV colada. Ele serve para conversão de formato, não para análise de transações.

Antes de usar o resultado, compare o resumo das colunas e a quantidade de linhas com a tabela de origem e confira 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 registros 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 registros 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 um aviso é exibido. As células vazias continuam sendo strings vazias e não afetam a conversão numérica. Não há inferência de moeda nem do formato local de datas.

Limitações e suposições

O analisador aceita até 1.000.000 caracteres e 10.000 registros e suporta separadores de vírgula, ponto e vírgula, tabulação e barra vertical com campos entre aspas. Não cobre todos os dialetos CSV ou exportação de corretores. Requer uma linha de cabeçalho, cabeçalhos normalizados exclusivos e o mesmo número de campos em cada registro. Somente aliases de cabeçalho exatos são mapeados. As datas e o texto permanecem inalterados; a conversão numérica aceita apenas valores decimais simples e preserva valores incertos como texto. O conversor não infere moeda, valida dados de mercado, reconcilia transações ou determina tratamento tributário. O CSV colado é armazenado no armazenamento do navegador neste 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 aceito como decimal finito com precisão numérica segura.

Perguntas relacionadas

Um analisador de CSV converte linhas e colunas em registros JSON, mantendo o texto de origem disponível. Ele não reconcilia transações nem calcula o desempenho dos investimentos.

Use este conversor quando precisar de registros JSON para um programa ou análise de 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 registros precisam ter o mesmo número de campos. Uma aspa não fechada ou mal posicionada, ou uma linha com quantidade 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 demais 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 serão interpretadas 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 o CSV que colei fica armazenado?

A análise do CSV é feita no navegador, e o texto colado fica salvo no armazenamento do navegador deste dispositivo. O analisador desta página não envia o conteúdo do CSV para o servidor do aplicativo. Apague o campo se usar um dispositivo compartilhado.

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.