CobrancaInclusaoDeMulta

Rotina do módulo Financeiro (submenu Cobrança) que aplica multa sobre um ou mais títulos a receber.

Rotina do módulo Financeiro (submenu Cobrança) que aplica multa sobre um ou mais títulos a receber. Ao ser executada, gera lançamentos financeiros de multa para os títulos informados, integra esses lançamentos com a contabilidade e atualiza o boleto/dados de cobrança correspondentes. Também oferece uma ação de impressão associada à rotina.

DTOCabecalhoDeOperacoes (campos relevantes para esta rotina)

DTODeTituloAProcessar (campos relevantes para esta rotina — o DTO é compartilhado por várias operações de alteração de título, então só os campos usados pela multa são listados)

1. É obrigatório informar ao menos um título. Se a lista de títulos a processar estiver vazia, a operação não é executada e o sistema exibe a mensagem:
   Mensagem exibida: “Não foi possível Salvar. Nenhum título foi informado. Verifique e informe título válido para operação”
2. Cálculo do valor da multa em moeda estrangeira. Se o campo MultaMoeda do título for maior que zero, o valor da multa em Real é recalculado a partir da cotação do título (MultaMoeda multiplicado pela cotação do título, arredondado para 2 casas decimais); caso contrário, o valor informado em Multa é usado tanto como valor em Real quanto como valor em moeda estrangeira.
3. Determinação da regra contábil (variação) aplicada ao lançamento. O sistema verifica se a filial do título pertence a uma cooperativa e se o participante do título é cooperado, e também se o tipo de documento do título é um adiantamento (código iniciado por “AD”), combinando essas condições para escolher a regra contábil de variação correta (ex.: Adiantamento Cooperado, Sem Variação Cooperado, Adiantamento Não Cooperado, Sem Variação Não Cooperado, Adiantamento, Sem Variação). Essa variação determina qual fato contábil (lançamento padrão) será usado para registrar a multa.
4. Geração do lançamento financeiro e integração contábil. Para cada título processado, é gerado um lançamento financeiro de multa (histórico e complemento vindos do fato contábil determinado na regra 3), que em seguida é enviado para integração com a contabilidade.
5. Atualização do boleto/dados híbridos de API. Após os lançamentos serem gerados, o sistema tenta atualizar os dados do boleto (ou integração via API) vinculados aos títulos processados. Caso ocorra falha nessa atualização:

• Se a falha for classificada como impeditiva (com base na configuração da rotina), a operação inteira é revertida (rollback) e a mensagem de erro identificada na atualização é lançada ao usuário.
• Se a falha não for impeditiva, a operação é concluída normalmente, mas um aviso informativo (reunindo o log de erro e o log de títulos já baixados) é retornado ao usuário para conhecimento.

1. Erro inesperado durante o processamento. Se qualquer erro não previsto ocorrer durante o processamento dos títulos, a operação é interrompida e o sistema exibe a mensagem:
   Mensagem exibida: “{Descrição do erro ocorrido}. Falha na operação. Verifique os dados e tente novamente.”
2. Toda a operação de aplicação de multa é executada dentro de uma transação: se concluída com sucesso, é feito o commit dos lançamentos gerados; em caso de erro impeditivo, nada é persistido.

Acesso à tela/rotina: “EditViewDeTitulosParaAlteracaoTRECMULT” (ID 1573) — permissão de acesso à tela de alteração de títulos para inclusão de multa (recurso pai: 1562 – Cobrança). Observação: esta rotina não segue o padrão usual “ListViewDe[NomeFeature]” + “[NomeFeature]/[Ação]” — o recurso de acesso à tela (1573) tem uma string de rota própria, distinta do nome do controller/ações reais (CobrancaInclusaoDeMulta), que possuem suas próprias permissões de ação abaixo.