Introdução
Você gasta horas conferindo extratos bancários para bater com seus lançamentos contábeis? Com o n8n e a API do Banco Inter, você cria um fluxo que extrai extratos, compara transações e atualiza planilhas automaticamente — sem saber programar. Basta configurar nós prontos e deixar a máquina trabalhar por você, economizando tempo e eliminando erros manuais.
Este guia mostra como montar uma automação completa: desde a geração da API Key no painel do Banco Inter até a integração com o Google Sheets ou um arquivo CSV. Você aprenderá a usar nós essenciais como HTTP Request, JSON Parser e Spreadsheet File, além de dicas para agendar a execução diária e resolver problemas comuns. Tudo passo a passo, com prints e exemplos práticos.
Por que automatizar a conciliação bancária é crucial para o seu negócio
A conciliação bancária manual consome tempo e introduz erros que podem custar caro: 30% das pequenas e médias empresas brasileiras enfrentam divergências fiscais por falhas nesse processo, segundo o SEBRAE. Cada lançamento não conferido pode gerar multas, juros e retrabalho na contabilidade.
Automatizar essa tarefa elimina inconsistências e libera você para focar no que realmente importa: crescer o negócio. Com um fluxo no n8n, você garante que cada transação do extrato do Banco Inter seja comparada automaticamente com seus lançamentos, destacando divergências em segundos. Para entender como a API viabiliza isso, confira nosso guia O que é API? Explicado de forma simples.
O que você precisa antes de começar: requisitos técnicos e acesso
Antes de montar o fluxo, reúna esses itens:
| Item | Detalhes | Onde obter |
|---|---|---|
| Conta no Banco Inter (Pessoa Jurídica) | Obrigatório para acessar a API de extratos | Site do Banco Inter |
| API Key do Banco Inter | Credencial para autenticar chamadas à API | Painel do Banco Inter > Desenvolvedores > Credenciais |
| n8n instalado | Versão local (Docker), nuvem ou self-hosted | n8n.io |
| Conta no Google Sheets | Opcional, mas recomendado para armazenar resultados | Google Sheets |
| Navegador moderno | Chrome, Firefox ou Edge (para acessar interfaces) | Qualquer navegador atualizado |
Aviso: A API do Banco Inter exige permissões específicas. Nunca compartilhe sua API Key ou Client Secret publicamente. Use variáveis de ambiente no n8n para armazená-las com segurança.
Para mais detalhes sobre as permissões, consulte a documentação oficial da API do Banco Inter.
Configurando a API do Banco Inter no n8n: passo a passo detalhado
Primeiro, gere suas credenciais no Banco Inter para acessar a API de extratos. No painel do banco, vá em Desenvolvedores > Credenciais e crie uma nova chave com escopo para Extrato.
-
Gerar API Key e Client Secret
No painel do Banco Inter, acesse Desenvolvedores > Credenciais e crie uma nova aplicação. Anote a API Key e o Client Secret gerados — você precisará deles para autenticar no n8n.
-
Configurar nó HTTP Request no n8n
No n8n, adicione um nó HTTP Request e preencha os campos:
- URL: `https://api.bancointer.com.br/openbanking/v1/transactions`
- Method: `GET`
- Authentication: `OAuth2`
- Client ID: Sua API Key do Banco Inter
- Client Secret: Seu Client Secret
- Query Parameters: `dataInicial` e `dataFinal` (formato: `YYYY-MM-DD`)
-
Testar endpoint de extrato
Execute o nó e verifique se a resposta retorna um JSON com as transações. Se der erro 401, revise as credenciais. Para autenticação com OAuth2, confira nosso guia Como usar a API do ChatGPT para iniciantes.
Dica: O Banco Inter atualiza extratos em horários específicos. Teste com uma data recente (ex: ontem) para garantir que os dados retornam corretamente.
Montando o fluxo de automação no n8n: do extrato à planilha
Com a API configurada, monte o fluxo no n8n para extrair extratos, processá-los e salvar em uma planilha. Este é o fluxo padrão:
- HTTP Request: Busca os extratos da API do Banco Inter
- JSON Parser: Extrai os dados relevantes (data, descrição, valor, tipo)
- Set: Adiciona colunas personalizadas (ex: "Status", "Divergência")
- Spreadsheet File: Gera um arquivo CSV ou Excel
- Google Sheets (opcional): Envia os dados para uma planilha
| Nó | Função | Configuração essencial |
|---|---|---|
| HTTP Request | Faz a chamada à API do Banco Inter | Método GET, URL com parâmetros de data, autenticação OAuth2 |
| JSON Parser | Transforma o JSON bruto em dados estruturados | Selecione o campo "transactions" no JSON de resposta |
| Set | Adiciona metadados ou regras de negócio | Ex: `{{$json.valor > 0 ? "Receita" : "Despesa"}}` |
| Spreadsheet File | Gera um arquivo CSV ou Excel | Selecione as colunas desejadas para exportar |
| Google Sheets | Envia dados para uma planilha | Autorize a integração no n8n e selecione a planilha |
Exemplo de fluxo: Ao executar o nó HTTP Request, o n8n busca os extratos do Banco Inter. O JSON Parser filtra apenas as transações, e o Set adiciona uma coluna "Status" com valores "OK" ou "Divergente". O Spreadsheet File exporta tudo para um CSV, que pode ser salvo em sua máquina ou enviado para o Google Sheets.
Automatizando a conciliação com regras inteligentes: como evitar divergências
Comparar extratos bancários com lançamentos contábeis exige regras claras. Use o nó Function no n8n para aplicar lógica personalizada, como: se o valor da transação no extrato for igual ao lançamento ± R$5, marque como "OK".
No Google Sheets, crie uma fórmula como `=SE(E(A2=B2; ABS(C2-D2)<5); "OK"; "Divergente")` para comparar data, descrição e valor entre duas colunas.
Exemplo avançado: Use IA no nó Function para classificar transações automaticamente. Com uma lista de palavras-chave ("Salário", "Aluguel", "Internet"), o n8n categoriza cada lançamento sem você precisar revisar manualmente.
Regras de comparação essenciais
- Tolerância de valor: Ignore divergências de até R$5 (comum em taxas ou arredondamentos).
- Data aproximada: Use `DATEDIF` no Google Sheets ou `moment.js` no n8n para aceitar transações até 2 dias de diferença.
- Descrição flexível: Normalize textos com `LOWER()` e remova caracteres especiais antes de comparar.
Curiosidade: O Banco Inter arredonda valores em centavos nas APIs. Se seu sistema usa mais casas decimais, ajuste a regra de comparação para evitar falsos positivos.
Agendando a automação: como rodar diariamente sem sua intervenção
Configure um Cron no n8n para executar o fluxo automaticamente todos os dias às 08:00 BRT (horário de atualização dos extratos no Banco Inter).
No nó Cron, use a sintaxe `0 8 * * *` para rodar diariamente às 8h da manhã, horário de Brasília. Ajuste para `0 7 * * *` se você estiver no Acre (fuso -4).
Dica: O Banco Inter atualiza extratos entre 06:00 e 07:30 BRT. Agende seu fluxo para executar após esse período, evitando dados incompletos.
Configuração passo a passo do Cron no n8n
-
Adicione o nó Cron
No painel do n8n, arraste o nó Cron para o fluxo e conecte-o ao início.
-
Defina a frequência
No campo Trigger Times, insira `0 8 * * *` (8h BRT todos os dias).
-
Teste manualmente antes de agendar
Execute o fluxo uma vez para garantir que todos os nós funcionam antes de confiar no agendamento.
Curiosidade: Se você usa n8n na nuvem, o agendamento fica a cargo dos servidores da plataforma. Em instalações locais, o nó Cron depende da máquina estar ligada no horário agendado.
Erros comuns e como resolvê-los: o guia de troubleshooting do n8n + Banco Inter
Problemas com APIs bancárias geralmente vêm de autenticação, dados ou timeout. Aqui estão os erros mais frequentes e suas soluções:
| Erro | Causa provável | Solução |
|---|---|---|
| 401 Unauthorized | API Key ou Client Secret inválidos | Revise as credenciais no nó HTTP Request. Teste com um novo par de chaves no painel do Banco Inter. |
| 403 Forbidden | Escopo da API incorreto (ex: extrato não habilitado) | Acesse o painel do Banco Inter > Desenvolvedores > Credenciais e adicione o escopo "Extrato" à sua aplicação. |
| 404 Not Found | URL errada ou data fora do intervalo disponível | Verifique a URL (`https://api.bancointer.com.br/openbanking/v1/transactions`) e use datas no formato `YYYY-MM-DD` dentro do período permitido pela API (geralmente últimos 90 dias). |
| Timeout (504) | Servidor do Banco Inter lento ou limite de requisições atingido | Aguarde 1-2 minutos e tente novamente. A API do Banco Inter tem limite de 100 requisições por minuto. |
| JSON Inválido | Resposta da API não está no formato esperado | Use o nó Set para validar o JSON antes de processá-lo. Adicione um nó IF para desviar fluxos com erro. |
Curiosidade: O Banco Inter retorna erros 429 quando você excede o limite de requisições. Use o nó Wait no n8n para aguardar 60 segundos entre chamadas consecutivas à API.
Alternativas e próximos passos: levando essa automação para outros bancos
Adapte este fluxo para outros bancos trocando apenas a URL da API e o método de autenticação. O Nubank usa OAuth2, enquanto Itaú e Bradesco usam Basic Auth ou Bearer Token.
Para bancos sem API pública, use o nó Webhook do n8n para receber notificações de transações via email ou SMS e processá-las automaticamente.
Tabela de adaptação para APIs bancárias brasileiras
| Banco | Autenticação | Endpoint de Extrato | Documentação Oficial |
|---|---|---|---|
| Nubank | OAuth2 | /api/extrato (via Open Banking Nubank) |
Nubank Developers |
| Itaú | Bearer Token | /api/v1/transactions (via Open Banking Itaú) |
Itaú Developers |
| Bradesco | Basic Auth | /api/v2/transactions (via Open Banking Bradesco) |
Bradesco Developers |
Exemplo de adaptação: Para o Nubank, substitua o nó HTTP Request pela URL `https://api.nubank.com.br/api/extrato` e use o token de acesso do OAuth2. O resto do fluxo (JSON Parser, Set, Spreadsheet) permanece igual.
Próximo nível: Se quiser escalar essa automação, confira nosso guia Como criar um SaaS com IA sem saber programar para transformar esse fluxo em um produto recorrente.
Perguntas frequentes sobre Como automatizar a conciliação bancária com n8n usando API do Banco Inter
Preciso saber programar para usar a API do Banco Inter no n8n?
Não! O n8n é uma ferramenta de automação sem código, então você não precisa saber programar para configurar o fluxo. Basta seguir os passos do guia, usar nós prontos como HTTP Request e JSON Parser, e adaptar os exemplos para sua realidade.
A API do Banco Inter tem custo para usar no n8n?
A API do Banco Inter é gratuita para uso pessoal ou comercial, mas verifique os limites de requisições na documentação oficial. O n8n também é open-source e gratuito em sua versão básica. Custos podem surgir apenas se você usar serviços de nuvem para hospedar o n8n ou integrar com ferramentas premium.
Como extrair o extrato do Banco Inter via API?
Use o nó HTTP Request no n8n para chamar o endpoint `/openbanking/v1/transactions` com os parâmetros `dataInicial` e `dataFinal`. Autentique com OAuth2 usando sua API Key e Client Secret. O retorno será um JSON com todas as transações, que você processará com nós como JSON Parser.
Posso integrar a automação com o Google Sheets?
Sim! O nó Spreadsheet File do n8n permite exportar os dados para um arquivo CSV ou diretamente para o Google Sheets. Basta autorizar a integração no n8n e selecionar a planilha de destino. Essa é a forma mais prática de armazenar e analisar os extratos conciliados.
O que fazer se a API do Banco Inter não retornar dados?
Primeiro, verifique se as credenciais (API Key e Client Secret) estão corretas e se o escopo 'Extrato' está habilitado no painel do Banco Inter. Teste com uma data recente (ex: ontem) e confira se o endpoint está acessível. Erros 401 ou 403 geralmente indicam problemas de autenticação.
Como configurar o webhook no n8n para receber dados da API?
O nó HTTP Request já funciona como um webhook quando usado com o método GET. Para receber dados em tempo real, configure o nó Webhook do n8n para escutar uma URL específica e processe os dados recebidos. No Banco Inter, use o endpoint de extrato com parâmetros de data para buscar informações periódicas.
É seguro usar a API do Banco Inter em um fluxo de automação?
Sim, desde que você proteja suas credenciais. Nunca compartilhe sua API Key ou Client Secret publicamente. Use variáveis de ambiente no n8n para armazená-las com segurança e restrinja o escopo da API no painel do Banco Inter. A API do Banco Inter usa OAuth2 e criptografia para proteger os dados.
Quais nós do n8n são essenciais para essa automação?
Os nós essenciais são: HTTP Request (para chamar a API), JSON Parser (para extrair dados), Set (para adicionar regras), Spreadsheet File (para exportar) e Google Sheets (opcional). Para automação agendada, adicione o nó Cron. Esses nós formam a base do fluxo de conciliação bancária.
Automação bancária sem segredos: transforme horas de trabalho em minutos
Automatizar a conciliação bancária com o n8n e a API do Banco Inter é um divisor de águas para empreendedores e profissionais de finanças. Você elimina erros manuais, economiza tempo valioso e ganha visibilidade em tempo real sobre suas transações, tudo sem precisar saber programar. Ao seguir os passos deste guia, você criou um fluxo robusto que extrai extratos, processa dados e atualiza planilhas automaticamente — e pode ser adaptado para outros bancos com facilidade.
Resumo rápido do que você conquistou:
- Economizou horas: A automação substitui o trabalho manual de conferência de extratos.
- Reduziu erros: Regras inteligentes evitam divergências e multas por lançamentos incorretos.
- Ganhou controle: Dados atualizados diariamente, prontos para análise ou exportação.
- Escalou sem limites: O mesmo fluxo funciona para outros bancos com pequenas adaptações.
Agora que você dominou a automação de conciliação bancária, que tal explorar outras formas de otimizar seu controle financeiro? Confira nossa categoria Automação Financeira para mais tutoriais práticos e dicas para pequenas empresas!
Quer mais sobre o assunto? Veja todos os artigos de APIs & Dev ou a lista completa de artigos.