Relatório de venda Comparativos de períodos

Histórico de Alterações

Data	Quem	Comentários
19/05/2025	Renato Lima	Criação do documento

Necessidade

A CONTRATANTE apresentou um modelo de relatório utilizado para o acompanhamento de vendas, que compara os dados do período atual, do mês anterior e do mesmo período do ano anterior. Para o cliente, ter essa visão disponível no GeoSales é imprescindível para a tomada de decisão e análise de desempenho comercial.

Solução

Para atender à necessidade do contratante em visualizar comparativos de desempenho de vendas entre diferentes períodos, será desenvolvido no GeoSales um novo modelo de relatório analítico, que poderá ser gerado em formato PDF e Excel (XLS). Este relatório permitirá a comparação entre:

- O período atual selecionado; - O mesmo período do mês anterior; - O mesmo período do ano anterior.

Esse comparativo fornecerá ao cliente uma visão clara da evolução dos resultados comerciais ao longo do tempo.

Funcionalidade da Solução

A solução incluirá:

• A criação de uma nova tela ou seção de relatórios no GeoSales contendo os seguintes filtros:

 - Data inicial;  
 - Data final; 
 - Supervisor; 
 - Vendedor;  
 - UF(Unidade Federativa).

• A exibição dos dados em formato tabular, contendo:

- Período selecionado, o mesmo período do mês anterior e o mesmo período do ano anterior;
- Código Vendedor;
- Nome do Vendedor; 
- Uf  do vendedor (conforme cadastro);
- Peso total do período de venda selecionado;
- Valor de venda  que o vendedor alcançou no período selecionado;
- Preço Médio de venda do kilo(Calculando como: Valor de venda divido pelo peso total apresentando) o resultado deve ser apresentado em reais
- Apresentação dos três valores (peso, valor, preço médio) para cada período comparado.

Regras de Negócios

[RN1] – O relatório deve está disponível dentro do menu de Vendas;

[RN2] – O relatório deve está disponível para os três pacotes GeoSales e deve ser liberado através do controle de permissão;

[RN3] – O relatório poderá ser exportado nos formatos PDF e XLS;

[RN4] – O intervalo máximo permitido entre a data inicial e final é de 1 mes;

[RN5] – A apresentação dos dados, devem respeitar a hierarquia cadastrada no GeoSales;

[RN6] – O acesso ao relatório será exclusivo pelo Portal GeoSales Evo;

[RN7] – As datas informadas nos filtros devem considerar a data de criação do pedido;

User Story

User Story 1: Acesso ao Relatório

Como usuário autorizado do GeoSales,

quero acessar um novo relatório comparativo no menu de Vendas,

para visualizar a evolução das vendas por período.

Critérios de Aceitação:

Dado que estou autenticado e tenho permissão,

quando acesso o menu de Vendas,

então devo visualizar a opção para o novo relatório comparativo de vendas.

Dado que meu pacote GeoSales (básico, intermediário ou avançado) está ativo,

quando a permissão de acesso estiver habilitada,

então o relatório deve estar disponível no portal GeoSales Evo.

User Story 2: Filtros do Relatório

Como usuário do relatório comparativo,

quero aplicar filtros por data, supervisor, vendedor e UF,

para refinar os dados exibidos no relatório.

Critérios de Aceitação:

Dado que estou na tela de relatório,

quando seleciono a data inicial e final (máximo de 1 mês),

então o sistema deve aceitar a entrada e filtrar os dados com base na data de criação do pedido.

Dado que desejo refinar os resultados,

quando seleciono um supervisor, vendedor ou UF,

então os dados exibidos devem refletir esses filtros corretamente.

User Story 3: Exibição de Dados

Como usuário do relatório,

quero visualizar os dados tabulados com três períodos comparativos,

'para entender a performance de vendas ao longo do tempo.

Critérios de Aceitação:

Dado que apliquei os filtros,

quando os dados forem exibidos,

então a tabela deve mostrar:

- Período atual;

- Mesmo período do mês anterior;

- Mesmo período do ano anterior;

- Código e nome do vendedor;

- UF do vendedor;

- Peso total vendido;

- Valor total de vendas;

- Preço médio do quilo vendido (Valor ÷ Peso).

E os valores de peso, valor e preço médio devem ser exibidos para os três períodos de forma clara e separada.

User Story 4: Exportação de Relatório

Como usuário, quero exportar o relatório em PDF ou Excel, para compartilhar ou analisar os dados fora do sistema.

Critérios de Aceitação:

Dado que estou visualizando o relatório, quando clico em "Exportar PDF", então um arquivo em formato PDF deve ser gerado com os dados da visualização atual.

Dado que estou visualizando o relatório, 'quando clico em "Exportar Excel", então um arquivo XLS deve ser gerado com os dados da visualização atual.

User Story 5: Respeito à Hierarquia

Como gestor ou supervisor, quero que os dados respeitem a hierarquia cadastrada no GeoSales, 'para garantir que cada usuário visualize apenas os dados permitidos.

Critérios de Aceitação:

Dado que estou logado no sistema, quando acesso o relatório, então devo ver apenas os dados relacionados à minha hierarquia ou permissões.

Aprovação

Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.

GeoSales

Setor	Aprovado Por	Data
Desenvolvimento - GeoSales	Pessoa que aprovou	00/00/0000
Integração - GeoSales	Pessoa que aprovou	00/00/0000
Configurações - GeoSales	Pessoa que aprovou	00/00/0000

Empresa solicitante

Setor	Aprovado Por	Data	Assinatura
Gerente TI - Cliente	Pessoa que aprovou	00/00/0000
Gerente de Projeto - Cliente	Pessoa que aprovou	00/00/0000
Gerente Comercial - Cliente	Pessoa que aprovou	00/00/0000