Pular para o conteúdo principal

ArrecadacaoVendedor

atenção

Gerado por Inteligência Artificial.


Visão Geral

Método assíncrono responsável por realizar a arrecadação para um vendedor específico, utilizando os identificadores de contrato e colaborador, além dos dados de autenticação fornecidos pelo token. Internamente, chama métodos para criação de comissões e utiliza utilitários para cálculos financeiros, garantindo o processamento correto das informações de comissão relacionadas ao vendedor.

BOX3_ERP_API.Core.BLL.ComissaoBLL.cs
public async Task ArrecadacaoVendedor(int contratoId, int colaboradorId, DadosToken dadosToken)

Dependências Diretas

MétodoLocalizaçãoLinha
ArrecadacaoVendedor(int, int, DadosToken)-0
CriarComissao(Comissao, DadosToken, List<Recebimento>)BOX3_ERP_API.Core.BLL.ComissaoBLL.cs1122
CriarComissao(Comissao, DadosToken, List<Recebimento>)BOX3_ERP_API.Core.BLL.ComissaoBLL.cs1134
Truncar(decimal)BOX3_ERP_API.Core.BLL.ComissaoBLL.cs73
Truncate(decimal)BOX3_ERP_API.Core.Util.Calculadora.cs11

Referências

Método / EndpointLocalizaçãoLinha
ArrecadacaoVendedor(int, int, DadosToken)-0
ComissaoMensalidade(int, Configuracao, int, decimal, DadosToken, Colaborador)BOX3_ERP_API.Core.BLL.ComissaoBLL.cs878
Pagamento(Item_RecebimentoPagamentoModel, DadosToken, int?, bool, bool, IMapper, DateTime?)BOX3_ERP_API.Core.BLL.RecebimentoBLL.cs1403
API_AtualizarListadosPagamentoStatus(List<int>)BOX3_ERP_API.Controllers.RecebimentoLinksController.cs303
API_Pagamento(Item_RecebimentoPagamentoModel)BOX3_ERP_API.Controllers.RecebimentoController.cs688
API_GetAprovacao(int, List<Item_PagamentoUnitarioModel>)BOX3_ERP_API.Controllers.RecebimentoController.cs1680
Consultar(RecebimentoLinks, LivroCaixaOperadorBLL)BOX3_ERP_API.Core.BLL.PagarmeBLL.cs410
Consultar(int, LivroCaixaOperadorBLL, int?)BOX3_ERP_API.Core.Repositories.Implementations.EfipayCarneRepository.cs261
AtualizarStatusPorCliente(int, LivroCaixaOperadorBLL, int?, int?)BOX3_ERP_API.Core.Repositories.Implementations.EfipayCarneRepository.cs407
Consultar(int, LivroCaixaOperadorBLL, bool)BOX3_ERP_API.Core.Repositories.Implementations.GerenciamentoBoletoRepository.cs236
ConsultaManual(int, LivroCaixaOperadorBLL, bool)BOX3_ERP_API.Core.Repositories.Implementations.GerenciamentoBoletoRepository.cs472
ConsultarPorId(int)BOX3_ERP_API.Core.Repositories.Implementations.FinanceiroTransacoesPixRepository.cs222

Detalhamento das Referências

ArrecadacaoVendedor(int, int, DadosToken)

Método principal que inicia o processo de arrecadação para o vendedor, recebendo os parâmetros necessários para identificar o contrato e o colaborador, além dos dados de autenticação.

CriarComissao(Comissao, DadosToken, List<Recebimento>)

Método privado e assíncrono que cria uma comissão baseada nos dados fornecidos, podendo receber uma lista opcional de recebimentos para processamento adicional.

Truncar(decimal)

Método estático que realiza o truncamento de valores decimais para garantir precisão financeira, utilizando internamente o método Math.Truncate.

ComissaoMensalidade(int, Configuracao, int, decimal, DadosToken, Colaborador)

Método que calcula e processa a comissão mensal baseada em configurações específicas, valores e dados do colaborador.

Pagamento(Item_RecebimentoPagamentoModel, DadosToken, int?, bool, bool, IMapper, DateTime?)

Método responsável por processar pagamentos, podendo ser chamado por múltiplos endpoints da API, garantindo a atualização dos status de pagamento.

Impacto de Alterações

Alterações neste método podem impactar diretamente o cálculo e processamento das comissões dos vendedores, afetando relatórios financeiros e pagamentos. Mudanças incorretas podem causar inconsistências nos valores arrecadados e comissões geradas.

Propagação de Mudanças

  1. Ajustes em ArrecadacaoVendedor podem exigir revisão em CriarComissao para garantir compatibilidade.
  2. Modificações em cálculos financeiros podem requerer atualização em Truncar e métodos relacionados.
  3. Alterações na autenticação ou dados do token podem impactar chamadas dependentes.
  4. Mudanças podem afetar endpoints que utilizam o método indiretamente, como ComissaoMensalidade e Pagamento.
  5. Testes devem ser realizados em toda a cadeia de chamadas para validar integridade.

Requisitos para Alteração Segura

  • Compreensão completa da lógica de cálculo de comissão e arrecadação.
  • Testes unitários e integrados cobrindo cenários de sucesso e falha.
  • Validação dos dados de entrada, especialmente IDs e tokens.
  • Revisão das dependências diretas e indiretas para evitar regressões.
  • Atualização da documentação técnica e de API relacionada.