Erros comuns ao importar OFX (e como resolver cada um)

Comece pelo sintoma — e abra o arquivo

Mensagens de erro de importação são inúteis: o sistema diz "arquivo inválido" e para por aí, sem dizer qual linha recusou. A boa notícia é que o OFX não é binário nem compactado — é texto puro. Abra-o no Bloco de Notas e você vê tudo: cabeçalho, dados da conta e cada lançamento entre etiquetas. Em vez de adivinhar, você confere.

As seções abaixo partem do sintoma que aparece na sua tela. Se a estrutura do arquivo ainda é nova para você, veja antes o que é o formato OFX.

Sintoma: "arquivo inválido" ou "formato não reconhecido"

O sistema recusa antes de listar um único lançamento. A causa quase sempre está nas primeiras linhas:

• O dialeto está errado. Um OFX 1.0 começa com OFXHEADER:100, DATA:OFXSGML e VERSION:102. Se a primeira linha for <?xml, é um OFX 2.0 — e o ERP que só aceita a 1.0 o rejeita sem explicar. Os sistemas brasileiros esperam a 1.0, que é o que geramos.
• O cabeçalho foi destruído. Essas linhas identificam o arquivo; abrir o OFX no Word e salvar por cima apaga o bloco inteiro.
• O download veio pela metade. O arquivo tem de terminar fechando a etiqueta OFX. Se acaba no meio de um lançamento, baixe de novo.
• Há uma marca invisível no início (BOM). Parsers estritos esperam o O de OFXHEADER no primeiro byte e engasgam com algo que você não vê. Salve como "UTF-8 sem BOM".
• Não é um OFX. Renomear um .csv para .ofx não converte nada.

Sintoma: o histórico veio com acentuação quebrada

Os valores estão certos, mas a descrição vira TRANSFERÊNCIA, ou os acentos viram losangos. Isso é encoding, não corrupção: o arquivo está íntegro, sendo lido com a tabela de caracteres errada.

O cabeçalho anuncia a codificação em duas linhas, ENCODING:UTF-8 e CHARSET:1252. Nem todo importador respeita o anúncio: alguns assumem Latin-1 e leem cada acento do UTF-8 como dois símbolos — por isso o mesmo arquivo importa perfeito num sistema e embaralha em outro. A correção é de quem lê: procure a opção de codificação na tela de importação; não havendo, reescreva o histórico no editor de OFX.

Caso parecido, outra causa: & literal na descrição não é acentuação. Símbolos como & viram entidades para não quebrar o arquivo, e cabe ao importador desfazer isso na leitura.

Sintoma: importou tudo duplicado

Cada lançamento aparece duas vezes. Quem deveria impedir isso é o identificador único de cada transação, o FITID: o ERP guarda os que já viu e descarta repetidos. Quando duplica, esse casamento falhou:

• O mesmo extrato foi convertido por duas ferramentas diferentes. A causa mais comum e a menos óbvia: cada conversor gera identificadores à sua maneira, então dois arquivos do mesmo PDF trazem FITIDs distintos para as mesmas transações — e o ERP não tem como saber disso.
• O período se sobrepõe e o banco reemitiu o extrato. Alguns bancos renumeram as transações a cada exportação: o extrato de 1º a 31 e o de 15 a 15 descrevem o mesmo Pix com identidades diferentes.
• O seu sistema ignora o FITID. Parte dos ERPs concilia por data e valor; nesses, período sobreposto duplica sempre.

Previna padronizando: converta cada mês uma vez, pela mesma ferramenta, e importe períodos que não se cruzam. Se o estrago aconteceu, desfaça o lote inteiro no ERP — e, antes de mexer no campo, leia como o FITID funciona no editor.

Sintoma: as datas vieram um dia antes

Este passa despercebido: todos os lançamentos entram deslocados um dia para trás. Não é erro de leitura — é fuso horário.

No OFX a data vai grudada, no padrão AAAAMMDD, seguida de um horário: 2 de junho de 2026 vira 20260602000000 — meia-noite. O formato permite marcar o fuso ao final, mas o trecho é opcional e costuma vir ausente. Aí mora a armadilha: um sistema que assume aquele horário como GMT e o converte para Brasília subtrai três horas de meia-noite e cai às 21h do dia anterior. O lançamento do dia 2 entra no dia 1º, e o último dia do período escapa dele. A correção é no ERP, não no arquivo: confirme o fuso GMT-3 e procure a opção "considerar apenas a data".

Sintoma parecido, outra origem: se as datas não estão deslocadas por igual, mas trocadas — dia virou mês, só até o dia 12 —, alguém interpretou 03/04 como 4 de março. Não ocorre partindo do PDF do banco; veja as regras de data do conversor de planilha.

Sintoma: faltam lançamentos ou o arquivo veio vazio

A importação conclui sem erro, mas com menos lançamentos do que o extrato tem — ou nenhum:

• O PDF é uma imagem. A explicação mais frequente para o arquivo vazio. Tente selecionar o texto de um lançamento: se nada seleciona, não há texto ali, só pixels — caso de extratos escaneados, fotos e PDFs feitos por "Imprimir para PDF". O conversor manda para o reconhecimento óptico o PDF que não chega a vinte caracteres de texto, mas o resultado é melhor com o original do internet banking.
• Faltam páginas. Exportações com intervalo de páginas cortam o fim do extrato. Confira a numeração ("página 3 de 7").
• É outra conta. Extratos consolidados trazem várias contas no mesmo documento. Confira o número da conta no arquivo gerado.
• O extrato está mesmo vazio. Layout reconhecido e período sem movimento: zero lançamentos é a resposta certa — o arquivo sai sem transações de propósito, em vez de inventar alguma.

Sintoma: o saldo não fecha

Tudo importou, nenhum erro apareceu, mas o saldo do sistema não é o do banco. Antes de caçar lançamento, pergunte: a diferença é constante ou varia?

Se é sempre a mesma, do primeiro ao último dia, não falta lançamento — falta o ponto de partida. O OFX de extrato carrega a movimentação do período: o arquivo que geramos não declara o saldo da conta. Quem o conhece é o seu sistema, pelo que foi cadastrado na criação da conta. Se esse saldo inicial estava errado (ou ficou em zero), toda a série nasce deslocada pelo mesmo valor. Corrija-o no ERP e a diferença evapora.

Se a diferença muda, há lançamento a mais ou a menos, e a data em que ela surge aponta o culpado. Suspeitos: tarifas, IOF, rendimento de aplicação automática e estornos, que não tinham título prévio no sistema; lançamentos agendados, que ainda não afetaram o saldo; e transações do último dia jogadas para fora do período pelo fuso. Para achar a linha exata, gere um Excel a partir do OFX, que traz as fórmulas prontas para contar e somar.

Sintoma: o sistema não encontra a conta

O arquivo é aceito, mas o ERP diz que a conta não está cadastrada, ou pede para vinculá-la a cada importação. É vínculo de metadado: o sistema casa o arquivo com a conta pelo código do banco (BANKID) e pelo número da conta (ACCTID), e um dos dois não bate — o deslize clássico é de formatação, com o cadastro em 12345-6 e o arquivo em 123456.

Reconverter não adianta: devolve o mesmo valor no mesmo campo. É caso de editar o metadado no editor de OFX online, que ajusta esses campos e explica qual código o BANKID espera (é um número, não o nome do banco).

Quando nada disso encaixa

Procure no arquivo um lançamento que você sabe que existe. Se ele está lá, com data e valor certos, o OFX está bom — e a investigação é do lado do ERP: cadastro da conta, fuso, período de importação. Se não está, converta de novo escolhendo o banco certo no conversor, já que o banco selecionado determina o leitor aplicado ao layout: Itaú, Banco do Brasil, Nubank e Bradesco, entre dezenas de outros, têm página própria.

Para gerar o arquivo, veja como converter o extrato em PDF para OFX; para as telas de cada sistema, o guia de importação no Conta Azul, Bling, Omie e QuickBooks. Persistindo, fale com a gente informando o banco.