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:
na etapa Check Import Result, encontre o seu ficheiro na lista
leia as colunas Rows count, File status e o estado da importação (consulte a tabela abaixo)
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
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.
cripto, siga Guia para Compilares o ficheiro CSV do Finbooks
finanças tradicionais (ações, obrigações, ETF, derivados e semelhantes), siga Como preencher o CSV Custom de Finanças Tradicionais do Finbooks
Para conhecer todas as suas opções, leia A minha plataforma não é suportada: quais são as minhas opções?.
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:
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
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
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
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.
