O Que É o Formato OFX? Entenda o Open Financial Exchange
OFX é o padrão aberto para troca de dados financeiros entre bancos e softwares. Veja o que um arquivo OFX contém e por que Xero, MYOB e GnuCash o preferem.
Seu software de contabilidade está pedindo um arquivo OFX. Seu banco forneceu um PDF. E agora você está olhando para um formato que nunca ouviu falar, perguntando-se por que uma planilha perfeitamente boa não serve.
OFX -- Open Financial Exchange -- é o padrão invisível que impulsiona o software financeiro moderno. É a razão pela qual o Xero pode importar transações bancárias sem que você precise mapear colunas. É por isso que o GnuCash pode detectar duplicatas. E é a base sobre a qual o formato QBO do QuickBooks é construído.
Este guia detalha o que é OFX, o que ele contém, como se compara a CSV e QBO, qual software o suporta e como criar arquivos OFX a partir de extratos bancários em PDF.
OFX em Uma Frase
Open Financial Exchange é um formato de dados baseado em XML para troca de informações financeiras entre instituições financeiras, aplicações de software e usuários finais. É o padrão aberto no qual o formato QBO da Intuit é baseado -- e o formato que a maioria dos softwares de contabilidade, exceto QuickBooks, prefere para importações de transações bancárias.
Pense no OFX como a língua franca dos dados financeiros. Bancos falam isso. Softwares de contabilidade leem isso. E ao contrário do CSV -- que são apenas linhas e colunas sem significado inerente -- o OFX carrega metadados estruturados que dizem ao software receptor exatamente o que cada dado representa.
A História do OFX
O OFX nasceu em 1997, criado pela Microsoft, Intuit e CheckFree. Cada um tinha seu próprio padrão concorrente -- a Microsoft tinha o OFC (Open Financial Connectivity), a Intuit tinha seu próprio formato de intercâmbio, e a CheckFree tinha seus protocolos de cobrança eletrônica. O OFX foi o compromisso que os unificou.
Linha do Tempo das Versões
- OFX 1.0 (1997) -- A especificação original, baseada em SGML (Standard Generalized Markup Language). SGML permite tags não fechadas, o que faz com que os arquivos OFX 1.x pareçam diferentes do XML moderno.
- OFX 1.6 (2002) -- A versão mais amplamente implantada. Ainda baseada em SGML. A maioria dos bancos que oferecem downloads OFX geram arquivos 1.6.
- OFX 2.0 (2005) -- Grande reescrita. Mudou de SGML para XML adequado com tags de fechamento.
- OFX 2.2 (2016) -- Melhorias de segurança e suporte aprimorado para transações de investimento.
- OFX 2.3 (Atual) -- A versão mais recente, mantida pela Financial Data Exchange (FDX), um consórcio da indústria que assumiu a governança dos fundadores originais.
A transição de SGML para XML é importante porque afeta a análise. Um arquivo versão 1.x usa tags não fechadas (<TRNTYPE>DEBIT sem </TRNTYPE>), enquanto a versão 2.x usa XML adequado com tags de fechamento. A maioria dos analisadores modernos lida com ambos, mas incompatibilidades de versão permanecem um erro comum na importação de OFX.
O Que o OFX Pode Conter
OFX não é apenas um formato de extrato bancário. A especificação abrange uma ampla gama de dados financeiros:
- Extratos de conta bancária -- Transações de contas correntes, poupança e mercado monetário. O caso de uso mais comum.
- Extratos de cartão de crédito -- Histórico de transações com suporte para códigos de categoria de comerciante e detalhes de compra.
- Extratos de investimento e corretagem -- Compras de ações, pagamentos de dividendos, transferências de fundos e posições de portfólio com dados de custo base em nível de lote.
- Informações de pagamento de contas -- Listas de beneficiários, pagamentos agendados e confirmações de pagamento.
- Informações fiscais -- Formulários 1099 e outros documentos fiscais transmitidos entre instituições financeiras e software fiscal.
- Extratos de empréstimo -- Registros de transações e informações de saldo de hipotecas, empréstimos automotivos e empréstimos pessoais.
Para a maioria dos contadores e escriturários, OFX significa uma coisa: importar transações bancárias e de cartão de crédito para o software de contabilidade sem mapeamento de colunas ou adivinhação de formato de data.
Dentro de um Arquivo OFX
Veja como é um arquivo de extrato bancário OFX 1.6 completo. Este é o formato que você encontrará com mais frequência -- a versão baseada em SGML que a maioria dos bancos e ferramentas de conversão geram:
OFXHEADER:100
DATA:OFXSGML
VERSION:160
SECURITY:NONE
ENCODING:USASCII
CHARSET:1252
COMPRESSION:NONE
OLDFILEUID:NONE
NEWFILEUID:NONE
<OFX>
<SIGNONMSGSRSV1>
<SONRS>
<STATUS>
<CODE>0
<SEVERITY>INFO
</STATUS>
<DTSERVER>20260228120000
<LANGUAGE>ENG
</SONRS>
</SIGNONMSGSRSV1>
<BANKMSGSRSV1>
<STMTTRNRS>
<TRNUID>0
<STATUS>
<CODE>0
<SEVERITY>INFO
</STATUS>
<STMTRS>
<CURDEF>USD
<BANKACCTFROM>
<BANKID>021000021
<ACCTID>123456789
<ACCTTYPE>CHECKING
</BANKACCTFROM>
<BANKTRANLIST>
<DTSTART>20260201120000
<DTEND>20260228120000
<STMTTRN>
<TRNTYPE>CREDIT
<DTPOSTED>20260201120000
<TRNAMT>3500.00
<FITID>20260201001
<NAME>DIRECT DEP PAYROLL
<MEMO>ACME CORP PAYROLL
</STMTTRN>
<STMTTRN>
<TRNTYPE>DEBIT
<DTPOSTED>20260203120000
<TRNAMT>-87.50
<FITID>20260203001
<NAME>POS PURCHASE GROCERY
<MEMO>WHOLE FOODS #10847
</STMTTRN>
<STMTTRN>
<TRNTYPE>CHECK
<DTPOSTED>20260210120000
<TRNAMT>-1200.00
<FITID>20260210001
<NAME>CHECK 1045
<CHECKNUM>1045
</STMTTRN>
</BANKTRANLIST>
<LEDGERBAL>
<BALAMT>4712.50
<DTASOF>20260228120000
</LEDGERBAL>
<AVAILBAL>
<BALAMT>4712.50
<DTASOF>20260228120000
</AVAILBAL>
</STMTRS>
</STMTTRNRS>
</BANKMSGSRSV1>
</OFX>
Anatomia do Arquivo
O arquivo tem três seções principais:
1. Bloco de Cabeçalho -- As linhas de texto simples no topo (antes de <OFX>) declaram a versão OFX, codificação e configurações de segurança. Isso não é XML -- é um cabeçalho simples de chave-valor que os analisadores leem antes de processar o corpo SGML/XML.
2. Resposta de Login (SIGNONMSGSRSV1) -- Metadados de autenticação e servidor. O CODE 0 significa sucesso. A maioria dos arquivos importados usa valores de placeholder aqui.
3. Resposta do Extrato (BANKMSGSRSV1) -- Os dados financeiros reais:
BANKACCTFROM-- A conta à qual as transações pertencem (número de roteamento, número da conta, tipo de conta)BANKTRANLIST-- A lista de transações, delimitada por uma data de início e fimSTMTTRN-- Registros de transações individuaisLEDGERBALeAVAILBAL-- Saldos de fechamento e disponíveis em uma data específica
Observe a sintaxe SGML: tags como <TRNTYPE>CREDIT não têm fechamento </TRNTYPE>. O analisador infere o fim de um valor a partir do início da próxima tag -- SGML válido, mas XML inválido, razão pela qual o OFX 2.x adicionou tags de fechamento.
Tags OFX Principais
Aqui está uma tabela de referência das tags que você encontrará com mais frequência em arquivos OFX de extratos bancários:
| Tag | Descrição | Exemplo |
|---|---|---|
STMTTRN |
Contêiner de transação do extrato | Contém todos os campos para uma transação |
TRNTYPE |
Tipo de transação | DEBIT, CREDIT, CHECK, DEP, ATM, POS, XFER, FEE, SRVCHG, INT |
DTPOSTED |
Data de postagem | 20260215120000 (AAAA MM DD HH MM SS) |
TRNAMT |
Valor da transação (com sinal) | -87.50 (negativo = débito), 3500.00 (positivo = crédito) |
FITID |
ID da Transação da Instituição Financeira | 20260215001 -- identificador único para detecção de duplicatas |
NAME |
Nome do beneficiário ou comerciante | POS PURCHASE GROCERY |
MEMO |
Descrição adicional | WHOLE FOODS #10847 AUSTIN TX |
CHECKNUM |
Número do cheque | 1045 (apenas para transações de cheque) |
REFNUM |
Número de referência | Referência atribuída pelo banco para a transação |
BANKACCTFROM |
Informações da conta de origem | Contém BANKID (roteamento), ACCTID (conta), ACCTTYPE |
LEDGERBAL |
Saldo de fechamento/contábil | Contém BALAMT e DTASOF |
AVAILBAL |
Saldo disponível | Contém BALAMT e DTASOF |
CURDEF |
Código da moeda | USD, GBP, EUR, AUD, CAD |
O FITID -- Por Que Ele Importa
O FITID (Financial Institution Transaction ID) é a tag mais importante em um arquivo OFX de uma perspectiva contábil. É um identificador único atribuído a cada transação, e é o que permite a detecção de duplicatas.
Quando você importa um arquivo OFX para Xero, GnuCash ou qualquer outro software compatível, ele armazena todos os FITIDs que viu. Importe o mesmo arquivo novamente e o software verifica cada FITID em seu banco de dados, silenciosamente ignorando duplicatas.
Esta é a principal vantagem que o OFX tem sobre o CSV. Com o CSV, não há identificador único -- importar o mesmo arquivo duas vezes resultará em entradas duplicadas para limpeza manual.
OFX vs CSV
Ambos os formatos podem transferir transações bancárias para o software de contabilidade. O OFX vence na estrutura; o CSV vence na flexibilidade.
Por Que OFX É Melhor para Importações Contábeis
| Recurso | OFX | CSV |
|---|---|---|
| Mapeamento de colunas | Automático -- tags definem o significado | Manual -- você atribui cada coluna |
| Detecção de duplicatas | Sim (baseado em FITID) | Não -- reimportar cria duplicatas |
| Formato de data | Inequívoco (AAAA MM DD HH MM SS) | Varia por região -- DD/MM/AAAA vs MM/DD/AAAA |
| Manuseio de valores | Valores com sinal e TRNTYPE | Precisa analisar sinais, símbolos, separadores |
| Identificação da conta | Embutido (roteamento + número da conta) | Não incluído |
| Verificação de saldo | Saldo de fechamento incluído | Geralmente não incluído |
| Tipos de transação | Tipado (DEBIT, CREDIT, CHECK, etc.) | Texto livre ou ausente |
| Arquivos de múltiplas contas | Suportado em um único arquivo | Arquivos separados necessários |
O formato de data sozinho economiza horas de solução de problemas. Com CSV, 01/02/2026 é ambíguo -- 1º de fevereiro ou 2 de janeiro? O OFX elimina isso com AAAA MM DD HH MM SS. 20260201120000 é sempre 1º de fevereiro de 2026.
Quando CSV É a Melhor Escolha
CSV tem vantagens legítimas:
- Edição de dados -- Você pode abrir um CSV no Excel, corrigir erros, adicionar categorizações e salvar novamente. Arquivos OFX exigem um editor de texto e conhecimento da estrutura de tags.
- Análise no Excel -- Se você precisar executar fórmulas, tabelas dinâmicas ou gráficos em dados de transações, o CSV é o formato intermediário natural.
- Processamento personalizado -- Scripts programáticos e pipelines de dados lidam com CSV mais facilmente do que a estrutura de tags aninhadas do OFX.
- Compatibilidade universal -- Todos os aplicativos que leem dados tabulares leem CSV. Nem todos os aplicativos leem OFX.
O conselho prático: use OFX para importar para software de contabilidade e CSV para todo o resto.
OFX vs QBO
Esta é a pergunta que confunde a maioria das pessoas -- e a resposta é mais simples do que você imagina.
QBO (QuickBooks Web Connect) é OFX com uma extensão de arquivo diferente e algumas tags específicas da Intuit. A estrutura de dados subjacente é idêntica. Um arquivo QBO é um arquivo OFX que o QuickBooks reconhece como seu.
As Principais Diferenças
| Aspecto | OFX | QBO |
|---|---|---|
| Extensão do arquivo | .ofx |
.qbo |
| Especificação | Padrão aberto (FDX) | Subconjunto de marca Intuit |
| Identificador da IF | Bloco FI opcional |
Tag INTU.BID (Intuit Bank ID) |
| Software de destino | Xero, MYOB, GnuCash, Wave, etc. | QuickBooks (Desktop e Online) |
| Compatibilidade | Mais ampla -- a maioria dos softwares de contabilidade | Específico para QuickBooks |
A tag INTU.BID é a principal adição da Intuit -- um código identificador do banco que informa ao QuickBooks de qual instituição financeira o arquivo veio, permitindo o auto-emparelhamento com a conta bancária correta durante a importação.
Na prática, você pode renomear um arquivo .ofx para .qbo e o QuickBooks geralmente o lerá. O contrário também funciona -- a maioria dos softwares que leem OFX processará um arquivo .qbo. Mas para importações limpas, use o formato que cada aplicativo espera.
Existe também o QFX (Quicken Financial Exchange) -- mesma base OFX, marca diferente, extensão de arquivo diferente, voltado para o Quicken.
Software Que Suporta OFX
OFX tem amplo suporte em softwares de contabilidade e finanças pessoais:
Xero (Formato Preferido)
Xero recomenda explicitamente OFX em vez de CSV para importações manuais de extratos bancários. Arquivos OFX mapeiam automaticamente sem configuração de colunas, incluem detecção de duplicatas baseada em FITID e carregam metadados da conta.
Para importar: Vá para Contabilidade > Contas Bancárias, selecione a conta, clique em Gerenciar Conta > Importar Extrato e escolha seu arquivo .ofx. Máximo de 1.000 transações por arquivo.
MYOB (Suporte Completo)
MYOB aceita OFX para importações de feed bancário. O processo é semelhante ao Xero -- carregue o arquivo para a conta bancária relevante e as transações aparecem no feed bancário para correspondência e categorização.
GnuCash (Gratuito, Código Aberto)
GnuCash tem importação OFX integrada via biblioteca libofx. É uma das melhores opções gratuitas para processar arquivos OFX.
Para importar: Vá para Arquivo > Importar > Importar OFX/QFX, selecione seu arquivo e mapeie-o para a conta correta. A detecção de duplicatas do GnuCash usa o FITID para evitar entradas duplicadas.
Outros Softwares Compatíveis
- Wave -- Software de contabilidade gratuito com suporte à importação OFX
- Sage Business Cloud -- Aceita OFX para importações de transações bancárias
- FreeAgent -- Suporta uploads de arquivos OFX e QIF
- Moneydance -- Software de finanças pessoais com conexão direta OFX e importação de arquivos
- KMyMoney -- Gerenciador de finanças pessoais de código aberto com suporte OFX via
libofx - Microsoft Money -- Descontinuado, mas ainda usado por alguns; o suporte OFX integrado foi um de seus principais recursos
- Reckon (Austrália) -- Aceita arquivos OFX no fluxo de trabalho de importação de feed bancário
QuickBooks é a ausência notável -- ele prefere sua variante de marca QBO e funciona de forma mais confiável com arquivos .qbo que incluem o identificador INTU.BID.
Criando Arquivos OFX a Partir de Extratos Bancários em PDF
A maioria dos bancos não oferece downloads OFX diretamente. Eles fornecem um PDF -- formatado para impressão, não para troca de dados. Alguns oferecem exportações CSV para transações recentes (geralmente os últimos 90 dias), mas para dados históricos, contas encerradas ou bancos sem opções de exportação digital, você fica preso aos PDFs.
O Conversor de Extratos Bancários do PDFSub extrai transações de extratos bancários em PDF e gera arquivos OFX válidos com estrutura adequada. A saída inclui FITIDs únicos para cada transação, formatação de data correta AAAA MM DD, valores com sinal e tipos de transação apropriados, e metadados da conta -- tudo o que o software de contabilidade precisa para uma importação limpa.
O conversor funciona com extratos de mais de 20.000 bancos em 133 idiomas. PDFs digitais (extratos baseados em texto) são processados em seu navegador -- o arquivo nunca sai do seu dispositivo. Extratos digitalizados ou com muitas imagens são roteados através da extração de IA no lado do servidor.
Os planos começam em $10/mês, com conversão de extrato bancário a $29/mês (plano Business + add-on BSC, 500 páginas). Todos os planos pagos incluem um teste gratuito de 7 dias. Para um guia detalhado sobre como importar os arquivos OFX resultantes no Xero, consulte o guia de importação de extratos bancários do Xero.
Problemas Comuns de OFX e Como Resolvê-los
Arquivos OFX são estruturados, mas não à prova de falhas. Aqui estão os problemas mais frequentes e como resolvê-los:
1. Sintaxe Inválida de XML/SGML
Sintoma: Seu software rejeita o arquivo com um erro de análise.
Causa: Tags malformadas, tags de fechamento ausentes (em arquivos 2.x) ou caracteres ilegais em descrições. Ampersands (&) são o culpado mais comum -- eles devem ser codificados como & em XML, mas muitas vezes são deixados brutos em nomes como "AT&T."
Correção: Abra o arquivo em um editor de texto e substitua & brutos por &. Verifique também tags não fechadas se o arquivo for da versão 2.x.
2. FITIDs Ausentes ou Duplicados
Sintoma: A importação cria transações duplicadas, ou o software relata identificadores ausentes.
Causa: Algumas ferramentas de conversão geram o mesmo FITID para todas as transações (como 0 ou 1), ou omitem a tag completamente.
Correção: Cada FITID deve ser único dentro do arquivo. Um padrão comum combina a data e um contador sequencial: 20260215001, 20260215002, etc. Edite os FITIDs de placeholder em um editor de texto antes de importar.
3. Formato de Data Incorreto
Sintoma: Transações aparecem nas datas erradas, ou o software mostra datas de 1900 ou 2099.
Causa: O valor DTPOSTED não segue o formato AAAA MM DD HH MM SS. AAAA MM DD (sem hora) é aceitável, mas DD/MM/AAAA ou MM-DD-AAAA causará erros de análise.
Correção: Certifique-se de que todos os valores DTPOSTED usem AAAA MM DD ou AAAA MM DD HH MM SS. Tanto 20260215 quanto 20260215120000 são válidos.
4. Problemas de Codificação de Caracteres
Sintoma: Descrições de transações mostram caracteres embaralhados, pontos de interrogação ou acentos ausentes.
Causa: O cabeçalho do arquivo declara uma codificação (geralmente USASCII ou UTF-8), mas o conteúdo real usa uma codificação diferente. Isso é especialmente comum com extratos bancários internacionais que contêm caracteres não ASCII.
Correção: Altere o cabeçalho ENCODING para corresponder à codificação real do arquivo. Para extratos internacionais com caracteres acentuados, UTF-8 é a escolha mais segura. Alguns softwares mais antigos exigem USASCII sem caracteres especiais.
5. Compatibilidade de Versão (1.x vs 2.x)
Sintoma: Software que espera OFX 2.x rejeita um arquivo 1.x, ou vice-versa.
Causa: OFX 1.x usa marcação SGML (tags não precisam ser fechadas), enquanto 2.x usa XML adequado (todas as tags devem ser abertas e fechadas). Analisadores construídos para uma versão podem falhar com a outra.
Correção: A maioria dos softwares de contabilidade modernos lida com ambas as versões. Se o seu não o faz, converta entre versões adicionando tags de fechamento (1.x para 2.x) ou removendo-as (2.x para 1.x). A busca e substituição em um editor de texto lida com isso para arquivos pequenos.
Perguntas Frequentes
O que significa OFX?
OFX significa Open Financial Exchange -- um padrão aberto para troca eletrônica de dados financeiros entre instituições financeiras e aplicações de usuário final, mantido pela Financial Data Exchange (FDX).
OFX é o mesmo que QBO?
Quase. QBO é a versão de marca da Intuit do OFX para o QuickBooks. A estrutura de dados é idêntica -- QBO adiciona uma tag INTU.BID para identificação do banco e usa a extensão .qbo. Frequentemente, você pode renomear .ofx para .qbo e o QuickBooks o aceitará.
Posso abrir um arquivo OFX no Excel?
Não diretamente como dados estruturados. O Excel abrirá o arquivo como um arquivo de texto, mostrando a marcação SGML/XML bruta. Para visualizar dados OFX no Excel, você precisa convertê-lo para CSV ou XLSX primeiro, ou usar um suplemento de terceiros que analise as tags OFX em colunas de planilha.
Qual é melhor para o Xero -- OFX ou CSV?
OFX é melhor para o Xero. Ele importa automaticamente sem mapeamento de colunas, inclui detecção de duplicatas baseada em FITID, usa um formato de data inequívoco e carrega metadados da conta. A própria documentação do Xero recomenda OFX em vez de CSV para importações manuais de extratos bancários.
Os bancos fornecem downloads OFX?
Alguns sim, mas é inconsistente. Grandes bancos nos EUA, Reino Unido e Austrália podem oferecer downloads OFX ou QFX para transações recentes (geralmente os últimos 90 dias). Muitos bancos menores, cooperativas de crédito e instituições internacionais fornecem apenas extratos em PDF. Para dados históricos além da janela de download, a conversão de PDF geralmente é a única opção.
OFX é seguro?
A especificação OFX inclui provisões para criptografia SSL/TLS durante a transmissão e autenticação baseada em certificado para conexões diretas. No entanto, um arquivo OFX salvo em disco é texto puro -- ele contém números de conta e detalhes de transações em forma legível. Trate os arquivos OFX com o mesmo cuidado que você daria a qualquer documento financeiro.
Qual é a diferença entre OFX 1.x e 2.x?
OFX 1.x usa marcação SGML (tags não precisam ser fechadas), enquanto 2.x usa XML adequado (todas as tags devem ser abertas e fechadas). O conteúdo dos dados é o mesmo -- a diferença é sintática. A versão 1.6 continua sendo o formato mais gerado. A maioria dos softwares de contabilidade modernos analisa ambas as versões sem problemas.
Posso editar um arquivo OFX manualmente?
Sim. Arquivos OFX são texto puro e podem ser editados em qualquer editor de texto. Você pode corrigir descrições, corrigir valores, adicionar FITIDs ausentes ou ajustar datas. Apenas mantenha a estrutura de tags -- uma tag não fechada ou incompatível causará falhas na importação. Para arquivos OFX 2.x, certifique-se de que cada tag de abertura tenha uma tag de fechamento correspondente.