Criação de Semáforo de itens pedidos/mês

Histórico de Alterações

Data	Quem	Comentários
24/11/2022	Renato Lima	Criação do documento

Necessidade

O cliente possui equipes de vendas que tem por modo de operação visitar um determinado cliente mais de uma vez dentro de um ciclo de vendas (mês comercial). Por conta desta estrutura, torna-se de difícil controle visualizar, a partir da relação dos produtos, quais itens já foram vendidos ao cliente neste ciclo e em ciclos anteriores. Por essa razão, há uma necessidade por parte do cliente em que se desenvolva um recurso visual que permita ao vendedor verificar os itens vendidos no ciclo de vendas.

Solução

Desenvolver um recurso que permita ao vendedor identificar itens já vendidos a um cliente dentro dos ciclos de vendas.

Implementação de um semáforo no card dos itens do pedido, que farão a identificação visual de itens que foram vendidos no ciclo em vigência.

Semáforo de Itens Pedidos

Ao entrar na tela de pedidos, os cards dos itens já apresentam informações pré-parametrizadas. No card de cada item deve apresentar uma indicação em cores que ao vendedor visualizar tenha ciência se aquele item já foi vendido para aquele cliente dentro do ciclo de vendas vigente.

Esse indicativo deve levar em consideração três situações em relação ao Item dentro do ciclo de venda para o cliente:

* Item não foi vendido
* Item vendido, mas sem nota fiscal ainda
* Item vendido e faturado

Existe um ícone de informação, de cor cinza, que abre uma tela com informações de item ao selecioná-lo. Considerando que o ciclo de vendas corresponde ao  período entre o início do mês comercial e o seu final, o item deverá ter um comportamento na qual a cor deste ícone pode mudar de acordo com a periodicidade em que este item foi pedido dentro do ciclo de vendas, ou de ciclos anteriores. Para isto, o ícone de informação, que possui a cor cinza como default, poderá ter as cores alteradas para verde, amarela ou vermelha, de acordo com os períodos parametrizados pelo cliente.

Se tomarmos como exemplo a necessidade corrente do cliente, o novo comportamento da funcionalidade será a seguinte: O vendedor acessará a tela de pedidos, na qual os cards dos itens estarão dispostos. Se o item na lista ainda não foi vendido no ciclo de vendas atual, o ícone de informação apresentará a cor default cinza. Se o cliente já tiver feito o pedido daquele item dentro do ciclo de vendas atual, o ícone de informação apresentará a cor verde, sinalizando ao vendedor que tal item já foi oferecido àquele cliente neste ciclo de vendas. Caso seja do interesse do cliente, outras cores do semáforo poderão ser parametrizadas, como a apresentação da cor amarela, caso o item não tenha sido vendido no ciclo corrente, mas foi no ciclo anterior, ou a apresentação na cor vermelha, caso o item não tenha sido vendido nos últimos 90 dias.

Importante

A customização do semáforo de itens pedidos no ciclo deverá ser habilitado/desabilitado por meio do controle de ações.

A marcação de item pedido no ciclo terá como critério de ativação o cadastro do pedido. Portanto, o sinal só deverá marcar os itens cujo o cadastro do pedido tiver sido já realizado.

Regras de Negócios

[RN1] - A visualização de marcação no item será controlado por perfil;

[RN2] - Para avaliar e apresentar a sinalização deve ter uma configuração para ativar avaliação;

[RN3] - Para que seja possível a sinalização, é necessário ter um ciclo de venda ativo;

[RN4] - Para consultar data e valor da venda deve acessar o card para visualizar a informação;

[RN5] - Avaliação de venda, será sempre baseada no ciclo de venda que encontra-se ativo.

Cenários

Considere para a composição do cenário as seguintes massas de dados:

Ciclo de Vendas: Período de 30 dias, no qual o início se dá no primeiro dia do mês, e o final se dá no último dia do mês.

Vendedor: VEND_001

Produtos de venda

CD_FAMILIA	NM_FAMILIA
1	ITEM_001
2	ITEM_002
3	ITEM_003
4	ITEM_004

Carteira de Clientes

CD_CLIENTE	NM_CLIENTE
1	CLIENTE_001
2	CLIENTE_002
3	CLIENTE_003
4	CLIENTE_004

Cenário 1.1: Semáforo de item pedido no Ciclo - Pedido Inicial

O Vendedor, no dia 01, visita o cliente 01 e vende o item 01

NM_VENDEDOR	DIA_CICLO	NM_CLIENTE	NM_ITEM
VEND_001	01	CLIENTE_001	ITEM_001

Pelo exposto, o cliente efetuou a venda do item 01 no primeiro dia do ciclo de vendas. Como não há venda anterior deste item cadastrado, o sinal apresentado no card no momento da venda possui a cor default cinza.

Cenário 1.2: Semáforo de item pedido no Ciclo - Segundo Pedido

O Vendedor, no dia 05, visita o cliente 01 e vende o item 01

NM_VENDEDOR	DIA_CICLO	NM_CLIENTE	NM_ITEM
VEND_001	05	CLIENTE_001	ITEM_001

Pelo exposto, o cliente efetuou a venda do item 01 no quinto dia do ciclo de vendas. Como existe venda anterior deste item cadastrado, o sinal apresentado no card no momento da venda virá com a cor verde.

Cenário 1.3: Semáforo de item pedido no Ciclo - Pedido num Ciclo distinto

O Vendedor, no dia 01 no ciclo seguinte (ex: próximo mês), visita o cliente 01 e vende o item 01

NM_VENDEDOR	DIA_CICLO	NM_CLIENTE	NM_ITEM
VEND_001	01	CLIENTE_001	ITEM_001

Pelo exposto, o cliente efetuou a venda do item 01 no primeiro dia do ciclo de vendas. Como no ciclo anterior o item foi vendido em pedidos passados, o card do item trará o sinal de informação na cor amarela, identificando que o pedido não foi feito no ciclo atual, mas foi feito no ciclo anterior.

Cenário 1.4: Semáforo de item pedido no Ciclo - Segundo Pedido num segundo ciclo

Nesta situação, repete-se o ocorrido no cenário 1.2.

Cenário 1.5: Semáforo de item pedido no Ciclo - Pedido num Ciclo distante

O Vendedor, no dia 01 de um ciclo posterior (ex: daqui a dois meses), visita o cliente 01 e vende o item 01

NM_VENDEDOR	DIA_CICLO	NM_CLIENTE	NM_ITEM
VEND_001	01	CLIENTE_001	ITEM_001

Pelo exposto, o cliente efetuou a venda do item 01 no primeiro dia do ciclo de vendas. Como há dois ciclos anteriores o item foi vendido em pedidos passados, o card do item trará o sinal de informação na cor vermelha, identificando que o pedido não foi feito no ciclo atual, nem no ciclo anterior.

Cenário 1.6: Semáforo de item pedido no Ciclo - segundo Pedido num Ciclo distante

Nesta situação, repete-se o ocorrido no cenário 1.2. e 1.4.

Entender as regras de negócios

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
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