Ello - Base de Conhecimentos

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

  1. Entre em contato com o suporte do banco ou gerente da conta
  2. Informe que precisa homologar a emissão de boletos por sistema de automação comercial
  3. Colete todas as informações do checklist acima
  4. Configure o sistema com os dados fornecidos — veja Configuração de Boletos
  5. Emita alguns boletos de teste
  6. Envie os boletos de teste ao banco conforme as instruções deles (geralmente por e-mail para o suporte)
  7. 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

Veja também