====== Boletos Bancários ======

O módulo de boletos do Ello ERP permite emitir boletos bancários, enviar arquivos de cobrança ao banco e processar os retornos de pagamento. Todo o ciclo — da emissão à confirmação do pagamento — é gerenciado dentro do sistema.

===== Tópicos =====

  * [[ello_erp:modulos:boleto:configuracao|Configuração]] — Como preparar o sistema para emitir boletos (dados do banco, taxas, carteira)
  * [[ello_erp:modulos:boleto:emissao|Emissão e Reimpressão]] — Como emitir, reimprimir, alterar vencimento e cancelar boletos
  * [[ello_erp:modulos:boleto:remessa|Remessa Bancária]] — Como gerar o arquivo de registro de boletos para enviar ao banco
  * [[ello_erp:modulos:boleto:retorno|Retorno Bancário]] — Como importar e processar o arquivo de pagamentos enviado pelo banco
  * [[ello_erp:modulos:boleto:hibrido|Boleto Híbrido com QR Code PIX]] — Boletos que aceitam pagamento via PIX
  * [[ello_erp:modulos:boleto:homologacao|Homologação por Banco]] — Como fazer a aprovação inicial com cada banco

\\
===== Ciclo de vida de um boleto =====

Todo boleto percorre as seguintes etapas:

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

start
:Emissão\nBoleto gerado no sistema a partir\nde um pedido ou conta a receber;
:Remessa\nArquivo enviado ao banco\npara registrar o boleto;
:Registro no banco\nBanco confirma e disponibiliza\no boleto para pagamento;
:Pagamento\nCliente paga em agência,\ninternet banking ou app;
:Retorno\nBanco envia arquivo com\nconfirmação dos pagamentos;
:Baixa\nSistema registra o pagamento\ne quita a parcela;
stop
@enduml
</uml>

  - **Emissão**: o usuário gera o boleto a partir de um pedido ou de uma conta a receber. O boleto ainda não existe para o banco.
  - **Remessa**: o sistema gera um arquivo de remessa com os boletos pendentes de registro e o usuário envia ao banco.
  - **Registro no banco**: o banco processa a remessa e confirma o registro. Nesse momento o cliente já pode pagar.
  - **Pagamento**: o cliente paga o boleto em qualquer agência, internet banking ou correspondente.
  - **Retorno**: o banco disponibiliza um arquivo de retorno com a confirmação dos pagamentos. O usuário importa esse arquivo no sistema.
  - **Baixa**: o sistema registra automaticamente o pagamento e dá baixa na parcela correspondente.

\\
===== Situações do boleto =====

Um boleto pode estar em uma das seguintes situações ao longo do seu ciclo:

<uml>
@startuml
skinparam stateBackgroundColor #EBF5FB
skinparam stateBorderColor #2471A3
skinparam arrowColor #2471A3
skinparam stateFontSize 12

[*] --> RemessaPendente : Boleto emitido

RemessaPendente --> RemessaGerada : Incluído em remessa
RemessaGerada --> Registrado : Banco confirmou (retorno)
RemessaGerada --> RecusadoPeloBanco : Banco rejeitou (retorno)

Registrado --> LiquidadoViaRetorno : Pago — confirmado no retorno
Registrado --> LiquidadoManualmente : Baixa manual no sistema
Registrado --> RecebimentoAntecipado : Pago com desconto de antecipação
Registrado --> Protestado : Encaminhado a protesto
Registrado --> CanceladoPeloBanco : Banco cancelou

RemessaPendente --> Cancelado : Usuário cancelou
RemessaGerada --> Cancelado : Usuário cancelou
Registrado --> Cancelado : Usuário solicitou baixa ao banco

LiquidadoViaRetorno --> [*]
LiquidadoManualmente --> [*]
RecebimentoAntecipado --> [*]
Cancelado --> [*]
CanceladoPeloBanco --> [*]
RecusadoPeloBanco --> [*]
Protestado --> [*]
@enduml
</uml>

^ Situação ^ O que significa ^
| Remessa Pendente | Boleto emitido, aguardando ser incluído em uma remessa para registro no banco |
| Remessa Gerada | Boleto incluído em uma remessa; arquivo gerado mas ainda não processado pelo banco |
| Registrado | Banco confirmou o registro; boleto disponível para pagamento |
| Liquidado via Retorno | Pagamento confirmado pelo banco no arquivo de retorno |
| Liquidado Manualmente | Pagamento registrado manualmente no sistema (sem retorno bancário) |
| Recebimento Antecipado | Pago antes do vencimento com desconto por antecipação |
| Cancelado | Boleto cancelado pelo usuário no sistema |
| Cancelado pelo Banco | Banco cancelou o registro do boleto |
| Recusado pelo Banco | Banco não aceitou o boleto (dados incorretos ou carteira inválida) |
| Protestado | Título encaminhado para protesto em cartório |

\\
===== Bancos suportados =====

A lista abaixo contém os bancos atualmente suportados pelo Ello:

  - [[bancos:Banco do Brasil|001 - Banco do Brasil]]
  - [[bancos:Bradesco|237 - Bradesco]]
  - [[bancos:Banco Itau|341 - Banco Itaú]]
  - [[bancos:Caixa|104 - Caixa Econômica Federal S.A.]]
  - [[bancos:sicredi|748 - Sicredi]]
  - [[bancos:Banco Real|356 - Banco Real]]
  - [[bancos:Unibanco|409 - Unibanco]]
  - [[bancos:099 - Multibank]]
  - [[bancos:003 - Banco da Amazônia]]
  - [[bancos:004 - Banco do Nordeste]]
  - [[bancos:Sicoob|756 - Sicoob]]
  - [[bancos:Santander|033 - Santander]]

\\
===== Vídeo: Geração de Remessa Bancária =====

{{youtube>2RrnswMVF3Q?}}

\\
===== O que fazer se um título foi protestado? =====

Dirija-se ao cartório onde consta o protesto e solicite uma certidão para identificar quem o protestou. Caso já tenha esse conhecimento, procure quitar o título junto ao credor, obtendo uma carta de anuência ou o instrumento de protesto. Com esses documentos, vá ao cartório e solicite o cancelamento do registro do protesto. Após o cancelamento, entregue a certidão negativa à instituição financeira (banco) ou à entidade protetora do crédito (Serasa etc.) para excluir o protesto do cadastro de restrições associado ao CPF/CNPJ.