ComissaoMensalidade
Gerado por Inteligência Artificial.
Visão Geral
Método responsável por calcular e registrar a comissão mensalidade para um contrato específico, utilizando configurações, valores de recebimento e informações do colaborador arrecadador. Executa operações assíncronas para criação das comissões e utiliza truncamento de valores para garantir precisão nos cálculos financeiros.
public async Task ComissaoMensalidade(int contratoId, Configuracao config, int recebimentoId, decimal valor, DadosToken dadosToken, Colaborador arrecadador) {...}
Dependências Diretas
| Método | Localização | Linha |
|---|---|---|
| ComissaoMensalidade(int, Configuracao, int, decimal, DadosToken, Colaborador) | - | 0 |
Referências
| Método / Endpoint | Localização | Linha |
|---|---|---|
| CriarComissao(Comissao, DadosToken, List\Recebimento>) | BOX3_ERP_API.Core.BLL.ComissaoBLL.cs | 876, 891, 909, 922, 935, 1122, 1134 |
| ArrecadacaoVendedor(int, int, DadosToken) | BOX3_ERP_API.Core.BLL.ComissaoBLL.cs | 878 |
| Truncar(decimal) | BOX3_ERP_API.Core.BLL.ComissaoBLL.cs | 73 |
| Math.Truncate(decimal) | BOX3_ERP_API.Core.Util.Calculadora.cs | 11 |
Detalhamento das Referências
CriarComissao
Método privado e assíncrono que cria uma comissão com base em um objeto Comissao, dados do token de autenticação e uma lista opcional de recebimentos. É utilizado para registrar as comissões calculadas no sistema.
ArrecadacaoVendedor
Método público e assíncrono que realiza o cálculo da arrecadação de um vendedor com base no contrato, colaborador e dados do token. Pode chamar o método CriarComissao para registrar comissões relacionadas.
Truncar
Método estático que realiza o truncamento de valores decimais para evitar arredondamentos indesejados em cálculos financeiros, garantindo precisão nos valores de comissão.
Math.Truncate
Método do sistema que realiza o truncamento de valores decimais, utilizado internamente pelo método Truncar para implementar a lógica de truncamento.
Impacto de Alterações
Alterações neste método podem impactar diretamente o cálculo e registro das comissões mensais, afetando a remuneração dos colaboradores e a integridade dos dados financeiros. Mudanças devem ser cuidadosamente testadas para evitar inconsistências e erros em processos financeiros.
Propagação de Mudanças
- Métodos que chamam ComissaoMensalidade, como Pagamento em RecebimentoBLL.
- Métodos internos como CriarComissao e ArrecadacaoVendedor.
- Utilitários financeiros como Calculadora.Truncar.
- Controladores que dependem do fluxo de pagamento e comissão, como RecebimentoController e RecebimentoLinksController.
Requisitos para Alteração Segura
- Garantir testes unitários e de integração abrangentes para validar cálculos e registros.
- Manter a precisão dos valores financeiros, especialmente no truncamento.
- Verificar impactos nos métodos dependentes e controladores que utilizam este método.
- Assegurar que alterações não quebrem a cadeia assíncrona de chamadas e o fluxo de dados.
- Documentar claramente as mudanças para facilitar manutenção futura.