Ir para conteúdo principal

Guia para Compilares o ficheiro CSV do CryptoBooks

Segue estas instruções por forma a tornares o teu ficheiro CSV compatível com o nosso formato

Atualizado esta semana

Segue este guia por forma a preencheres corretamente as linhas do ficheiro CSV no formato do CryptoBooks.

Caso não saibas como editar e guardar um ficheiro CSV, lê o seguinte artigo:

De seguida apresentamos instroções detalhadas sobre os valores permitidos para preencher cada campo/ coluna do ficheiro CSV:

  • Primeira(o) coluna/ campo: TYPE/ TIPO- Campo obrigatório

    Indica o tipo de transação (depósito, levantamento ou troca)

    • Se estiveres a criar uma linha para uma transação de depósito deves introduzir um dos seguintes dados:

      • Incoming/ Entrada

      • Deposit/ Depósito

      • Ingoing/ Em andamento

    • Se estiveres a criar uma linha para uma transação de levantamento, deves introduzir um dos seguintes dados:

      1. Outgoing/ Saída

      2. Withdrawal/ Retirada

    • Se estiveres a criar uma linha para uma transação de troca, deves introduzir o seguinte:

      1. Trade/ Troca

  • Segunda(o) coluna/ campo: CATEGORY/ CATEGORIA - Campo obrigatório

    Indica a categoria a que pertence a transação importada. Os valores permitidos são os seguintes:

    • Transfer/ Transferência;

    • Transferimento;

    • Trading;

    • Staking;

    • Mining;

    • Payments/ Pagamentos;

    • Lending/ Emprestar;

    • Pool;

    • Borrowing/ Pedir Emprestado;

    • Farming;

    • Fees/ Comissões;

    • Salary/ Salário;

    • General_Income/ Rendimento;

    • Settlement;

    • Airdrop;

    • Bank&Card/Cartões&Bancos;

    • Lost/ Perdidos;

    • Delisted/ Fora da lista;

    • Gift/ Presente.

    Caso não saibas qual categoria atribuir à transação consulta o seguinte artigo:

  • Terceira(o) coluna/ campo: TRANSACTION DATE/ DATA DA TRANSAÇÃO - Campo obrigatório

    Indica a data da transação a importar. Os formatos permitidos são:

    • yyyy-MM-dd HH:mm:ss (exemplo: 2023-07-14 12:34:56)

    • yyyy-MM-dd HH:mm (exemplo: 2023-07-14 12:34)

    • dd/MM/yyyy HH:mm:ss (exemplo: 14/07/2023 12:34:56)

    • dd/MM/yyyy HH:mm (exemplo: 14/07/2023 12:34)

    Note-se que yyyy = ano; MM = mês; dd = dia; HH = hora; mm = minutos e ss = segundos.

  • Quarta(o) coluna/ campo: FROM CURRENCY/ MOEDA DE ORIGEM - Campo obrigatório

    Dependendo do tipo de transação, indica:

    • Em transações de levantamento: o código da moeda levantada/vendida.

    • Em transações de depósito: o código da moeda depositada/comprada.

    • Em transações de troca: o código da moeda vendida na troca.

!!!Nota importante!!!
Se utilizares vírgulas como separador decimal, deve colocar os valores entre aspas ("xxxx,xx").
Esta regra aplica-se a todos os campos com valores numéricos que utilizem vírgula para indicar casas decimais.

Exemplo de linha incorreta (não aceite pelo software):

Trade,Trading,13/04/2022 19:04,EUR,2999,85,BNB,7,6368,,,

Exemplo de linha correta (aceite pelo software):

Trade,Trading,13/04/2022 19:04,EUR,"2999,85",BNB,"7,6368",,,

  • Quinta(o) coluna/ campo: FROM AMOUNT/ QUANTIDADE ENVIADA- Campo obrigatório

    Dependendo do tipo de transação, indica:

    • Para levantamentos: o montante da moeda levantada/vendida.

    • Para depósitos: o montante da moeda depositada/comprada.

    • Para trocas: o montante da moeda vendida na troca.

  • Sexta(o) coluna/ campo: TO CURRENCY/ MOEDA DE DESTINO- Campo obrigatório para transações do tipo TRADE

    Indica o código da moeda comprada na troca.

    • Para levantamentos:

      • Deixa em branco caso pretendas utilizar a taxa de conversão de mercado à data da transação.

      • Preenche com o símbolo da moeda fiduciária (por exemplo, EUR ou GBP) se quiseres indicar um preço diferente do de mercado.

    • Para depósitos:

      • Deixa em branco caso pretendas utilizar a taxa de conversão de mercado à data da transação.

      • Preenche com o símbolo da moeda fiduciária (por exemplo, EUR ou GBP) se quiseres indicar um preço diferente do de mercado.

  • Sétima(o) coluna/ campo: TO AMOUNT/ QUANTIDADE RECEBIDA- Campo obrigatório para transações do tipo TRADE

    Em trocas, indica o montante da moeda comprada na transação.

    • Para levantamentos:

      • Deixa em branco caso pretendas utilizar a taxa de conversão de mercado à data da transação.

      • Preenche com o símbolo da moeda fiduciária (por exemplo, EUR ou GBP) se quiseres indicar um preço diferente do de mercado.

    • Para depósitos:

      • Deixa em branco caso pretendas utilizar a taxa de conversão de mercado à data da transação.

      • Preenche com o símbolo da moeda fiduciária (por exemplo, EUR ou GBP) se quiseres indicar um preço diferente do de mercado.

!!!Nota importante!!!
Se utilizares vírgulas como separador decimal, deve colocar os valores entre aspas ("xxxx,xx").
Esta regra aplica-se a todos os campos com valores numéricos que utilizem vírgula para indicar casas decimais.

Exemplo de linha incorreta (não aceite pelo software):

Trade,Trading,13/04/2022 19:04,EUR,2999,85,BNB,7,6368,,,

Exemplo de linha correta (aceite pelo software):

Trade,Trading,13/04/2022 19:04,EUR,"2999,85",BNB,"7,6368",,,

  • Oitava(o) coluna/ campo: FEE CURRENCY/ MOEDA DAS COMISSÕES - campo opcional

    Indica o código da moeda utilizada para pagares as comissões e encargos associados à transação.

    Preenche este campo apenas se tiveres pago uma comissão nesta transação.

  • Nona(o) coluna/ campo: FEE AMOUNT/ QUANTIDADE DE COMISSÕES - campo opcional

    Indica o montante de comissões e encargos pagos pela transação.

    Preenche este campo apenas se tiveres pago uma comissão nesta transação.

  • Coluna/ Campo: NOTES/ NOTAS - campo opcional

    Preenche este campo caso pretendas inserir notas ou comentários sobre a transação, até um limite de 200 caracteres

  • Coluna/ Campo: ORIGINAL ID/ ID ORIGINAL- campo opcional

    Aqui podes introduzir o ID Original da transação, útil para facilitar pesquisas mais rápidas de uma ou mais transações dentro do ficheiro CSV.

Abaixo poderás encontrar um exemplo de um ficheiro corretamente compilado o qual apresenta linhas com transações de diferentes tipos:

No Excel

No editor de texto

Isto respondeu à sua pergunta?