====== Retorno Bancário ====== O retorno bancário é o processo inverso da remessa: o banco envia um arquivo de volta ao sistema informando o que aconteceu com cada boleto — se foi pago, recusado, protestado, e quais tarifas foram cobradas. Processar o retorno é o que faz o sistema registrar os pagamentos recebidos. ===== O que é o retorno bancário? ===== Após processar a remessa enviada pelo sistema, o banco disponibiliza um arquivo de retorno com a resposta para cada ocorrência: confirmação de registro, confirmação de pagamento, recusa de boleto, tarifas cobradas, entre outros. Ao importar esse arquivo no sistema, o Ello: * Dá baixa automática nas parcelas pagas * Registra tarifas bancárias cobradas * Atualiza a situação de cada boleto * Registra créditos em conta para valores recebidos sem correspondência ===== Fluxo remessa × retorno ===== @startuml skinparam sequenceArrowColor #2471A3 skinparam sequenceLifeLineBorderColor #2471A3 skinparam sequenceParticipantBackgroundColor #EBF5FB skinparam sequenceParticipantBorderColor #2471A3 actor Usuário participant "Sistema\nEllo" as Ello participant "Banco" as Banco Usuário -> Ello : Gera arquivo de remessa Ello -> Banco : Envia arquivo CNAB (remessa) Banco -> Banco : Processa boletos Banco -> Usuário : Disponibiliza arquivo de retorno Usuário -> Ello : Importa arquivo de retorno Ello -> Ello : Dá baixa nas parcelas pagas\nRegistra tarifas e créditos @enduml ===== Importando e processando o retorno ===== - Baixe o arquivo de retorno disponibilizado pelo banco (internet banking ou gerenciador financeiro) - No sistema, acesse **Financeiro → Boletos → Retorno Bancário** - Clique em **Adicionar** - Selecione o arquivo baixado do banco - O sistema lê o arquivo e exibe todas as ocorrências encontradas - Revise as ocorrências antes de confirmar (veja seção abaixo) - Clique em **Processar** para confirmar Após o processamento, o sistema registra os pagamentos, atualiza as situações dos boletos e grava os movimentos financeiros correspondentes. ===== Entendendo a tela de retorno ===== A tela de retorno possui três abas: ==== Aba Ocorrências ==== Lista todas as transações informadas pelo banco no arquivo. Cada linha representa uma instrução bancária: * **Liquidação**: boleto foi pago pelo cliente — gera baixa da parcela * **Recusa**: banco não reconheceu ou rejeitou o boleto — boleto volta para pendente * **Protesto**: banco encaminhou o título para protesto * **Tarifa**: cobrança de taxa de serviço pelo banco * **Cancelamento pelo banco**: banco cancelou o boleto Cada ocorrência exibe a situação do processamento: aguardando, processada ou rejeitada. ==== Aba Financeiro ==== Exibe os lançamentos financeiros gerados pelo processamento do retorno: * Depósitos em conta (valores recebidos) * Tarifas debitadas pelo banco * Outros créditos ou débitos gerados ==== Aba Liquidados ==== Lista as parcelas que foram baixadas (pagas) a partir deste retorno, com o valor recebido, juros, multa, descontos e outros detalhes do pagamento. ===== Tipos de ocorrência e o que o sistema faz ===== ^ Tipo de ocorrência ^ O que o sistema faz ^ | Pagamento / Liquidação | Baixa a parcela; registra os valores de juros, multa e descontos; deposita o valor na conta financeira | | Registro confirmado | Atualiza o boleto para situação "Registrado" | | Recusa pelo banco | Atualiza o boleto para situação "Recusado pelo banco"; nenhum pagamento é registrado | | Cancelamento pelo banco | Atualiza o boleto para situação "Cancelado pelo banco" | | Protesto | Atualiza o boleto para situação "Protestado" | | Tarifa bancária | Registra o débito da tarifa na conta financeira | | Pagamento antecipado | Registra o pagamento com o valor após o desconto por antecipação | ===== Corrigindo uma ocorrência com parcela errada ===== Às vezes o banco retorna um pagamento que o sistema não consegue identificar automaticamente, ou que foi associado à parcela errada. Nesses casos: - Na aba **Ocorrências**, localize a ocorrência com problema - Clique na linha para editá-la - Altere a parcela vinculada para a correta - O sistema recalcula os valores com base na parcela selecionada ===== Tarifas bancárias ===== Cada banco registra as tarifas de maneira diferente no arquivo de retorno. O sistema identifica automaticamente o tipo de tarifa e a registra como débito na conta financeira correspondente. Se as tarifas não estiverem aparecendo corretamente, verifique se a conta financeira está configurada adequadamente no cadastro do tipo de documento. ===== Boleto pago sem correspondência ===== Quando o banco informa um pagamento cujo boleto não existe no sistema (por exemplo, boleto de outra empresa ou boleto que foi excluído), o sistema registra o valor como **crédito sem correspondência** na conta financeira. O analista deve verificar manualmente e fazer o ajuste necessário. ===== Perguntas frequentes ===== **O sistema deu erro ao ler o arquivo de retorno. O que fazer?**\\ Verifique se o arquivo correto foi selecionado (arquivo do banco, não a remessa enviada). Certifique-se de que o tipo de documento configurado no sistema corresponde ao banco do arquivo. **Uma parcela foi paga mas ainda não aparece como baixada. O que fazer?**\\ Confirme se o arquivo de retorno já foi processado para o dia do pagamento. Se o arquivo ainda não foi disponibilizado pelo banco, aguarde até o próximo dia útil. **O valor recebido no retorno é diferente do valor do boleto. É normal?**\\ Sim. O valor recebido pode diferir do valor original por causa de juros, multa por atraso ou desconto por antecipação. O sistema registra cada componente separadamente. ===== Veja também ===== * [[ello_erp:modulos:boleto|Boletos Bancários — Visão Geral]] * [[ello_erp:modulos:boleto:remessa|Remessa Bancária]] * [[ello_erp:modulos:boleto:emissao|Emissão e Reimpressão de Boletos]]