====== Boleto Híbrido com QR Code PIX ======

O boleto híbrido é um boleto bancário que também pode ser pago via QR Code PIX. O cliente pode escolher pagar pelo código de barras tradicional ou escanear o QR Code com o aplicativo do banco para pagar via PIX.

===== Bancos suportados =====

  * Sicredi

===== Como funciona =====

O QR Code PIX não é gerado pelo sistema diretamente. Ele é gerado pelo banco após o registro do boleto. Por isso, o fluxo do boleto híbrido exige uma etapa a mais em relação ao boleto comum:

<uml>
@startuml
skinparam activityBackgroundColor #E8F4FD
skinparam activityBorderColor #2980B9
skinparam arrowColor #2980B9

start
:Emissão do boleto no sistema;
:Geração e envio da remessa ao banco;
:Banco processa e gera o QR Code PIX;
:Processamento do retorno bancário\n(QR Code é vinculado ao boleto);
:Reimpressão do boleto\n(agora com QR Code);
:Cliente paga via código de barras\nou via QR Code PIX;
stop
@enduml
</uml>

Boletos híbridos **não devem ser impressos antes do processamento do retorno**, pois o QR Code ainda não está disponível.

===== Configuração =====

==== Passo 1 — Configurar a conta financeira ====

  - Acesse o cadastro da **Conta Financeira** utilizada para o boleto
  - Ative o parâmetro **Aceita PIX**
  - Informe a **chave PIX** da conta (pode ser CPF/CNPJ, e-mail, celular ou chave aleatória)

==== Passo 2 — Configurar o tipo de documento ====

  - Acesse o cadastro do **Tipo de Documento** utilizado para emitir boletos
  - Vá até a aba **Boleto**
  - Ative a opção **Boleto híbrido (com QR Code PIX)**

Após essas duas configurações, todos os boletos emitidos com esse tipo de documento serão híbridos.

===== Fluxo de uso =====

  - Emita o boleto normalmente pela tela de emissão — o boleto será gerado sem o QR Code por enquanto
  - Gere a remessa bancária e envie ao banco — [[ello_erp:modulos:boleto:remessa|como gerar remessa]]
  - Aguarde o banco processar o arquivo (normalmente no mesmo dia útil)
  - Importe o arquivo de retorno bancário — [[ello_erp:modulos:boleto:retorno|como processar retorno]]
  - O sistema vincula o QR Code ao boleto automaticamente durante o processamento do retorno
  - Reimprima o boleto — agora ele exibirá o QR Code PIX

===== Perguntas frequentes =====

**O QR Code não aparece no boleto impresso. O que fazer?**\\
O QR Code só é gerado após o processamento do retorno bancário. Certifique-se de que a remessa foi enviada e o retorno foi importado antes de reimprimir.

**O cliente pode pagar o boleto híbrido antes de aparecer o QR Code?**\\
Sim, pelo código de barras tradicional. O QR Code é um recurso adicional — o boleto permanece válido para pagamento via código de barras independentemente.

**O desconto por antecipação funciona no pagamento via PIX?**\\
Sim, desde que o banco suporte essa funcionalidade no boleto híbrido. O desconto configurado no tipo de documento é informado ao banco na remessa.

===== 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:remessa|Remessa Bancária]]
  * [[ello_erp:modulos:boleto:retorno|Retorno Bancário]]