Homologação de Boletos por Banco
A homologação é o processo de aprovação que o banco realiza antes de permitir a emissão de boletos em produção. Cada banco tem seu próprio processo, mas o objetivo é sempre o mesmo: confirmar que o sistema do cliente está gerando boletos corretamente no formato e com os dados exigidos.
Por que a homologação é necessária?
Antes de começar a emitir boletos para clientes reais, o banco precisa validar que:
- Os dados de identificação do emitente (cedente, convênio, carteira) estão corretos
- O layout do boleto atende ao padrão exigido pelo banco
- Os arquivos de remessa gerados estão no formato correto
Sem homologação, boletos podem não ser reconhecidos pelo banco e os clientes não conseguirão efetuar o pagamento.
Checklist de informações a coletar com o banco
Antes de configurar o sistema, solicite ao gerente ou ao suporte do banco as seguintes informações:
- Carteira de cobrança e sua variação (quando houver)
- Código do cedente (identificador do emitente)
- Convênio (principalmente para Banco do Brasil)
- Espécie do documento (duplicata mercantil, recibo etc.)
- Aceite (S ou N — indica se o devedor aceitou o título)
- Formato do arquivo de remessa: CNAB 240 ou CNAB 400
- Tipo de cobrança: com registro ou sem registro
Informe ao suporte do banco que o boleto será emitido por um sistema de automação comercial.
Processo geral de homologação
- Entre em contato com o suporte do banco ou gerente da conta
- Informe que precisa homologar a emissão de boletos por sistema de automação comercial
- Colete todas as informações do checklist acima
- Configure o sistema com os dados fornecidos — veja Configuração de Boletos
- Emita alguns boletos de teste
- Envie os boletos de teste ao banco conforme as instruções deles (geralmente por e-mail para o suporte)
- Aguarde a aprovação do banco
Informações específicas por banco
Banco do Brasil
- É obrigatório informar o número do convênio — sem ele, não é possível configurar o boleto
- Preste atenção especial à variação da carteira, que é comum no BB
- O BB homologa todo o processo pelo suporte do banco
Banco Itaú
- Homologa apenas o layout visual do boleto por e-mail
- Também é possível realizar a homologação pelo portal do parceiro do banco
Bradesco
- Solicita boletos de teste por e-mail para o suporte
- Verifique a necessidade de utilizar CNAB 240 ou CNAB 400 conforme o tipo de conta
Sicredi
- Contate a cooperativa local onde a conta está mantida
- O Sicredi também suporta boleto híbrido com QR Code PIX — veja Boleto Híbrido
Sicoob
- Contate a cooperativa local
- Verifique o formato de arquivo aceito pela cooperativa específica
Santander
- Solicite os dados de carteira e cedente ao gerente
- Envie boletos de teste para homologação
Caixa Econômica Federal
- Verifique com o gerente o tipo de carteira disponível para a conta
Dicas importantes
- Priorize obter a carteira, sua variação, e confirmar se o boleto é aceite ou não
- Sempre mencione que o boleto será emitido por sistema de automação comercial — isso ajuda o suporte do banco a direcionar corretamente
- Cada banco tem canais diferentes: alguns homologam por e-mail, outros pelo portal, outros pelo próprio gerente
- Em caso de dúvida sobre um campo específico, pergunte ao suporte do banco antes de preencher