Ir para conteúdo principal

Porque é que o meu ficheiro CSV foi rejeitado?

⚪️ Guia do usuário

Quando carrega um ficheiro CSV ou Excel, o Finbooks verifica o seu formato e conteúdo antes de importar o que quer que seja. Se o ficheiro não corresponder ao que a ligação espera, é marcado como Rejected e nenhuma transação é importada.

Este artigo explica como ler o resultado, as causas de rejeição mais comuns e o que fazer a seguir.


Como verificar o que correu mal

Logo depois de clicar em Upload CSV, o Finbooks valida cada ficheiro e leva-o para a etapa Check Import Result. Siga estes passos para ler o resultado:

  1. na etapa Check Import Result, encontre o seu ficheiro na lista

  2. leia as colunas Rows count, File status e o estado da importação (consulte a tabela abaixo)

  3. se o ficheiro estiver Rejected com um número de linhas com erros, clique em Ver erros para abrir o painel de detalhes dos erros, onde pode ver o erro específico de cada linha

  4. clique em Export errors para descarregar a lista de erros como ficheiro CSV

Se o estado da importação for Malformed, não está disponível nenhum relatório de erros: o cabeçalho do ficheiro está errado, pelo que não há erros de linha para mostrar. Verifique o cabeçalho com o guia da sua ligação.

Quando o cabeçalho está errado, a app mostra um botão Download template CSV. É a solução mais rápida: descarregue o modelo e copie para ele as suas transações.

Resultado da importação por estado do ficheiro:

File status

Rows count

Estado da importação

O que significa

Uploaded

Número de transações importadas

Imported ou In progress

o formato está correto e o ficheiro foi aceite

Rejected

0

Malformed

o cabeçalho do ficheiro está errado, não foi importado nada e não está disponível nenhum relatório de erros

Rejected

0

Número de linhas com erros

o ficheiro tem linhas que não podem ser lidas, pelo que o ficheiro inteiro é rejeitado e não foi importado nada

⚠️ Os erros não são guardados

Os detalhes dos erros só estão disponíveis enquanto está na etapa Check Import Result. Se sair da página ou iniciar um novo upload, perdem-se. Descarregue o relatório de erros com Export errors antes de sair, ou carregue novamente o ficheiro para ver os erros outra vez.


Causas comuns de rejeição e como resolvê-las

Verifique as causas abaixo por ordem. A maioria das rejeições deve-se às quatro primeiras.

O tipo de ficheiro não corresponde à ligação

Algumas ligações aceitam apenas ficheiros CSV, outras aceitam ficheiros Excel (.xlsx) nativos. Consulte o guia de ligação da sua plataforma para ver que formato suporta.

Se o guia pedir o ficheiro exatamente como a plataforma o exporta, carregue-o sem o converter. Guardar novamente um ficheiro noutro formato pode alterar a sua estrutura.

O ficheiro foi editado ou guardado novamente

Abrir um CSV no Excel e guardá-lo de novo pode acrescentar alterações que não vê, por exemplo aspas a mais no cabeçalho ou nas primeiras linhas. Isto é suficiente para o ficheiro ser rejeitado.

Se precisar de verificar um ficheiro, abra-o num editor de texto simples (Bloco de Notas no Windows, TextEdit no Mac). Para saber mais, leia O que é um ficheiro CSV e como editá-lo.

O ficheiro não é o que o guia de ligação pede

Cada guia de ligação indica que relatório descarregar. Um relatório diferente da mesma plataforma, ou um ficheiro de outra plataforma, não corresponderá à estrutura esperada.

Verifique se está a carregar o ficheiro pedido no guia, que cubra todo o seu histórico, e para a ligação criada para essa plataforma.

A plataforma não é suportada com ficheiro nativo

Se o Finbooks não suportar o ficheiro nativo da plataforma, a exportação da plataforma não pode ser carregada tal como está. Tem de passar as suas transações para o CSV personalizado do Finbooks e carregá-lo numa ligação personalizada.

O CSV personalizado não segue o formato do Finbooks

Se compilou um CSV personalizado, o ficheiro é rejeitado quando o cabeçalho ou as colunas não correspondem ao modelo:

  • a primeira linha tem de ser o cabeçalho e tem de corresponder exatamente a um modelo do Finbooks: mesmos nomes de colunas, mesma ordem, sem colunas a mais ou em falta

  • as 13 colunas têm de estar presentes, mesmo que algumas estejam vazias

  • cada linha é uma única transação

  • as colunas obrigatórias têm de estar sempre preenchidas

No CSV personalizado de cripto, o cabeçalho pode estar em inglês, italiano, francês, espanhol ou português, desde que corresponda exatamente a um modelo do Finbooks. No CSV personalizado de TradFi, o cabeçalho tem de estar em inglês.

Como separador entre colunas pode usar tanto a vírgula como o ponto e vírgula.

O cabeçalho do CSV personalizado de cripto, em inglês, é:

` 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 `

O cabeçalho do CSV personalizado de TradFi (apenas em inglês) é:

` ASSET CLASS,TYPE,EXCHANGE CODE,CATEGORY,TRANSACTION DATE,OUTGOING ASSET,OUTGOING AMOUNT,INCOMING ASSET,INCOMING AMOUNT,FEE CURRENCY,FEE AMOUNT,POSITION ID,NOTES `

Pode partir do modelo de cripto, que já contém o cabeçalho.

Se o cabeçalho estiver errado, a app mostra um botão Download template CSV: descarregue o modelo e copie para ele as suas transações. Para o CSV personalizado de TradFi não existe link para um modelo, por isso siga o guia de TradFi.

ℹ️ Cripto e finanças tradicionais são separadas

Use o CSV personalizado de cripto para cripto e o CSV personalizado de TradFi para investimentos tradicionais. Se na sua conta só vir a secção de finanças tradicionais, leia Como ativar a secção de criptomoedas.

As datas não estão num formato suportado

A coluna TRANSACTION DATE é obrigatória e tem de usar um destes formatos:

  • yyyy-MM-dd HH:mm:ss

  • yyyy-MM-dd HH:mm

  • dd/MM/yyyy HH:mm:ss

  • dd/MM/yyyy HH:mm

Por exemplo, uma transação de 02 de janeiro de 2024 às 21:45 pode ser escrita como 2024-01-02 21:45 ou 02/01/2024 21:45.

A data e a hora também têm de corresponder ao seu fuso horário local. O Finbooks não consegue detetar o fuso horário usado pela plataforma, por isso converta os registos de data e hora para a sua hora local antes de carregar o ficheiro.

Os números usam vírgula decimal

Se usar uma vírgula como separador decimal, tem de colocar o número entre aspas; caso contrário, a vírgula é lida como separador de colunas e a linha fica errada. Também pode usar um ponto como separador decimal.

Formato

Exemplo

Resultado

Vírgula decimal sem aspas

2999,85

errado

Vírgula decimal com aspas

"2999,85"

correto

Ponto decimal

2999.85

correto

Faltam valores obrigatórios

O que tem de preencher depende do tipo de transação:

  • Incoming, o ativo e a quantidade recebidos

  • Outgoing, o ativo e a quantidade enviados

  • Trade, tanto o ativo e a quantidade enviados como os recebidos

Cada linha também precisa do tipo, da categoria e da data. Para ver a lista completa de colunas, consulte o guia de cripto ou de finanças tradicionais.

A plataforma alterou o seu formato de exportação

As plataformas atualizam os seus ficheiros de tempos a tempos. Isto pode originar um formato não suportado, colunas em falta, tipos de transação não reconhecidos ou cabeçalhos que deixam de corresponder.

Se acreditar que o ficheiro deveria ser suportado, contacte o Suporte Finbooks. Os detalhes estão na secção abaixo.


Mensagens de erro comuns

Mensagem

O que costuma significar

Some errors were found in the header: one or more column headers do not match our required format, and we are unable to suggest a valid correction.

o cabeçalho do ficheiro não corresponde ao esperado: verifique o tipo de ficheiro, verifique se o ficheiro foi editado e verifique se o cabeçalho corresponde exatamente ao guia de ligação ou ao modelo do CSV personalizado

Unrecognised columns: no Finbooks CSV template matches this file

o cabeçalho não corresponde a nenhum modelo do Finbooks em nenhum idioma suportado: compare o cabeçalho com o modelo e corrija os nomes e a ordem, ou recomece a partir do modelo com Download template CSV

Unrecognized section

o ficheiro contém uma secção que o software não consegue reconhecer: carregue exatamente o relatório pedido no guia de ligação, sem o editar

Se vir uma mensagem de erro técnica inesperada, contacte o Suporte Finbooks e anexe o ficheiro.


Não existem importações parciais

O Finbooks importa um ficheiro na totalidade ou não importa nada. Se uma única linha tiver um erro, o ficheiro inteiro é rejeitado e nenhuma transação desse ficheiro é importada.

Quando o estado da importação mostra um número de linhas com erros, abra Ver erros para ver porque falhou cada linha, corrija essas linhas no ficheiro de origem e carregue novamente o ficheiro. Como não foi importado nada do ficheiro rejeitado, não vai criar duplicados ao carregar o ficheiro corrigido.


O que fazer a seguir

Siga estes passos depois de uma rejeição:

  1. se o estado da importação mostrar linhas com erros, abra Ver erros e descarregue a lista com Export errors. Se mostrar Malformed, não há relatório de erros: verifique antes o cabeçalho

  2. compare o erro com as causas acima e corrija o ficheiro. Se o cabeçalho estiver errado, clique em Download template CSV e copie as suas transações para o modelo

  3. carregue novamente o ficheiro corrigido:

    • numa ligação existente, clique em Conexões no menu à esquerda, clique nos três pontos no fim da linha da ligação e depois selecione Adicionar novo CSV

    • a partir da última etapa do procedimento de upload, clique em Import new CSV

  4. verifique o novo resultado em Check Import Result

Se não quiser compilar o ficheiro por si, pode usar o Serviço de formatação de ficheiros CSV, que é pago. O resultado depende dos dados que fornecer.


Como contactar o Suporte

Se o ficheiro continuar a ser rejeitado, contacte o Suporte Finbooks por chat ou em customer.support@finbooks.com e envie:

  • o nome do ficheiro e a plataforma de onde provém

  • o ficheiro original, exatamente como o descarregou

  • o relatório de erros descarregado com Export errors

A nossa equipa verificará se o formato é suportado e ajudá-lo-á com o passo seguinte.

Para ver o procedimento de upload completo, leia Transfere o ficheiro CSV para o Finbooks.


Respostas rápidas

Posso carregar um ficheiro Excel?

Depende da ligação. Algumas ligações aceitam ficheiros Excel (.xlsx) nativos, outras aceitam apenas CSV. Consulte o guia de ligação da sua plataforma.

Porque é que o meu ficheiro mostra Malformed?

Malformed significa que o cabeçalho do ficheiro está errado, pelo que o ficheiro inteiro foi rejeitado e nenhuma transação foi importada. Verifique se está a carregar o ficheiro pedido no guia, sem edições, ou se o cabeçalho do seu CSV personalizado corresponde exatamente a um modelo do Finbooks. A solução mais rápida é o botão Download template CSV: descarregue o modelo e copie para ele as suas transações.

Porque é que o Check Import Result não funciona depois de eu sair da página?

Os detalhes dos erros não são guardados quando sai do procedimento de upload. Carregue novamente o ficheiro e clique em Ver erros antes de sair da página.

É importada alguma transação de um ficheiro rejeitado?

Não. Um ficheiro é importado na totalidade ou não é importado: se uma linha tiver um erro, o ficheiro inteiro é rejeitado. Num ficheiro Rejected, Rows count mostra 0 porque nenhuma transação foi importada.

Posso descarregar um relatório de erros de um ficheiro Malformed?

Não. Malformed significa que o cabeçalho do ficheiro está errado, pelo que não está disponível nenhum relatório de erros. Verifique o cabeçalho com o guia de ligação.

Isto respondeu à sua pergunta?