Conferir antes de importar
Ver quantos lançamentos existem, qual o período e quanto dá o líquido, antes de o movimento entrar no sistema contábil. Depois de importado, corrigir custa muito mais.
Converter OFX para Excel
Envie o OFX que o banco gerou e receba uma planilha .xlsx ou um CSV com um lançamento por linha: Data, Histórico, Documento, Valor e Tipo. É para quando você tem o arquivo certo para importar, mas precisa olhar o movimento antes — conferir, filtrar, somar — fora do sistema contábil.
Converter e conferir são gratuitos. O crédito só é debitado quando você baixa o arquivo.
Sem cadastro para testar. O arquivo é processado na memória e descartado — não guardamos o seu extrato.
o formato
OFX 1.x não é XML. É SGML — e é por isso que ele não abre.
Esta é a explicação que quase ninguém dá, e é a razão de o arquivo ser tão difícil de abrir com ferramenta genérica. O OFX é descrito como formato baseado em tags, o que leva muita gente a tratá-lo como XML e a tentar renomeá-lo para .xml. Não funciona.
Na versão 1.x, as tags de valor não são fechadas. Uma linha de valor é assim:
<STMTTRN>
<TRNTYPE>DEBIT
<DTPOSTED>20260301120000[-3:BRT]
<TRNAMT>-89.90
<MEMO>PIX ENVIADO
</STMTTRN>Não existe </TRNAMT>: o valor termina na quebra de linha. Isso é SGML válido e OFX 1.x perfeitamente correto — e é XML inválido. Um analisador de XML não recupera desse erro: ele rejeita o arquivo inteiro, não a linha. Só o OFX 2.x é XML de verdade, com todas as tags fechadas e prólogo declarado.
Como os bancos brasileiros exportam quase sempre a versão 1.0.2, a leitura aqui é feita por varredura de tags, que funciona nas duas versões. É menos elegante que usar uma biblioteca de XML pronta. É também a única forma de ler o arquivo que o seu banco realmente emite.
a leitura
O que é extraído de cada lançamento
Cada lançamento do OFX é um bloco <STMTTRN>. Destes campos sai a planilha:
- DTPOSTED
- A data do lançamento. Vem como AAAAMMDD, com hora e fuso opcionais.
- TRNAMT
- O valor, com sinal. É ele que define se o lançamento é débito ou crédito.
- MEMO
- O histórico — vira a coluna Histórico da planilha.
- CHECKNUM
- O número do documento, quando o banco preenche.
- NAME
- O nome associado ao lançamento, quando existe.
- TRNTYPE
- O tipo declarado pelo banco. Só é consultado quando o valor é zero.
Do cabeçalho do arquivo vêm ainda o código e o nome da instituição, a agência, a conta, o período declarado e o saldo — usados para identificar o extrato, não para preencher a planilha.
as armadilhas
Quatro coisas que o OFX brasileiro faz fora do padrão
O padrão OFX é de meados dos anos 1990 e cada banco o implementou do seu jeito. Estas são as divergências que aparecem em arquivo de banco brasileiro e que quebram a leitura ingênua:
- O acento vem em Windows-1252, não em UTF-8. O OFX 1.x declara a codificação no cabeçalho, e os bancos gravam mesmo em cp1252. Ler o arquivo como UTF-8 corrompe todo acento do histórico. O cabeçalho é inspecionado antes da decodificação — inclusive o prólogo XML, no caso do 2.x.
- O valor pode vir com vírgula decimal. O padrão manda ponto, e a maioria segue. O Bradesco é o caso conhecido de banco brasileiro que grava vírgula. As duas formas são lidas.
- O tipo declarado pode contradizer o sinal. Há arquivos com CREDIT em lançamento de valor negativo. O sinal do valor é a fonte da verdade; o tipo declarado só decide quando o valor é exatamente zero.
- A data vem com hora e fuso — e o fuso não é confiável. O formato é 20260301120000[-3:BRT]. Hora em extrato bancário é ruído, e o fuso declarado pelos bancos é inconsistente o bastante para não valer a pena interpretar. Só a data é usada.
quando usar
Por que converter um arquivo que já serve para importar
Quem chega aqui não tem problema de importação — tem o arquivo certo. O problema é que o OFX é escrito para o software, não para o leitor. Estes são os casos:
Entender por que o sistema recusou
Quando a importação falha sem dizer o motivo, olhar o conteúdo do arquivo é o primeiro passo — datas fora do período, lançamentos do dia corrente, histórico vazio.
Trabalhar fora do sistema
Conciliar com o contas a pagar, mandar o movimento para um cliente que não tem sistema contábil, ou simplesmente filtrar e somar. Nada disso se faz em OFX.
a planilha
O que sai no arquivo
Cinco colunas, uma linha por lançamento: Data em DD/MM/AAAA, Histórico, Documento, Valor e Tipo. O valor sai como número, com o sinal do lançamento — débito negativo — para que somar a coluna devolva o líquido do período direto.
No .xlsx a coluna de valor já vem com formato numérico brasileiro e as larguras ajustadas. No CSV, o separador é ponto e vírgula e o arquivo leva BOM UTF-8, que é o que faz o Excel em português abrir sem corromper a acentuação do histórico. O detalhe de cada um está na página sobre converter PDF para Excel.
outros caminhos
perguntas
Perguntas sobre converter OFX para Excel
Por que o Excel não abre um arquivo OFX?
Porque o OFX não é um formato de planilha. E, na versão que os bancos brasileiros usam, ele também não é XML: é SGML, uma estrutura de tags em que as tags de valor não são fechadas. Renomear o arquivo para .xml não resolve — qualquer leitor de XML rejeita o arquivo inteiro na primeira tag sem fechamento.
OFX é XML?
Depende da versão. O OFX 2.x é XML de verdade, com prólogo e todas as tags fechadas. O OFX 1.x é SGML: uma linha como <TRNAMT>-89.90 termina na quebra de linha, sem </TRNAMT>. Os bancos brasileiros exportam quase sempre a versão 1.0.2, que é 1.x — por isso a ferramenta genérica de XML falha na prática, mesmo que o padrão OFX apareça descrito como XML.
Qual versão de OFX os bancos brasileiros usam?
Quase sempre a 1.0.2. É a mesma versão que o Convertou gera quando o caminho é o inverso, porque é a que os sistemas contábeis brasileiros esperam na importação. A leitura aqui é feita por varredura de tags, que funciona nas duas versões — 1.x e 2.x — em vez de depender de um analisador de XML.
A acentuação do histórico vai sair certa?
Sim. O OFX 1.x declara a codificação no cabeçalho, e os bancos brasileiros gravam mesmo em Windows-1252. Ler o arquivo como UTF-8 corrompe todo acento do histórico. O leitor inspeciona o cabeçalho antes de decidir como decodificar, e trata o caso do OFX 2.x, que declara a codificação no prólogo XML.
E se o valor no arquivo vier com vírgula?
É aceito. O padrão OFX manda ponto decimal, mas há bancos brasileiros que gravam vírgula — o Bradesco é o caso conhecido. Recusar um arquivo que o próprio banco emitiu não ajudaria ninguém, então as duas formas são lidas.
E se o banco marcou como crédito um lançamento negativo?
O sinal do valor manda. Há bancos que gravam CREDIT em lançamento com valor negativo; o valor negativo é inequívoco e o tipo declarado não é. O tipo declarado só decide quando o valor é exatamente zero.
O que acontece se algum lançamento estiver ilegível?
Ele não some em silêncio. Um lançamento sem data ou sem valor legível é registrado como aviso, com o trecho do arquivo, para você ver o que ficou de fora. Um arquivo sem nenhum lançamento reconhecível é recusado com essa mensagem, em vez de gerar uma planilha vazia.
Vocês guardam o meu arquivo?
Não. O OFX é processado na memória e descartado ao fim da conversão. Não é gravado em disco, não vai para banco de dados e não vai para armazenamento em nuvem.