CobrancaInclusaoDeDesconto

Rotina do módulo Financeiro (submenu Cobrança → Alteração TREC → Desconto, recurso 1572) que aplica um desconto (operação financeira TRECDESC) sobre um ou mais títulos a receber selecionados, gerando a movimentação financeira correspondente, o lançamento contábil de integração e, quando aplicável, o comprovante de impressão da operação.

Rotina do módulo Financeiro (submenu Cobrança → Alteração TREC → Desconto, recurso 1572) que aplica um desconto (operação financeira TRECDESC) sobre um ou mais títulos a receber selecionados, gerando a movimentação financeira correspondente, o lançamento contábil de integração e, quando aplicável, o comprovante de impressão da operação.

1. Lista de títulos obrigatória. Se `dto.TitulosAProcessar` estiver vazia ou nula, a operação é bloqueada.
   Mensagem exibida: Erro: “Não foi possível Salvar”. Motivo: “Nenhum título foi informado.” Solução: “Verifique e informe título válido para operação”.
2. Cálculo do valor do desconto. Se `DescontoMoeda` do título for maior que zero, o valor efetivo do desconto é recalculado como `DescontoMoeda × ValorCotacao` (arredondado a 2 casas decimais) e o valor em moeda é mantido como `DescontoMoeda`; caso contrário, tanto o valor em moeda nacional quanto o valor “em moeda” usados na movimentação são preenchidos com `Desconto`.
3. Título já vinculado a remessa pendente. Quando o título tem `IDDaUltimaOcorrencia` igual a “1”, o sistema busca a remessa de cobrança pendente para a carteira de pagamento informada, associa o número da remessa ao título, marca a ocorrência do título como “8” e registra a movimentação financeira do desconto vinculada a essa remessa — sem entrar no cálculo de variação cambial.
4. Liquidação em moeda estrangeira. Quando `dto.EhLiquidacaoMoedaExtrangeira` é verdadeiro, antes de aplicar o desconto o sistema executa a movimentação de variação cambial do título (se houver) e confirma essa movimentação isoladamente (commit parcial). Em seguida consulta o saldo atualizado do título: se o desconto informado corresponde ao saldo total (não é parcial), o valor do desconto é ajustado para o saldo exato do título antes de ser lançado.
5. Integração contábil obrigatória. Após processar todos os títulos, se houve ao menos uma movimentação financeira gerada, o sistema dispara a integração contábil (lançamentos automáticos) para toda a lista de movimentações.
6. Atualização de boleto híbrido via API. Ao final do processamento, o sistema tenta atualizar os dados de boleto híbrido (API) para os títulos afetados. Se essa etapa falhar, o sistema decide — com base em `dto.IdRotina` e na regra de negócio interna de “deve interromper por falha no banco” — se desfaz toda a operação (rollback) ou apenas registra um aviso informativo ao usuário sem desfazer o desconto já lançado.
7. Transação atômica. Todo o processamento de uma chamada a “Salvar” ocorre dentro de uma única transação de banco de dados; qualquer erro não tratado durante o processamento de um título é convertido em mensagem de erro padrão do sistema (ver mensagem “ERRO_CHAMADA_METODO_BASE”, que reexibe o texto da exceção original) e a transação é finalizada.

Acesso à rotina: permissão de acesso à árvore “Alteração TREC” / item “Desconto” (recurso pai 1562 – Cobrança, ID 1572)