Como validar um arquivo OFX antes de importar

Seis conferências que levam poucos minutos e evitam horas de estorno: contagem de lançamentos, período, fechamento de saldo, identificadores repetidos, dados da conta e dialeto do arquivo.

Atualizado em 09/08/2026 · 5 min de leitura

Por que conferir antes compensa

A assimetria que justifica este guia é simples: validar custa poucos minutos, e desfazer custa horas. Em vários sistemas de gestão não existe botão para reverter uma importação inteira — a saída é estornar lançamento por lançamento, ou pedir suporte. Em sistemas contábeis, quando o período já foi encerrado, o estrago exige reabertura de competência.

Some-se a isso o fato de que os defeitos mais caros são os silenciosos. Um arquivo corrompido é recusado na hora e não causa dano. O que machuca é o arquivo que entra normalmente, sem nenhuma mensagem, carregando três lançamentos a menos do que deveria.

Este guia trata do que fazer antes de subir. Para diagnosticar o que já deu errado depois de importar, veja erros comuns ao importar OFX.

A ferramenta: veja o arquivo como planilha

OFX é um formato pensado para máquinas. Abri-lo em editor de texto funciona para inspecionar um campo específico, mas é péssimo para conferir cem lançamentos.

O caminho prático é converter o OFX em Excel e trabalhar na planilha, onde ordenar, somar e contar são triviais. As conferências abaixo assumem isso. Encontrando algo errado, o editor de OFX online corrige os campos e gera o arquivo novo.

1. A contagem de lançamentos

Comece pelo mais bruto: quantas transações o arquivo tem, e quantas linhas o extrato original mostra? Os dois números precisam ser iguais.

Divergência para menos é o sinal mais importante que existe nessa checagem, e tem duas causas típicas. Ou o arquivo foi gerado a partir de um PDF e a leitura perdeu linhas — comum quando o documento é digitalizado. Ou há identificadores repetidos, e a conferência do item 4 vai confirmar.

Divergência para mais costuma indicar que linhas de saldo, cabeçalho de página ou totalizadores foram lidas como se fossem movimentação. Vale olhar as primeiras e as últimas linhas da planilha, onde esse tipo de sujeira se concentra.

2. O período coberto

Confira a menor e a maior data do arquivo. Elas devem corresponder ao intervalo que você pediu ao banco.

Três anomalias aparecem aqui. Datas fora do intervalo, que indicam leitura errada — típico quando o ano vem truncado ou quando o dia e o mês foram trocados por um formato inesperado. Períodos mais curtos do que o solicitado, sinal de que o banco limitou a consulta em silêncio. E deslocamento de um dia em todas as datas, que costuma vir de interpretação de fuso horário.

Vale conferir também se há buracos: uma semana inteira sem nenhum lançamento pode ser normal numa conta parada, e pode ser página perdida numa conta movimentada. O contexto da empresa responde.

3. O fechamento de saldo

Esta é a conferência mais poderosa das seis, porque valida o conjunto inteiro de uma vez. Some os créditos, some os débitos, e verifique:

saldo inicial + créditos − débitos = saldo final

Os saldos vêm impressos no próprio extrato. Se a igualdade se sustenta, é altamente improvável que falte ou sobre lançamento, e improvável que algum valor tenha sido lido errado — um erro de valor quebra a conta.

Não fechando, a diferença é a pista. Se ela é exatamente o valor de uma linha visível no extrato, essa linha não entrou. Se é o dobro de uma linha, ela entrou duas vezes. Se é um número que não corresponde a nada, provavelmente um valor foi lido com dígito trocado, e vale procurar valores parecidos com o esperado.

4. Identificadores repetidos

Ordene a planilha pela coluna do identificador de transação e procure valores iguais. Cada um deveria aparecer uma única vez.

Repetições fazem o sistema descartar lançamentos silenciosamente na importação, o que é a causa mais difícil de diagnosticar depois. Encontrando alguma, corrija antes de subir. A mecânica completa desse campo, incluindo por que certos bancos o geram mal, está em FITID: por que um lançamento entra duas vezes.

5. Os dados da conta

Confira o código do banco, o número da agência e o número da conta declarados no arquivo contra o que está cadastrado no sistema de destino.

A armadilha aqui não é o dado ausente, é o dado escrito de outro jeito. Conta cadastrada como 12345-6 e arquivo trazendo 123456 são textos diferentes para qualquer comparação automática, e o sintoma é uma recusa de conta não encontrada que parece inexplicável, já que a conta obviamente existe.

Confira também o tipo — corrente, poupança — e a moeda, especialmente se o arquivo veio de ferramenta estrangeira. Um extrato que não declara reais numa empresa brasileira pode gerar conversão indevida.

6. O dialeto

Por fim, verifique a geração do formato. A maioria dos sistemas brasileiros lê OFX 1.0, baseado em SGML; existe uma segunda geração baseada em XML que boa parte dos ERPs nacionais não aceita.

É a causa da mensagem genérica de formato inválido em arquivo que parece perfeito. A distinção entre as gerações está explicada em o que é o formato OFX. Arquivos gerados pelo conversor de extrato deste site saem em OFX 1.0 justamente por isso.

Vale olhar também os acentos: se nomes de fornecedores aparecem com caracteres estranhos na planilha, houve problema de codificação, e ele tende a se propagar para os históricos dentro do sistema.

Um roteiro que cabe em cinco minutos

Consolidando, na ordem em que dão mais retorno por minuto gasto:

  1. Saldo fecha? Se sim, os itens 1 e 3 estão implicitamente resolvidos.
  2. Período confere com o que foi pedido?
  3. Algum identificador repetido?
  4. Banco, agência, conta e tipo batem com o cadastro?
  5. É OFX 1.0?

Cinco perguntas. Em arquivos gerados por conversão de PDF digitalizado, onde o reconhecimento óptico pode trocar dígitos, essa rotina deixa de ser recomendável e passa a ser obrigatória — o assunto está em por que o OCR troca números no extrato.

Converta o extrato do seu banco para OFX, grátis e sem cadastro.

Abrir o conversor

Perguntas frequentes

Vale a pena conferir o arquivo antes de importar?

Sim, pela assimetria de custo: validar leva poucos minutos e desfazer leva horas. Vários sistemas não têm botão para reverter uma importação inteira, e em sistemas contábeis o período já encerrado exige reabertura de competência.

Qual é a conferência mais eficiente?

O fechamento de saldo: saldo inicial mais créditos menos débitos deve resultar no saldo final impresso no extrato. Ela valida o conjunto inteiro de uma vez, porque qualquer valor lido errado ou lançamento faltante quebra a igualdade.

O sistema diz que a conta não foi encontrada, mas ela existe.

Normalmente o número está escrito de outro jeito. Cadastro com dígito verificador e arquivo sem dígito são textos diferentes para qualquer comparação automática. Confira também o tipo da conta e a moeda declarada.

Como vejo o conteúdo de um OFX sem abrir em editor de texto?

Convertendo para Excel. O formato foi pensado para máquinas, e a planilha permite ordenar, somar e contar, que é o que as conferências exigem.