====== 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 [[ello_erp:modulos:boleto:configuracao|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 [[ello_erp:modulos:boleto:hibrido|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 =====

  * [[ello_erp:modulos:boleto|Boletos Bancários — Visão Geral]]
  * [[ello_erp:modulos:boleto:configuracao|Configuração de Boletos]]
  * [[ello_erp:modulos:boleto:emissao|Emissão e Reimpressão de Boletos]]