Pular para o conteúdo principal

ParcelasPagasAnterioresPeriodo

atenção

Gerado por Inteligência Artificial.

Visão Geral​

Este método retorna o total de parcelas pagas antes do período atual para um arrecadador específico, filtrando opcionalmente por mês e ano, produzindo um RelatorioValorQtdModel com os valores e quantidades agregados.

BOX3_ERP_API\BOX3_ERP_API.Core\BLL\Relatorio\ArrecadacaoMensalColaboradorBLL.cs
public RelatorioValorQtdModel ParcelasPagasAnterioresPeriodo(int arrecadadorId, int? mes = null, int? ano = null) { ... }

Dependências Diretas​

MétodoLocalizaçãoLinha
List<int>.Contains(int)BOX3_ERP_API\BOX3_ERP_API.Core\BLL\Relatorio\ArrecadacaoMensalColaboradorBLL.cs531
ConfiguracaoBLL.GetItem(bool)BOX3_ERP_API\BOX3_ERP_API.Core\BLL\Relatorio\ArrecadacaoMensalColaboradorBLL.cs544

Referências​

Método / EndpointLocalizaçãoLinha
API_RelatorioArrecadacaoMensalGrafico(FiltroRelatorioArrecadacaoMensalModel)BOX3_ERP_API\BOX3_ERP_API\Controllers\ColaboradorController.cs1538

Detalhamento das Referências​

API_RelatorioArrecadacaoMensalGrafico​

Este método do controller ColaboradorController, decorado com

[HttpPost("relatorioArrecadacaoMensalGrafico")]
public ActionResult<ItemGraficoArrecadadoresModel> API_RelatorioArrecadacaoMensalGrafico(FiltroRelatorioArrecadacaoMensalModel item) { ... }

invoca internamente ParcelasPagasAnterioresPeriodo no BLL para obter os dados de parcelas pagas anteriormente ao período e retorna o modelo ao cliente.

Impacto de Alterações​

  • Mudanças em Contains podem alterar quais parcelas são consideradas anteriores ao período.
  • Alterações em GetItem podem afetar valores padrão de mês ou ano quando não informados.
  • Modificações na assinatura ou no comportamento de ParcelasPagasAnterioresPeriodo exigem atualização do controller e de clientes que consomem este endpoint.

Propagação de Mudanças​

  1. Atualizar testes unitários que cobrem cenários de arrecadadorId, mes e ano para parcelas anteriores.
  2. Verificar o comportamento de API_RelatorioArrecadacaoMensalGrafico após alterações no BLL.
  3. Sincronizar mudanças com front-end que consome este endpoint.
  4. Atualizar documentação Swagger/OpenAPI para refletir alterações na assinatura ou no modelo de retorno.

Requisitos para Alteração Segura​

  • Cobertura de testes para casos com e sem filtros de mês/ano, incluindo cenários sem parcelas anteriores.
  • Validação de parâmetros de entrada na camada de controller e BLL.
  • Tratamento de exceções e fallback para períodos sem registros.
  • Verificação de performance na agregação de grandes volumes de dados.