Integração Bancária (Banco Inter)

O que é a Integração Bancária

A Integração Bancária conecta uma conta bancária cadastrada no ERP à API oficial do banco. Com isso, o Bunto consegue:

• Consultar o saldo atual da conta em tempo real.
• Importar o extrato de forma automática, criando movimentos no fluxo de caixa.
• Conciliar o que entrou e saiu no banco com o que foi lançado no ERP.
• Emitir boletos e pix dinamicamente quando necessário.

Atualmente o Bunto suporta o Banco Inter, com arquitetura extensível para outros bancos. As credenciais (client secret, certificado cliente, chave privada) ficam criptografadas no banco de dados usando Fernet — nunca expostas em texto puro.

Como acessar

A integração é configurada a partir da conta bancária. No menu lateral, acesse Configurações → Meios de Pagamento → Contas Bancárias. Abra a conta desejada e use o bloco de integração bancária para iniciar a configuração.

Pré-requisitos

Para integrar com o Banco Inter, você precisa:

• Conta PJ ativa no Inter.
• Aplicação cadastrada no portal do desenvolvedor do Inter.
• Client ID e Client Secret da aplicação.
• Certificado cliente (arquivo .crt) e chave privada (.key) emitidos pelo Inter.
• Escopos autorizados — leitura de extrato, saldo, cobrança, pix etc.

Configuração

Dados da aplicação

• Provedor — Banco Inter.
• Ambiente — sandbox (testes) ou produção.
• Client ID — identificador público da aplicação.
• Client secret — chave secreta (armazenada criptografada).

Certificado

• Upload do .crt e do .key (ambos criptografados no banco).
• O sistema calcula o fingerprint e armazena as datas de emissão e expiração para alertar antes do vencimento.

Escopos

Lista de escopos OAuth que a aplicação vai usar (por exemplo, extrato.read, pagamento-pix.write). Eles precisam bater com o que foi autorizado no portal do Inter.

Conta corrente

Quando a aplicação tem acesso a várias contas, informe a conta corrente específica que será usada.

Ações disponíveis

• Testar conexão — valida credenciais e certificado. O resultado é gravado como último teste em e, em caso de erro, em último erro.
• Sincronizar saldo — atualiza o saldo do caixa vinculado com o valor real do banco.
• Importar extrato — busca os movimentos de um período e cria os lançamentos no fluxo de caixa.
• Renovar certificado — quando o certificado está perto de expirar, faz upload do novo.
• Revogar acesso — remove a integração, invalida o token na API do banco.

Conciliação

Após importar o extrato, os movimentos chegam marcados como vindos da integração. Você pode:

• Conciliar — vincular o movimento do extrato a um pagamento ou recebimento já lançado no ERP.
• Lançar novo — criar um novo movimento diretamente a partir da linha do extrato.
• Ignorar — marcar como já tratado (em casos raros).

Essa conciliação automatiza uma das tarefas mais chatas do financeiro: comparar, linha por linha, o extrato do banco com o que está no sistema.

Status da integração

Integrações com outros módulos

Conta bancária

Cada integração é vinculada a uma conta bancária única. A mesma conta não pode ter duas integrações ativas.

Caixa

Os movimentos importados do extrato alimentam o caixa correspondente à conta, mantendo o saldo do ERP sincronizado com o banco.

Fluxo de caixa

Movimentos importados aparecem no fluxo de caixa com a origem integração bancária.

Cobranças bancárias

A integração permite emitir boletos diretamente pela API e recebê-los marcados no retorno automático.

Pix

Com os escopos de pix habilitados, o Bunto pode gerar QR Codes de cobrança dinâmica e consultar o status em tempo real.

Segurança

Credenciais e certificados são criptografados com Fernet antes de persistir. A API do ERP nunca expõe esses dados em endpoints de leitura. As chamadas para o banco são assinadas com o certificado cliente e autenticadas por OAuth 2.0.

Permissões

• Visualizar finanças.
• Gerenciar integração bancária.
• Sincronizar saldo.
• Importar extrato.
• Revogar integração.

Perguntas frequentes

Qual a diferença entre ambiente sandbox e produção?

Sandbox é o ambiente de testes — credenciais separadas, dados fictícios, sem movimentação real. Produção é o ambiente real, com movimentos de verdade. Comece sempre pelo sandbox para validar a configuração.

O que acontece se o certificado vencer?

O status da integração muda para Expirada e as chamadas passam a falhar. Renove o certificado com o novo .crt e .key antes que isso aconteça.

O sistema importa extrato automaticamente?

A importação pode ser agendada ou disparada manualmente, dependendo da sua configuração operacional.

Posso integrar com outros bancos além do Inter?

A arquitetura está preparada para outros bancos. Atualmente o Inter é o provedor suportado. Integrações com Itaú, Banco do Brasil, Santander e Sicredi estão no roadmap.

Como revogo o acesso?

Use a ação Revogar acesso. O sistema remove as credenciais do ERP e, quando a API do banco permite, invalida o token correspondente — garantindo que nenhuma chamada futura será aceita.