De OFX e CNAB para API: como migrar a integração bancária do ERP

A maior parte dos ERPs e sistemas de gestão brasileiros ainda troca informação com banco por arquivo: OFX para ler extrato, CNAB para enviar ordem de pagamento e receber retorno. Funciona, está em produção há décadas e ninguém vai desligar isso amanhã.

O problema não é o formato. É que arquivo é lote, e lote impõe um atraso que o produto inteiro herda. Quem faz a conciliação descobre o que aconteceu quando o arquivo chega, não quando o dinheiro se move.

Este artigo explica o que muda ao trocar arquivo por API, o que não muda, e como fazer a migração sem reescrever o produto.

OFX, CNAB e API lado a lado

Por que arquivo ainda é a regra

Vale reconhecer o motivo antes de propor troca, porque quem mantém esses fluxos tem razões boas.

O OFX resolveu de fato um problema: antes dele, cada banco exportava do seu jeito. O CNAB fez o mesmo do lado de pagamento e cobrança, com layouts que viraram padrão de mercado pela FEBRABAN.

E principalmente: está funcionando. Trocar uma integração que funciona por outra exige justificar o esforço.

O que arquivo cobra do seu produto

A conta aparece em lugares que não parecem integração bancária:

• Alguém precisa buscar. Todo fluxo por arquivo tem um passo humano no começo, seja o cliente baixando OFX, seja alguém do time subindo remessa.
• O dado nasce velho. Entre o fato e o arquivo existe uma janela. Toda funcionalidade que depende de saldo ou de confirmação herda essa janela.
• Cada banco é um caso. O layout é padrão, a implementação varia. Na prática o seu time mantém exceções por instituição, e cada mudança de banco vira ticket.
• Erro descoberto tarde. Um pagamento que falhou aparece no retorno. Até lá, o sistema acha que deu certo.
• Suporte carrega o resto. Boa parte dos chamados de "meu extrato não bateu" é arquivo faltando, duplicado ou fora de ordem.

O que a API muda

Com Open Finance e conectores de acesso direto, o cliente autoriza uma vez e os dados passam a chegar sozinhos:

• saldo, extrato e transações em requisição ou por webhook, sem ninguém baixar nada;
• todas as instituições no mesmo JSON, então a exceção por banco sai do seu código;
• transações já categorizadas pela camada de enriquecimento, incluindo identificação de recorrência e de transferência entre contas do mesmo titular;
• iniciação de pagamento por Pix dentro do próprio sistema, com confirmação em segundos em vez de retorno em lote.

A Pluggy é autorizada pelo Banco Central como Iniciadora de Transação de Pagamento, então leitura de dado e movimentação de dinheiro acontecem na mesma integração e no mesmo contrato.

Como migrar sem parar o produto

O erro comum é tratar isso como substituição de uma vez. Não precisa ser.

1. Rode os dois em paralelo. Ligue a API para um conjunto pequeno de clientes mantendo o fluxo de arquivo ativo. Compare as duas saídas no mesmo período e você descobre divergência antes de qualquer cliente descobrir.

2. Comece pela leitura, não pelo pagamento. Extrato é o de menor risco: se der errado, ninguém perde dinheiro. Pagamento entra depois, com a confiança já construída.

3. Ataque primeiro os bancos que mais geram ticket. Não é preciso cobrir tudo no primeiro release. O ganho aparece nas instituições onde o arquivo mais falha hoje.

4. Trate consentimento como parte do fluxo. O consentimento do Open Finance tem prazo de validade compatível com a finalidade declarada e pode ser revogado pelo cliente. Renovação é rotina normal, não exceção a resolver depois.

5. Só desligue o arquivo quando a API cobrir o caso. Instituição ou dado fora do escopo regulado continua exigindo o caminho antigo, e tudo bem.

O que não muda

Seu modelo de dados provavelmente continua igual. A API entrega saldo, extrato e transação, que são as mesmas entidades que você já processa do OFX. O que muda é o transporte e a frequência, não o domínio.

A conciliação também continua sendo sua. A API entrega dado limpo e categorizado, mas a regra de negócio que casa lançamento com movimentação é do seu produto.

Perguntas frequentes

Preciso abandonar o OFX e o CNAB?

Não. A maioria das integrações no Brasil convive com os dois por um bom tempo. O objetivo é tirar o arquivo do caminho crítico, não eliminá-lo no primeiro dia.

A API cobre todos os bancos que meu CNAB cobre?

Depende da instituição. O Open Finance cobre as participantes, e os conectores de acesso direto cobrem parte do que fica de fora. Vale checar a cobertura das instituições que concentram seus clientes antes de planejar.

Quanto tempo leva a integração?

O sandbox fica disponível no ato do cadastro, sem aprovação comercial. O tempo até produção depende muito mais das suas regras de conciliação do que da API em si.

Meu cliente precisa fazer algo?

Sim, uma vez: autorizar o compartilhamento no app ou site do próprio banco. Depois disso o fluxo é automático até o consentimento vencer ou ser revogado.

E se o banco cair?

Continua sendo um problema, como já é com arquivo. A diferença é que você sabe na hora, em vez de descobrir quando o arquivo não chegou.

Por onde começar

O recorte completo para sistemas de gestão está em Open Finance para ERP e sistemas de gestão, e o caminho técnico detalhado está no guia de API de extrato bancário para ERPs.

Para testar, o sandbox é gratuito e não pede cartão de crédito. A documentação está em docs.pluggy.ai.

Última atualização: 17 de setembro de 2026.