Exibir código-fonte para Exibição de metas

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem 
! Comentários 
|-
| 02/07/2019  || Ryvane Maria || Criação do documento 
|-
|}

== Necessidade ==

Exibir com finalidade de consulta as métricas de apuração de meta no GeoSales Mobile.

== Solução ==

== Implementação ==

'''- Campos já existentes no GeoSales Mobile a respeito das informações de metas:'''

Atualmente, na aba de meta geral do GeoSales são exibidas as seguintes informações a cerca das metas cadastrada: 

* '''Meta de hoje:''' A meta de hoje exibe o valor a ser atingido idealmente no dia de hoje. Para montar essa visão de 'meta de hoje' o GeoSales verifica se ainda há dias a trabalhar até a data final da meta, e divide o valor da meta, subtraindo o que já foi atendido, pela quantidade de dias que restam a trabalhar, até o fim da meta.

A fórmula utilizada é a seguinte: (valor da meta - valor atingido) / ((dias a trabalhar + 1) - dias trabalhados).

Desta forma, o vendedor conseguirá visualizar quanto deverá ser alcançado no dia de hoje, para que, ao fim do período pré-determinado, a meta seja atingida. É válido salientar que, caso não hajam dias a trabalhar até o fim da meta, o valor desta meta será zero.

* '''Vendido hoje:''' Valor total dos pedidos que já foram vendidos hoje. O sistema verifica os pedidos que foram cadastrados no dia corrente e é informado ao usuário a soma do valor total desses pedidos. É importante lembrar que só serão considerados neste cálculo pedidos com tipo de pedido parametrizado para utilizar meta, ou seja, com o campo ID_UTILIZA_META setado com o valor 'S'.

* '''Saldo de hoje:''' O sistema verifica os pedidos que foram cadastrados e subtrai da meta diária do vendedor, para isso, utiliza-se a seguinte fórmula: (Valor da meta hoje - valor vendido). Exibindo assim o valor que foi atingido no dia de hoje.

* '''Atingido até hoje:''' Valor da meta que foi atingido até a data de hoje. Para saber se o valor da meta foi atingido ou não, o sistema soma todas as notas fiscais dos pedidos do vendedor em específico e verifica a data do pedido para saber se o pedido foi cadastrado no período da meta.

* '''Tendência:''' O valor de tendência é dado pela seguinte fórmula: (valor atingido / dias trabalhados) * (dias a trabalhar / valor da meta * 100).

* '''Positivação:''' O campo de positivação é utilizado para informar o percentual de clientes que foram atendidos pelo vendedor. Esse percentual de positivação é montado conforme a quantidade de clientes que já foram atendidos, quando comparado ao total de clientes a serem atendidos. 

* '''Data Inicial:''' Data inicial da meta.

* '''Data Final:''' Data final da meta.

* '''Dias à trabalhar:''' Quantidade de dias a serem trabalhados para que a meta seja atingida.

* '''Dias trabalhados:''' Quantidade de dias que já foram trabalhados. Ou seja, dias em que houveram inserção de pedidos ou de justificativas de não venda pelo vendedor.

* '''Dias úteis restantes:''' Quantidade de dias úteis restantes a trabalhar pelo vendedor (ou dias de trabalho) para que o período da meta se encerre.

* '''Valor meta diária:''' A meta diária é dada pelo valor da meta dividido pela quantidade de dias trabalhados.

* '''Valor meta período:''' 

* '''Positivação:''' O campo de positivação é utilizado para determinar o percentual de clientes que deve ser atendido pelo vendedor.


'''- Novos campos a serem criados no GeoSales Mobile a respeito das informações de metas:'''

Além dos campos já existentes descritos no tópico anterior (que exibem a meta por valor), serão criados novos campos, com finalidade de exibir algumas informações a respeito de meta por volume e por preço médio. 

É importante salientar que o volume descrito abaixo, se refere a quantidade de itens inseridos em um pedido, caso os produtos sejam vendidos em caixa fechada, o volume se refere portanto, a quantidade de caixas vendidas (E o GeoSales considera uma caixa como um único item).

A criação desses campos irá seguir os seguintes critérios de exibição: 

* '''Meta de hoje por volume:''' Análoga a ‘meta de hoje’ por valor, porém considerando a quantidade de itens vendidos.

A meta de hoje por volume exibe a quantidade de itens a ser vendida idealmente no dia de hoje. Para montar essa visão de 'meta de hoje' o GeoSales verifica se ainda há dias a trabalhar até a data final da meta, e divide o volume (quantidade de itens) da meta, subtraindo o que já foi atendido, pela quantidade de dias que restam a trabalhar, até o fim da meta.

A fórmula utilizada é a seguinte: (volume da meta - volume atingido) / ((dias a trabalhar + 1) - dias trabalhados). Considerando volume como sendo a quantidade de itens.

Desta forma, o vendedor conseguirá visualizar quanto deverá ser alcançado no dia de hoje, para que, ao fim do período pré-determinado, a meta seja atingida. É válido salientar que, caso não hajam dias a trabalhar até o fim da meta, o valor desta meta será zero.

* '''Vendido hoje por volume:''' Somatório da quantidade de itens vendidos nos pedidos cadastrados no dia corrente. O total vendido hoje por volume é dado pela quantidade total de itens em pedidos que foram vendidos hoje. O sistema verifica os pedidos que foram cadastrados no dia corrente e é informado ao usuário a soma da quantidade de itens total desses pedidos. É importante lembrar que só serão considerados neste cálculo pedidos com tipo de pedido parametrizado para utilizar meta, ou seja, com o campo ID_UTILIZA_META setado com o valor 'S'.

* '''Saldo de hoje por volume:'''  O sistema irá verificar os pedidos que foram cadastrados e subtrair a meta diária do vendedor, para isso, utiliza-se a seguinte fórmula: (Quantidade de caixas dos pedidos cadastrados no dia atual - Meta do dia atual por volume).

* '''Atingido até hoje por volume:''' Somatório da quantidade de itens dos pedidos cadastrados no período desde a data inicial da meta da meta até o dia atual.

* '''Atingido até hoje por preço médio:''' O valor de meta atingido até hoje, considerando o preço médio de venda é dado pela seguinte fórmula: (Valor da venda realizada(em reais) / volume de caixas realizado), no período desde a data inicial da meta da meta até o dia atual.

* '''Valor da meta do período por volume:''' Valor da meta por volume a ser atingida pelo vendedor.

* '''Valor da meta preço médio:''' Valor da meta por preço médio a ser atingida pelo vendedor.

== Regras de Negócios ==

'''[RN1] - ''' 

'''[RN2] - ''' 

'''[RN3] - ''' 

'''[RN4] - ''' 

'''[RN5] - ''' 

'''[RN6] - ''' 

'''[RN7] - ''' 

'''[RN8] - ''' 

== Regras de Integração ==

'''[RI1] - ''' 

'''[RI2] - ''' 

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

{| class="wikitable"
! Setor 
! Aprovado Por
! Data

|- 
| Desenvolvimento - GeoSales ||  || 
|- 
| Integração - GeoSales ||  || 
|-
| Configurações - GeoSales ||  || 
|-
|}

=== Empresa solicitante === 

{| class="wikitable"
! Setor 
! style="width:200px" |Aprovado Por
! style="width:200px" |Data

|-  
| TI - Montana ||  || 
|- 
| Gestor do Projeto - Montana ||  || 
|- 
| Diretoria - Montana ||  || 
|}