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:
TIPO,CATEGORIA,DATA TRANSAÇÃO,MOEDA SAÍDA,QUANTIDADE SAÍDA,VALOR FIAT SAÍDA,MOEDA ENTRADA,QUANTIDADE ENTRADA,VALOR FIAT ENTRADA,MOEDA COMISSÃO,QUANTIDADE COMISSÃO,NOTAS,ID ORIGINAL
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.
Tipo
Preenchimento obrigatório. Indica se na transação recebeste um ativo, enviaste/pagaste um ativo ou trocaste um ativo por outro. Valores aceites:
Incoming (Recebimento)
Outgoing (Saída)
Trade (Troca)
Categoria
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 (Rendimentos) ou Income (Rendimento).
A categoria por defeito e mais comum é Trading.
Data transação
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
Moeda saída
Ticker do ativo enviado. Obrigatório para Outgoing (Saída) e Trade. Deixar em branco para Incoming.
Quantidade saída
Quantidade do ativo enviado. Obrigatório para Outgoing (Saída) e Trade. Deixar em branco para Incoming (Entrada).
⚠️ Se usares vírgula como separador decimal, coloca os valores entre aspas: "xxxx,xx".
Ex.: "2999,85"
Valor fiat saída
Valor total do ativo enviado em moeda fiduciária. Opcional para Outgoing (Saída) e Trade. Deixar em branco para Incoming (Entrada).
Moeda entrada
Ticker do ativo recebido. Obrigatório para Incoming (Entrada) e Trade. Deixar em branco para Outgoing (Saída).
Quantidade entrada
Quantidade do ativo recebido. Obrigatório para Incoming (Entrada) e Trade. Deixar em branco para Outgoing (Saída).
Valor fiat entrada
Valor total do ativo recebido em moeda fiduciária. Opcional para Incoming (Entrada) e Trade. Se deixado em branco, será usado o preço de mercado na altura da transação.
Moeda comissões
Ticker do ativo usado para pagar taxas. Opcional para todas as transações; preencher apenas se houve taxa.
Quantidade comissões
Quantidade do ativo usada para pagar taxas. Opcional; preencher apenas se houve taxa.
NOTAS
Campo para notas sobre a transação. Opcional, máximo 200 caracteres.
ID ORIGINAL
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 de Entrada
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 de Saída
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
