Este artigo explica como formatar dados de transações de finanças tradicionais para importação, usando o modelo CSV personalizado (Custom CSV) da Finbooks.

O CSV Custom TradFi da Finbooks é um formato de folha de cálculo específico que aceitamos para importares as tuas transações de finanças tradicionais.

Deves usar este formato se:

O nosso CSV personalizado foi pensado para ser simples e direto. Basta preencheres os detalhes das tuas transações seguindo o nosso modelo, e vais conseguir importar os teus dados de TradFi mesmo que a tua plataforma não seja diretamente suportada.

O formato CSV de TradFi é composto por 13 colunas. A primeira linha contém o cabeçalho do CSV, com o título de cada coluna, e cada coluna tem uma finalidade diferente.

As colunas têm de ser preenchidas de acordo com regras específicas (explicadas nesta secção) e têm de se manter pela ordem correta.

Este será sempre o cabeçalho obrigatório:

Cada linha representa uma única transação e só deve conter os dados relativos a essa transação.

Aqui encontras uma explicação de como cada coluna do CSV deve ser usada e que valores são aceites. Também indicamos quando uma coluna deve ser preenchida, quando não deve, e quando é opcional, consoante o tipo de transação que queres representar.

Preencher esta coluna é sempre obrigatório. Este campo é necessário para identificar o tipo de instrumento financeiro envolvido na transação e para determinar que regras contabilísticas e fiscais se aplicam.

Se a transação envolver tanto moeda fiduciária como outra classe de ativo, por exemplo, ao comprar ou vender uma ação, este campo tem sempre de ser preenchido com a classe de ativo do instrumento financeiro diferente da fiat.

Por exemplo:

A Asset Class só deve ser definida como Fiat Currency quando a transação envolver exclusivamente moedas fiduciárias, como:

Os valores aceites são:

Preencher esta coluna é sempre obrigatório. Esta coluna é usada para explicar se, na transação, recebeste um ativo, pagaste ou enviaste um ativo, ou trocaste um ativo por outro.

Os valores aceites são:

Este campo é necessário para encontrar o preço de mercado correto relativo ao ativo. É sempre obrigatório, exceto quando o campo Asset Class da transação é CFD.

O formato aceite é o código oficial do mercado ou da praça onde a negociação ocorreu.

Preencher esta coluna é sempre obrigatório. As categorias ajudam a organizar a tua contabilidade e a garantir que o software trata cada transação corretamente para efeitos de relatórios e fiscais.

Os valores aceites são:

Preencher esta coluna é sempre obrigatório. Permite ao software perceber quando ocorreu uma transação. Aqui tens a lista de formatos suportados:

Em que yyyy é o ano, MM é o mês, dd é o dia, hh é a hora, mm são os minutos, e ss são os segundos.

Por exemplo, se uma transação ocorreu a 2 de janeiro de 2024, às 21h45, pode ser importada como:

Insere o ticker do ativo que enviaste. Este campo é obrigatório para transações Outgoing e Trade. Deixa este campo em branco para transações Incoming.

Aqui insere o montante (ou quantidade) do ativo que enviaste. Este campo é obrigatório para transações Outgoing e Trade. Deixa este campo em branco para transações Incoming.

Esta regra aplica-se a todos os campos onde insiras valores numéricos que usem vírgula para indicar casas decimais.

Por exemplo, precisas de importar uma transação incoming de € 2.999,85

Formato de linha errado

Formato de linha correto

Insere o identificador do ativo que recebeste. Este campo é obrigatório para transações Incoming e Trade. Deixa este campo em branco para transações Outgoing.

Os formatos aceites são os mesmos do Outgoing Asset.

Aqui insere o montante (ou quantidade) do ativo que recebeste. Este campo é obrigatório para transações Incoming e Trade. Deixa este campo em branco para transações Outgoing.

Aqui insere o ticker da moeda que usaste para pagar as taxas. Este campo é opcional para todas as transações; só o deves preencher se pagaste taxas.

Aqui insere o montante da taxa que pagaste. Este campo é opcional, mas torna-se obrigatório se o Fee Currency estiver preenchido.

Este campo é opcional, mas tem de ser usado sempre que uma transação precise de ser explicitamente ligada a um ativo subjacente específico. O Position ID permite ao sistema associar corretamente movimentos que estão economicamente ligados ao mesmo instrumento financeiro.

Em particular, deve ser usado para:

Por exemplo, se recebes um dividendo em USD da Apple, tens de incluir um identificador estruturado no Position ID para que o montante fiat recebido seja corretamente ligado à ação subjacente.

Nestes casos, o Position ID tem de seguir este formato: Ticker, Asset Class, Market.
Ex.: AAPL, Stock, US

Usar esta combinação estruturada garante que as transações relacionadas são claramente identificadas, agrupadas de forma consistente e processadas de acordo com as regras contabilísticas corretas.

Este campo pode ser usado para inserir notas sobre uma transação. Os comentários aqui inseridos são mostrados nos detalhes da transação depois de importados para a Finbooks.

Este campo é sempre opcional.

As colunas que tens de preencher para uma transação Trade são:

Por exemplo, a 01/01/2025 às 13h34m56s compraste 10 AAPL pagando 1500 USD e pagaste uma taxa de 5 USD:

Se estiveres a usar a vírgula como separador decimal:

As colunas que tens de preencher para uma transação Incoming são:

Por exemplo, a 26/12/2025 às 14h41m01s recebeste um dividendo de 50 USD.

As colunas que tens de preencher para uma transação Outgoing são:

Por exemplo, a 13/05/2025 às 10h12 pagaste uma comissão de 1,55 USD.

Se estiveres a usar a vírgula como separador decimal: