O que é verificado num ficheiro de extrato

Estas linhas não têm tantas colunas como a linha de cabeçalho. O culpado habitual é uma vírgula sem aspas dentro de uma descrição («Transferência para o João, poupança»). Os importadores deslocam então todas as colunas seguintes ou rejeitam o ficheiro. Isto exige correção manual — uma reparação automática teria de adivinhar qual a vírgula verdadeira.

Vários importadores deixam de ler na primeira linha em branco e descartam em silêncio tudo o que vem depois — o clássico «só metade das minhas transações foi importada». As linhas em branco podem ser removidas automaticamente.

O Excel acrescenta esta marca ao guardar como «CSV UTF-8». Alguns programas de finanças leem-na como parte do nome da primeira coluna («Data» em vez de «Data») e deixam de encontrar o cabeçalho esperado. Se o seu importador se queixa de uma primeira coluna desconhecida, remova-a.

É exatamente isto que o YNAB comunica como «ficheiro vazio» e outros programas como «0 transações importadas». A exportação do seu banco não continha linhas: normalmente um período sem movimentos, ou um botão de exportar que produziu apenas os títulos das colunas.

As exportações do Excel em Portugal e na Europa separam as colunas com «;». Os importadores que esperam vírgulas (YNAB, muitos formulários de carregamento) leem a linha inteira como uma única coluna. O ficheiro pode ser reescrito com vírgulas automaticamente; os campos entre aspas são preservados corretamente.

Nomes de beneficiários como «AT&T» ou «H&M» têm de ser escritos «AT&T» dentro de um ficheiro OFX/QFX. Um «&» cru quebra a análise SGML/XML exatamente nesse ponto — uma das razões mais comuns para um ficheiro falhar na importação apesar de abrir sem problemas num editor.

O ficheiro começa com uma marca UTF-8 invisível. Muitos analisadores OFX exigem que os primeiros caracteres sejam «OFXHEADER» e, caso contrário, rejeitam o ficheiro como inválido. É uma causa frequente do erro «ficheiro inválido» em ficheiros que num editor de texto parecem perfeitamente normais.

O agregado <OFX> nunca é fechado. Normalmente significa que a transferência foi interrompida pelo banco ou pelo navegador. A maioria dos importadores limita-se a dizer «não é possível ler o ficheiro». A etiqueta de fecho pode ser acrescentada, mas verifique se a lista de transações está completa.

As datas OFX têm de ser escritas como AAAAMMDD (opcionalmente com hora e fuso horário). Valores como «2026-08-01» ou «01/08/2026» levam o importador a rejeitar a transação ou o ficheiro inteiro.

Cada <STMTTRN> tem de trazer um FITID único — é assim que o Quicken, o QuickBooks e o YNAB sabem se uma transação já foi importada. As transações sem ele são descartadas em silêncio ou fazem falhar toda a importação. Podem ser gerados identificadores estáveis a partir da data, do valor e do beneficiário.

Um ficheiro OFX 1.x tem de começar com um bloco de cabeçalho (OFXHEADER:100, DATA:OFXSGML, VERSION, ENCODING …) antes do corpo <OFX>. Sem ele, o Quicken, o QuickBooks e o GnuCash rejeitam o ficheiro. Um cabeçalho padrão pode ser acrescentado automaticamente.

Os valores TRNAMT têm de ser números simples com o ponto como separador decimal (por exemplo -1234.56). Separadores de milhares, símbolos de moeda ou espaços fazem com que a transação seja ignorada.

Nomes com acentos (é, ü, ã …) aparecem num ficheiro cujo cabeçalho declara ASCII puro. Alguns importadores substituem-nos por caracteres ilegíveis, outros interrompem. Peça ao banco uma exportação em UTF-8. Não é aplicada transliteração automática, deliberadamente, para não alterar nomes.

Duas transações diferentes partilham o mesmo FITID. Os importadores tratam entradas com o mesmo FITID como uma só transação e saltam todas menos a primeira — o clássico «faltam transações depois de importar». Os duplicados podem tornar-se únicos com um sufixo numérico.

O ficheiro lê-se corretamente mas não contém qualquer <STMTTRN>. Os programas comunicam isto como «ficheiro vazio» ou «0 transações importadas». Os bancos produzem ficheiros vazios quando o período escolhido não tem movimentos — transfira de novo com um intervalo mais amplo.

Os ficheiros QFX e QBO contêm normalmente uma etiqueta <INTU.BID> que identifica um banco licenciado para Web Connect. Sem ela, o Quicken pode recusar o ficheiro com «não é um ficheiro Web Connect válido». Esta ferramenta não insere identificadores bancários: esse valor é atribuído ao banco pela Intuit. Em alternativa, importe por CSV.

Este é um extrato de conta de títulos (INVSTMTRS), cujos movimentos são compras, vendas e transferências em vez de lançamentos bancários. O ficheiro não está vazio. As verificações de todo o documento — cabeçalho, escape de caracteres, datas, truncagem — foram feitas; as verificações de identificador por transação ainda não são suportadas para registos de títulos.

Cada transação QIF tem de terminar com uma linha que contenha apenas «^». Os registos sem esse terminador fundem-se com a transação seguinte ou desaparecem por completo — o clássico «só parte das minhas transações foi importada».

Um ficheiro QIF tem de começar com uma declaração de tipo como «!Type:Bank» ou «!Type:CCard». Sem ela, o GnuCash e o Quicken recusam o ficheiro ou importam zero transações. Pode ser acrescentado um «!Type:Bank» genérico; mude para !Type:CCard em contas de cartão de crédito.

Valores como «1,234.56» confundem vários importadores, que leem a vírgula como separador de campo ou decimal. As vírgulas podem ser retiradas automaticamente («1234.56»).

Uma marca UTF-8 invisível precede a primeira linha «!». Os importadores QIF mais antigos leem-na como lixo e rejeitam o cabeçalho. Pode ser removida com segurança.

As datas QIF escrevem-se, consoante o país, como M/D/AA, M/D/AAAA ou D/M/AA. Outras formas (ISO 2026-08-01, nomes de mês …) fazem o importador saltar registos em silêncio. Como o QIF não declara a sua ordem de data, reescrevê-la automaticamente seria adivinhar — defina o formato na janela de importação.

Não foi encontrado qualquer registo numa secção !Type:Bank/CCard/Cash, pelo que o ficheiro não contém nada para importar. Se esperava dados, o intervalo de datas da exportação estava provavelmente vazio.