Pular para o conteúdo principal

ComissaoOrdemServico

atenção

Gerado por Inteligência Artificial.

Visão Geral​

Este método privado e assíncrono calcula a comissão relacionada a uma ordem de serviço específica, utilizando informações do contrato, dados do token de autenticação, configurações do sistema e uma lista opcional de recebimentos. Ele integra diversas operações internas para obter valores totais, preços e criar registros de comissão, garantindo o cálculo preciso e consistente das comissões dentro do sistema ERP.

BOX3_ERP_API.Core.BLL.ComissaoBLL.cs
private async Task\<decimal\> ComissaoOrdemServico(int contratoId, DadosToken dadosToken, Configuracao config, List\<Recebimento\> recebimentos = null) {...}

Dependências Diretas​

MétodoLocalizaçãoLinha
ComissaoOrdemServico(int, DadosToken, Configuracao, List<Recebimento>)-0

Referências​

Método / EndpointLocalizaçãoLinha
OrdemServicoBLL.Total(int)BOX3_ERP_API.Core.BLL.ComissaoBLL.cs146
OrdemServicoBLL.CalculoServicoEpoca(int)BOX3_ERP_API.Core.BLL.OrdemServicoBLL.cs207
OrdemServicoBLL.CalculoProdutoEpoca(int)BOX3_ERP_API.Core.BLL.OrdemServicoBLL.cs208
Calculadora.Truncar(decimal)BOX3_ERP_API.Core.BLL.OrdemServicoBLL.cs413, 427, 439
ComissaoBLL.CriarComissao(Comissao, DadosToken, List<Recebimento>)BOX3_ERP_API.Core.BLL.ComissaoBLL.cs176, 192, 206, 230, 251, 272
ServicoBLL.GetPreco(int)BOX3_ERP_API.Core.BLL.ComissaoBLL.cs180, 235
ComissaoBLL.EquipeDoDia(DateTime, int)BOX3_ERP_API.Core.BLL.ComissaoBLL.cs210

Detalhamento das Referências​

OrdemServicoBLL.Total​

Método assíncrono que calcula o valor total de uma ordem de serviço com base no seu identificador. Internamente, utiliza cálculos específicos para serviços e produtos associados à ordem, aplicando truncamentos para garantir precisão decimal.

OrdemServicoBLL.CalculoServicoEpoca​

Responsável pelo cálculo do valor dos serviços em uma determinada época para uma ordem de serviço. Utiliza métodos auxiliares para truncar valores decimais e garantir a precisão do cálculo.

OrdemServicoBLL.CalculoProdutoEpoca​

Calcula o valor dos produtos em uma determinada época para uma ordem de serviço, também aplicando truncamentos para manter a precisão dos valores monetários.

Calculadora.Truncar​

Método estático que realiza o truncamento de valores decimais, removendo casas decimais excedentes sem arredondamento, garantindo consistência nos cálculos financeiros.

ComissaoBLL.CriarComissao​

Método privado assíncrono que cria registros de comissão no sistema, utilizando dados da comissão, token de autenticação e uma lista opcional de recebimentos para processar as informações corretamente.

ServicoBLL.GetPreco​

Método assíncrono que obtém o preço de um serviço com base no seu identificador, aplicando truncamento para manter a precisão do valor retornado.

ComissaoBLL.EquipeDoDia​

Método privado assíncrono que retorna a lista de registros de ponto da equipe para um dia específico e empresa, utilizado para cálculos relacionados à comissão.

Impacto de Alterações​

Alterações neste método podem afetar diretamente o cálculo das comissões das ordens de serviço, impactando a precisão dos valores financeiros e a geração de registros de comissão. Mudanças incorretas podem levar a inconsistências nos pagamentos e relatórios financeiros.

Propagação de Mudanças​

  1. Revisar métodos dependentes como ComissaoVendaGeral que utilizam este método.
  2. Validar integrações com controladores que acionam processos de finalização de vendas e ordens de serviço.
  3. Testar fluxos que envolvem criação e cálculo de comissões para garantir integridade dos dados.
  4. Atualizar documentação e testes automatizados relacionados.

Requisitos para Alteração Segura​

  • Compreensão completa dos cálculos financeiros envolvidos.
  • Testes unitários e de integração abrangentes para validar resultados.
  • Garantia de que truncamentos e arredondamentos estejam corretos.
  • Revisão das dependências e chamadas para evitar efeitos colaterais.
  • Comunicação com equipes financeiras para alinhamento das regras de negócio.