Conciliação bancária para devs: OFX, CNAB e Open Finance

Escrito por: Rafael Caribé, CEO, Agilize

Principais lições deste artigo

• ME e EPP no Simples Nacional precisam conciliar extratos bancários em formatos OFX, CNAB e Open Finance para cumprir obrigações contábeis e realizar cálculos como o Fator R.

• Um motor de conciliação eficaz segue cinco etapas claras: ingestão, normalização, matching em camadas, fila de exceções e reconciliação final com trilha de auditoria.

• Armazenar valores em centavos, garantir idempotência e manter um ledger imutável reduzem erros e aumentam a conformidade.

• Manter parsers internos exige manutenção contínua diante de atualizações regulatórias do Open Finance e novos layouts CNAB, o que consome tempo que poderia ser dedicado ao produto.

• Delegar a conciliação bancária para a Agilize Contabilidade permite que o time técnico foque no produto enquanto especialistas cuidam da rotina contábil; fale com a Agilize Contabilidade.

O problema: a rotina contábil obrigatória e a dor de sincronização

ME e EPP no Simples Nacional têm obrigações contábeis formais. A legislação empresarial exige escrituração contábil regular, e a contratação de um contador é obrigatória. Para empresas de serviços intelectuais, como programadores, engenheiros e arquitetos, enquadradas nos anexos do Simples Nacional III ou V, o controle financeiro precisa estar alinhado com a contabilidade para que cálculos como o Fator R sejam aplicados corretamente.

A sincronização entre bancos e sistemas internos concentra a maior parte da dor. Extratos chegam em formatos distintos, como OFX exportado manualmente do internet banking, CNAB 240 ou CNAB 400 gerado pelo banco, e também via endpoints do Open Finance. Cada fonte tem estrutura, encoding e semântica de datas diferentes. Manter esses dados alinhados com o sistema interno consome tempo que poderia ser usado no desenvolvimento do produto.

Empresas com 20 a 200 funcionários gastavam entre 12 e 18 horas semanais em conciliação bancária manual em 2024. A chegada do Open Finance e da automação reduziu esse número para 4 a 6 horas semanais em 2026, mas mesmo essa redução ainda representa um custo operacional relevante para equipes enxutas que precisam priorizar desenvolvimento de produto.

A solução: fluxo técnico em cinco etapas

Um motor de conciliação eficaz processa dados de múltiplas fontes, normaliza formatos distintos e identifica correspondências de forma automática. As cinco etapas a seguir formam a base de uma implementação robusta para ME e EPP que precisam manter a contabilidade em dia sem desviar o foco do produto.

1. Ingestão de arquivos OFX/CNAB e endpoints Open Finance

OFX é um formato XML estruturado exportado manualmente pelo usuário. CNAB 240 e CNAB 400 são arquivos de posição fixa gerados pelo banco, com layouts definidos pela Febraban. O Open Finance, regulado pelo Banco Central via Instrução Normativa BCB nº 720 de abril de 2026, disponibiliza os dados via API REST autenticada com OAuth 2.0, certificados ICP-Brasil e algoritmos AES-256 e RSA-2048.

Para acessar transações via Open Finance, o cliente precisa autorizar o consentimento. O escopo de consentimento segue o formato consent:{ConsentResourceId}, implementado como UUIDv4, e o token de acesso expira entre 300 e 900 segundos. O endpoint de transações exige o header x-fapi-interaction-id em todas as requisições.

2. Normalização de dados

Cada fonte entrega campos com nomes, formatos de data e representações de valor distintos. A normalização mapeia todos os feeds para um schema canônico único antes de qualquer lógica de matching. Sem essa etapa, os algoritmos de matching produzem falsos positivos e perdem divergências reais. O dado bruto original precisa ser preservado intacto para auditoria e resolução de disputas.

3. Motor de matching em camadas

O matching opera em camadas determinísticas que reduzem o trabalho manual:

1. Correspondência exata por identificador único, como EndToEndId para Pix, NSU para cartão, número do documento ou código de barras para boleto e ID interno do pedido.

2. Correspondência por valor e data dentro de uma janela temporal para absorver diferenças de fuso e atraso de liquidação.

3. Tolerância de centavos para lidar com arredondamentos.

Sistemas de reconciliação automatizados podem atingir altas taxas de auto-match na primeira passagem, o que reduz de forma relevante o volume de transações que exigem revisão manual.

4. Fila de exceções

Transações sem correspondência seguem para uma fila de exceções organizada por tipo. Os tipos mais comuns no fluxo brasileiro incluem boletos pagos abaixo do valor de face, tarifas bancárias sem lançamento interno, depósitos em trânsito, transações duplicadas entre canais, chargebacks pendentes e exceções de liquidação de split. Cada item na fila precisa ter causa raiz classificada, como erro de lançamento, transação não registrada, transação pendente ou divergência a investigar.

5. Reconciliação final

Após o matching e o tratamento de exceções, o sistema gera o saldo reconciliado e exporta o resultado para o sistema contábil. O histórico de cada decisão, incluindo ajustes manuais, precisa ser registrado de forma imutável para garantir rastreabilidade em auditorias.

Estrutura de banco de dados recomendada

Para que o fluxo de cinco etapas funcione na prática, a estrutura de dados precisa garantir rastreabilidade, auditoria e boa performance. Um modelo de dados confiável para conciliação bancária requer pelo menos três tabelas principais:

• transactions: armazena cada transação normalizada com campos de valor em inteiro, em centavos, data de competência, data de liquidação, identificador de origem, identificador canônico e status, como pendente, matched ou exceção.

• matching_rules: registra as regras aplicadas em cada tentativa de matching, com versão e timestamp, o que permite auditar qual lógica produziu cada resultado.

• reconciliation_ledger: tabela append-only que registra cada evento de reconciliação, como match confirmado, exceção criada e ajuste manual, sem permitir UPDATE ou DELETE. Essa arquitetura usa uma camada de memória de estado, ou state ledger, separada do motor de matching, com trilhas de auditoria automáticas desde o início para garantir conformidade com LGPD e políticas internas.

Boas práticas de implementação

• Valores monetários como inteiros: armazene sempre em centavos, usando tipo INTEGER, e nunca em FLOAT. Operações de ponto flutuante introduzem erros de arredondamento acumulativos.

• Idempotência na ingestão: use o identificador único de cada transação como chave de deduplicação. Reprocessar o mesmo arquivo OFX ou CNAB não deve criar registros duplicados.

• Tarifas bancárias: tarifas aparecem no extrato bancário sem lançamento interno correspondente, por isso crie uma regra de matching específica para categorizar automaticamente esses itens com base em descrição e valor típico.

• Depósitos em trânsito: a janela temporal do matching precisa absorver a diferença de liquidação de boletos mencionada anteriormente, com corte em torno de 13h30 e crédito no mesmo dia útil ou no dia útil seguinte.

• Boletos com valor divergente: pagamentos parciais ou com desconto exigem regra de tolerância percentual, e não apenas de centavos.

Build vs usar solução pronta

Manter lógica interna de conciliação bancária faz sentido quando o volume de transações é alto, o modelo de negócio exige regras de matching muito específicas ou a equipe tem capacidade técnica dedicada para manutenção contínua. O custo real inclui o desenvolvimento inicial, a manutenção de parsers para cada versão de layout CNAB, a adaptação às atualizações do Open Finance, como a versão 5.0 do Manual de Segurança publicada em abril de 2026, e o tratamento de novos tipos de exceção a cada mudança regulatória.

Para PMEs brasileiras, a automação da conciliação bancária reduz significativamente os custos operacionais. Para ME e EPP de serviços no Simples Nacional, a conta é direta, o tempo gasto em conciliação é tempo retirado do produto. É nesse cenário que delegar a rotina contábil faz mais sentido.

A Agilize Contabilidade oferece conciliação bancária integrada como parte da contabilidade online da empresa. Nos planos Unique e Unique Plus, a importação de extratos bancários de até 2 ou 3 contas está incluída, com categorização de transações e conciliação financeira feita pelo time de especialistas, sem que o empreendedor precise configurar parsers, gerenciar filas de exceção ou acompanhar mudanças de API.

Checklist rápida de implementação

• Definir as fontes de dados, como OFX manual, CNAB 240 ou 400 via SFTP ou Open Finance via API.

• Implementar parser com schema canônico e preservação do dado bruto.

• Armazenar valores monetários como inteiros em centavos.

• Garantir idempotência na ingestão com chave de deduplicação por identificador único.

• Configurar janela temporal para depósitos em trânsito, com mínimo de D+1 útil.

• Criar regras de matching em camadas, começando por ID exato, depois valor e data, e por fim tolerância.

• Implementar fila de exceções com classificação de causa raiz.

• Registrar todo o histórico de decisões em tabela append-only, com ledger imutável.

• Monitorar atualizações do Manual de Segurança do Open Finance do Banco Central.

• Validar com o contador responsável que o output da conciliação está alinhado com a escrituração contábil.

Perguntas frequentes sobre conciliação bancária para devs

Qual a diferença entre OFX, CNAB 240 e CNAB 400?

OFX é um formato baseado em XML exportado manualmente pelo usuário no internet banking, adequado para volumes menores e integração direta com sistemas contábeis. CNAB 240 e CNAB 400 são formatos de arquivo de posição fixa definidos pela Febraban, gerados automaticamente pelo banco e transmitidos via SFTP ou EDI, e o número indica a quantidade de caracteres por linha. CNAB 240 é mais completo e suporta múltiplos lotes de pagamento. CNAB 400 é mais simples e ainda amplamente usado por bancos menores. O Open Finance reduz a necessidade de exportação manual ao disponibilizar os dados via API autenticada em tempo próximo ao real.

O Open Finance elimina a necessidade de processar OFX e CNAB?

O Open Finance não elimina totalmente a necessidade de OFX e CNAB. O Open Finance cobre as instituições participantes obrigadas pelo Banco Central, mas nem todos os bancos e fintechs têm cobertura total de todos os tipos de transação via API. OFX e CNAB continuam necessários como fallback para instituições com cobertura parcial, para históricos anteriores à adesão ao Open Finance e para fluxos de pagamento que ainda não têm endpoint padronizado. Uma implementação robusta mantém os três parsers ativos.

Como tratar boletos pagos com valor diferente do emitido?

Boletos podem ser pagos com desconto, juros por atraso ou multa, o que resulta em valor diferente do registrado internamente. A regra de matching deve primeiro tentar correspondência exata por código de barras ou número do documento. Se o identificador bater, mas o valor divergir, o sistema precisa classificar a transação como exceção do tipo “valor divergente” e registrar a diferença para ajuste contábil. Não aplique tolerância de centavos para boletos, porque a divergência pode ser intencional e precisa de revisão.

ME e EPP são obrigadas a fazer conciliação bancária?

Como mencionado anteriormente, ME e EPP têm obrigação legal de escrituração contábil, e a conciliação bancária é parte essencial desse processo, porque valida os lançamentos contábeis contra a movimentação real da conta. Para empresas no Simples Nacional que calculam o Fator R, a precisão dos dados financeiros impacta diretamente a alíquota de imposto aplicada. O contador responsável pela empresa é quem garante que a conciliação está correta e alinhada com as obrigações fiscais.

Quando vale a pena delegar a conciliação bancária para a contabilidade online?

Para ME e EPP de serviços com volume de transações moderado, típico de empresas de desenvolvimento de software, consultoria ou serviços intelectuais, o custo de manter e evoluir um motor de matching interno raramente se justifica. Cada atualização regulatória do Open Finance, cada novo layout de CNAB ou cada mudança de API bancária exige manutenção. Delegar essa rotina para a Agilize Contabilidade permite que o time técnico foque no produto enquanto especialistas contábeis cuidam da conciliação, da escrituração e das obrigações fiscais da empresa.

Conclusão

Implementar um motor de matching bancário com OFX, CNAB e Open Finance é tecnicamente viável e bem documentado. O fluxo de cinco etapas, com ingestão, normalização, matching, fila de exceções e reconciliação final, cobre os principais cenários do mercado brasileiro, incluindo as particularidades de boletos, Pix e tarifas bancárias.

A decisão de construir ou usar uma solução pronta depende do volume de transações, da capacidade de manutenção da equipe e do custo de oportunidade de dedicar tempo de engenharia a uma rotina contábil obrigatória. Para a maioria das ME e EPP de serviços no Simples Nacional, a Agilize Contabilidade cuida de toda a contabilidade da empresa, incluindo conciliação bancária, para que o empreendedor foque na estratégia do negócio.