Mudanças entre as edições de "Exibição de metas"

Edição atual tal como às 13h24min de 8 de agosto de 2019

Histórico de Alterações

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

Manter campos já existentes no aplicativo e fazer a adição de novos campos de meta, considerando além do valor, o volume(quantidade) e o preço médio.

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

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: Valor da meta a ser atingida pelo vendedor.

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). O preço médio, por sua vez, refere-se ao valor total de venda, dividido pela quantidade de itens vendidos, gerando assim uma média do preço aplicado na venda.

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 por volume 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 (em reais) / quantidade de itens vendidos), 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] - O layout da tela atual de metas não será alterado, portanto, serão adicionadas a tabela que exibe metas atualmente, novas linhas, com finalidade de exibir os novos campos abaixo dos campos existentes atualmente.

[RN2] - As visões de meta por volume (quantidade de itens) a serem adicionadas no GeoSales são exclusivamente: Meta de hoje por volume, Vendido hoje por volume, saldo de hoje por volume, atingido até hoje por volume e valor da meta do período por volume.

[RN3] - As visões de meta por preço médio a serem adicionadas no GeoSales são exclusivamente: Atingido até hoje por preço médio, e valor da meta por preço médio.

Regras de Integração

[RI1] - A meta por valor será trazida do campo CT_VALOR e integrada ao GeoSales, sendo salva na tabela META_VENDA.

[RI2] - A meta por volume (quantidade) será trazida do campo CT_QUANT e integrada ao GeoSales, sendo salva na tabela META_VENDA.

[RI3] - A meta por preço médio será trazida do campo CT_XPMEDIO e integrada ao GeoSales, sendo salva na tabela META_VENDA.

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
Integração - GeoSales
Configurações - GeoSales

Empresa solicitante

Setor	Aprovado Por	Data
TI - Montana
Gestor do Projeto - Montana
Diretoria - Montana

@@ Linha 5: / Linha 5: @@
 ! Comentários
 |-
-| 17/04/2019  || Ryvane Maria || Inclusão de solicitações do cliente
+| 02/07/2019  || Ryvane Maria || Criação do documento
 |-
 |}
@@ Linha 11: / Linha 11: @@
 == Necessidade ==
-É possível que seja aplicado, durante um determinado período de tempo, um percentual de desconto logístico faseado sob uma venda. Este desconto possibilita, por exemplo, alavancar as vendas antes do fechamento do fim do mês.
+Exibir com finalidade de consulta as métricas de apuração de meta no GeoSales Mobile.
-Esse percentual de desconto, chamado de desconto por período logístico, tendo como base de cálculo a data de faturamento do pedido, e varia de acordo com o período do mês. Este desconto deverá ser cadastrado diretamente no GeoSales.
+== Solução ==
-== Solução ==
+Manter campos já existentes no aplicativo e fazer a adição de novos campos de meta, considerando além do valor, o volume(quantidade) e o preço médio.
+== 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 cadastradas:
+* '''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).
-De forma a viabilizar o cadastro de informações necessário para a aplicação de desconto logístico, será criada uma nova tela no portal GeoSales EVO, onde o usuário poderá associar um percentual de desconto a um período de aplicação, de acordo com a organização de venda, canal de venda, e o grupo de cliente selecionados.
+* '''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.
-Ao passo que a data de faturamento prevista for definida, o GeoSales irá informar ao vendedor que existe um desconto para aquele período logístico, e perguntar se o vendedor deseja aplicar o desconto ou não. Caso o vendedor confirme, este percentual será aplicado sob todos os itens do pedido.
+* '''Data Inicial:''' Data inicial da meta.
-É importante salientar que este desconto será validado considerando a data de faturamento do pedido, ou seja, o desconto aplicado será referente o período em que se encaixa a data de faturamento do pedido. Caso haja um desconto a ser aplicado neste período, o vendedor será alertado e poderá decidir entre aplicar ou não o desconto sob o valor final do pedido, ou seja, sob todos os seus itens.
+* '''Data Final:''' Data final da meta.
-== Implementação ==
+* '''Dias à trabalhar:''' Quantidade de dias a serem trabalhados para que a meta seja atingida.
-'''- Criar novo tipo de desconto:'''
+* '''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.
-Deverá ser criado um novo tipo de desconto chamado desconto por período logístico. (DESC_PERIODO)
+* '''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.
-'''- Criar campos para cadastro de informações:'''
+* '''Valor meta diária:''' A meta diária é dada pelo valor da meta dividido pela quantidade de dias trabalhados.
-Deverá ser criado um cadastro com a finalidade de incluir informações a respeito do desconto por período logístico.
+* '''Valor meta período:''' Valor da meta a ser atingida pelo vendedor.
-Neste cadastro poderão ser incluídos pelo usuário as seguintes informações: Dia de início do período logístico, Dia de término do período logístico, organização de venda, canal de venda, grupo de clientes e percentual de desconto. É importante salientar que todos esses campos tem preenchimento obrigatório, exceto o campo grupo de clientes.
+* '''Positivação:''' O campo de positivação é utilizado para determinar o percentual de clientes que deve ser atendido pelo vendedor.
-Será possível, além dos parâmetros citados, definir uma data de vigência para o desconto citado. Essa data de vigência será definida por uma data de início e uma data de término. É importante salientar que a data de início deve ser superior ou igual a data atual, bem como a data de término deve ser igual ao superior a data de início, sendo estes campos não obrigatórios. Caso não haja cadastro de data de início e de término, o GeoSales não irá considerar data de vigência.
+'''- Novos campos a serem criados no GeoSales Mobile a respeito das informações de metas:'''
-O campo 'grupo de clientes' será utilizado para realizar cadastro de exceções.
+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.
-'''- Salvar informações cadastradas no GeoSales:'''
+É 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). O preço médio, por sua vez, refere-se ao valor total de venda, dividido pela quantidade de itens vendidos, gerando assim uma média do preço aplicado na venda.
-As informações inseridas no cadastro descrito acima deverão ser salvas na tabela PERIODO_LOGISTICO.
+A criação desses campos irá seguir os seguintes critérios de exibição:
-'''- Validar informações inseridas pelo usuário:'''
+* '''Meta de hoje por volume:''' Análoga a ‘meta de hoje’ por valor, porém considerando a quantidade de itens vendidos.
-Com a finalidade de garantir a correta inserção de dados e uma parametrização de descontos mais eficaz, algumas validações devem ser feitas nos dados digitados pelo usuário.
+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.
-Deverá ser verificado se o período e o desconto inseridos são válidos, de acordo com os seguintes critérios:
+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.
-#Período, ou parte dele, já não possui um desconto cadastrado.
+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.
-#Desconto só recebe valores numéricos, decimais ou inteiros.
-#Desconto é um valor entre zero e cem.
-É importante salientar que não deve ser possível cadastrar dois descontos para um mesmo dia ou período e mesmos parâmetros, visando evitar o conflito ou a sobreposição desse tipo de desconto. Portanto, caso seja necessário alterar o desconto já criado para um grupo de clientes, o usuário deverá editar o desconto já parametrizado acessando a lista de descontos.
+* '''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'.
-== Regras de Negócios ==
+* '''Saldo de hoje por volume:'''  O sistema irá verificar os pedidos que foram cadastrados e subtrair a meta diária por volume 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).
-'''[RN1] - ''' Não deve ser possível cadastrar dois descontos para um mesmo cenário de parâmetros.
+* '''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.
-'''[RN2] - ''' Quando houverem alterações no cadastro, será criado um log registrando a modificação.
+* '''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 (em reais) / quantidade de itens vendidos), no período desde a data inicial da meta da meta até o dia atual.
-'''[RN3] - ''' O período, ou parte dele, não deve possuir um desconto já cadastrado.
+* '''Valor da meta do período por volume:''' Valor da meta por volume a ser atingida pelo vendedor.
-'''[RN4] - ''' O campo de desconto só deve receber valores numéricos, decimais ou inteiros.
+* '''Valor da meta preço médio:''' Valor da meta por preço médio a ser atingida pelo vendedor.
-'''[RN5] - ''' O campo de desconto só deve receber valores entre zero e cem.
+== Regras de Negócios ==
-'''[RN6] - ''' Caso não haja data de início cadastrada, o GeoSales irá assumir como início a data de cadastro.
+'''[RN1] - ''' O layout da tela atual de metas não será alterado, portanto, serão adicionadas a tabela que exibe metas atualmente, novas linhas, com finalidade de exibir os novos campos abaixo dos campos existentes atualmente.
-'''[RN7] - ''' Caso haja um desconto cadastrado com o valor 'zero', o GeoSales irá entender que para os parâmetros cadastrados não irá ser aplicado desconto. Por exemplo: Um cadastro realizado para a organização de venda A, e grupo de cliente B, que tenha o percentual de desconto zerado, não será aplicado desconto algum para o o grupo de cliente em questão.
+'''[RN2] - ''' As visões de meta por volume (quantidade de itens) a serem adicionadas no GeoSales são exclusivamente: Meta de hoje por volume, Vendido hoje por volume, saldo de hoje por volume, atingido até hoje por volume e valor da meta do período por volume.
-'''[RN8] - ''' A ausência de informação no campo 'grupo de cliente' torna a regra cadastrada válida para todos os grupos contidos neste canal, caso não haja outra regra de exceção cadastrada para um grupo de clientes
+'''[RN3] - ''' As visões de meta por preço médio a serem adicionadas no GeoSales são exclusivamente: Atingido até hoje por preço médio, e valor da meta por preço médio.
 == Regras de Integração ==
-'''[RI1] - ''' As informações de desconto por período logístico serão cadastradas diretamente no GeoSales e não serão trazidas do ERP.
+'''[RI1] - ''' A meta por valor será trazida do campo CT_VALOR e integrada ao GeoSales, sendo salva na tabela META_VENDA.
+'''[RI2] - ''' A meta por volume (quantidade) será trazida do campo CT_QUANT e integrada ao GeoSales, sendo salva na tabela META_VENDA.
-'''[RI2] - ''' As informações de desconto por período logístico não serão enviadas ao ERP.
+'''[RI3] - ''' A meta por preço médio será trazida do campo CT_XPMEDIO e integrada ao GeoSales, sendo salva na tabela META_VENDA.
 == Aprovação ==
@@ Linha 91: / Linha 111: @@
 |-
-| Desenvolvimento - GeoSales || Jefferson Quesado || 21/12/2019
+| Desenvolvimento - GeoSales ||  ||
 |-
 | Integração - GeoSales ||  ||