Buscar o extrato direto no banco (sem baixar arquivo)
Em vez de entrar no internet banking, gerar o OFX e importar o arquivo, o Hap busca o extrato da conta corrente direto no banco: um botão em Caixas e Contas traz os lançamentos do período e abre a mesma tela de leitura e conciliação de sempre. Funciona hoje com Bradesco, Banco Inter, Santander, C6 Bank, Sicredi, Sicoob e Cora; nos demais bancos o caminho continua sendo o arquivo OFX — com a mesma conciliação no final.
Quando usar
Use quando a rotina de conciliação depende de alguém baixar OFX todo dia, ao conectar uma conta nova de um dos bancos com busca automática, ou quando o botão da tela aparece como "Conectar banco" e você quer saber o que falta.
Antes de começar
- Conta bancária cadastrada com agência e conta preenchidas.
- Produto de extrato/conta corrente liberado no banco — em alguns bancos é uma liberação à parte da cobrança.
- Credenciais do extrato preenchidas na aba Extrato da conta bancária (veja o artigo "Boleto e extrato são integrações diferentes" para o detalhe de cada banco).
A conciliação bancária sempre dependeu de um ritual: entrar no internet banking, gerar o extrato em OFX, baixar o arquivo e importá-lo no sistema. A busca automática corta esse caminho — o Hap fala direto com o banco, traz os lançamentos do período e abre a mesma tela de conciliação. O arquivo OFX continua existindo como alternativa, e os dois caminhos terminam no mesmo lugar: só muda como o extrato chega.
1. Conectar a conta (uma vez só)
Abra Financeiro > Contas Bancárias, edite a conta e vá na aba Extrato ("Extrato de conta corrente"). É ali que ficam o Client ID, o Client Secret e o Ambiente da busca automática — na conta, não no convênio, porque extrato é da conta corrente e convênio é acordo de cobrança. A própria aba mostra o passo a passo "Como obter o certificado e as credenciais" do seu banco e, no fim, o botão "Testar credenciais do extrato", que autentica no banco e busca 1 dia de extrato para provar que está tudo certo.
2. Buscar no banco
- 1
Abra Financeiro > Caixas e Contas e selecione a conta bancária. No canto direito do cabeçalho aparece o botão "Buscar no banco" com uma bolinha verde quando a conta está conectada.
- 2
Clique nele. O modal "Buscar extrato no banco" mostra a conta, o banco e o período: Últimos 7 dias, Este mês (padrão), Mês passado ou Personalizado, com as datas e a contagem de dias.
- 3
Confira o bloco "Como o banco entrega os dados" — é ali que aparecem os limites daquele banco — e clique em "Buscar lançamentos".
- 4
O resumo diz quantos lançamentos vieram, quantos são novos e quantos já tinham sido trazidos antes. A tela de "Leitura de extrato" abre em seguida, com a marca "Buscado no banco".
3. Conciliar (igual para busca automática e OFX)
A tela de Leitura de extrato lista cada lançamento com filtros Pendentes, Conciliados e Importados. Para cada linha você pode: conciliar com um título do financeiro (o painel "Conciliar lançamento" busca os candidatos por pessoa, documento, valor e vencimento) ou marcá-la e usar "Importar para caixas e contas" para criar o movimento — informando descrição, conta financeira e centro de resultado. Os cartões do topo mostram débitos, créditos e o saldo do extrato do período.
4. E quando o banco não tem busca automática
Itaú, Banco do Brasil, Caixa e Safra não publicam API de extrato de conta corrente. Nesses bancos, gere o extrato do período em OFX no internet banking e use o botão "Importar Extrato" da própria tela de Caixas e Contas: abre exatamente a mesma Leitura de extrato, com a mesma conciliação. O botão da busca automática nesses bancos aparece como "Extrato automático" (esmaecido) e, clicado, explica esse caminho.
Problemas comuns
- O botão aparece como "Extrato automático", esmaecido: o banco da conta ainda não tem busca automática no Hap (é o caso de Itaú, Banco do Brasil, Caixa e Safra). Clique nele para ver o passo a passo do arquivo OFX — a conciliação é exatamente a mesma.
- O botão aparece amarelo, como "Conectar banco": falta algo para a busca funcionar. O painel que abre lista exatamente o que está pendente (credencial, certificado, agência e conta). As credenciais ficam na aba Extrato da CONTA, não no convênio.
- O boleto funciona e o extrato não: são produtos diferentes no banco, com credenciais próprias. No Sicredi, inclusive, a credencial da cobrança não serve — o extrato exige um app de Conta Corrente separado.
- "O banco devolve no máximo N dias por consulta. Divida o período.": alguns bancos limitam a janela — o C6 aceita até 30 dias por busca e o Sicoob é consultado mês a mês. Busque em períodos menores; o que já foi trazido não duplica.
- Busquei de novo e veio "Todos os lançamentos deste período já foram trazidos em uma leitura anterior": é a proteção contra duplicidade. O extrato já está gravado — abra a leitura pendente para conciliar.
- O botão "Buscar no banco" não aparece: ele só existe quando o destino selecionado é uma conta bancária. Em caixa e cartão a busca automática não se aplica.