Neste guia, encontrarás tudo o que precisas de saber sobre quando usar o formato CSV do CryptoBooks e como introduzir corretamente as tuas transações nesse ficheiro.
O que é o CSV personalizado do CryptoBooks?
O CSV personalizado do CryptoBooks é um formato específico de folha de cálculo que aceitamos para importar as tuas transações. Deves usar este formato se:
Não suportamos uma ligação direta via API à tua plataforma
Não suportamos o formato de exportação nativo da plataforma
O nosso CSV personalizado foi desenhado para ser simples e direto, facilitando a introdução das tuas transações e a sua importação para o CryptoBooks. Basta preencher os dados das transações seguindo o nosso modelo, e poderás importar os teus dados mesmo que a tua plataforma não seja suportada diretamente.
ℹ️ O que é um ficheiro CSV e como editá-lo
Se não estás familiarizado com ficheiros CSV ou precisas de ajuda para os editar e guardar, consulta este guia. Alternativamente, podes deixar que o nosso Serviço de CSV trate da formatação por ti — aprende mais neste guia.
O formato CSV
O CSV do CryptoBooks é composto por 13 colunas. A primeira linha contém o header do CSV, com o título de cada coluna, e cada coluna tem um propósito diferente. As colunas devem ser preenchidas segundo regras específicas (explicadas nesta secção) e manter a ordem correta.
O header obrigatório é sempre:
TYPE,CATEGORY,TRANSACTION DATE,OUT CURRENCY,OUT AMOUNT,OUT FIAT VALUE,IN CURRENCY,IN AMOUNT,IN FIAT VALUE,FEE CURRENCY,FEE AMOUNT,NOTES,ORIGINAL ID
Podes deixar algumas colunas vazias se não forem aplicáveis, mas todos os headers devem estar incluídos. Cada linha representa uma transação e deve conter apenas os dados relativos a essa transação.
Não é necessário criar o CSV do zero — podes descarregar um template com o header já preenchido clicando aqui.
TYPE
Preenchimento obrigatório. Indica se na transação recebeste um ativo, enviaste/pagaste um ativo ou trocaste um ativo por outro. Valores aceites:
Incoming (Entrada)
Outgoing (Saída)
Trade (Troca)
CATEGORY
Preenchimento obrigatório. As categorias ajudam a organizar a contabilidade e garantem que o software trata cada transação corretamente para fins fiscais.
Ex.: recompensas que devem ser declaradas como rendimento podem ser categorizadas como Earning ou Income.
A categoria por defeito e mais comum é Trading.
TRANSACTION DATE
Preenchimento obrigatório. Indica a data e hora em que a transação ocorreu. Formatos suportados:
yyyy-MM-dd HH:mm:ss
yyyy-MM-dd HH:mm
dd/MM/yyyy HH:mm:ss
dd/MM/yyyy HH:mm
Ex.: transação a 02/01/2024 às 21:45 pode ser escrita como:
2024-01-02 21:45:00 2024-01-02 21:45 02-01-2024 21:45:00 02-01-2024 21:45
OUT CURRENCY
Ticker do ativo enviado. Obrigatório para Outgoing e Trade. Deixar em branco para Incoming.
OUT AMOUNT
Quantidade do ativo enviado. Obrigatório para Outgoing e Trade. Deixar em branco para Incoming.
⚠️ Se usares vírgula como separador decimal, coloca os valores entre aspas: "xxxx,xx".
Ex.: "2999,85"
OUT FIAT VALUE
Valor total do ativo enviado em moeda fiduciária. Opcional para Outgoing e Trade. Deixar em branco para Incoming.
IN CURRENCY
Ticker do ativo recebido. Obrigatório para Incoming e Trade. Deixar em branco para Outgoing.
IN AMOUNT
Quantidade do ativo recebido. Obrigatório para Incoming e Trade. Deixar em branco para Outgoing.
IN FIAT VALUE
Valor total do ativo recebido em moeda fiduciária. Opcional para Incoming e Trade. Se deixado em branco, será usado o preço de mercado na altura da transação.
FEE CURRENCY
Ticker do ativo usado para pagar taxas. Opcional para todas as transações; preencher apenas se houve taxa.
FEE AMOUNT
Quantidade do ativo usada para pagar taxas. Opcional; preencher apenas se houve taxa.
NOTES
Campo para notas sobre a transação. Opcional, máximo 200 caracteres.
ORIGINAL ID
ID único da transação fornecido pela exchange ou blockchain (ex.: hash da transação). Opcional, útil para relacionar a transação com a sua fonte.
Como inserir uma transação Trade
Colunas obrigatórias:
TYPE,CATEGORY,TRANSACTION DATE,OUT CURRENCY,OUT AMOUNT,IN CURRENCY,IN AMOUNT,FEE CURRENCY (se houver taxa),FEE AMOUNT (se houver taxa)
Ex.: 01/01/2025 às 13:34:56, troquei 15,45 ETH por 1 BTC, valor total 30.000€, taxa de 2€
Se quiser especificar o valor em fiat:
Trade,Trading,01-01-2025 13:34:56,ETH,15.45,30000,BTC,1,30000,EUR,2,,,
Se usar vírgulas como separador decimal:
Trade,Trading,01-01-2025 13:34:56,ETH,"15,45",30000,BTC,1,30000,EUR,2,,,
Se quiser usar o preço de mercado sem especificar o valor:
Trade,Trading,01-01-2025 13:34:56,ETH,,15.45,BTC,1,,EUR,2,,,
Se não quiser adicionar nota:
Trade,Trading,01-01-2025 13:34:56,ETH,,15.45,BTC,1,,EUR,2,This is a note,,
Como inserir uma transação Incoming
Colunas obrigatórias:
TYPE,CATEGORY,TRANSACTION DATE,IN CURRENCY,IN AMOUNT,FEE CURRENCY (se houver taxa),FEE AMOUNT (se houver taxa)
Ex.: 26/12/2025 às 14:41:01, comprei 3 BTC com cartão, valor total 120.000€, taxa 0,05 BTC
Com valor em fiat:
Incoming,Trading,26-12-2025 14:41:01,BTC,3,120000,,,,,BTC,0.05,,,
Sem valor em fiat (usar preço de mercado):
Incoming,Trading,26-12-2025 14:41:01,BTC,3,,,,,,BTC,0.05,,,
Como inserir uma transação Outgoing
Colunas obrigatórias:
TYPE,CATEGORY,TRANSACTION DATE,OUT CURRENCY,OUT AMOUNT,FEE CURRENCY (se houver taxa),FEE AMOUNT (se houver taxa)
Ex.: 13/05/2025 às 10:12, enviei 2.500 USDT, valor total 2.200€, taxa 1,55 USD
Com valor em fiat:
Outgoing,Trading,13-05-2025 10:12,,,,USDT,2500,2200,,USD,1.55,,,
Sem valor em fiat (usar preço de mercado):
Outgoing,Trading,13-05-2025 10:12,,,,USDT,2500,,,USD,1.55,,,No editor de texto
