Pular para o conteúdo principal

DetalhadoArrecadado

atenção

Gerado por Inteligência Artificial.

Visão Geral​

Este método retorna o detalhamento dos recebimentos arrecadados por colaborador, filtrando pelo arrecadadorId e opcionalmente por mês e ano, produzindo uma lista de RelatorioDetalhadoRecebimentoArrecadadorModel com os detalhes de cada parcela arrecadada.

BOX3_ERP_API\BOX3_ERP_API.Core\BLL\Relatorio\ArrecadacaoMensalColaboradorBLL.cs
public List<RelatorioDetalhadoRecebimentoArrecadadorModel> DetalhadoArrecadado(int arrecadadorId, int? mes = null, int? ano = null) { ... }

Dependências Diretas​

MétodoLocalizaçãoLinha
---

Referências​

Método / EndpointLocalizaçãoLinha
DetalhadoArrecadado(int arrecadadorId, int? mes = null, int? ano = null)BOX3_ERP_API\BOX3_ERP_API\Controllers\ColaboradorController.cs1658

Detalhamento das Referências​

DetalhadoArrecadado​

Este é o método do controller ColaboradorController decorado com

[HttpPost("RelatorioDetalhadoRecebimentoArrecadador/{arrecadadorId}/{mes?}/{ano?}")]  
public ActionResult<List<RelatorioDetalhadoRecebimentoArrecadadorModel>> DetalhadoArrecadado(int arrecadadorId, int? mes = null, int? ano = null) { ... }

Ele expõe o endpoint REST que recebe os parâmetros de rota, invoca o BLL DetalhadoArrecadado para obter os detalhes de recebimentos e retorna o resultado ao cliente.

Impacto de Alterações​

  • Mudanças na assinatura (parâmetros ou tipo de retorno) exigirão atualização do controller e de todo cliente que consome este endpoint.
  • Alterações na estrutura de RelatorioDetalhadoRecebimentoArrecadadorModel afetam diretamente o contrato da API e a renderização no front-end.
  • Qualquer lógica de filtragem interna no BLL impacta os dados detalhados retornados.

Propagação de Mudanças​

  1. Atualizar e revisar testes unitários que cobrem cenários de arrecadadorId, mês e ano.
  2. Verificar o comportamento do endpoint DetalhadoArrecadado no controller após a alteração.
  3. Sincronizar mudanças com front-end ou aplicativos móveis que consomem este relatório.
  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 cenários com e sem filtro de mês/ano, e verificação de casos extremos.
  • Validação de parâmetros de entrada no controller e no BLL.
  • Monitoramento de performance para grandes volumes de dados detalhados.
  • Tratamento de exceções e fallback em caso de falha na geração dos dados.