====== Configuração de Boletos Bancários ======

Esta página descreve como preparar o sistema para emitir boletos bancários. A configuração é feita uma única vez por banco e tipo de cobrança utilizado.

===== Pré-requisitos =====

Antes de configurar o boleto, verifique se os itens abaixo já estão cadastrados:

  * **Conta financeira** correspondente à conta bancária que receberá os pagamentos
  * **Tipo de documento** que será vinculado à cobrança bancária (ex.: "Duplicata Mercantil", "Recibo")
  * Dados bancários fornecidos pelo gerente ou suporte do banco: número da carteira, código do cedente, convênio (quando aplicável)

Se a conta financeira ou o tipo de documento ainda não existirem, cadastre-os antes de prosseguir.

===== Configurando o Tipo de Documento para Boleto =====

O **Tipo de Documento** é o registro que define como o boleto será gerado para cada banco. Acesse o cadastro do Tipo de Documento desejado e vá até a aba **Boleto**.

==== Informações do banco ====

Preencha os campos conforme os dados fornecidos pelo banco:

  * **Banco**: selecione o banco emissor (ex.: Bradesco, Sicredi, Banco do Brasil)
  * **Conta financeira**: a conta bancária que receberá os pagamentos
  * **Carteira**: código da carteira de cobrança (obtido com o banco)
  * **Variação da carteira**: quando o banco exigir (alguns bancos usam variações)
  * **Código do cedente**: identificação do emitente junto ao banco
  * **Convênio**: número do convênio bancário (obrigatório para Banco do Brasil)
  * **Formato do arquivo de remessa**: CNAB 240 ou CNAB 400 (conforme orientação do banco)

==== Taxas e encargos ====

Configure os encargos que serão cobrados em caso de atraso:

  * **Percentual de juros ao dia**: percentual de juros sobre o valor do boleto por dia de atraso
  * **Percentual de multa**: percentual cobrado após o vencimento
  * **Dias de carência**: quantidade de dias após o vencimento antes de o sistema começar a calcular juros
  * **Dias para protesto**: após quantos dias de atraso o título será encaminhado para protesto (deixe zero para não protestar)

==== Desconto por antecipação ====

Se desejar oferecer desconto para pagamento antes do vencimento:

  * Ative a opção **Desconto por antecipação**
  * Informe o **valor ou percentual** do desconto
  * Informe a **data limite** até a qual o desconto é válido

==== Forma de entrega padrão ====

Define como o boleto será entregue ao cliente quando emitido:

  * **Presencial**: apenas imprime, sem envio automático
  * **E-mail**: envia automaticamente por e-mail após a emissão
  * **WhatsApp**: envia automaticamente via WhatsApp após a emissão

==== Boleto Híbrido (QR Code PIX) ====

Para habilitar o pagamento via QR Code PIX no boleto:

  - Na **Conta Financeira**, ative o parâmetro **Aceita PIX** e informe a chave PIX
  - No **Tipo de Documento**, aba Boleto, ative a opção **Boleto híbrido (com QR Code PIX)**

Consulte [[ello_erp:modulos:boleto:hibrido|Boleto Híbrido]] para mais detalhes sobre esse recurso.

===== Dicas e observações =====

  * As informações de carteira, cedente e convênio devem ser obtidas diretamente com o banco. Dados incorretos impedem o registro do boleto.
  * Cada banco pode ter campos obrigatórios diferentes. Consulte a página de [[ello_erp:modulos:boleto:homologacao|Homologação]] para orientações por banco.
  * Após configurar, é recomendável emitir um boleto de teste antes de usar em produção.

===== Veja também =====

  * [[ello_erp:modulos:boleto|Boletos Bancários — Visão Geral]]
  * [[ello_erp:modulos:boleto:emissao|Emissão e Reimpressão de Boletos]]
  * [[ello_erp:modulos:boleto:homologacao|Homologação por Banco]]
  * [[ello_erp:modulos:boleto:hibrido|Boleto Híbrido com QR Code PIX]]