GeoSales - Contribuições do(a) usuário(a) [pt-br]

Busca de produtos por Referência

2021-04-12T14:44:33Z

Leo2s: Desfeita a edição 15157 de Ramon.queiroz (Discussão)

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 12/04/2021 || João Ramon || Criação do documento
|-
|}

== Necessidade ==

Ao realizar estoques de produtos, muitas vezes é necessário possuir mais de um fornecedor, a fim de que tal produto esteja sempre disponível. Para fins de cadastro, um produto com as mesmas especificações (tomemos como exemplo parafusos com mesmas dimensões e tamanhos, ou fios com mesma bitola e corrente máxima, etc), possuem o mesmo '''código de referência''', muito embora possuam códigos de produtos diferenciados. Na plataforma GeoSales, ao realizar um determinado tipo de consulta de produtos na tela de pedidos, ao pesquisar o produto pela sua referência, o portal irá retornar todos os produtos vinculados a este código de referência, mas o contrário não se obseva; Ao realizar a pesquisa por meio de um produto, o portal retornará apenas o produto especificado, e não as vinculações dos códigos de referência. Haja visto que tal pesquisa é de fundamental importância para o cliente, aponta-se a necessidade de, ao realizar pesquisa por código de produto, o sistema consiga retornar todos os produtos com o código de referência a eles vinculados.

== Solução ==

== Implementação ==

== Cenários ==

Para a formação e entendimento dos cenários considere a seguinte tabela:

{|class = "wikitable"
! CD_PRODUTO
! CD_REFERENCIA
|-
| P001 || R001
|-
| P002 || R001
|-
| P003 || R002
|-
| P004 || R002
|-
|}

Aqui temos 4 produtos cadastrados, vinculados a 2 referencias distintas.

=== Cenário 1 (Pesquisa atual por referência) ===

Ao realizar a pesquisa na tela de produtos no acompanhamento de vendas, caso seja desejado verificar qual(is) produto(s) está(ão) cadastrado(s) em determinada referência, realizo, por exemplo, a pesquisa digitando 'R001'.

A pesquisa retornará os dados constantes da tabela abaixo:

{|class = "wikitable"
! CD_PRODUTO
! CD_REFERENCIA
|-
| P001 || R001
|-
| P002 || R001
|-
|}

Ou seja, pela pesquisa, sabemos que os produtos P001 e P002 estão vinculados à referência R001.

=== Cenário 2 (Pesquisa atual por produto) ===

Ao realizar a pesquisa na tela de produtos no acompanhamento de vendas, caso seja desejado verificar qual(is) referências(s) está(ão) cadastrada(s) em determinado(s) produto(s), realizo, por exemplo, a pesquisa digitando 'P001'.

A pesquisa retornará os dados constantes da tabela abaixo:

{|class = "wikitable"
! CD_PRODUTO
! CD_REFERENCIA
|-
| P001 || R001
|-
|}

Ou seja, pela pesquisa, sabemos que o produto P001 está vinculado à referência R001, '''mas a busca não traz, por exemplo, o produto P003, cuja referência também é R001.'''

=== Cenário 3 (Pesquisa desejada por referência) ===

Ao realizar a pesquisa na tela de produtos no acompanhamento de vendas, caso seja desejado verificar qual(is) produto(s) está(ão) cadastrado(s) em determinada referência, realizo, por exemplo, a pesquisa digitando 'R002'.

A pesquisa retornará os dados constantes da tabela abaixo:

{|class = "wikitable"
! CD_PRODUTO
! CD_REFERENCIA
|-
| P003 || R002
|-
| P004 || R002
|-
|}

Ou seja, pela pesquisa, sabemos que os produtos P003 e P004 estão vinculados à referência R002. Em outras palavras, vimos que o cenário 3 possui mecanismo de pesquisa idêntico ao Cenário 1 e, portanto, já atende ao Cenário desejado.

=== Cenário 4 (Pesquisa desejada por produto) ===

Ao realizar a pesquisa na tela de produtos no acompanhamento de vendas, caso seja desejado verificar qual(is) referências(s) está(ão) cadastrada(s) em determinado(s) produto(s), realizo, por exemplo, a pesquisa digitando 'P001'.

A pesquisa retornará os dados constantes da tabela abaixo:

{|class = "wikitable"
! CD_PRODUTO
! CD_REFERENCIA
|-
| P001 || R001
|-
| P002 || R001
|-
|}

Ou seja, pela pesquisa, sabemos que os produtos P001 e P002 estão vinculados à referência R001. À semelhança do Cenário 1, os valores obtidos são similares, ''com a diferença'' que o meio de busca não foi por meio da '''referência''', mas dos '''produtos vinculados à ela'''.

== Regras de Negócios ==

'''[RN1] - '''

'''[RN2] - '''

'''[RN3] - '''

=== Protótipos ===

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T22:32:07Z

Leo2s: /* Cenário 4 ( Fórmula com utilização de Quantidade) */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio usuário consiga fazer esta composição.

O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''' (a mesma lógica de cálculo das calculadoras HP 12 C), ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.

== Implementação ==

O processo terá como bases os seguintes passos: 

# Criação de Tabela;
# Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela);
# Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos;
# Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços.

=== Cadastro tabela de preço ===
Para criação da tabela de preço, será criada uma tela onde o usuário irá fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado, mas, apenas desativa-los.

Ao entrar na tela o sistema deve apresentar campos de filtros, os quais, o usuário poderá localizar um cadastro já inserido ou realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela, terá o acesso para fazer um novo cadastro. na qual, o usuário vai preencher os seguintes campos.

==== Campos de cadastro ====
* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Data inicial vigência''' - Campo de data, onde definirá o inicio da vigência da tabela;
* '''Data final vigência''' - Campo de data, onde definirá o final da vigência da tabela;

* Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar a data final inferior a data atual;
* Caso uma tabela de preço tenha uma data inicial posterior à data atual, essa tabela de preço específica não deverá ser exibida para seleção no cadastro do pedido;
* Caso uma tabela de preço esteja com a data final de vigência vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;
* Os campos de datas não serão obrigatórios. Quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;
* Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo, sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utilizar os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.

[[Arquivo:Tabelapreco.jpg|500px]]

[[Arquivo:Tabelapreco2.jpg|500px]]

[[Arquivo:Tela1.jpg|700px]]

=== Declaração de variáveis ===

Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:

* O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e está limitada ao máximo de 8 caracteres, sendo todos minúsculos obrigatoriamente, seguindo o padrão <code>[a-z0-9]</code>.
* A variável deve estar associada a um produto ou uma tabela de preço
* Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.
* Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.
* As variáveis fs, fmm e fmx, especificamente, não poderão ser utilizadas, por tratarem-se de variáveis protegidas em uso no sistema.

==== Campos de cadastro ====

* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Chave''' - Campo de texto de 8 caracteres;
* '''Produto / Tabela''' - A seleção de um produto ou de uma tabela, dados previamente alimentados;
* '''Valor''' - Campo numérico(18:6);

A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

[[Arquivo:Tela2.jpg|500px]]

=== Definição da formula de preço ===

* Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.
* Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.
* Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.
* Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.
* Quando um dos campos das formulas não houver definição de formula, o valor será gerado com o valor zero ou o resultado da formula apresentar um valor negativo, esse valor também se apresentará como zero.
* Ao gerar os valores da faixa de preço, caso o valor mínimo, seja maior que o valor sugerido, esse valor será replicado para para o sugerido.

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

[[Arquivo:Tela3.jpg|500px]]

=== Processar tabela ===

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de venda está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos. Ou seja, será possível realizar a seleção de produtos e colocar dentro de um mesmo Agrupamento. Ao fim do processo, os produtos vinculados aquele agrupamento e a tabela de preço, receberam seus preços baseados nas formulas inseridas para a tabela preço especificada.

Para geração do preço, necessariamente o produto precisa está vinculado a tabela de preço, seja de forma individual ou como já citado dentro de um agrupamento.

Sempre que uma das variáveis ou formulas de calculo for alteradas, para que ocorra atualização de valores da faixa de preço baseados na alteração, deve ser feito um reprocessamento, assim os valores serão atualizados levando em consideração as alterações feitas.

Na aba de reprocessamento, sempre que houver uma solicitação de processamento devemos salvar as informações para eventual consulta. Ao entrar no detalhe podemos acompanhar o status do processamento.

Ao iniciar um processamento ou reprocessamento, qualquer alteração só refletirá nos valores, depois de um novo reprocessamento, já que o iniciado, foi antes da alteração realizada.

[[Arquivo:Tela4.jpg|500px]]

== Cenários ==

===DICIONÁRIO DE DADOS ===

Considere tabela abaixo com as seguintes tabelas cadastradas e suas respectivas vigências:
{|class = "wikitable"
! TABELA
! DESCRIÇÃO
! INICIO DA VIGÊNCIA
! FINAL DA VIGÊNCIA
|-
| '''01''' || TABELA SP || 01/05/2020 || 01/01/2022
|-
| '''02''' || TABELA RJ || 01/05/2020 || 01/01/2022
|-
| '''03''' ||TABELA RS ||01/05/2020 || 01/01/2022
|-
| '''04''' || TABELA SP - CARREFU || 01/05/2020 || 01/01/2022
|-
| '''05''' || TABELA BA || 01/05/2020 || 01/01/2022
|-
| '''06''' || TABELA ES || 01/05/2020 || 01/01/2022
|-
| '''07''' || TABELA SP - CAPITAL ||01/05/2020 || 01/01/2022
|}

Selecionada a tabela desejada, o próximo passo é fazer a declaração das variáveis.
{|class = "wikitable"
! CHAVE
! DESCRIÇÃO DA VARIÁVEL
! TABELA / PRODUTO
! VALOR
|-
| '''pp''' || Preço de Partida || Tabela - 01 || R$ 106,00
|-
| '''fc''' || Cor / Tamanho || Produto - 001 || 1,5
|-
| '''ce''' ||Custo de Embalagem || Tabela - 01 || R$ 12,20
|-
| '''fr''' || Frete || Tabela - 01 || - 5
|-
| '''pr''' || Promotor || Tabela - 01 || 1,02
|-
| '''qu''' || Fator Quebra || Tabela - 01 || 3,5
|-
| '''cf''' || Contrato de Fidelidade || Tabela - 01 || 1,02
|}

=== Cenário 1 (Formula com utilização integral de variáveis) ===

Elaborando o preço do produto 'P001' para o cliente 'C001' por um período de 6 meses.

No portal GeoSales, na tela de variáveis, serão utilizadas as seguintes informações:

'''Enumeração das variáveis''' 

Pelo exposto, temos que 7 variáveis foram declaradas. As fórmulas que devemos gerar (Fórmula de valor mínimo, fórmula de valor Sugerido e Fórmula de Valor Máximo) serão derivadas destas variáveis que apontamos.

Supondo que, para a fórmula de valor Sugerido, iremos adotar a seguinte fórmula:

<center><code>fs = pp fc / * qu * cf *</code></center>

Com esta composição, o valor Sugerido do produto será '''''R$ 252,28'''''.

Supondo que, para a fórmula de valor Mínimo, iremos adotar a seguinte fórmula:

<center><code>fmm = pp fc /</code></center>

Com esta composição, o valor mínimo do produto será '''''R$ 70,66'''''.

Supondo que, para a fórmula de valor Máximo, iremos adotar a seguinte fórmula:

<center><code>fmx = pp fc / ce + fr + pr * qu * cf * </code></center>

Com esta composição, o valor máximo do produto será ''''' R$ 283,54'''''.

=== Cenário 2 (fórmula com utilização de variáveis protegidas ''fs'', ''fmm'' e ''fmx'') ===

Elaborando o preço do produto 'P002' para o cliente 'C002' por um período de 6 meses.

Pelo exposto, temos que 7 variáveis foram declaradas. As fórmulas que devemos gerar (Fórmula de valor mínimo, fórmula de valor Sugerido e Fórmula de Valor Máximo) serão derivadas destas variáveis que apontamos.

Supondo que, para a fórmula de valor Sugerido, iremos adotar a seguinte fórmula:

<center><code>fs = pp fc / * qu * cf *</code></center>

Com esta composição, o valor Sugerido do produto será '''''R$ 252,28'''''.

Supondo que, para a fórmula de valor Mínimo, iremos adotar a seguinte fórmula:

<center><code>fmm = fs fc /</code></center>

Onde fs é o valor sugerido, criado a partir da formação de valor do procedimento anterior.

Com esta composição, o valor mínimo do produto será '''''R$ 168,18'''''.

Supondo que, para a fórmula de valor Máximo, iremos adotar a seguinte fórmula:

<center><code>fmx = fmm qu * </code></center>

Com esta composição, o valor máximo do produto será ''''' R$ 588,63'''''.

=== Cenário 3 ( Fórmula com utilização de variáveis protegidas e constantes) ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

'''Enumeração das variáveis''' 

Supondo que, para a fórmula de valor Sugerido, iremos adotar a seguinte fórmula:

<center><code>fs = pp fc / * qu * cf *</code></center>

Com esta composição, o valor Sugerido do produto será '''''R$ 252,28'''''.

Supondo que, para a fórmula de valor Mínimo, iremos adotar a seguinte fórmula:

<center><code>fmm = fs 100 -</code></center>

Com esta composição, o valor mínimo do produto será '''''R$ 152,28'''''.

Supondo que, para a fórmula de valor Máximo, iremos adotar a seguinte fórmula:

<center><code>fmx = fs 100 +</code></center>

Com esta composição, o valor máximo do produto será ''''' R$ 352,28'''''.

=== Cenário 4 ( Fórmula com utilização de Quantidade) ===

O campo quantidade fornece um escalonamento de valores, permitindo que pequenos reajustes esttratégicos de preço possam ser realizados de forma automática de acordo com a quantidade de produtos solicitados. Para a elaboração deste cenário, utilizaremos esta Tabela de Quantidade:

{| class = "wikitable"
! Quantidade (between)
! Fator de dedução
|-
|0 - 10 || 1,00
|-
|11 - 20 || 1,01
|-
|Acima de 20 || 1,02
|}

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

'''Enumeração das variáveis''' 

Supondo que, para a fórmula de valor Sugerido, iremos adotar a seguinte fórmula:

<center><code>fs = pp fc / * qu * cf *</code></center>

Com esta composição, o valor Sugerido do produto será '''''R$ 252,28'''''.

# Supondo que, para a fórmula de valor sugerido, associei uma quantidade de 05 unidades de produto. Logo o valor sugerido na quantidade solicitada será <code>fs * fator de dedução</code>, em valores reais, ''''' R$ 252,58'''''.
# Supondo que, para a fórmula de valor sugerido, associei uma quantidade de 15 unidades de produto. Logo o valor sugerido na quantidade solicitada será <code>fs * fator de dedução</code>, em valores reais, ''''' R$ 250,05'''''.
# Supondo que, para a fórmula de valor sugerido, associei uma quantidade de 25 unidades de produto. Logo o valor sugerido na quantidade solicitada será <code>fs * fator de dedução</code>, em valores reais, ''''' R$ 247,23'''''.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar, ou seja, o batch irá apresentar os dados apenas referentes às variáveis relacionadas (via GSOload). A medida visa evitar um carregamento excessivamente pesado de dados para determinada função. 

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

'''[RN7] - ''' A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

'''[RN8] - ''' As variáveis '''''fs''''', '''''fmm''''' e '''''fmx''''' corresponderão aos valores resultantes das fórmulas de valor Sugerido, Valor Mínimo e Valor Máximo, respectivamente. Portanto, tais variáveis serão protegidas.

'''[RN9] - ''' As variáveis permitidas para cadastro pelo usuário deverão atender ao padrão <code>[a-z0-9]</code>

'''[RN10] - ''' As formulas não poderão ter valor nulo, nem valores negativos. Caso não haja valor sugerido cadastrado, o valor mínimo será igual ao valor sugerido, ou o resultado da formula ser um valor negativo, o campo receberá o valor zero.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T21:26:12Z

Leo2s: /* Composição de preço */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio usuário consiga fazer esta composição.

O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''' (a mesma lógica de cálculo das calculadoras HP 12 C), ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.

== Implementação ==

O processo terá como bases os seguintes passos: 

# Criação de Tabela;

# Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela);
# Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos;
# Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços.

=== Cadastro tabela de preço ===
Para criação da tabela de preço, será criada uma tela onde o usuário irá fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado, mas, apenas desativa-los.

Ao entrar na tela o sistema deve apresentar campos de filtros, os quais, o usuário poderá localizar um cadastro já inserido ou realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela, terá o acesso para fazer um novo cadastro. na qual, o usuário vai preencher os seguintes campos.

==== Campos de cadastro ====
* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Data inicial vigência''' - Campo de data, onde definirá o inicio da vigência da tabela;
* '''Data final vigência''' - Campo de data, onde definirá o final da vigência da tabela;

* Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar a data final inferior a data atual;
* Caso uma tabela de preço tenha uma data inicial posterior à data atual, essa tabela de preço específica não deverá ser exibida para seleção no cadastro do pedido;
* Caso uma tabela de preço esteja com a data final de vigência vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;
* Os campos de datas não serão obrigatórios. Quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;
* Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo, sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utilizar os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.

[[Arquivo:Tabelapreco.jpg|500px]]

[[Arquivo:Tabelapreco2.jpg|500px]]

[[Arquivo:Tela1.jpg|700px]]

=== Declaração de variáveis ===

Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:

* O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e está limitada ao máximo de 8 caracteres, sendo todos minúsculos obrigatoriamente, seguindo o padrão <code>[a-z0-9]</code>.
* A variável deve estar associada a um produto ou uma tabela de preço
* Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.
* Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.
* As variáveis fs, fmm e fmx, especificamente, não poderão ser utilizadas, por tratarem-se de variáveis protegidas em uso no sistema.

==== Campos de cadastro ====

* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Chave''' - Campo de texto de 8 caracteres;
* '''Produto / Tabela''' - A seleção de um produto ou de uma tabela, dados previamente alimentados;
* '''Valor''' - Campo numérico(18:6);

A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

[[Arquivo:Tela2.jpg|500px]]

=== Definição da formula de preço ===

* Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.
* Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.
* Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.
* Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

[[Arquivo:Tela3.jpg|500px]]

=== Processar tabela ===

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de venda está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos. Ou seja, será possível realizar a seleção de produtos e colocar dentro de um mesmo Agrupamento. Ao fim do processo, os produtos vinculados aquele agrupamento e a tabela de preço, receberam seus preços baseados nas formulas inseridas para a tabela preço especificada.

Para geração do preço, necessariamente o produto precisa está vinculado a tabela de preço, seja de forma individual ou como já citado dentro de um agrupamento.

Sempre que uma das variáveis ou formulas de calculo for alteradas, para que ocorra atualização de valores da faixa de preço baseados na alteração, deve ser feito um reprocessamento, assim os valores serão atualizados levando em consideração as alterações feitas.

Na aba de reprocessamento, sempre que houver uma solicitação de processamento devemos salvar as informações para eventual consulta. Ao entrar no detalhe podemos acompanhar o status do processamento.

Ao iniciar um processamento ou reprocessamento, qualquer alteração só refletirá nos valores, depois de um novo reprocessamento, já que o iniciado, foi antes da alteração realizada.

[[Arquivo:Tela4.jpg|500px]]

== Cenários ==

===DICIONÁRIO DE DADOS ===

Considere tabela abaixo com as seguintes tabelas cadastradas e suas respectivas vigências:
{|class = "wikitable"
! TABELA
! DESCRIÇÃO
! INICIO DA VIGÊNCIA
! FINAL DA VIGÊNCIA
|-
| '''01''' || TABELA SP || 01/05/2020 || 01/01/2022
|-
| '''02''' || TABELA RJ || 01/05/2020 || 01/01/2022
|-
| '''03''' ||TABELA RS ||01/05/2020 || 01/01/2022
|-
| '''04''' || TABELA SP - CARREFU || 01/05/2020 || 01/01/2022
|-
| '''05''' || TABELA BA || 01/05/2020 || 01/01/2022
|-
| '''06''' || TABELA ES || 01/05/2020 || 01/01/2022
|-
| '''07''' || TABELA SP - CAPITAL ||01/05/2020 || 01/01/2022
|}

Selecionada a tabela desejada, o próximo passo é fazer a declaração das variáveis.
{|class = "wikitable"
! CHAVE
! DESCRIÇÃO DA VARIÁVEL
! TABELA / PRODUTO
! VALOR
|-
| '''pp''' || Preço de Partida || Tabela - 01 || R$ 106,00
|-
| '''fc''' || Cor / Tamanho || Produto - 001 || 1,5
|-
| '''ce''' ||Custo de Embalagem || Tabela - 01 || R$ 12,20
|-
| '''fr''' || Frete || Tabela - 01 || - 5
|-
| '''pr''' || Promotor || Tabela - 01 || 1,02
|-
| '''qu''' || Fator Quebra || Tabela - 01 || 3,5
|-
| '''cf''' || Contrato de Fidelidade || Tabela - 01 || 1,02
|}

=== Cenário 1 (Formula com utilização integral de variáveis) ===

Elaborando o preço do produto 'P001' para o cliente 'C001' por um período de 6 meses.

No portal GeoSales, na tela de variáveis, serão utilizadas as seguintes informações:

'''Enumeração das variáveis''' 

Pelo exposto, temos que 7 variáveis foram declaradas. As fórmulas que devemos gerar (Fórmula de valor mínimo, fórmula de valor Sugerido e Fórmula de Valor Máximo) serão derivadas destas variáveis que apontamos.

Supondo que, para a fórmula de valor Sugerido, iremos adotar a seguinte fórmula:

<center><code>p = pp fc / * qu * cf *</code></center>

Com esta composição, o valor Sugerido do produto será '''''R$ 252,28'''''.

Supondo que, para a fórmula de valor Mínimo, iremos adotar a seguinte fórmula:

<center><code>p = pp fc /</code></center>

Com esta composição, o valor mínimo do produto será '''''R$ 70,66'''''.

Supondo que, para a fórmula de valor Máximo, iremos adotar a seguinte fórmula:

<center><code>p = pp fc / ce + fr + pr * qu * cf * </code></center>

Com esta composição, o valor máximo do produto será ''''' R$ 283,54'''''.

=== Cenário 2 (fórmula com utilização de variáveis protegidas ''fs'', ''fmm'' e ''fmx'') ===

Elaborando o preço do produto 'P002' para o cliente 'C002' por um período de 6 meses.

Pelo exposto, temos que 7 variáveis foram declaradas. As fórmulas que devemos gerar (Fórmula de valor mínimo, fórmula de valor Sugerido e Fórmula de Valor Máximo) serão derivadas destas variáveis que apontamos.

Supondo que, para a fórmula de valor Sugerido, iremos adotar a seguinte fórmula:

<center><code>p = pp fc / * qu * cf *</code></center>

Com esta composição, o valor Sugerido do produto será '''''R$ 252,28'''''.

Supondo que, para a fórmula de valor Mínimo, iremos adotar a seguinte fórmula:

<center><code>p = fs fc /</code></center>

Onde fs é o valor sugerido, criado a partir da formação de valor do procedimento anterior.

Com esta composição, o valor mínimo do produto será '''''R$ 168,18'''''.

Supondo que, para a fórmula de valor Máximo, iremos adotar a seguinte fórmula:

<center><code>p = fmm qu * </code></center>

Com esta composição, o valor máximo do produto será ''''' R$ 588,63'''''.

=== Cenário 3 ( Fórmula com utilização de variáveis protegidas e constantes) ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

'''Enumeração das variáveis''' 

Supondo que, para a fórmula de valor Sugerido, iremos adotar a seguinte fórmula:

<center><code>p = pp fc / * qu * cf *</code></center>

Com esta composição, o valor Sugerido do produto será '''''R$ 252,28'''''.

Supondo que, para a fórmula de valor Mínimo, iremos adotar a seguinte fórmula:

<center><code>p = fs 100 -</code></center>

Com esta composição, o valor mínimo do produto será '''''R$ 152,28'''''.

Supondo que, para a fórmula de valor Máximo, iremos adotar a seguinte fórmula:

<center><code>p = fs 100 +</code></center>

Com esta composição, o valor máximo do produto será ''''' R$ 352,28'''''.



== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar, ou seja, o batch irá apresentar os dados apenas referentes às variáveis relacionadas (via GSOload). A medida visa evitar um carregamento excessivamente pesado de dados para determinada função. 

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

'''[RN7] - ''' A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

'''[RN8] - ''' As variáveis '''''fs''''', '''''fmm''''' e '''''fmx''''' corresponderão aos valores resultantes das fórmulas de valor Sugerido, Valor Mínimo e Valor Máximo, respectivamente. Portanto, tais variáveis serão protegidas.

'''[RN9] - ''' As variáveis permitidas para cadastro pelo usuário deverão atender ao padrão <code>[a-z0-9]</code>

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T20:12:51Z

Leo2s: /* Declaração de variáveis */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio usuário consiga fazer esta composição.

O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''' (a mesma lógica de cálculo das calculadoras HP 12 C), ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.

== Implementação ==

O processo terá como bases os seguintes passos: 

# Criação de Tabela;

# Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela);
# Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos;
# Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços.

=== Cadastro tabela de preço ===
Para criação da tabela de preço, será criada uma tela onde o usuário irá fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado, mas, apenas desativa-los.

Ao entrar na tela o sistema deve apresentar campos de filtros, os quais, o usuário poderá localizar um cadastro já inserido ou realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela, terá o acesso para fazer um novo cadastro. na qual, o usuário vai preencher os seguintes campos.

==== Campos de cadastro ====
* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Data inicial vigência''' - Campo de data, onde definirá o inicio da vigência da tabela;
* '''Data final vigência''' - Campo de data, onde definirá o final da vigência da tabela;

* Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar a data final inferior a data atual;
* Caso uma tabela de preço esteja com a data final de vigência vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;
* Os campos de datas não serão obrigatórios. Quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;
* Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo, sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utilizar os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.
</dd>
[[Arquivo:Tabelapreco.jpg|500px]]

[[Arquivo:Tabelapreco2.jpg|500px]]

=== Declaração de variáveis ===

Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:

* O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e está limitada ao máximo de 8 caracteres, sendo todos minúsculos obrigatoriamente, seguindo o padrão <code>[a-z0-9]</code>.
* A variável deve estar associada a um produto ou uma tabela de preço
* Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.
* Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.
* As variáveis fs, fmm e fmx, especificamente, não poderão ser utilizadas, por tratarem-se de variáveis protegidas em uso no sistema.

==== Campos de cadastro ====

* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Chave''' - Campo de texto de 8 caracteres;
* '''Produto / Tabela''' - A seleção de uma produto ou de uma tabela, dados previamente alimentados;
* '''Valor''' - Campo numérico(18:6);

A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

[[Arquivo:Tela2.jpg|500px]]

=== Definição da formula de preço ===

* Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.
* Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.
* Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.
* Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

[[Arquivo:Tela3.jpg|500px]]

=== Processar tabela ===

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

Sempre que uma das variáveis for alterada, para que ocorra atualização de valores da faixa de preço baseados na alteração, deve ser feito um reprocessamento baseado nos valores atualizados das variáveis.

Na aba de reprocessamento, sempre que houver uma solicitação de processamento devemos salvar as informações para eventual consulta. Ao entrar no detalhe podemos acompanhar o status do processamento.

[[Arquivo:Tela4.jpg|500px]]

== Cenários ==

===DICIONÁRIO DE DADOS ===

Considere tabela abaixo com as seguintes tabelas cadastradas e suas respectivas vigências:
{|class = "wikitable"
! TABELA
! DESCRIÇÃO
! INICIO DA VIGÊNCIA
! FINAL DA VIGÊNCIA
|-
| '''01''' || TABELA SP || 01/05/2020 || 01/01/2022
|-
| '''02''' || TABELA RJ || 01/05/2020 || 01/01/2022
|-
| '''03''' ||TABELA RS ||01/05/2020 || 01/01/2022
|-
| '''04''' || TABELA SP - CARREFU || 01/05/2020 || 01/01/2022
|-
| '''05''' || TABELA BA || 01/05/2020 || 01/01/2022
|-
| '''06''' || TABELA ES || 01/05/2020 || 01/01/2022
|-
| '''07''' || TABELA SP - CAPITAL ||01/05/2020 || 01/01/2022
|}

Selecionada a tabela desejada, o próximo passo é fazer a declaração das variáveis.
{|class = "wikitable"
! CHAVE
! DESCRIÇÃO DA VARIÁVEL
! TABELA / PRODUTO
! VALOR
|-
| '''pp''' || Preço de Partida || Tabela - 01 || R$ 106,00
|-
| '''fc''' || Cor / Tamanho || Produto - 001 || 1,5
|-
| '''ce''' ||Custo de Embalagem || Tabela - 01 || R$ 12,20
|-
| '''fr''' || Frete || Tabela - 01 || - 5
|-
| '''pr''' || Promotor || Tabela - 01 || 1,02
|-
| '''ou''' || Fator Quebra || Tabela - 01 || 3,5
|-
| '''cf''' || Contrato de Fidelidade || Tabela - 01 || 1,02
|}

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001' por um período de 6 meses.

No portal GeoSales, na tela de variáveis, serão utilizadas as seguintes informações:

'''Enumeração das variáveis''' 

Pelo exposto, temos que 7 variáveis foram declaradas. As fórmulas que devemos gerar (Fórmula de valor mínimo, fórmula de valor Sugerido e Fórmula de Valor Máximo) serão derivadas destas variáveis que apontamos.

Supondo que, para a fórmula de valor Sugerido, iremos adotar a seguinte fórmula:

<code>p = pp fc / * qu * cf *</code>

Com esta composição, o valor Sugerido do produto será '''''R$ 252,28'''''.

Supondo que, para a fórmula de valor Mínimo, iremos adotar a seguinte fórmula:

<code>p = pp fc /</code>

Com esta composição, o valor mínimo do produto será '''''R$ 70,66'''''.

Supondo que, para a fórmula de valor Máximo, iremos adotar a seguinte fórmula:

<code>p = pp fc / ce + fr + pr * qu *cf * </code>

Com esta composição, o valor máximo do produto será ''''' R$ 283,54'''''.


As variáveis estão relacionadas matematicamente de acordo com a notação: 

<code>P = PpFc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+</code>

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar, ou seja, o batch irá apresentar os dados apenas referentes às variáveis relacionadas (via GSOload). A medida visa evitar um carregamento excessivamente pesado de dados para determinada função. 

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

'''[RN7] - ''' A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T20:12:40Z

Leo2s: /* Declaração de variáveis */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio usuário consiga fazer esta composição.

O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''' (a mesma lógica de cálculo das calculadoras HP 12 C), ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.

== Implementação ==

O processo terá como bases os seguintes passos: 

# Criação de Tabela;

# Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela);
# Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos;
# Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços.

=== Cadastro tabela de preço ===
Para criação da tabela de preço, será criada uma tela onde o usuário irá fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado, mas, apenas desativa-los.

Ao entrar na tela o sistema deve apresentar campos de filtros, os quais, o usuário poderá localizar um cadastro já inserido ou realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela, terá o acesso para fazer um novo cadastro. na qual, o usuário vai preencher os seguintes campos.

==== Campos de cadastro ====
* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Data inicial vigência''' - Campo de data, onde definirá o inicio da vigência da tabela;
* '''Data final vigência''' - Campo de data, onde definirá o final da vigência da tabela;

* Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar a data final inferior a data atual;
* Caso uma tabela de preço esteja com a data final de vigência vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;
* Os campos de datas não serão obrigatórios. Quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;
* Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo, sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utilizar os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.
</dd>
[[Arquivo:Tabelapreco.jpg|500px]]

[[Arquivo:Tabelapreco2.jpg|500px]]

=== Declaração de variáveis ===

Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:

* O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e está limitada ao máximo de 8 caracteres, sendo todos minúsculos obrigatoriamente, seguindo o padrão <code>[a-z0-9]</code>.
* A variável deve estar associada a um produto ou uma tabela de preço
* Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.
* Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.
* As variáveis fs, fmm e fmx, especificamente, não poderão ser utilizadas, por tratarem-se de variáveis protegidas em uso no sistema.

==== Campos de cadastro ====

* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Chave''' - Campo de texto de 8 caracteres;
* '''Produto / Tabela''' - A seleção de uma produto ou de uma tabela, dados previamente alimentados;
* '''Valor''' - Campo numérico(18:6);

A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

[[Arquivo:Tela2.jpg|500px]]

=== Definição da formula de preço ===

* Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.
* Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.
* Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.
* Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

[[Arquivo:Tela3.jpg|500px]]

=== Processar tabela ===

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

Sempre que uma das variáveis for alterada, para que ocorra atualização de valores da faixa de preço baseados na alteração, deve ser feito um reprocessamento baseado nos valores atualizados das variáveis.

Na aba de reprocessamento, sempre que houver uma solicitação de processamento devemos salvar as informações para eventual consulta. Ao entrar no detalhe podemos acompanhar o status do processamento.

[[Arquivo:Tela4.jpg|500px]]

== Cenários ==

===DICIONÁRIO DE DADOS ===

Considere tabela abaixo com as seguintes tabelas cadastradas e suas respectivas vigências:
{|class = "wikitable"
! TABELA
! DESCRIÇÃO
! INICIO DA VIGÊNCIA
! FINAL DA VIGÊNCIA
|-
| '''01''' || TABELA SP || 01/05/2020 || 01/01/2022
|-
| '''02''' || TABELA RJ || 01/05/2020 || 01/01/2022
|-
| '''03''' ||TABELA RS ||01/05/2020 || 01/01/2022
|-
| '''04''' || TABELA SP - CARREFU || 01/05/2020 || 01/01/2022
|-
| '''05''' || TABELA BA || 01/05/2020 || 01/01/2022
|-
| '''06''' || TABELA ES || 01/05/2020 || 01/01/2022
|-
| '''07''' || TABELA SP - CAPITAL ||01/05/2020 || 01/01/2022
|}

Selecionada a tabela desejada, o próximo passo é fazer a declaração das variáveis.
{|class = "wikitable"
! CHAVE
! DESCRIÇÃO DA VARIÁVEL
! TABELA / PRODUTO
! VALOR
|-
| '''pp''' || Preço de Partida || Tabela - 01 || R$ 106,00
|-
| '''fc''' || Cor / Tamanho || Produto - 001 || 1,5
|-
| '''ce''' ||Custo de Embalagem || Tabela - 01 || R$ 12,20
|-
| '''fr''' || Frete || Tabela - 01 || - 5
|-
| '''pr''' || Promotor || Tabela - 01 || 1,02
|-
| '''ou''' || Fator Quebra || Tabela - 01 || 3,5
|-
| '''cf''' || Contrato de Fidelidade || Tabela - 01 || 1,02
|}

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001' por um período de 6 meses.

No portal GeoSales, na tela de variáveis, serão utilizadas as seguintes informações:

'''Enumeração das variáveis''' 

Pelo exposto, temos que 7 variáveis foram declaradas. As fórmulas que devemos gerar (Fórmula de valor mínimo, fórmula de valor Sugerido e Fórmula de Valor Máximo) serão derivadas destas variáveis que apontamos.

Supondo que, para a fórmula de valor Sugerido, iremos adotar a seguinte fórmula:

<code>p = pp fc / * qu * cf *</code>

Com esta composição, o valor Sugerido do produto será '''''R$ 252,28'''''.

Supondo que, para a fórmula de valor Mínimo, iremos adotar a seguinte fórmula:

<code>p = pp fc /</code>

Com esta composição, o valor mínimo do produto será '''''R$ 70,66'''''.

Supondo que, para a fórmula de valor Máximo, iremos adotar a seguinte fórmula:

<code>p = pp fc / ce + fr + pr * qu *cf * </code>

Com esta composição, o valor máximo do produto será ''''' R$ 283,54'''''.


As variáveis estão relacionadas matematicamente de acordo com a notação: 

<code>P = PpFc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+</code>

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar, ou seja, o batch irá apresentar os dados apenas referentes às variáveis relacionadas (via GSOload). A medida visa evitar um carregamento excessivamente pesado de dados para determinada função. 

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

'''[RN7] - ''' A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T20:12:20Z

Leo2s: /* Definição da formula de preço */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio usuário consiga fazer esta composição.

O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''' (a mesma lógica de cálculo das calculadoras HP 12 C), ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.

== Implementação ==

O processo terá como bases os seguintes passos: 

# Criação de Tabela;

# Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela);
# Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos;
# Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços.

=== Cadastro tabela de preço ===
Para criação da tabela de preço, será criada uma tela onde o usuário irá fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado, mas, apenas desativa-los.

Ao entrar na tela o sistema deve apresentar campos de filtros, os quais, o usuário poderá localizar um cadastro já inserido ou realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela, terá o acesso para fazer um novo cadastro. na qual, o usuário vai preencher os seguintes campos.

==== Campos de cadastro ====
* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Data inicial vigência''' - Campo de data, onde definirá o inicio da vigência da tabela;
* '''Data final vigência''' - Campo de data, onde definirá o final da vigência da tabela;

* Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar a data final inferior a data atual;
* Caso uma tabela de preço esteja com a data final de vigência vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;
* Os campos de datas não serão obrigatórios. Quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;
* Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo, sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utilizar os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.
</dd>
[[Arquivo:Tabelapreco.jpg|500px]]

[[Arquivo:Tabelapreco2.jpg|500px]]

=== Declaração de variáveis ===

Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:

* O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e está limitada ao máximo de 8 caracteres, sendo todos minúsculos obrigatoriamente, seguindo o padrão <code>[a-z0-9]</code>.
* A variável deve estar associada a um produto ou uma tabela de preço
* Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.
* Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.
* As variáveis fs, fmm e fmx, especificamente, não poderão ser utilizadas, por tratarem-se de variáveis protegidas em uso no sistema.
[[Arquivo:Tela2.jpg|500px]]

==== Campos de cadastro ====

* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Chave''' - Campo de texto de 8 caracteres;
* '''Produto / Tabela''' - A seleção de uma produto ou de uma tabela, dados previamente alimentados;
* '''Valor''' - Campo numérico(18:6);

A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

=== Definição da formula de preço ===

* Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.
* Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.
* Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.
* Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

[[Arquivo:Tela3.jpg|500px]]

=== Processar tabela ===

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

Sempre que uma das variáveis for alterada, para que ocorra atualização de valores da faixa de preço baseados na alteração, deve ser feito um reprocessamento baseado nos valores atualizados das variáveis.

Na aba de reprocessamento, sempre que houver uma solicitação de processamento devemos salvar as informações para eventual consulta. Ao entrar no detalhe podemos acompanhar o status do processamento.

[[Arquivo:Tela4.jpg|500px]]

== Cenários ==

===DICIONÁRIO DE DADOS ===

Considere tabela abaixo com as seguintes tabelas cadastradas e suas respectivas vigências:
{|class = "wikitable"
! TABELA
! DESCRIÇÃO
! INICIO DA VIGÊNCIA
! FINAL DA VIGÊNCIA
|-
| '''01''' || TABELA SP || 01/05/2020 || 01/01/2022
|-
| '''02''' || TABELA RJ || 01/05/2020 || 01/01/2022
|-
| '''03''' ||TABELA RS ||01/05/2020 || 01/01/2022
|-
| '''04''' || TABELA SP - CARREFU || 01/05/2020 || 01/01/2022
|-
| '''05''' || TABELA BA || 01/05/2020 || 01/01/2022
|-
| '''06''' || TABELA ES || 01/05/2020 || 01/01/2022
|-
| '''07''' || TABELA SP - CAPITAL ||01/05/2020 || 01/01/2022
|}

Selecionada a tabela desejada, o próximo passo é fazer a declaração das variáveis.
{|class = "wikitable"
! CHAVE
! DESCRIÇÃO DA VARIÁVEL
! TABELA / PRODUTO
! VALOR
|-
| '''pp''' || Preço de Partida || Tabela - 01 || R$ 106,00
|-
| '''fc''' || Cor / Tamanho || Produto - 001 || 1,5
|-
| '''ce''' ||Custo de Embalagem || Tabela - 01 || R$ 12,20
|-
| '''fr''' || Frete || Tabela - 01 || - 5
|-
| '''pr''' || Promotor || Tabela - 01 || 1,02
|-
| '''ou''' || Fator Quebra || Tabela - 01 || 3,5
|-
| '''cf''' || Contrato de Fidelidade || Tabela - 01 || 1,02
|}

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001' por um período de 6 meses.

No portal GeoSales, na tela de variáveis, serão utilizadas as seguintes informações:

'''Enumeração das variáveis''' 

Pelo exposto, temos que 7 variáveis foram declaradas. As fórmulas que devemos gerar (Fórmula de valor mínimo, fórmula de valor Sugerido e Fórmula de Valor Máximo) serão derivadas destas variáveis que apontamos.

Supondo que, para a fórmula de valor Sugerido, iremos adotar a seguinte fórmula:

<code>P = PpFc/*Qu*Cf*</code>

Com esta composição, o valor Sugerido do produto será '''''R$ 252,28'''''.

Supondo que, para a fórmula de valor Mínimo, iremos adotar a seguinte fórmula:

<code>P = PpFc/</code>

Com esta composição, o valor mínimo do produto será '''''R$ 70,66'''''.

Supondo que, para a fórmula de valor Máximo, iremos adotar a seguinte fórmula:

<code>P = PpFc/Ce+Fr+Pr*Qu*Cf*</code>

Com esta composição, o valor máximo do produto será ''''' R$ 283,54'''''.


As variáveis estão relacionadas matematicamente de acordo com a notação: 

<code>P = PpFc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+</code>

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar, ou seja, o batch irá apresentar os dados apenas referentes às variáveis relacionadas (via GSOload). A medida visa evitar um carregamento excessivamente pesado de dados para determinada função. 

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

'''[RN7] - ''' A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T20:11:35Z

Leo2s: /* DICIONÁRIO DE DADOS */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio usuário consiga fazer esta composição.

O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''' (a mesma lógica de cálculo das calculadoras HP 12 C), ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.

== Implementação ==

O processo terá como bases os seguintes passos: 

# Criação de Tabela;

# Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela);
# Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos;
# Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços.

=== Cadastro tabela de preço ===
Para criação da tabela de preço, será criada uma tela onde o usuário irá fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado, mas, apenas desativa-los.

Ao entrar na tela o sistema deve apresentar campos de filtros, os quais, o usuário poderá localizar um cadastro já inserido ou realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela, terá o acesso para fazer um novo cadastro. na qual, o usuário vai preencher os seguintes campos.

==== Campos de cadastro ====
* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Data inicial vigência''' - Campo de data, onde definirá o inicio da vigência da tabela;
* '''Data final vigência''' - Campo de data, onde definirá o final da vigência da tabela;

* Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar a data final inferior a data atual;
* Caso uma tabela de preço esteja com a data final de vigência vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;
* Os campos de datas não serão obrigatórios. Quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;
* Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo, sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utilizar os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.
</dd>
[[Arquivo:Tabelapreco.jpg|500px]]

[[Arquivo:Tabelapreco2.jpg|500px]]

=== Declaração de variáveis ===

Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:

* O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e está limitada ao máximo de 8 caracteres, sendo todos minúsculos obrigatoriamente, seguindo o padrão <code>[a-z0-9]</code>.
* A variável deve estar associada a um produto ou uma tabela de preço
* Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.
* Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.
* As variáveis fs, fmm e fmx, especificamente, não poderão ser utilizadas, por tratarem-se de variáveis protegidas em uso no sistema.
[[Arquivo:Tela2.jpg|500px]]

==== Campos de cadastro ====

* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Chave''' - Campo de texto de 8 caracteres;
* '''Produto / Tabela''' - A seleção de uma produto ou de uma tabela, dados previamente alimentados;
* '''Valor''' - Campo numérico(18:6);

A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

=== Definição da formula de preço ===

* Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.
* Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.
* Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.
* Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.
[[Arquivo:Tela3.jpg|500px]]

=== Processar tabela ===

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

Sempre que uma das variáveis for alterada, para que ocorra atualização de valores da faixa de preço baseados na alteração, deve ser feito um reprocessamento baseado nos valores atualizados das variáveis.

Na aba de reprocessamento, sempre que houver uma solicitação de processamento devemos salvar as informações para eventual consulta. Ao entrar no detalhe podemos acompanhar o status do processamento.

[[Arquivo:Tela4.jpg|500px]]

== Cenários ==

===DICIONÁRIO DE DADOS ===

Considere tabela abaixo com as seguintes tabelas cadastradas e suas respectivas vigências:
{|class = "wikitable"
! TABELA
! DESCRIÇÃO
! INICIO DA VIGÊNCIA
! FINAL DA VIGÊNCIA
|-
| '''01''' || TABELA SP || 01/05/2020 || 01/01/2022
|-
| '''02''' || TABELA RJ || 01/05/2020 || 01/01/2022
|-
| '''03''' ||TABELA RS ||01/05/2020 || 01/01/2022
|-
| '''04''' || TABELA SP - CARREFU || 01/05/2020 || 01/01/2022
|-
| '''05''' || TABELA BA || 01/05/2020 || 01/01/2022
|-
| '''06''' || TABELA ES || 01/05/2020 || 01/01/2022
|-
| '''07''' || TABELA SP - CAPITAL ||01/05/2020 || 01/01/2022
|}

Selecionada a tabela desejada, o próximo passo é fazer a declaração das variáveis.
{|class = "wikitable"
! CHAVE
! DESCRIÇÃO DA VARIÁVEL
! TABELA / PRODUTO
! VALOR
|-
| '''pp''' || Preço de Partida || Tabela - 01 || R$ 106,00
|-
| '''fc''' || Cor / Tamanho || Produto - 001 || 1,5
|-
| '''ce''' ||Custo de Embalagem || Tabela - 01 || R$ 12,20
|-
| '''fr''' || Frete || Tabela - 01 || - 5
|-
| '''pr''' || Promotor || Tabela - 01 || 1,02
|-
| '''ou''' || Fator Quebra || Tabela - 01 || 3,5
|-
| '''cf''' || Contrato de Fidelidade || Tabela - 01 || 1,02
|}

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001' por um período de 6 meses.

No portal GeoSales, na tela de variáveis, serão utilizadas as seguintes informações:

'''Enumeração das variáveis''' 

Pelo exposto, temos que 7 variáveis foram declaradas. As fórmulas que devemos gerar (Fórmula de valor mínimo, fórmula de valor Sugerido e Fórmula de Valor Máximo) serão derivadas destas variáveis que apontamos.

Supondo que, para a fórmula de valor Sugerido, iremos adotar a seguinte fórmula:

<code>P = PpFc/*Qu*Cf*</code>

Com esta composição, o valor Sugerido do produto será '''''R$ 252,28'''''.

Supondo que, para a fórmula de valor Mínimo, iremos adotar a seguinte fórmula:

<code>P = PpFc/</code>

Com esta composição, o valor mínimo do produto será '''''R$ 70,66'''''.

Supondo que, para a fórmula de valor Máximo, iremos adotar a seguinte fórmula:

<code>P = PpFc/Ce+Fr+Pr*Qu*Cf*</code>

Com esta composição, o valor máximo do produto será ''''' R$ 283,54'''''.


As variáveis estão relacionadas matematicamente de acordo com a notação: 

<code>P = PpFc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+</code>

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar, ou seja, o batch irá apresentar os dados apenas referentes às variáveis relacionadas (via GSOload). A medida visa evitar um carregamento excessivamente pesado de dados para determinada função. 

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

'''[RN7] - ''' A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T20:11:17Z

Leo2s: /* DICIONÁRIO DE DADOS */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio usuário consiga fazer esta composição.

O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''' (a mesma lógica de cálculo das calculadoras HP 12 C), ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.

== Implementação ==

O processo terá como bases os seguintes passos: 

# Criação de Tabela;

# Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela);
# Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos;
# Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços.

=== Cadastro tabela de preço ===
Para criação da tabela de preço, será criada uma tela onde o usuário irá fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado, mas, apenas desativa-los.

Ao entrar na tela o sistema deve apresentar campos de filtros, os quais, o usuário poderá localizar um cadastro já inserido ou realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela, terá o acesso para fazer um novo cadastro. na qual, o usuário vai preencher os seguintes campos.

==== Campos de cadastro ====
* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Data inicial vigência''' - Campo de data, onde definirá o inicio da vigência da tabela;
* '''Data final vigência''' - Campo de data, onde definirá o final da vigência da tabela;

* Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar a data final inferior a data atual;
* Caso uma tabela de preço esteja com a data final de vigência vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;
* Os campos de datas não serão obrigatórios. Quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;
* Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo, sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utilizar os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.
</dd>
[[Arquivo:Tabelapreco.jpg|500px]]

[[Arquivo:Tabelapreco2.jpg|500px]]

=== Declaração de variáveis ===

Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:

* O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e está limitada ao máximo de 8 caracteres, sendo todos minúsculos obrigatoriamente, seguindo o padrão <code>[a-z0-9]</code>.
* A variável deve estar associada a um produto ou uma tabela de preço
* Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.
* Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.
* As variáveis fs, fmm e fmx, especificamente, não poderão ser utilizadas, por tratarem-se de variáveis protegidas em uso no sistema.
[[Arquivo:Tela2.jpg|500px]]

==== Campos de cadastro ====

* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Chave''' - Campo de texto de 8 caracteres;
* '''Produto / Tabela''' - A seleção de uma produto ou de uma tabela, dados previamente alimentados;
* '''Valor''' - Campo numérico(18:6);

A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

=== Definição da formula de preço ===

* Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.
* Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.
* Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.
* Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.
[[Arquivo:Tela3.jpg|500px]]

=== Processar tabela ===

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

Sempre que uma das variáveis for alterada, para que ocorra atualização de valores da faixa de preço baseados na alteração, deve ser feito um reprocessamento baseado nos valores atualizados das variáveis.

Na aba de reprocessamento, sempre que houver uma solicitação de processamento devemos salvar as informações para eventual consulta. Ao entrar no detalhe podemos acompanhar o status do processamento.

[[Arquivo:Tela4.jpg|500px]]

== Cenários ==

===DICIONÁRIO DE DADOS ===

Considere tabela abaixo com as seguintes tabelas cadastradas e suas respectivas vigências:
{|class = "wikitable"
! TABELA
! DESCRIÇÃO
! INICIO DA VIGÊNCIA
! FINAL DA VIGÊNCIA
|-
| '''01''' || TABELA SP || 01/05/2020 || 01/01/2022
|-
| '''02''' || TABELA RJ || 01/05/2020 || 01/01/2022
|-
| '''03''' ||TABELA RS ||01/05/2020 || 01/01/2022
|-
| '''04''' || TABELA SP - CARREFU || 01/05/2020 || 01/01/2022
|-
| '''05''' || TABELA BA || 01/05/2020 || 01/01/2022
|-
| '''06''' || TABELA ES || 01/05/2020 || 01/01/2022
|-
| '''07''' || TABELA SP - CAPITAL ||01/05/2020 || 01/01/2022
|}

Selecionada a tabela desejada, o próximo passo é fazer a declaração das variáveis.
{|class = "wikitable"
! CHAVE
! DESCRIÇÃO DA VARIÁVEL
! TABELA / PRODUTO
! VALOR
|-
| '''pp''' || Preço de Partida || Tabela - 01 || R$ 106,00
|-
| '''fc''' || Cor / Tamanho || Produto - 001 || 1,5
|-
| '''ce''' ||Custo de Embalagem || Tabela - 01 || R$ 12,20
|-
| '''fr''' || Frete || Tabela - 01 || - 5
|-
| ''pr''' || Promotor || Tabela - 01 || 1,02
|-
| '''ou''' || Fator Quebra || Tabela - 01 || 3,5
|-
| '''cf''' || Contrato de Fidelidade || Tabela - 01 || 1,02
|}

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001' por um período de 6 meses.

No portal GeoSales, na tela de variáveis, serão utilizadas as seguintes informações:

'''Enumeração das variáveis''' 

Pelo exposto, temos que 7 variáveis foram declaradas. As fórmulas que devemos gerar (Fórmula de valor mínimo, fórmula de valor Sugerido e Fórmula de Valor Máximo) serão derivadas destas variáveis que apontamos.

Supondo que, para a fórmula de valor Sugerido, iremos adotar a seguinte fórmula:

<code>P = PpFc/*Qu*Cf*</code>

Com esta composição, o valor Sugerido do produto será '''''R$ 252,28'''''.

Supondo que, para a fórmula de valor Mínimo, iremos adotar a seguinte fórmula:

<code>P = PpFc/</code>

Com esta composição, o valor mínimo do produto será '''''R$ 70,66'''''.

Supondo que, para a fórmula de valor Máximo, iremos adotar a seguinte fórmula:

<code>P = PpFc/Ce+Fr+Pr*Qu*Cf*</code>

Com esta composição, o valor máximo do produto será ''''' R$ 283,54'''''.


As variáveis estão relacionadas matematicamente de acordo com a notação: 

<code>P = PpFc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+</code>

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar, ou seja, o batch irá apresentar os dados apenas referentes às variáveis relacionadas (via GSOload). A medida visa evitar um carregamento excessivamente pesado de dados para determinada função. 

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

'''[RN7] - ''' A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T19:59:41Z

Leo2s: /* DICIONÁRIO DE DADOS */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio usuário consiga fazer esta composição.

O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.

== Implementação ==

O processo terá como bases os seguintes passos: 

# Criação de Tabela;

# Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela);
# Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos;
# Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços.

=== Cadastro tabela de preço ===
Para criação da tabela de preço, será criada uma tela onde o usuário irá fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado, mas, apenas desativa-los.

Ao entrar na tela o sistema deve apresentar campos de filtros, os quais, o usuário poderá localizar um cadastro já inserido ou realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela, terá o acesso para fazer um novo cadastro. na qual, o usuário vai preencher os seguintes campos.

==== Campos de cadastro ====
* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Data inicial vigência''' - Campo de data, onde definirá o inicio da vigência da tabela;
* '''Data final vigência''' - Campo de data, onde definirá o final da vigência da tabela;

* Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar a data final inferior a data atual;
* Caso uma tabela de preço esteja com a data final de vigência vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;
* Os campos de datas não serão obrigatórios. Quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;
* Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo, sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utilizar os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.
</dd>
[[Arquivo:Tabelapreco.jpg|500px]]

[[Arquivo:Tabelapreco2.jpg|500px]]

=== Declaração de variáveis ===

Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:

* O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e está limitada ao máximo de 8 caracteres, sendo todos minúsculos obrigatoriamente, seguindo o padrão [a-z0-9].
* A variável deve estar associada a um produto ou uma tabela de preço
* Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.
* Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.
* As variáveis fs, fmm e fmx, especificamente, não poderão ser utilizadas, por tratarem-se de variáveis protegidas em uso no sistema.

==== Campos de cadastro ====

* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Chave''' - Campo de texto de 8 caracteres;
* '''Produto / Tabela''' - A seleção de uma produto ou de uma tabela, dados previamente alimentados;
* '''Valor''' - Campo numérico(18:6);

A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

=== Definição da formula de preço ===

* Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.
* Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.
* Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.
* Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

=== Processar tabela ===

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

Sempre que uma das variáveis for alterada, para que ocorra atualização de valores da faixa de preço baseados na alteração, deve ser feito um reprocessamento baseado nos valores atualizados das variáveis.

Na aba de reprocessamento, sempre que houver uma solicitação de processamento devemos salvar as informações para eventual consulta. Ao entrar no detalhe podemos acompanhar o status do processamento.

== Cenários ==

===DICIONÁRIO DE DADOS ===

Considere tabela abaixo com as seguintes tabelas cadastradas e suas respectivas vigências:
{|class = "wikitable"
! TABELA
! DESCRIÇÃO
! INICIO DA VIGÊNCIA
! FINAL DA VIGÊNCIA
|-
| '''01''' || TABELA SP || 01/05/2020 || 01/01/2022
|-
| '''02''' || TABELA RJ || 01/05/2020 || 01/01/2022
|-
| '''03''' ||TABELA RS ||01/05/2020 || 01/01/2022
|-
| '''04''' || TABELA SP - CARREFU || 01/05/2020 || 01/01/2022
|-
| '''05''' || TABELA BA || 01/05/2020 || 01/01/2022
|-
| '''06''' || TABELA ES || 01/05/2020 || 01/01/2022
|-
| '''07''' || TABELA SP - CAPITAL ||01/05/2020 || 01/01/2022
|}

Selecionada a tabela desejada, o próximo passo é fazer a declaração das variáveis.
{|class = "wikitable"
! CHAVE
! DESCRIÇÃO DA VARIÁVEL
! TABELA / PRODUTO
! VALOR
|-
| '''Pp''' || Preço de Partida || Tabela - 01 || R$ 106,00
|-
| '''Fc''' || Fator de Conversão || Tabela - 01 || 1,5
|-
| '''Ce''' ||Custo de Embalagem || Tabela - 01 || R$ 12,20
|-
| '''Fr''' || Frete || Tabela - 01 || - 5
|-
| '''Pr''' || Promotor || Tabela - 01 || 1,02
|-
| '''Qu''' || Fator Quebra || Tabela - 01 || 3,5
|-
| '''Cf''' || Contrato de Fidelidade || Tabela - 01 || 1,02
|}

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001' por um período de 6 meses.

No portal GeoSales, na tela de variáveis, serão utilizadas as seguintes informações:

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}

Pelo exposto, temos que 7 variáveis foram declaradas. As fórmulas que devemos gerar (Fórmula de valor mínimo, fórmula de valor Sugerido e Fórmula de Valor Máximo) serão derivadas destas variáveis que apontamos.

Supondo que, para a fórmula de valor Sugerido, iremos adotar a seguinte fórmula:

<code>P = PpFc/*Qu*Cf*</code>

Com esta composição, o valor mínimo do produto será

Supondo que, para a fórmula de valor Mínimo, iremos adotar a seguinte fórmula:

<code>P = PpFc/</code>

Supondo que, para a fórmula de valor Máximo, iremos adotar a seguinte fórmula:

<code>P = PpFc/Ce+Fr+Pr*Qu*Cf*</code>


As variáveis estão relacionadas matematicamente de acordo com a notação: 

<code>P = PpFc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+</code>

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar, ou seja, o batch irá apresentar os dados apenas referentes às variáveis relacionadas (via GSOload). A medida visa evitar um carregamento excessivamente pesado de dados para determinada função. 

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

'''[RN7] - ''' A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T19:59:29Z

Leo2s: /* DICIONÁRIO DE DADOS */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio usuário consiga fazer esta composição.

O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.

== Implementação ==

O processo terá como bases os seguintes passos: 

# Criação de Tabela;

# Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela);
# Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos;
# Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços.

=== Cadastro tabela de preço ===
Para criação da tabela de preço, será criada uma tela onde o usuário irá fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado, mas, apenas desativa-los.

Ao entrar na tela o sistema deve apresentar campos de filtros, os quais, o usuário poderá localizar um cadastro já inserido ou realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela, terá o acesso para fazer um novo cadastro. na qual, o usuário vai preencher os seguintes campos.

==== Campos de cadastro ====
* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Data inicial vigência''' - Campo de data, onde definirá o inicio da vigência da tabela;
* '''Data final vigência''' - Campo de data, onde definirá o final da vigência da tabela;

* Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar a data final inferior a data atual;
* Caso uma tabela de preço esteja com a data final de vigência vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;
* Os campos de datas não serão obrigatórios. Quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;
* Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo, sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utilizar os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.
</dd>
[[Arquivo:Tabelapreco.jpg|500px]]

[[Arquivo:Tabelapreco2.jpg|500px]]

=== Declaração de variáveis ===

Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:

* O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e está limitada ao máximo de 8 caracteres, sendo todos minúsculos obrigatoriamente, seguindo o padrão [a-z0-9].
* A variável deve estar associada a um produto ou uma tabela de preço
* Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.
* Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.
* As variáveis fs, fmm e fmx, especificamente, não poderão ser utilizadas, por tratarem-se de variáveis protegidas em uso no sistema.

==== Campos de cadastro ====

* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Chave''' - Campo de texto de 8 caracteres;
* '''Produto / Tabela''' - A seleção de uma produto ou de uma tabela, dados previamente alimentados;
* '''Valor''' - Campo numérico(18:6);

A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

=== Definição da formula de preço ===

* Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.
* Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.
* Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.
* Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

=== Processar tabela ===

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

Sempre que uma das variáveis for alterada, para que ocorra atualização de valores da faixa de preço baseados na alteração, deve ser feito um reprocessamento baseado nos valores atualizados das variáveis.

Na aba de reprocessamento, sempre que houver uma solicitação de processamento devemos salvar as informações para eventual consulta. Ao entrar no detalhe podemos acompanhar o status do processamento.

== Cenários ==

===DICIONÁRIO DE DADOS ===

Considere tabela abaixo com as seguintes tabelas cadastradas e suas respectivas vigências:
{|class = "wikitable"
! TABELA
! DESCRIÇÃO
! INICIO DA VIGÊNCIA
! FINAL DA VIGÊNCIA
|-
| '''01''' || TABELA SP || 01/05/2020 || 01/01/2022
|-
| '''02''' || TABELA RJ || 01/05/2020 || 01/01/2022
|-
| '''03''' ||TABELA RS ||01/05/2020 || 01/01/2022
|-
| '''04''' || TABELA SP - CARREFU || 01/05/2020 || 01/01/2022
|-
| '''05''' || TABELA BA || 01/05/2020 || 01/01/2022
|-
| '''06''' || TABELA ES || 01/05/2020 || 01/01/2022
|-
| '''07''' || TABELA SP - CAPITAL ||01/05/2020 || 01/01/2022
|}

Selecionada a tabela desejada, o próximo passo é fazer a declaração das variáveis.

{|class = "wikitable"
! CHAVE
! DESCRIÇÃO DA VARIÁVEL
! TABELA / PRODUTO
! VALOR
|-
| '''Pp''' || Preço de Partida || Tabela - 01 || R$ 106,00
|-
| '''Fc''' || Fator de Conversão || Tabela - 01 || 1,5
|-
| '''Ce''' ||Custo de Embalagem || Tabela - 01 || R$ 12,20
|-
| '''Fr''' || Frete || Tabela - 01 || - 5
|-
| '''Pr''' || Promotor || Tabela - 01 || 1,02
|-
| '''Qu''' || Fator Quebra || Tabela - 01 || 3,5
|-
| '''Cf''' || Contrato de Fidelidade || Tabela - 01 || 1,02
|}

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001' por um período de 6 meses.

No portal GeoSales, na tela de variáveis, serão utilizadas as seguintes informações:

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}

Pelo exposto, temos que 7 variáveis foram declaradas. As fórmulas que devemos gerar (Fórmula de valor mínimo, fórmula de valor Sugerido e Fórmula de Valor Máximo) serão derivadas destas variáveis que apontamos.

Supondo que, para a fórmula de valor Sugerido, iremos adotar a seguinte fórmula:

<code>P = PpFc/*Qu*Cf*</code>

Com esta composição, o valor mínimo do produto será

Supondo que, para a fórmula de valor Mínimo, iremos adotar a seguinte fórmula:

<code>P = PpFc/</code>

Supondo que, para a fórmula de valor Máximo, iremos adotar a seguinte fórmula:

<code>P = PpFc/Ce+Fr+Pr*Qu*Cf*</code>


As variáveis estão relacionadas matematicamente de acordo com a notação: 

<code>P = PpFc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+</code>

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar, ou seja, o batch irá apresentar os dados apenas referentes às variáveis relacionadas (via GSOload). A medida visa evitar um carregamento excessivamente pesado de dados para determinada função. 

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

'''[RN7] - ''' A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T19:58:05Z

Leo2s: /* Definição da formula de preço */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio usuário consiga fazer esta composição.

O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.

== Implementação ==

O processo terá como bases os seguintes passos: 

# Criação de Tabela;

# Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela);
# Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos;
# Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços.

=== Cadastro tabela de preço ===
Para criação da tabela de preço, será criada uma tela onde o usuário irá fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado, mas, apenas desativa-los.

Ao entrar na tela o sistema deve apresentar campos de filtros, os quais, o usuário poderá localizar um cadastro já inserido ou realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela, terá o acesso para fazer um novo cadastro. na qual, o usuário vai preencher os seguintes campos.

==== Campos de cadastro ====
* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Data inicial vigência''' - Campo de data, onde definirá o inicio da vigência da tabela;
* '''Data final vigência''' - Campo de data, onde definirá o final da vigência da tabela;

* Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar a data final inferior a data atual;
* Caso uma tabela de preço esteja com a data final de vigência vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;
* Os campos de datas não serão obrigatórios. Quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;
* Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo, sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utilizar os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.
</dd>
[[Arquivo:Tabelapreco.jpg|500px]]

[[Arquivo:Tabelapreco2.jpg|500px]]

=== Declaração de variáveis ===

Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:

* O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e está limitada ao máximo de 8 caracteres, sendo todos minúsculos obrigatoriamente, seguindo o padrão [a-z0-9].
* A variável deve estar associada a um produto ou uma tabela de preço
* Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.
* Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.
* As variáveis fs, fmm e fmx, especificamente, não poderão ser utilizadas, por tratarem-se de variáveis protegidas em uso no sistema.

==== Campos de cadastro ====

* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Chave''' - Campo de texto de 8 caracteres;
* '''Produto / Tabela''' - A seleção de uma produto ou de uma tabela, dados previamente alimentados;
* '''Valor''' - Campo numérico(18:6);

A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

=== Definição da formula de preço ===

* Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.
* Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.
* Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.
* Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

=== Processar tabela ===

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

Sempre que uma das variáveis for alterada, para que ocorra atualização de valores da faixa de preço baseados na alteração, deve ser feito um reprocessamento baseado nos valores atualizados das variáveis.

Na aba de reprocessamento, sempre que houver uma solicitação de processamento devemos salvar as informações para eventual consulta. Ao entrar no detalhe podemos acompanhar o status do processamento.

== Cenários ==

===DICIONÁRIO DE DADOS ===

Considere tabela abaixo com as seguintes tabelas cadastradas e suas respectivas vigências:

{|class = "wikitable"
! TABELA
! DESCRIÇÃO
! INICIO DA VIGÊNCIA
! FINAL DA VIGÊNCIA
|-
| '''01''' || TABELA SP || 01/05/2020 || 01/01/2022
|-
| '''02''' || TABELA RJ || 01/05/2020 || 01/01/2022
|-
| '''03''' ||TABELA RS ||01/05/2020 || 01/01/2022
|-
| '''04''' || TABELA SP - CARREFU || 01/05/2020 || 01/01/2022
|-
| '''05''' || TABELA BA || 01/05/2020 || 01/01/2022
|-
| '''06''' || TABELA ES || 01/05/2020 || 01/01/2022
|-
| '''07''' || TABELA SP - CAPITAL ||01/05/2020 || 01/01/2022
|}

Selecionada a tabela desejada, o próximo passo é fazer a declaração das variáveis.

{|class = "wikitable"
! CHAVE
! DESCRIÇÃO DA VARIÁVEL
! TABELA / PRODUTO
! VALOR
|-
| '''Pp''' || Preço de Partida || Tabela - 01 || R$ 106,00
|-
| '''Fc''' || Fator de Conversão || Tabela - 01 || 1,5
|-
| '''Ce''' ||Custo de Embalagem || Tabela - 01 || R$ 12,20
|-
| '''Fr''' || Frete || Tabela - 01 || - 5
|-
| '''Pr''' || Promotor || Tabela - 01 || 1,02
|-
| '''Qu''' || Fator Quebra || Tabela - 01 || 3,5
|-
| '''Cf''' || Contrato de Fidelidade || Tabela - 01 || 1,02
|}

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001' por um período de 6 meses.

No portal GeoSales, na tela de variáveis, serão utilizadas as seguintes informações:

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}

Pelo exposto, temos que 7 variáveis foram declaradas. As fórmulas que devemos gerar (Fórmula de valor mínimo, fórmula de valor Sugerido e Fórmula de Valor Máximo) serão derivadas destas variáveis que apontamos.

Supondo que, para a fórmula de valor Sugerido, iremos adotar a seguinte fórmula:

<code>P = PpFc/*Qu*Cf*</code>

Supondo que, para a fórmula de valor Mínimo, iremos adotar a seguinte fórmula:

<code>P = PpFc/</code>

Supondo que, para a fórmula de valor Máximo, iremos adotar a seguinte fórmula:

<code>P = PpFc/Ce+Fr+Pr*Qu*Cf*</code>


As variáveis estão relacionadas matematicamente de acordo com a notação: 

<code>P = PpFc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+</code>

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar, ou seja, o batch irá apresentar os dados apenas referentes às variáveis relacionadas (via GSOload). A medida visa evitar um carregamento excessivamente pesado de dados para determinada função. 

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

'''[RN7] - ''' A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T19:37:31Z

Leo2s: /* Declaração de variáveis */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio cliente consiga fazer esta composição.

O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.

== Implementação ==

O processo terá como bases os seguintes passos: 

# Criação de Tabela;

# Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela);
# Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos;
# Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços.

=== Cadastro tabela de preço ===
Para criação da tabela de preço, será criada uma tela onde o usuário irá fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado, mas, apenas desativa-los.

Ao entrar na tela o sistema deve apresentar campos de filtros, os quais, o usuário poderá localizar um cadastro já inserido ou realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela, terá o acesso para fazer um novo cadastro. na qual, o usuário vai preencher os seguintes campos.

==== Campos de cadastro ====
* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Data inicial vigência''' - Campo de data, onde definirá o inicio da vigência da tabela;
* '''Data final vigência''' - Campo de data, onde definirá o final da vigência da tabela;

* Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar a data final inferior a data atual;
* Caso uma tabela de preço esteja com a data final de vigência vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;
* Os campos de datas não serão obrigatórios. Quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;
* Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo, sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utilizar os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.
</dd>
[[Arquivo:Tabelapreco.jpg|500px]]

[[Arquivo:Tabelapreco2.jpg|500px]]

=== Declaração de variáveis ===

Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:

* O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e está limitada ao máximo de 8 caracteres, sendo todos minúsculos obrigatoriamente.
* A variável deve estar associada a um produto ou uma tabela de preço
* Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.
* Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.

==== Campos de cadastro ====

* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Chave''' - Campo de texto de 8 caracteres;
* '''Produto / Tabela''' - A seleção de uma produto ou de uma tabela, dados previamente alimentados;
* '''Valor''' - Campo numérico(18:6);

A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

=== Definição da formula de preço ===

* Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.
* Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.
* Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.

* Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

=== Processar tabela ===

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

== Cenários ==

===DICIONÁRIO DE DADOS ===

{|class = "wikitable"
! TABELA
! DESCRIÇÃO
! INICIO DA VIGÊNCIA
! FINAL DA VIGÊNCIA
|-
| '''01''' || TABELA SP || 01/05/2020 || 01/01/2022
|-
| '''02''' || TABELA RJ || 01/05/2020 || 01/01/2022
|-
| '''03''' ||TABELA RS ||01/05/2020 || 01/01/2022
|-
| '''04''' || TABELA SP - CARREFU || 01/05/2020 || 01/01/2022
|-
| '''05''' || TABELA BA || 01/05/2020 || 01/01/2022
|-
| '''06''' || TABELA ES || 01/05/2020 || 01/01/2022
|-
| '''07''' || TABELA SP - CAPITAL ||01/05/2020 || 01/01/2022
|}

{|class = "wikitable"
! CHAVE
! DESCRIÇÃO DA VARIÁVEL
! TABELA / PRODUTO
! VALOR
|-
| '''Pp''' || Preço de Partida || Tabela - 01 || R$ 106,00
|-
| '''Fc''' || Fator de Conversão || Tabela - 01 || 1,5
|-
| '''Ce''' ||Custo de Embalagem || Tabela - 01 || R$ 12,20
|-
| '''Fr''' || Frete || Tabela - 01 || - 5
|-
| '''Pr''' || Promotor || Tabela - 01 || 1,02
|-
| '''Qu''' || Fator Quebra || Tabela - 01 || 3,5
|-
| '''Cf''' || Contrato de Fidelidade || Tabela - 01 || 1,02
|}

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001' por um período de 6 meses.

No portal GeoSales, na tela de variáveis, serão utilizadas as seguintes informações:

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}

Pelo exposto, temos que 7 variáveis foram declaradas. As fórmulas que devemos gerar (Fórmula de valor mínimo, fórmula de valor Sugerido e Fórmula de Valor Máximo) serão derivadas destas variáveis que apontamos.

Supondo que, para a fórmula de valor Sugerido, iremos adotar a seguinte fórmula:

<code>P = PpFc/Ce+Fr+Pr*Qu*Cf*</code>

Supondo que, para a fórmula de valor Mínimo, iremos adotar a seguinte fórmula:

<code>P = PpFc/Ce+Fr+Pr*Qu*Cf*</code>

Supondo que, para a fórmula de valor Máximo, iremos adotar a seguinte fórmula:

<code>P = PpFc/Ce+Fr+Pr*Qu*Cf*</code>


As variáveis estão relacionadas matematicamente de acordo com a notação: 

<code>P = PpFc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+</code>

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar, ou seja, o batch irá apresentar os dados apenas referentes às variáveis relacionadas (via GSOload). A medida visa evitar um carregamento excessivamente pesado de dados para determinada função. 

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

'''[RN7] - ''' A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T19:30:37Z

Leo2s: /* DICIONÁRIO DE DADOS */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio cliente consiga fazer esta composição.

O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.

== Implementação ==

O processo terá como bases os seguintes passos: 

# Criação de Tabela;

# Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela);
# Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos;
# Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços.

=== Cadastro tabela de preço ===
Para criação da tabela de preço, será criada uma tela onde o usuário irá fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado, mas, apenas desativa-los.

Ao entrar na tela o sistema deve apresentar campos de filtros, os quais, o usuário poderá localizar um cadastro já inserido ou realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela, terá o acesso para fazer um novo cadastro. na qual, o usuário vai preencher os seguintes campos.

==== Campos de cadastro ====
* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Data inicial vigência''' - Campo de data, onde definirá o inicio da vigência da tabela;
* '''Data final vigência''' - Campo de data, onde definirá o final da vigência da tabela;

* Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar a data final inferior a data atual;
* Caso uma tabela de preço esteja com a data final de vigência vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;
* Os campos de datas não serão obrigatórios. Quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;
* Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo, sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utilizar os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.
</dd>
[[Arquivo:Tabelapreco.jpg|500px]]

[[Arquivo:Tabelapreco2.jpg|500px]]

=== Declaração de variáveis ===

Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:

* O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e nao ser mais que 8 caracteres
* A variável deve estar associada a um produto ou uma tabela de preço
* Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.
* Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.

==== Campos de cadastro ====

* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Chave''' - Campo de texto de 8 caracteres;
* '''Produto / Tabela''' - A seleção de uma produto ou de uma tabela, dados previamente alimentados;
* '''Valor''' - Campo numérico(18:6);

A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

=== Definição da formula de preço ===

* Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.
* Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.
* Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.

* Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

=== Processar tabela ===

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

== Cenários ==

===DICIONÁRIO DE DADOS ===

{|class = "wikitable"
! TABELA
! DESCRIÇÃO
! INICIO DA VIGÊNCIA
! FINAL DA VIGÊNCIA
|-
| '''01''' || TABELA SP || 01/05/2020 || 01/01/2022
|-
| '''02''' || TABELA RJ || 01/05/2020 || 01/01/2022
|-
| '''03''' ||TABELA RS ||01/05/2020 || 01/01/2022
|-
| '''04''' || TABELA SP - CARREFU || 01/05/2020 || 01/01/2022
|-
| '''05''' || TABELA BA || 01/05/2020 || 01/01/2022
|-
| '''06''' || TABELA ES || 01/05/2020 || 01/01/2022
|-
| '''07''' || TABELA SP - CAPITAL ||01/05/2020 || 01/01/2022
|}

{|class = "wikitable"
! CHAVE
! DESCRIÇÃO DA VARIÁVEL
! TABELA / PRODUTO
! VALOR
|-
| '''Pp''' || Preço de Partida || Tabela - 01 || R$ 106,00
|-
| '''Fc''' || Fator de Conversão || Tabela - 01 || 1,5
|-
| '''Ce''' ||Custo de Embalagem || Tabela - 01 || R$ 12,20
|-
| '''Fr''' || Frete || Tabela - 01 || - 5
|-
| '''Pr''' || Promotor || Tabela - 01 || 1,02
|-
| '''Qu''' || Fator Quebra || Tabela - 01 || 3,5
|-
| '''Cf''' || Contrato de Fidelidade || Tabela - 01 || 1,02
|}

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001' por um período de 6 meses.

No portal GeoSales, na tela de variáveis, serão utilizadas as seguintes informações:

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}

Pelo exposto, temos que 7 variáveis foram declaradas. As fórmulas que devemos gerar (Fórmula de valor mínimo, fórmula de valor Sugerido e Formula de Valor Máximo) serão derivadas destas variáveis que apontamos.


As variáveis estão relacionadas matematicamente de acordo com a notação: 

<code>P = PpFc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+</code>

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar, ou seja, o batch irá apresentar os dados apenas referentes às variáveis relacionadas (via GSOload). A medida visa evitar um carregamento excessivamente pesado de dados para determinada função. 

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

'''[RN7] - ''' A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T19:29:48Z

Leo2s: /* DICIONÁRIO DE DADOS */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio cliente consiga fazer esta composição.

O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.

== Implementação ==

O processo terá como bases os seguintes passos: 

# Criação de Tabela;

# Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela);
# Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos;
# Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços.

=== Cadastro tabela de preço ===
Para criação da tabela de preço, será criada uma tela onde o usuário irá fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado, mas, apenas desativa-los.

Ao entrar na tela o sistema deve apresentar campos de filtros, os quais, o usuário poderá localizar um cadastro já inserido ou realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela, terá o acesso para fazer um novo cadastro. na qual, o usuário vai preencher os seguintes campos.

==== Campos de cadastro ====
* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Data inicial vigência''' - Campo de data, onde definirá o inicio da vigência da tabela;
* '''Data final vigência''' - Campo de data, onde definirá o final da vigência da tabela;

* Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar a data final inferior a data atual;
* Caso uma tabela de preço esteja com a data final de vigência vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;
* Os campos de datas não serão obrigatórios. Quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;
* Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo, sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utilizar os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.
</dd>
[[Arquivo:Tabelapreco.jpg|500px]]

[[Arquivo:Tabelapreco2.jpg|500px]]

=== Declaração de variáveis ===

Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:

* O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e nao ser mais que 8 caracteres
* A variável deve estar associada a um produto ou uma tabela de preço
* Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.
* Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.

==== Campos de cadastro ====

* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Chave''' - Campo de texto de 8 caracteres;
* '''Produto / Tabela''' - A seleção de uma produto ou de uma tabela, dados previamente alimentados;
* '''Valor''' - Campo numérico(18:6);

A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

=== Definição da formula de preço ===

* Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.
* Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.
* Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.

* Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

=== Processar tabela ===

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

== Cenários ==

===DICIONÁRIO DE DADOS ===

{|class = "wikitable"
! TABELA
! DESCRIÇÃO
! INICIO DA VIGÊNCIA
! FINAL DA VIGÊNCIA
|-
| '''01''' || TABELA SP || 01/05/2020 || 01/01/2022
|-
| '''02''' || TABELA RJ || 01/05/2020 || 01/01/2022
|-
| '''03''' ||TABELA RS ||01/05/2020 || 01/01/2022
|-
| '''04''' || TABELA SP - CARREFU || 01/05/2020 || 01/01/2022
|-
| '''05''' || TABELA BA || 01/05/2020 || 01/01/2022
|-
| '''06''' || TABELA ES || 01/05/2020 || 01/01/2022
|-
| '''07''' || TABELA SP - CAPITAL ||01/05/2020 || 01/01/2022
|}

{|class = "wikitable"
! CHAVE
! DESCRIÇÃO DA VARIÁVEL
! TABELA / PRODUTO
! VALOR

|-
| '''Pp''' || Preço de Partida || Tabela - 01 || R$ 106,00
|-
| '''Fc''' || Fator de Conversão || Tabela - 01 || 1,5
|-
| '''Ce''' ||Custo de Embalagem || Tabela - 01 || R$ 12,20
|-
| '''Fr''' || Frete || Tabela - 01 || - 5
|-
| '''Pr''' || Promotor || Tabela - 01 || 1,02
|-
| '''Qu''' || Fator Quebra || Tabela - 01 || 3,5
|-
| '''Cf''' || Contrato de Fidelidade || Tabela - 01 || 1,02
|}

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001' por um período de 6 meses.

No portal GeoSales, na tela de variáveis, serão utilizadas as seguintes informações:

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}

Pelo exposto, temos que 7 variáveis foram declaradas. As fórmulas que devemos gerar (Fórmula de valor mínimo, fórmula de valor Sugerido e Formula de Valor Máximo) serão derivadas destas variáveis que apontamos.


As variáveis estão relacionadas matematicamente de acordo com a notação: 

<code>P = PpFc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+</code>

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar, ou seja, o batch irá apresentar os dados apenas referentes às variáveis relacionadas (via GSOload). A medida visa evitar um carregamento excessivamente pesado de dados para determinada função. 

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

'''[RN7] - ''' A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T19:28:26Z

Leo2s: /* DICIONÁRIO DE DADOS */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio cliente consiga fazer esta composição.

O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.

== Implementação ==

O processo terá como bases os seguintes passos: 

# Criação de Tabela;

# Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela);
# Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos;
# Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços.

=== Cadastro tabela de preço ===
Para criação da tabela de preço, será criada uma tela onde o usuário irá fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado, mas, apenas desativa-los.

Ao entrar na tela o sistema deve apresentar campos de filtros, os quais, o usuário poderá localizar um cadastro já inserido ou realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela, terá o acesso para fazer um novo cadastro. na qual, o usuário vai preencher os seguintes campos.

==== Campos de cadastro ====
* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Data inicial vigência''' - Campo de data, onde definirá o inicio da vigência da tabela;
* '''Data final vigência''' - Campo de data, onde definirá o final da vigência da tabela;

* Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar a data final inferior a data atual;
* Caso uma tabela de preço esteja com a data final de vigência vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;
* Os campos de datas não serão obrigatórios. Quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;
* Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo, sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utilizar os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.
</dd>
[[Arquivo:Tabelapreco.jpg|500px]]

[[Arquivo:Tabelapreco2.jpg|500px]]

=== Declaração de variáveis ===

Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:

* O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e nao ser mais que 8 caracteres
* A variável deve estar associada a um produto ou uma tabela de preço
* Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.
* Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.

==== Campos de cadastro ====

* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Chave''' - Campo de texto de 8 caracteres;
* '''Produto / Tabela''' - A seleção de uma produto ou de uma tabela, dados previamente alimentados;
* '''Valor''' - Campo numérico(18:6);

A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

=== Definição da formula de preço ===

* Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.
* Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.
* Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.

* Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

=== Processar tabela ===

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

== Cenários ==

===DICIONÁRIO DE DADOS ===

{|class = "wikitable"
! TABELA
! DESCRIÇÃO
! INICIO DA VIGÊNCIA
! FINAL DA VIGÊNCIA
|-
| '''01''' || TABELA SP || 01/05/2020 || 01/01/2022
|-
| '''02''' || TABELA RJ || 01/05/2020 || 01/01/2022
|-
| '''03''' ||TABELA RS ||01/05/2020 || 01/01/2022
|-
| '''04''' || TABELA SP - CARREFU || 01/05/2020 || 01/01/2022
|-
| '''05''' || TABELA BA || 01/05/2020 || 01/01/2022
|-
| '''06''' || TABELA ES || 01/05/2020 || 01/01/2022
|-
| '''07''' || TABELA SP - CAPITAL ||01/05/2020 || 01/01/2022
|}

{|class = "wikitable"
! CHAVE
! DESCRIÇÃO DA VARIÁVEL
! TABELA / PRODUTO
! VALOR

|-
| '''Pp''' || Preço de Partida || Tabela - 01 || R$ 106,00
|-
| '''Fc''' || Fator de Conversão || Tabela - 01 || 1,5
|-
| '''Ce''' ||Custo de Embalagem || Tabela - 01 || R$ 12,20
|-
| '''Fr''' || Frete || Tabela - 01 || - 5
|-
| '''Pr''' || Promotor || Tabela - 01 || 1,02
|-
| '''Qu''' || Fator Quebra || Tabela - 01 || 3,5
|-
| '''Cf''' || Contrato de Fidelidade || Tabela - 01 || 1,02
|}

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001' por um período de 6 meses.

No portal GeoSales, na tela de variáveis, serão utilizadas as seguintes informações:

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}

Pelo exposto, temos que 7 variáveis foram declaradas. As fórmulas que devemos gerar (Fórmula de valor mínimo, fórmula de valor Sugerido e Formula de Valor Máximo) serão derivadas destas variáveis que apontamos.


As variáveis estão relacionadas matematicamente de acordo com a notação: 

<code>P = PpFc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+</code>

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar, ou seja, o batch irá apresentar os dados apenas referentes às variáveis relacionadas (via GSOload). A medida visa evitar um carregamento excessivamente pesado de dados para determinada função. 

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

'''[RN7] - ''' A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T19:27:43Z

Leo2s: /* DICIONÁRIO DE DADOS */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio cliente consiga fazer esta composição.

O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.

== Implementação ==

O processo terá como bases os seguintes passos: 

# Criação de Tabela;

# Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela);
# Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos;
# Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços.

=== Cadastro tabela de preço ===
Para criação da tabela de preço, será criada uma tela onde o usuário irá fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado, mas, apenas desativa-los.

Ao entrar na tela o sistema deve apresentar campos de filtros, os quais, o usuário poderá localizar um cadastro já inserido ou realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela, terá o acesso para fazer um novo cadastro. na qual, o usuário vai preencher os seguintes campos.

==== Campos de cadastro ====
* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Data inicial vigência''' - Campo de data, onde definirá o inicio da vigência da tabela;
* '''Data final vigência''' - Campo de data, onde definirá o final da vigência da tabela;

* Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar a data final inferior a data atual;
* Caso uma tabela de preço esteja com a data final de vigência vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;
* Os campos de datas não serão obrigatórios. Quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;
* Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo, sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utilizar os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.
</dd>
[[Arquivo:Tabelapreco.jpg|500px]]

[[Arquivo:Tabelapreco2.jpg|500px]]

=== Declaração de variáveis ===

Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:

* O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e nao ser mais que 8 caracteres
* A variável deve estar associada a um produto ou uma tabela de preço
* Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.
* Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.

==== Campos de cadastro ====

* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Chave''' - Campo de texto de 8 caracteres;
* '''Produto / Tabela''' - A seleção de uma produto ou de uma tabela, dados previamente alimentados;
* '''Valor''' - Campo numérico(18:6);

A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

=== Definição da formula de preço ===

* Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.
* Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.
* Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.

* Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

=== Processar tabela ===

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

== Cenários ==

===DICIONÁRIO DE DADOS ===

{|class = "wikitable"
! TABELA
! DESCRIÇÃO
! INICIO DA VIGÊNCIA
! FINAL DA VIGÊNCIA
|-
| 01 || TABELA SP || 01/05/2020 || 01/01/2022
|-
| 02 || TABELA RJ || 01/05/2020 || 01/01/2022
|-
| 03 ||TABELA RS ||01/05/2020 || 01/01/2022
|-
| 04 || TABELA SP - CARREFU || 01/05/2020 || 01/01/2022
|-
| 05 || TABELA BA || 01/05/2020 || 01/01/2022
|-
| 06 || TABELA ES || 01/05/2020 || 01/01/2022
|-
| 07 || TABELA SP - CAPITAL ||01/05/2020 || 01/01/2022
|}

{|class = "wikitable"
! CHAVE
! DESCRIÇÃO DA VARIÁVEL
! TABELA / PRODUTO
! VALOR

|-
| '''Pp''' || Preço de Partida || Tabela - 01 || R$ 106,00
|-
| '''Fc''' || Fator de Conversão || Tabela - 01 || 1,5
|-
| '''Ce''' ||Custo de Embalagem || Tabela - 01 || R$ 12,20
|-
| '''Fr''' || Frete || Tabela - 01 || - 5
|-
| '''Pr''' || Promotor || Tabela - 01 || 1,02
|-
| '''Qu''' || Fator Quebra || Tabela - 01 || 3,5
|-
| '''Cf''' || Contrato de Fidelidade || Tabela - 01 || 1,02
|}

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001' por um período de 6 meses.

No portal GeoSales, na tela de variáveis, serão utilizadas as seguintes informações:

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}

Pelo exposto, temos que 7 variáveis foram declaradas. As fórmulas que devemos gerar (Fórmula de valor mínimo, fórmula de valor Sugerido e Formula de Valor Máximo) serão derivadas destas variáveis que apontamos.


As variáveis estão relacionadas matematicamente de acordo com a notação: 

<code>P = PpFc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+</code>

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar, ou seja, o batch irá apresentar os dados apenas referentes às variáveis relacionadas (via GSOload). A medida visa evitar um carregamento excessivamente pesado de dados para determinada função. 

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

'''[RN7] - ''' A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T19:26:52Z

Leo2s: /* DICIONÁRIO DE DADOS */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio cliente consiga fazer esta composição.

O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.

== Implementação ==

O processo terá como bases os seguintes passos: 

# Criação de Tabela;

# Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela);
# Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos;
# Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços.

=== Cadastro tabela de preço ===
Para criação da tabela de preço, será criada uma tela onde o usuário irá fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado, mas, apenas desativa-los.

Ao entrar na tela o sistema deve apresentar campos de filtros, os quais, o usuário poderá localizar um cadastro já inserido ou realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela, terá o acesso para fazer um novo cadastro. na qual, o usuário vai preencher os seguintes campos.

==== Campos de cadastro ====
* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Data inicial vigência''' - Campo de data, onde definirá o inicio da vigência da tabela;
* '''Data final vigência''' - Campo de data, onde definirá o final da vigência da tabela;

* Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar a data final inferior a data atual;
* Caso uma tabela de preço esteja com a data final de vigência vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;
* Os campos de datas não serão obrigatórios. Quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;
* Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo, sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utilizar os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.
</dd>
[[Arquivo:Tabelapreco.jpg|500px]]

[[Arquivo:Tabelapreco2.jpg|500px]]

=== Declaração de variáveis ===

Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:

* O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e nao ser mais que 8 caracteres
* A variável deve estar associada a um produto ou uma tabela de preço
* Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.
* Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.

==== Campos de cadastro ====

* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Chave''' - Campo de texto de 8 caracteres;
* '''Produto / Tabela''' - A seleção de uma produto ou de uma tabela, dados previamente alimentados;
* '''Valor''' - Campo numérico(18:6);

A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

=== Definição da formula de preço ===

* Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.
* Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.
* Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.

* Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

=== Processar tabela ===

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

== Cenários ==

===DICIONÁRIO DE DADOS ===

{|class = "wikitable"
! TABELA
! DESCRIÇÃO
! INICIO DA VIGÊNCIA
! FINAL DA VIGÊNCIA
|-
| 01 || TABELA SP || 01/05/2020 || 01/01/2022
|-
| 02 || TABELA RJ || 01/05/2020 || 01/01/2022
|-
| 03 ||TABELA RS ||01/05/2020 || 01/01/2022
|-
| 04 || TABELA SP - CARREFU || 01/05/2020 || 01/01/2022
|-
| 05 || TABELA BA || 01/05/2020 || 01/01/2022
|-
| 06 || TABELA ES || 01/05/2020 || 01/01/2022
|-
| 07 || TABELA SP - CAPITAL ||01/05/2020 || 01/01/2022
|}

{|class = "wikitable"
! CHAVE
! DESCRIÇÃO DA VARIÁVEL
! TABELA / PRODUTO
! VALOR

|-
| Pp || Preço de Partida || Tabela - 01 || R$ 106,00
|-
| Fc || Fator de Conversão || Tabela - 01 || 1,5
|-
| Ce ||Custo de Embalagem || Tabela - 01 || R$ 12,20
|-
| Fr || Frete || Tabela - 01 || - 5
|-
| Pr || Promotor || Tabela - 01 || 1,02
|-
| Qu || Fator Quebra || Tabela - 01 || 3,5
|-
| Cf || Contrato de Fidelidade || Tabela - 01 || 1,02
|}

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001' por um período de 6 meses.

No portal GeoSales, na tela de variáveis, serão utilizadas as seguintes informações:

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}

Pelo exposto, temos que 7 variáveis foram declaradas. As fórmulas que devemos gerar (Fórmula de valor mínimo, fórmula de valor Sugerido e Formula de Valor Máximo) serão derivadas destas variáveis que apontamos.


As variáveis estão relacionadas matematicamente de acordo com a notação: 

<code>P = PpFc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+</code>

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar, ou seja, o batch irá apresentar os dados apenas referentes às variáveis relacionadas (via GSOload). A medida visa evitar um carregamento excessivamente pesado de dados para determinada função. 

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

'''[RN7] - ''' A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T19:23:54Z

Leo2s: /* DICIONÁRIO DE DADOS */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio cliente consiga fazer esta composição.

O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.

== Implementação ==

O processo terá como bases os seguintes passos: 

# Criação de Tabela;

# Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela);
# Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos;
# Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços.

=== Cadastro tabela de preço ===
Para criação da tabela de preço, será criada uma tela onde o usuário irá fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado, mas, apenas desativa-los.

Ao entrar na tela o sistema deve apresentar campos de filtros, os quais, o usuário poderá localizar um cadastro já inserido ou realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela, terá o acesso para fazer um novo cadastro. na qual, o usuário vai preencher os seguintes campos.

==== Campos de cadastro ====
* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Data inicial vigência''' - Campo de data, onde definirá o inicio da vigência da tabela;
* '''Data final vigência''' - Campo de data, onde definirá o final da vigência da tabela;

* Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar a data final inferior a data atual;
* Caso uma tabela de preço esteja com a data final de vigência vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;
* Os campos de datas não serão obrigatórios. Quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;
* Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo, sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utilizar os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.
</dd>
[[Arquivo:Tabelapreco.jpg|500px]]

[[Arquivo:Tabelapreco2.jpg|500px]]

=== Declaração de variáveis ===

Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:

* O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e nao ser mais que 8 caracteres
* A variável deve estar associada a um produto ou uma tabela de preço
* Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.
* Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.

==== Campos de cadastro ====

* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Chave''' - Campo de texto de 8 caracteres;
* '''Produto / Tabela''' - A seleção de uma produto ou de uma tabela, dados previamente alimentados;
* '''Valor''' - Campo numérico(18:6);

A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

=== Definição da formula de preço ===

* Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.
* Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.
* Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.

* Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

=== Processar tabela ===

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

== Cenários ==

===DICIONÁRIO DE DADOS ===

{|class = "wikitable"
! TABELA
! DESCRIÇÃO
! INICIO DA VIGÊNCIA
! FINAL DA VIGÊNCIA
|-
| 01 || TABELA SP || 01/05/2020 || 01/01/2022
|-
| 02 || TABELA RJ || 01/05/2020 || 01/01/2022
|-
| 03 ||TABELA RS ||01/05/2020 || 01/01/2022
|-
| 04 || TABELA SP - CARREFU || 01/05/2020 || 01/01/2022
|-
| 05 || TABELA BA || 01/05/2020 || 01/01/2022
|-
| 06 || TABELA ES || 01/05/2020 || 01/01/2022
|-
| 07 || TABELA SP - CAPITAL ||01/05/2020 || 01/01/2022
|}

{|class = "wikitable"
! Variável
! Descrição da Variável
! Tabela / Produto
! Valor

|-
| Pp || Preço de Partida || Tabela - 01 || R$ 106,00
|-
| Fc || Fator de Conversão || Tabela - 01 || 1,5
|-
| Ce ||Custo de Embalagem || Tabela - 01 || R$ 12,20
|-
| Fr || Frete || Tabela - 01 || - 5
|-
| Pr || Promotor || Tabela - 01 || 1,02
|-
| Qu || Fator Quebra || Tabela - 01 || 3,5
|-
| Cf || Contrato de Fidelidade || Tabela - 01 || 1,02
|}

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001' por um período de 6 meses.

No portal GeoSales, na tela de variáveis, serão utilizadas as seguintes informações:

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}

Pelo exposto, temos que 7 variáveis foram declaradas. As fórmulas que devemos gerar (Fórmula de valor mínimo, fórmula de valor Sugerido e Formula de Valor Máximo) serão derivadas destas variáveis que apontamos.


As variáveis estão relacionadas matematicamente de acordo com a notação: 

<code>P = PpFc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+</code>

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar, ou seja, o batch irá apresentar os dados apenas referentes às variáveis relacionadas (via GSOload). A medida visa evitar um carregamento excessivamente pesado de dados para determinada função. 

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

'''[RN7] - ''' A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T19:20:02Z

Leo2s: /* DICIONÁRIO DE DADOS */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio cliente consiga fazer esta composição.

O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.

== Implementação ==

O processo terá como bases os seguintes passos: 

# Criação de Tabela;

# Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela);
# Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos;
# Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços.

=== Cadastro tabela de preço ===
Para criação da tabela de preço, será criada uma tela onde o usuário irá fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado, mas, apenas desativa-los.

Ao entrar na tela o sistema deve apresentar campos de filtros, os quais, o usuário poderá localizar um cadastro já inserido ou realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela, terá o acesso para fazer um novo cadastro. na qual, o usuário vai preencher os seguintes campos.

==== Campos de cadastro ====
* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Data inicial vigência''' - Campo de data, onde definirá o inicio da vigência da tabela;
* '''Data final vigência''' - Campo de data, onde definirá o final da vigência da tabela;

* Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar a data final inferior a data atual;
* Caso uma tabela de preço esteja com a data final de vigência vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;
* Os campos de datas não serão obrigatórios. Quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;
* Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo, sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utilizar os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.
</dd>
[[Arquivo:Tabelapreco.jpg|500px]]

[[Arquivo:Tabelapreco2.jpg|500px]]

=== Declaração de variáveis ===

Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:

* O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e nao ser mais que 8 caracteres
* A variável deve estar associada a um produto ou uma tabela de preço
* Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.
* Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.

==== Campos de cadastro ====

* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Chave''' - Campo de texto de 8 caracteres;
* '''Produto / Tabela''' - A seleção de uma produto ou de uma tabela, dados previamente alimentados;
* '''Valor''' - Campo numérico(18:6);

A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

=== Definição da formula de preço ===

* Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.
* Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.
* Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.

* Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

=== Processar tabela ===

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

== Cenários ==

===DICIONÁRIO DE DADOS ===

{|class = "wikitable"
! TABELA
! DESCRIÇÃO
! INICIO DA VIGÊNCIA
! FINAL DA VIGÊNCIA
|-
| 01 || TABELA SP || 01/05/2020 || 01/01/2022
|-
| 02 || TABELA RJ || 01/05/2020 || 01/01/2022
|-
| 03 ||TABELA RS ||01/05/2020 || 01/01/2022
|-
| 04 || TABELA SP - CARREFU || 01/05/2020 || 01/01/2022
|-
| 05 || TABELA BA || 01/05/2020 || 01/01/2022
|-
| 06 || TABELA ES || 01/05/2020 || 01/01/2022
|-
| 07 || TABELA SP - CAPITAL ||01/05/2020 || 01/01/2022
|}

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001' por um período de 6 meses.

No portal GeoSales, na tela de variáveis, serão utilizadas as seguintes informações:

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}

Pelo exposto, temos que 7 variáveis foram declaradas. As fórmulas que devemos gerar (Fórmula de valor mínimo, fórmula de valor Sugerido e Formula de Valor Máximo) serão derivadas destas variáveis que apontamos.


As variáveis estão relacionadas matematicamente de acordo com a notação: 

<code>P = PpFc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+</code>

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar, ou seja, o batch irá apresentar os dados apenas referentes às variáveis relacionadas (via GSOload). A medida visa evitar um carregamento excessivamente pesado de dados para determinada função. 

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

'''[RN7] - ''' A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T19:19:15Z

Leo2s: /* DICIONÁRIO DE DADOS */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio cliente consiga fazer esta composição.

O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.

== Implementação ==

O processo terá como bases os seguintes passos: 

# Criação de Tabela;

# Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela);
# Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos;
# Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços.

=== Cadastro tabela de preço ===
Para criação da tabela de preço, será criada uma tela onde o usuário irá fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado, mas, apenas desativa-los.

Ao entrar na tela o sistema deve apresentar campos de filtros, os quais, o usuário poderá localizar um cadastro já inserido ou realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela, terá o acesso para fazer um novo cadastro. na qual, o usuário vai preencher os seguintes campos.

==== Campos de cadastro ====
* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Data inicial vigência''' - Campo de data, onde definirá o inicio da vigência da tabela;
* '''Data final vigência''' - Campo de data, onde definirá o final da vigência da tabela;

* Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar a data final inferior a data atual;
* Caso uma tabela de preço esteja com a data final de vigência vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;
* Os campos de datas não serão obrigatórios. Quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;
* Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo, sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utilizar os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.
</dd>
[[Arquivo:Tabelapreco.jpg|500px]]

[[Arquivo:Tabelapreco2.jpg|500px]]

=== Declaração de variáveis ===

Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:

* O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e nao ser mais que 8 caracteres
* A variável deve estar associada a um produto ou uma tabela de preço
* Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.
* Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.

==== Campos de cadastro ====

* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Chave''' - Campo de texto de 8 caracteres;
* '''Produto / Tabela''' - A seleção de uma produto ou de uma tabela, dados previamente alimentados;
* '''Valor''' - Campo numérico(18:6);

A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

=== Definição da formula de preço ===

* Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.
* Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.
* Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.

* Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

=== Processar tabela ===

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

== Cenários ==

===DICIONÁRIO DE DADOS ===

{|class = "wikitable"
! TABELA
! DESCRIÇÃO
! INICIO DA VIGÊNCIA
! FINAL DA VIGÊNCIA
|-
| 01 || TABELA SP || 01/05/2020 || 01/01/2022
|-
| 02 || TABELA RJ || 01/05/2020 || 01/01/2022
|-
| 03 ||TABELA RS ||01/05/2020 || 01/01/2022
|-
| 04 || TABELA SP - CARREFU || 01/05/2020 || 01/01/2022
|-
| 05 || TABELA BA || 01/05/2020 || 01/01/2022
|-
| 06 || TABELA ES || 01/05/2020 || 01/01/2022
|-
| 07 || Contrato de Fidelidade ||01/05/2020 || 01/01/2022
|}

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001' por um período de 6 meses.

No portal GeoSales, na tela de variáveis, serão utilizadas as seguintes informações:

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}

Pelo exposto, temos que 7 variáveis foram declaradas. As fórmulas que devemos gerar (Fórmula de valor mínimo, fórmula de valor Sugerido e Formula de Valor Máximo) serão derivadas destas variáveis que apontamos.


As variáveis estão relacionadas matematicamente de acordo com a notação: 

<code>P = PpFc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+</code>

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar, ou seja, o batch irá apresentar os dados apenas referentes às variáveis relacionadas (via GSOload). A medida visa evitar um carregamento excessivamente pesado de dados para determinada função. 

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

'''[RN7] - ''' A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T19:15:49Z

Leo2s: /* Cenários */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio cliente consiga fazer esta composição.

O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.

== Implementação ==

O processo terá como bases os seguintes passos: 

# Criação de Tabela;

# Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela);
# Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos;
# Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços.

=== Cadastro tabela de preço ===
Para criação da tabela de preço, será criada uma tela onde o usuário irá fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado, mas, apenas desativa-los.

Ao entrar na tela o sistema deve apresentar campos de filtros, os quais, o usuário poderá localizar um cadastro já inserido ou realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela, terá o acesso para fazer um novo cadastro. na qual, o usuário vai preencher os seguintes campos.

==== Campos de cadastro ====
* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Data inicial vigência''' - Campo de data, onde definirá o inicio da vigência da tabela;
* '''Data final vigência''' - Campo de data, onde definirá o final da vigência da tabela;

* Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar a data final inferior a data atual;
* Caso uma tabela de preço esteja com a data final de vigência vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;
* Os campos de datas não serão obrigatórios. Quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;
* Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo, sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utilizar os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.
</dd>
[[Arquivo:Tabelapreco.jpg|500px]]

[[Arquivo:Tabelapreco2.jpg|500px]]

=== Declaração de variáveis ===

Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:

* O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e nao ser mais que 8 caracteres
* A variável deve estar associada a um produto ou uma tabela de preço
* Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.
* Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.

==== Campos de cadastro ====

* '''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;
* '''Chave''' - Campo de texto de 8 caracteres;
* '''Produto / Tabela''' - A seleção de uma produto ou de uma tabela, dados previamente alimentados;
* '''Valor''' - Campo numérico(18:6);

A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

=== Definição da formula de preço ===

* Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.
* Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.
* Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.

* Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

=== Processar tabela ===

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

== Cenários ==

===DICIONÁRIO DE DADOS ===

{|class = "wikitable"
! TABELA
! DESCRIÇÃO
! INICIO DA VIGÊNCIA
! FINAL DA VIGÊNCIA
|-
| 01 || TABELA SP || 01/05/2020 || 01/01/2022
|-
| 02 || TABELA RJ || 01/05/2020 || 01/01/2022
|-
| 03 ||TABELA RS ||01/05/2020 || 01/01/2022
|-
| 04 || TABELA SP - CARREFU || 01/05/2020 || 01/01/2022
|-
| 05 || Promotor || 01/05/2020 || 01/01/2022
|-
| 06 || Fator Quebra || 01/05/2020 || 01/01/2022
|-
| 07 || Contrato de Fidelidade ||01/05/2020 || 01/01/2022
|}

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001' por um período de 6 meses.

No portal GeoSales, na tela de variáveis, serão utilizadas as seguintes informações:

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}

Pelo exposto, temos que 7 variáveis foram declaradas. As fórmulas que devemos gerar (Fórmula de valor mínimo, fórmula de valor Sugerido e Formula de Valor Máximo) serão derivadas destas variáveis que apontamos.


As variáveis estão relacionadas matematicamente de acordo com a notação: 

<code>P = PpFc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*</code>

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação:

<code>P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+</code>

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar, ou seja, o batch irá apresentar os dados apenas referentes às variáveis relacionadas (via GSOload). A medida visa evitar um carregamento excessivamente pesado de dados para determinada função. 

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

'''[RN7] - ''' A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T18:38:01Z

Leo2s: /* Implementação */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio cliente consiga fazer esta composição. 
O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.
</dd>

== Implementação ==

O processo terá como bases os seguintes passos: 

1. Criação de Tabela; 

2. Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela); 
3. Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos; 
4. Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços. 

'''Cadastro tabela de preço'''
<dd> Para criação da tabela de preço, será criada uma tela onde o usuário irá fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado, mas, apenas desativa-los.
<dd>Ao entrar na tela o sistema deve apresentar campos de filtros, os quais, o usuário poderá localizar um cadastro já inserido ou realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela, terá o acesso para fazer um novo cadastro. na qual, o usuário vai preencher os seguintes campos.</dd>

<dd>
'''Campos de cadastro:''' 
<li>'''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;</li>
<li>'''Data inicial vigência''' - Campo de data, onde definirá o inicio da vigência da tabela;</li>
<li>'''Data final vigência''' - Campo de data, onde definirá o final da vigência da tabela;</li>
 

<li>Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar a data final inferior a data atual;</li>
<li>Caso uma tabela de preço esteja com a data final de vigência vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;</li>
<li>Os campos de datas não serão obrigatórios. Quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;</li>
<li>Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo, sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utilizar os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.</li>

</dd>
[[Arquivo:Tabelapreco.jpg|500px]]

[[Arquivo:Tabelapreco2.jpg|500px]]

 
 
'''Declaração de variáveis'''

<dd>
Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:
<li> O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e nao ser mais que 8 caracteres</li>
<li> A variável deve estar associada a um produto ou uma tabela de preço</li>
<li> Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.</li>
<li> Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.
 
'''Campos de cadastro:''' 
<li>'''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;</li>
<li>'''Chave''' - Campo de texto de 8 caracteres;</li>
<li>'''Produto / Tabela''' - A seleção de uma produto ou de uma tabela, dados previamente alimentados;</li>
<li>'''Valor''' - Campo numérico(18:6);</li>
 
A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

 
</dd>
'''Definição da formula de preço'''
 
<dd>
<li> Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.</li>
<li> Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.</li>
<li> Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.</li>

<li>Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.</li>

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

'''Processar tabela'''

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.
</dd>
== Cenário 1 ==

Elaborando o preço do produto 'P001' para o cliente 'C001':

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}


As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpFc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+'''''

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar, ou seja, o batch irá apresentar os dados apenas referentes às variáveis relacionadas (via GSOload). A medida visa evitar um carregamento excessivamente pesado de dados para determinada função. 

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

'''[RN7] - ''' A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T18:36:41Z

Leo2s: /* Implementação */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio cliente consiga fazer esta composição. 
O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.

== Implementação ==

O processo terá como bases os seguintes passos: 

1. Criação de Tabela; 

2. Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela); 
3. Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos; 
4. Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços. 

'''Cadastro tabela de preço'''
<dd> Para criação da tabela de preço, será criada uma tela onde o usuário irá fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado, mas, apenas desativa-los.
<dd>Ao entrar na tela o sistema deve apresentar campos de filtros, os quais, o usuário poderá localizar um cadastro já inserido ou realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela, terá o acesso para fazer um novo cadastro. na qual, o usuário vai preencher os seguintes campos.</dd>

<dd>
'''Campos de cadastro:''' 
<li>'''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;</li>
<li>'''Data inicial vigência''' - Campo de data, onde definirá o inicio da vigência da tabela;</li>
<li>'''Data final vigência''' - Campo de data, onde definirá o final da vigência da tabela;</li>
 

<li>Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar a data final inferior a data atual;</li>
<li>Caso uma tabela de preço esteja com a data final de vigência vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;</li>
<li>Os campos de datas não serão obrigatórios. Quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;</li>
<li>Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo, sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utilizar os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.</li>

</dd>
[[Arquivo:Tabelapreco.jpg|500px]]

[[Arquivo:Tabelapreco2.jpg|500px]]

 
 
'''Declaração de variáveis'''

<dd>
Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:
<li> O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e nao ser mais que 8 caracteres</li>
<li> A variável deve estar associada a um produto ou uma tabela de preço</li>
<li> Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.</li>
<li> Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.
 
'''Campos de cadastro:''' 
<li>'''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;</li>
<li>'''Chave''' - Campo de texto de 8 caracteres;</li>
<li>'''Produto / Tabela''' - A seleção de uma produto ou de uma tabela, dados previamente alimentados;</li>
<li>'''Valor''' - Campo numérico(18:6);</li>
 
A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

 
</dd>
'''Definição da formula de preço'''
 
<dd>
<li> Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.</li>
<li> Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.</li>
<li> Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.</li>

<li>Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.</li>

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

'''Processar tabela'''

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001':

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}


As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpFc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+'''''

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar, ou seja, o batch irá apresentar os dados apenas referentes às variáveis relacionadas (via GSOload). A medida visa evitar um carregamento excessivamente pesado de dados para determinada função. 

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

'''[RN7] - ''' A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T18:35:45Z

Leo2s: /* Processamento da Tabela */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio cliente consiga fazer esta composição. 
O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.


</dd>

== Implementação ==

O processo terá como bases os seguintes passos: 

1. Criação de Tabela; 

2. Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela); 
3. Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos; 
4. Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços. 

'''Cadastro tabela de preço'''
<dd> Para criação da tabela de preço, será criada uma tela onde o usuário irá fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado, mas, apenas desativa-los.
<dd>Ao entrar na tela o sistema deve apresentar campos de filtros, os quais, o usuário poderá localizar um cadastro já inserido ou realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela, terá o acesso para fazer um novo cadastro. na qual, o usuário vai preencher os seguintes campos.</dd>

<dd>
'''Campos de cadastro:''' 
<li>'''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;</li>
<li>'''Data inicial vigência''' - Campo de data, onde definirá o inicio da vigência da tabela;</li>
<li>'''Data final vigência''' - Campo de data, onde definirá o final da vigência da tabela;</li>
 

<li>Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar a data final inferior a data atual;</li>
<li>Caso uma tabela de preço esteja com a data final de vigência vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;</li>
<li>Os campos de datas não serão obrigatórios. Quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;</li>
<li>Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo, sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utilizar os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.</li>

</dd>
[[Arquivo:Tabelapreco.jpg|500px]]

[[Arquivo:Tabelapreco2.jpg|500px]]

 
 
'''Declaração de variáveis'''

<dd>
Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:
<li> O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e nao ser mais que 8 caracteres</li>
<li> A variável deve estar associada a um produto ou uma tabela de preço</li>
<li> Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.</li>
<li> Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.
 
'''Campos de cadastro:''' 
<li>'''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;</li>
<li>'''Chave''' - Campo de texto de 8 caracteres;</li>
<li>'''Produto / Tabela''' - A seleção de uma produto ou de uma tabela, dados previamente alimentados;</li>
<li>'''Valor''' - Campo numérico(18:6);</li>
 
A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

 
</dd>
'''Definição da formula de preço'''
 
<dd>
<li> Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.</li>
<li> Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.</li>
<li> Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.</li>

<li>Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.</li>

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

</dd>

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001':

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}


As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpFc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+'''''

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar, ou seja, o batch irá apresentar os dados apenas referentes às variáveis relacionadas (via GSOload). A medida visa evitar um carregamento excessivamente pesado de dados para determinada função. 

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

'''[RN7] - ''' A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T18:24:04Z

Leo2s: /* Implementação */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio cliente consiga fazer esta composição. 
O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.


</dd>

== Implementação ==

O processo terá como bases os seguintes passos: 

1. Criação de Tabela; 

2. Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela); 
3. Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos; 
4. Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços. 

'''Cadastro tabela de preço'''
<dd> Para criação da tabela de preço, será criada uma tela para o usuário fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado.
<dd>Ao entrar na tela o sistema deve apresentar campos de filtros, os quais o usuário poderá localizar um cadastro já inserido e realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela o acesso a realizar um novo cadastro os quais o usuário vai preencher os seguintes campos.</dd>

<dd>
'''Campos de cadastro:''' 
<li>'''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;</li>
<li>'''Data inicial vigência''' - Campo de data, onde definirá o inicio da vigência da tabela;</li>
<li>'''Data final vigência''' - Campo de data, onde definirá o final da vigência da tabela;</li>
 

<li>Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar em seu intervalo de data validade, colocando a data final inferior a data atual;</li>
<li>Caso uma tabela de preço esteja com a data de validade vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;</li>
<li>Os campos de datas não serão obrigatórios. Quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;</li>
<li>Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo, sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utilizar os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.</li>

</dd>
[[Arquivo:Tabelapreco.jpg|500px]]

[[Arquivo:Tabelapreco2.jpg|500px]]

 
 
'''Declaração de variáveis'''

<dd>
Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:
<li> O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e nao ser mais que 8 caracteres</li>
<li> A variável deve estar associada a um produto ou uma tabela de preço</li>
<li> Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.</li>
<li> Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.
 
'''Campos de cadastro:''' 
<li>'''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;</li>
<li>'''Chave''' - Campo de texto de 8 caracteres;</li>
<li>'''Produto / Tabela''' - A seleção de uma produto ou de uma tabela, dados previamente alimentados;</li>
<li>'''Valor''' - Campo numérico(18:6);</li>
 
A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

 
</dd>
'''Definição da formula de preço'''
 
<dd>
<li> Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.</li>
<li> Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.</li>
<li> Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.</li>

<li>Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.</li>

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

</dd>

== Processamento da Tabela ==
 

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001':

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}


As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpFc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+'''''

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar, ou seja, o batch irá apresentar os dados apenas referentes às variáveis relacionadas (via GSOload). A medida visa evitar um carregamento excessivamente pesado de dados para determinada função. 

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

'''[RN7] - ''' A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T18:23:47Z

Leo2s: /* Implementação */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio cliente consiga fazer esta composição. 
O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.


</dd>

== Implementação ==

O processo terá como bases os seguintes passos: 

1. Criação de Tabela; 

2. Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela); 
3. Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos; 
4. Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços. 

'''Cadastro tabela de preço'''
<dd> Para criação da tabela de preço, será criada uma tela para o usuário fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado.
<dd>Ao entrar na tela o sistema deve apresentar campos de filtros, os quais o usuário poderá localizar um cadastro já inserido e realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela o acesso a realizar um novo cadastro os quais o usuário vai preencher os seguintes campos.</dd>

<dd>
'''Campos de cadastro:''' 
<li>'''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;</li>
<li>'''Data inicial vigência''' - Campo de data, onde definirá o inicio da vigência da tabela;</li>
<li>'''Data final vigência''' - Campo de data, onde definirá o final da vigência da tabela;</li>
 

<li>Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar em seu intervalo de data validade, colocando a data final inferior a data atual;</li>
<li>Caso uma tabela de preço esteja com a data de validade vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;</li>
<li>Os campos de datas não serão obrigatórios. Quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;</li>
<li>Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo, sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utilizar os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.</li>

</dd>
[[Arquivo:Tabelapreco.jpg|500px]]

[[Arquivo:Tabelapreco2.jpg|500px]]

 
'''Declaração de variáveis'''

<dd>
Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:
<li> O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e nao ser mais que 8 caracteres</li>
<li> A variável deve estar associada a um produto ou uma tabela de preço</li>
<li> Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.</li>
<li> Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.
 
'''Campos de cadastro:''' 
<li>'''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;</li>
<li>'''Chave''' - Campo de texto de 8 caracteres;</li>
<li>'''Produto / Tabela''' - A seleção de uma produto ou de uma tabela, dados previamente alimentados;</li>
<li>'''Valor''' - Campo numérico(18:6);</li>
 
A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

 
</dd>
'''Definição da formula de preço'''
 
<dd>
<li> Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.</li>
<li> Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.</li>
<li> Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.</li>

<li>Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.</li>

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

</dd>

== Processamento da Tabela ==
 

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001':

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}


As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpFc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+'''''

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar, ou seja, o batch irá apresentar os dados apenas referentes às variáveis relacionadas (via GSOload). A medida visa evitar um carregamento excessivamente pesado de dados para determinada função. 

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

'''[RN7] - ''' A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T18:22:05Z

Leo2s: /* Implementação */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio cliente consiga fazer esta composição. 
O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.


</dd>

== Implementação ==

O processo terá como bases os seguintes passos: 

1. Criação de Tabela; 

2. Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela); 
3. Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos; 
4. Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços. 

'''Cadastro tabela de preço'''
<dd> Para criação da tabela de preço, será criada uma tela para o usuário fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado.
<dd>Ao entrar na tela o sistema deve apresentar campos de filtros, os quais o usuário poderá localizar um cadastro já inserido e realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela o acesso a realizar um novo cadastro os quais o usuário vai preencher os seguintes campos.</dd>

'''Campos de cadastro:''' 
<li>'''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;</li>
<li>'''Data inicial vigência''' - Campo de data, onde definirá o inicio da vigência da tabela;</li>
<li>'''Data final vigência''' - Campo de data, onde definirá o final da vigência da tabela;</li>
 

<li>Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar em seu intervalo de data validade, colocando a data final inferior a data atual;</li>
<li>Caso uma tabela de preço esteja com a data de validade vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;</li>
<li>Os campos de datas não serão obrigatórios. Quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;</li>
<li>Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo, sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utilizar os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.</li>

[[Arquivo:Tabelapreco.jpg|500px]]

[[Arquivo:Tabelapreco2.jpg|500px]]
</dd>

'''Declaração de variáveis'''

<dd>
Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:
<li> O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e nao ser mais que 8 caracteres</li>
<li> A variável deve estar associada a um produto ou uma tabela de preço</li>
<li> Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.</li>
<li> Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.
 
'''Campos de cadastro:''' 
<li>'''Descrição''' - Campo de texto limitados ao máximo de 70 caracteres;</li>
<li>'''Chave''' - Campo de texto de 8 caracteres;</li>
<li>'''Produto / Tabela''' - A seleção de uma produto ou de uma tabela, dados previamente alimentados;</li>
<li>'''Valor''' - Campo numérico(18:6);</li>
 
A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

 
</dd>
'''Definição da formula de preço'''
 
<dd>
<li> Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.</li>
<li> Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.</li>
<li> Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.</li>

<li>Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.</li>

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

</dd>

== Processamento da Tabela ==
 

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001':

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}


As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpFc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+'''''

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar, ou seja, o batch irá apresentar os dados apenas referentes às variáveis relacionadas (via GSOload). A medida visa evitar um carregamento excessivamente pesado de dados para determinada função. 

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

'''[RN7] - ''' A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T18:18:55Z

Leo2s: /* Implementação */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio cliente consiga fazer esta composição. 
O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.


</dd>

== Implementação ==

O processo terá como bases os seguintes passos: 

1. Criação de Tabela; 

2. Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela); 
3. Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos; 
4. Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços. 

'''Cadastro tabela de preço'''
<dd> Para criação da tabela de preço, será criada uma tela para o usuário fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado. Ao entrar na tela o sistema deve apresentar campos de filtros, os quais o usuário poderá localizar um cadastro já inserido e realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela o acesso a realizar um novo cadastro os quais o usuário vai preencher os seguintes campos.

{| class="wikitable"
! Campo
! Tipo
! Utilização
|-
| Descrição || Texto || O campo de descrição é um texto que aceita no máximo 70 caracteres
|-
| Data inicial vigência || Data || O campo de data inicial irá determinar o início da vigência para tabela de preço
|-
| Data final vigência || Data || O campo de data final irá determinar o fim da vigência para tabela de preço
|-
|}

<li>Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar em seu intervalo de data validade, colocando a data final inferior a data atual;</li>
<li>Caso uma tabela de preço esteja com a data de validade vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;</li>
<li>Os campos de datas não serão obrigatórios. Quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;</li>
<li>Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo, sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utilizar os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.</li>

[[Arquivo:Tabelapreco.jpg|500px]]

[[Arquivo:Tabelapreco2.jpg|500px]]
</dd>

'''Declaração de variáveis'''

<dd>
Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:
<li> O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e nao ser mais que 8 caracteres</li>
<li> A variável deve estar associada a um produto ou uma tabela de preço</li>
<li> Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.</li>
<li> Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.
 
'''Campos de cadastro:''' 
<li>'''Descrição''' - Campo de texto;</li>
<li>'''Chave''' - Campo de texto de 8 caracteres;</li>
<li>'''Produto / Tabela''' - A seleção de uma produto ou de uma tabela, dados previamente alimentados;</li>
<li>'''Valor''' - Campo numérico(18:6);</li>
 
A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

 
</dd>
'''Definição da formula de preço'''
 
<dd>
<li> Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.</li>
<li> Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.</li>
<li> Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.</li>

<li>Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.</li>

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

</dd>

== Processamento da Tabela ==
 

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001':

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}


As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpFc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+'''''

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar, ou seja, o batch irá apresentar os dados apenas referentes às variáveis relacionadas (via GSOload). A medida visa evitar um carregamento excessivamente pesado de dados para determinada função. 

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

'''[RN7] - ''' A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T18:14:02Z

Leo2s: /* Regras de Negócios */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio cliente consiga fazer esta composição. 
O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.


</dd>

== Implementação ==

O processo terá como bases os seguintes passos: 

1. Criação de Tabela; 

2. Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela); 
3. Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos; 
4. Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços. 

'''Cadastro tabela de preço'''
<dd> Para criação da tabela de preço, será criada uma tela para o usuário fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado. Ao entrar na tela o sistema deve apresentar campos de filtros, os quais o usuário poderá localizar um cadastro já inserido e realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela o acesso a realizar um novo cadastro os quais o usuário vai preencher os seguintes campos.

{| class="wikitable"
! Campo
! Tipo
! Utilização
|-
| Descrição || Texto || O campo de descrição é um texto que aceita no máximo 70 caracteres
|-
| Data inicial vigência || Data || O campo de data inicial irá determinar o início da vigência para tabela de preço
|-
| Data final vigência || Data || O campo de data final irá determinar o fim da vigência para tabela de preço
|-
|}

<li>Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar em seu intervalo de data validade, colocando a data final inferior a data atual;</li>
<li>Caso uma tabela de preço esteja com a data de validade vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;</li>
<li>Os campos de datas não serão obrigatórios. Quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;</li>
<li>Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo, sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utilizar os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.</li>
[[Arquivo:Tabelapreco.jpg|300px|Pesquisa]]
[[Arquivo:Tabelapreco2.jpg|300px|Cadastro]]
</dd>

'''Declaração de variáveis'''

<dd>
Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:
<li> O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e nao ser mais que 8 caracteres</li>
<li> A variável deve estar associada a um produto ou uma tabela de preço</li>
<li> Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.</li>
<li> Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.
 
'''Campos de cadastro:''' 
<li>'''Descrição''' - Campo de texto;</li>
<li>'''Chave''' - Campo de texto de 8 caracteres;</li>
<li>'''Produto / Tabela''' - A seleção de uma produto ou de uma tabela, dados previamente alimentados;</li>
<li>'''Valor''' - Campo numérico(18:6);</li>

 
</dd>
'''Definição da formula de preço'''
 
<dd>
<li> Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.</li>
<li> Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.</li>
<li> Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.</li>

<li>Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.</li>

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

</dd>

== Processamento da Tabela ==
 

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001':

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}


As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpFc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+'''''

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar, ou seja, o batch irá apresentar os dados apenas referentes às variáveis relacionadas (via GSOload). A medida visa evitar um carregamento excessivamente pesado de dados para determinada função. 

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

'''[RN7] - ''' A chave poderá ser associada a mais de um produto/tabela, mas o valor é específico pela unidade de um destes dois atributos.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T18:13:30Z

Leo2s: /* Implementação */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio cliente consiga fazer esta composição. 
O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.


</dd>

== Implementação ==

O processo terá como bases os seguintes passos: 

1. Criação de Tabela; 

2. Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela); 
3. Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos; 
4. Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços. 

'''Cadastro tabela de preço'''
<dd> Para criação da tabela de preço, será criada uma tela para o usuário fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado. Ao entrar na tela o sistema deve apresentar campos de filtros, os quais o usuário poderá localizar um cadastro já inserido e realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela o acesso a realizar um novo cadastro os quais o usuário vai preencher os seguintes campos.

{| class="wikitable"
! Campo
! Tipo
! Utilização
|-
| Descrição || Texto || O campo de descrição é um texto que aceita no máximo 70 caracteres
|-
| Data inicial vigência || Data || O campo de data inicial irá determinar o início da vigência para tabela de preço
|-
| Data final vigência || Data || O campo de data final irá determinar o fim da vigência para tabela de preço
|-
|}

<li>Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar em seu intervalo de data validade, colocando a data final inferior a data atual;</li>
<li>Caso uma tabela de preço esteja com a data de validade vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;</li>
<li>Os campos de datas não serão obrigatórios. Quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;</li>
<li>Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo, sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utilizar os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.</li>
</dd>
[[Arquivo:Tabelapreco.jpg|300px|Pesquisa]]
[[Arquivo:Tabelapreco2.jpg|300px|Cadastro]]

'''Declaração de variáveis'''

<dd>
Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:
<li> O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e nao ser mais que 8 caracteres</li>
<li> A variável deve estar associada a um produto ou uma tabela de preço</li>
<li> Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.</li>
<li> Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.
 
'''Campos de cadastro:''' 
<li>'''Descrição''' - Campo de texto;</li>
<li>'''Chave''' - Campo de texto de 8 caracteres;</li>
<li>'''Produto / Tabela''' - A seleção de uma produto ou de uma tabela, dados previamente alimentados;</li>
<li>'''Valor''' - Campo numérico(18:6);</li>

 
</dd>
'''Definição da formula de preço'''
 
<dd>
<li> Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.</li>
<li> Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.</li>
<li> Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.</li>

<li>Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.</li>

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

</dd>

== Processamento da Tabela ==
 

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001':

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}


As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpFc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+'''''

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar, ou seja, o batch irá apresentar os dados apenas referentes às variáveis relacionadas (via GSOload). A medida visa evitar um carregamento excessivamente pesado de dados para determinada função. 

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T18:11:09Z

Leo2s: /* Implementação */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio cliente consiga fazer esta composição. 
O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.


</dd>

== Implementação ==

O processo terá como bases os seguintes passos: 

1. Criação de Tabela; 

2. Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela); 
3. Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos; 
4. Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços. 

'''Cadastro tabela de preço'''
<dd> Para criação da tabela de preço, será criada uma tela para o usuário fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado. Ao entrar na tela o sistema deve apresentar campos de filtros, os quais o usuário poderá localizar um cadastro já inserido e realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela o acesso a realizar um novo cadastro os quais o usuário vai preencher os seguintes campos.

{| class="wikitable"
! Campo
! Tipo
! Utilização
|-
| Descrição || Texto || O campo de descrição é um texto que aceita no máximo 70 caracteres
|-
| Data inicial vigência || Data || O campo de data inicial irá determinar o início da vigência para tabela de preço
|-
| Data final vigência || Data || O campo de data final irá determinar o fim da vigência para tabela de preço
|-
|}

<li>Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar em seu intervalo de data validade, colocando a data final inferior a data atual;</li>
<li>Caso uma tabela de preço esteja com a data de validade vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;</li>
<li>Os campos de datas não serão obrigatórios. Quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;</li>
<li>Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo, sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utilizar os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.</li>
</dd>
'''Declaração de variáveis'''

<dd>
Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:
<li> O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e nao ser mais que 8 caracteres</li>
<li> A variável deve estar associada a um produto ou uma tabela de preço</li>
<li> Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.</li>
<li> Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.
 
''Campos de cadastro:'' 
<li>'''Descrição''' - Campo de texto;</li>
<li>'''Chave''' - Campo de texto de 8 caracteres;</li>
<li>'''Produto / Tabela''' - A seleção de uma produto ou de uma tabela, dados previamente alimentados;</li>
<li>'''Valor''' - Campo numérico(18:6);</li>

 
</dd>
'''Definição da formula de preço'''
 
<dd>
<li> Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.</li>
<li> Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.</li>
<li> Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.</li>

<li>Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.</li>

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

</dd>

== Processamento da Tabela ==
 

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001':

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}


As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpFc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+'''''

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar, ou seja, o batch irá apresentar os dados apenas referentes às variáveis relacionadas (via GSOload). A medida visa evitar um carregamento excessivamente pesado de dados para determinada função. 

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T18:10:41Z

Leo2s: /* Implementação */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio cliente consiga fazer esta composição. 
O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.


</dd>

== Implementação ==

O processo terá como bases os seguintes passos: 

1. Criação de Tabela; 

2. Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela); 
3. Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos; 
4. Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços. 

'''Cadastro tabela de preço'''
<dd> Para criação da tabela de preço, será criada uma tela para o usuário fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado. Ao entrar na tela o sistema deve apresentar campos de filtros, os quais o usuário poderá localizar um cadastro já inserido e realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela o acesso a realizar um novo cadastro os quais o usuário vai preencher os seguintes campos.

{| class="wikitable"
! Campo
! Tipo
! Utilização
|-
| Descrição || Texto || O campo de descrição é um texto que aceita no máximo 70 caracteres
|-
| Data inicial vigência || Data || O campo de data inicial irá determinar o início da vigência para tabela de preço
|-
| Data final vigência || Data || O campo de data final irá determinar o fim da vigência para tabela de preço
|-
|}

<li>Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar em seu intervalo de data validade, colocando a data final inferior a data atual;</li>
<li>Caso uma tabela de preço esteja com a data de validade vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;</li>
<li>Os campos de datas não serão obrigatórios. Quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;</li>
<li>Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo, sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utilizar os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.</li>
</dd>
'''Declaração de variáveis'''

<dd>
Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:
<li> O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e nao ser mais que 8 caracteres</li>
<li> A variável deve estar associada a um produto ou uma tabela de preço</li>
<li> Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.</li>
<li> Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.

Campos de cadastro:
<li>'''Descrição''' - Campo de texto;</li>
<li>'''Chave''' - Campo de texto de 8 caracteres;</li>
<li>'''Produto / Tabela''' - A seleção de uma produto ou de uma tabela, dados previamente alimentados;</li>
<li>'''Valor''' - Campo numérico(18:6);</li>

 
</dd>
'''Definição da formula de preço'''
 
<dd>
<li> Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.</li>
<li> Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.</li>
<li> Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.</li>

<li>Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.</li>

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

</dd>

== Processamento da Tabela ==
 

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001':

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}


As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpFc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+'''''

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar, ou seja, o batch irá apresentar os dados apenas referentes às variáveis relacionadas (via GSOload). A medida visa evitar um carregamento excessivamente pesado de dados para determinada função. 

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T17:35:02Z

Leo2s: /* Solução */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio cliente consiga fazer esta composição. 
O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.


</dd>

== Implementação ==

O processo terá como bases os seguintes passos: 

1. Criação de Tabela; 

2. Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela); 
3. Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos; 
4. Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços. 

'''Cadastro tabela de preço'''
<dd> Para criação da tabela de preço, será criada uma tela para o usuário fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado. Ao entrar na tela o sistema deve apresentar campos de filtros, os quais o usuário poderá localizar um cadastro já inserido e realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela o acesso a realizar um novo cadastro os quais o usuário vai preencher os seguintes campos.

{| class="wikitable"
! Campo
! Tipo
! Utilização
|-
| Descrição || Texto || O campo de descrição é um texto que aceita no máximo 70 caracteres
|-
| Data inicial vigência || Data || O campo de data inicial irá determinar o início da vigência para tabela de preço
|-
| Data final vigência || Data || O campo de data final irá determinar o fim da vigência para tabela de preço
|-
|}

<li>Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar em seu intervalo de data validade, colocando a data final inferior a data atual;</li>
<li>Caso uma tabela de preço esteja com a data de validade vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;</li>
<li>Os campos de datas não serão obrigatórios, quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;</li>
<li>Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo. Sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utiliza os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.</li>
</dd>
'''Declaração de variáveis'''

<dd>
Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:
<li> O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e nao ser mais que 8 caracteres</li>
<li> A variável deve estar associada a um produto ou uma tabela de preço</li>
<li> Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.</li>
<li> Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.

 
</dd>
'''Definição da formula de preço'''
 
<dd>
<li> Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.</li>
<li> Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.</li>
<li> Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.</li>

<li>Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.</li>

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

</dd>

== Processamento da Tabela ==
 

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001':

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}


As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpFc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+'''''

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar (requisito não funcional).

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T17:34:35Z

Leo2s: /* Histórico de Alterações */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio cliente consiga fazer esta composição. 
O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.


</dd>
== Implementação ==

O processo terá como bases os seguintes passos: 

1. Criação de Tabela; 

2. Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela); 
3. Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos; 
4. Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços. 

'''Cadastro tabela de preço'''
<dd> Para criação da tabela de preço, será criada uma tela para o usuário fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado. Ao entrar na tela o sistema deve apresentar campos de filtros, os quais o usuário poderá localizar um cadastro já inserido e realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela o acesso a realizar um novo cadastro os quais o usuário vai preencher os seguintes campos.

{| class="wikitable"
! Campo
! Tipo
! Utilização
|-
| Descrição || Texto || O campo de descrição é um texto que aceita no máximo 70 caracteres
|-
| Data inicial vigência || Data || O campo de data inicial irá determinar o início da vigência para tabela de preço
|-
| Data final vigência || Data || O campo de data final irá determinar o fim da vigência para tabela de preço
|-
|}

<li>Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar em seu intervalo de data validade, colocando a data final inferior a data atual;</li>
<li>Caso uma tabela de preço esteja com a data de validade vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;</li>
<li>Os campos de datas não serão obrigatórios, quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;</li>
<li>Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo. Sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utiliza os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.</li>
</dd>
'''Declaração de variáveis'''

<dd>
Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:
<li> O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e nao ser mais que 8 caracteres</li>
<li> A variável deve estar associada a um produto ou uma tabela de preço</li>
<li> Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.</li>
<li> Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.

 
</dd>
'''Definição da formula de preço'''
 
<dd>
<li> Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.</li>
<li> Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.</li>
<li> Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.</li>

<li>Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.</li>

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

</dd>

== Processamento da Tabela ==
 

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001':

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}


As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpFc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+'''''

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar (requisito não funcional).

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T17:33:53Z

Leo2s: /* Protótipos */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio cliente consiga fazer esta composição. 
O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.


</dd>
== Implementação ==

O processo terá como bases os seguintes passos: 

1. Criação de Tabela; 

2. Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela); 
3. Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos; 
4. Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços. 

'''Cadastro tabela de preço'''
<dd> Para criação da tabela de preço, será criada uma tela para o usuário fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado. Ao entrar na tela o sistema deve apresentar campos de filtros, os quais o usuário poderá localizar um cadastro já inserido e realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela o acesso a realizar um novo cadastro os quais o usuário vai preencher os seguintes campos.

{| class="wikitable"
! Campo
! Tipo
! Utilização
|-
| Descrição || Texto || O campo de descrição é um texto que aceita no máximo 70 caracteres
|-
| Data inicial vigência || Data || O campo de data inicial irá determinar o início da vigência para tabela de preço
|-
| Data final vigência || Data || O campo de data final irá determinar o fim da vigência para tabela de preço
|-
|}

<li>Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar em seu intervalo de data validade, colocando a data final inferior a data atual;</li>
<li>Caso uma tabela de preço esteja com a data de validade vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;</li>
<li>Os campos de datas não serão obrigatórios, quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;</li>
<li>Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo. Sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utiliza os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.</li>
</dd>
'''Declaração de variáveis'''

<dd>
Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:
<li> O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e nao ser mais que 8 caracteres</li>
<li> A variável deve estar associada a um produto ou uma tabela de preço</li>
<li> Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.</li>
<li> Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.

 
</dd>
'''Definição da formula de preço'''
 
<dd>
<li> Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.</li>
<li> Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.</li>
<li> Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.</li>

<li>Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.</li>

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

</dd>

== Processamento da Tabela ==
 

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001':

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}


As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpFc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+'''''

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar (requisito não funcional).

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T17:33:26Z

Leo2s: /* tabela Preço */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio cliente consiga fazer esta composição. 
O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.


</dd>
== Implementação ==

O processo terá como bases os seguintes passos: 

1. Criação de Tabela; 

2. Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela); 
3. Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos; 
4. Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços. 

'''Cadastro tabela de preço'''
<dd> Para criação da tabela de preço, será criada uma tela para o usuário fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado. Ao entrar na tela o sistema deve apresentar campos de filtros, os quais o usuário poderá localizar um cadastro já inserido e realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela o acesso a realizar um novo cadastro os quais o usuário vai preencher os seguintes campos.

{| class="wikitable"
! Campo
! Tipo
! Utilização
|-
| Descrição || Texto || O campo de descrição é um texto que aceita no máximo 70 caracteres
|-
| Data inicial vigência || Data || O campo de data inicial irá determinar o início da vigência para tabela de preço
|-
| Data final vigência || Data || O campo de data final irá determinar o fim da vigência para tabela de preço
|-
|}

<li>Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar em seu intervalo de data validade, colocando a data final inferior a data atual;</li>
<li>Caso uma tabela de preço esteja com a data de validade vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;</li>
<li>Os campos de datas não serão obrigatórios, quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;</li>
<li>Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo. Sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utiliza os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.</li>
</dd>
'''Declaração de variáveis'''

<dd>
Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:
<li> O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e nao ser mais que 8 caracteres</li>
<li> A variável deve estar associada a um produto ou uma tabela de preço</li>
<li> Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.</li>
<li> Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.

 
</dd>
'''Definição da formula de preço'''
 
<dd>
<li> Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.</li>
<li> Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.</li>
<li> Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.</li>

<li>Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.</li>

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

</dd>

== Processamento da Tabela ==
 

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001':

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}


As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpFc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+'''''

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar (requisito não funcional).

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

== Protótipos ==

[[Arquivo: 1200px-tela-de-cadastro-de-precificacao-mantiqueira.png|600px]]

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T17:32:53Z

Leo2s: /* Implementação */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio cliente consiga fazer esta composição. 
O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.


</dd>
== Implementação ==

O processo terá como bases os seguintes passos: 

1. Criação de Tabela; 

2. Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela); 
3. Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos; 
4. Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços. 

'''Cadastro tabela de preço'''
<dd> Para criação da tabela de preço, será criada uma tela para o usuário fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado. Ao entrar na tela o sistema deve apresentar campos de filtros, os quais o usuário poderá localizar um cadastro já inserido e realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela o acesso a realizar um novo cadastro os quais o usuário vai preencher os seguintes campos.

{| class="wikitable"
! Campo
! Tipo
! Utilização
|-
| Descrição || Texto || O campo de descrição é um texto que aceita no máximo 70 caracteres
|-
| Data inicial vigência || Data || O campo de data inicial irá determinar o início da vigência para tabela de preço
|-
| Data final vigência || Data || O campo de data final irá determinar o fim da vigência para tabela de preço
|-
|}

<li>Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar em seu intervalo de data validade, colocando a data final inferior a data atual;</li>
<li>Caso uma tabela de preço esteja com a data de validade vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;</li>
<li>Os campos de datas não serão obrigatórios, quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;</li>
<li>Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo. Sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utiliza os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.</li>
</dd>
'''Declaração de variáveis'''

<dd>
Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:
<li> O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e nao ser mais que 8 caracteres</li>
<li> A variável deve estar associada a um produto ou uma tabela de preço</li>
<li> Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.</li>
<li> Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.

 
</dd>
'''Definição da formula de preço'''
 
<dd>
<li> Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.</li>
<li> Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.</li>
<li> Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.</li>

<li>Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.</li>

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

</dd>

== Processamento da Tabela ==
 

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

== tabela Preço ==

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001':

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}


As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpFc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+'''''

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar (requisito não funcional).

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

== Protótipos ==

[[Arquivo: 1200px-tela-de-cadastro-de-precificacao-mantiqueira.png|600px]]

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T17:32:29Z

Leo2s: /* Declaração de variáveis */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio cliente consiga fazer esta composição. 
O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.


</dd>
== Implementação ==

O processo terá como bases os seguintes passos: 

1. Criação de Tabela; 

2. Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela); 
3. Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos; 
4. Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços. 

'''Cadastro tabela de preço'''
<dd> Para criação da tabela de preço, será criada uma tela para o usuário fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado. Ao entrar na tela o sistema deve apresentar campos de filtros, os quais o usuário poderá localizar um cadastro já inserido e realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela o acesso a realizar um novo cadastro os quais o usuário vai preencher os seguintes campos.

{| class="wikitable"
! Campo
! Tipo
! Utilização
|-
| Descrição || Texto || O campo de descrição é um texto que aceita no máximo 70 caracteres
|-
| Data inicial vigência || Data || O campo de data inicial irá determinar o início da vigência para tabela de preço
|-
| Data final vigência || Data || O campo de data final irá determinar o fim da vigência para tabela de preço
|-
|}

<li>Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar em seu intervalo de data validade, colocando a data final inferior a data atual;</li>
<li>Caso uma tabela de preço esteja com a data de validade vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;</li>
<li>Os campos de datas não serão obrigatórios, quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;</li>
<li>Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo. Sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utiliza os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.</li>

'''Declaração de variáveis'''

<dd>
Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:
<li> O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e nao ser mais que 8 caracteres</li>
<li> A variável deve estar associada a um produto ou uma tabela de preço</li>
<li> Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.</li>
<li> Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.

 
</dd>
'''Definição da formula de preço'''
 
<dd>
<li> Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.</li>
<li> Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.</li>
<li> Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.</li>

<li>Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.</li>

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

</dd>

== Processamento da Tabela ==
 

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

== tabela Preço ==

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001':

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}


As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpFc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+'''''

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar (requisito não funcional).

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

== Protótipos ==

[[Arquivo: 1200px-tela-de-cadastro-de-precificacao-mantiqueira.png|600px]]

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T17:31:13Z

Leo2s: /* Solução */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio cliente consiga fazer esta composição. 
O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.


</dd>
== Implementação ==

O processo terá como bases os seguintes passos: 

1. Criação de Tabela; 

2. Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela); 
3. Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos; 
4. Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços. 

'''Cadastro tabela de preço'''
<dd> Para criação da tabela de preço, será criada uma tela para o usuário fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado. Ao entrar na tela o sistema deve apresentar campos de filtros, os quais o usuário poderá localizar um cadastro já inserido e realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela o acesso a realizar um novo cadastro os quais o usuário vai preencher os seguintes campos.

{| class="wikitable"
! Campo
! Tipo
! Utilização
|-
| Descrição || Texto || O campo de descrição é um texto que aceita no máximo 70 caracteres
|-
| Data inicial vigência || Data || O campo de data inicial irá determinar o início da vigência para tabela de preço
|-
| Data final vigência || Data || O campo de data final irá determinar o fim da vigência para tabela de preço
|-
|}

<li>Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar em seu intervalo de data validade, colocando a data final inferior a data atual;</li>
<li>Caso uma tabela de preço esteja com a data de validade vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;</li>
<li>Os campos de datas não serão obrigatórios, quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;</li>
<li>A função de cadastro da tabela de preço está disponível no pacote Evolution.</li>
<li>Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo. Sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utiliza os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.</li>

== '''Declaração de variáveis''' ==

<dd>
Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:
<li> O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e nao ser mais que 8 caracteres</li>
<li> A variável deve estar associada a um produto ou uma tabela de preço</li>
<li> Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.</li>
<li> Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.

 
</dd>
'''Definição da formula de preço'''
 
<dd>
<li> Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.</li>
<li> Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.</li>
<li> Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.</li>

<li>Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.</li>

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

</dd>

== Processamento da Tabela ==
 

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

== tabela Preço ==

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001':

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}


As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpFc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+'''''

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar (requisito não funcional).

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

== Protótipos ==

[[Arquivo: 1200px-tela-de-cadastro-de-precificacao-mantiqueira.png|600px]]

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T17:30:42Z

Leo2s: /* tabela */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio cliente consiga fazer esta composição. 
O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.



=== Implementação ===

O processo terá como bases os seguintes passos: 

1. Criação de Tabela; 

2. Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela); 
3. Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos; 
4. Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços. 

'''Cadastro tabela de preço'''
<dd> Para criação da tabela de preço, será criada uma tela para o usuário fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado. Ao entrar na tela o sistema deve apresentar campos de filtros, os quais o usuário poderá localizar um cadastro já inserido e realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela o acesso a realizar um novo cadastro os quais o usuário vai preencher os seguintes campos.

{| class="wikitable"
! Campo
! Tipo
! Utilização
|-
| Descrição || Texto || O campo de descrição é um texto que aceita no máximo 70 caracteres
|-
| Data inicial vigência || Data || O campo de data inicial irá determinar o início da vigência para tabela de preço
|-
| Data final vigência || Data || O campo de data final irá determinar o fim da vigência para tabela de preço
|-
|}

<li>Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar em seu intervalo de data validade, colocando a data final inferior a data atual;</li>
<li>Caso uma tabela de preço esteja com a data de validade vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;</li>
<li>Os campos de datas não serão obrigatórios, quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;</li>
<li>A função de cadastro da tabela de preço está disponível no pacote Evolution.</li>
<li>Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo. Sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utiliza os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.</li>
</dd>

== '''Declaração de variáveis''' ==

<dd>
Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:
<li> O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e nao ser mais que 8 caracteres</li>
<li> A variável deve estar associada a um produto ou uma tabela de preço</li>
<li> Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.</li>
<li> Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.

 
</dd>
'''Definição da formula de preço'''
 
<dd>
<li> Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.</li>
<li> Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.</li>
<li> Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.</li>

<li>Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.</li>

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

</dd>

== Processamento da Tabela ==
 

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

== tabela Preço ==

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001':

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}


As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpFc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+'''''

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar (requisito não funcional).

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

== Protótipos ==

[[Arquivo: 1200px-tela-de-cadastro-de-precificacao-mantiqueira.png|600px]]

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T17:30:11Z

Leo2s: /* tabela */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio cliente consiga fazer esta composição. 
O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.



=== Implementação ===

O processo terá como bases os seguintes passos: 

1. Criação de Tabela; 

2. Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela); 
3. Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos; 
4. Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços. 

== tabela ==
<dd> Para criação da tabela de preço, será criada uma tela para o usuário fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado. Ao entrar na tela o sistema deve apresentar campos de filtros, os quais o usuário poderá localizar um cadastro já inserido e realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela o acesso a realizar um novo cadastro os quais o usuário vai preencher os seguintes campos.

{| class="wikitable"
! Campo
! Tipo
! Utilização
|-
| Descrição || Texto || O campo de descrição é um texto que aceita no máximo 70 caracteres
|-
| Data inicial vigência || Data || O campo de data inicial irá determinar o início da vigência para tabela de preço
|-
| Data final vigência || Data || O campo de data final irá determinar o fim da vigência para tabela de preço
|-
|}

<li>Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar em seu intervalo de data validade, colocando a data final inferior a data atual;</li>
<li>Caso uma tabela de preço esteja com a data de validade vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;</li>
<li>Os campos de datas não serão obrigatórios, quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;</li>
<li>A função de cadastro da tabela de preço está disponível no pacote Evolution.</li>
<li>Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo. Sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utiliza os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.</li>
</dd>

== '''Declaração de variáveis''' ==

<dd>
Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:
<li> O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e nao ser mais que 8 caracteres</li>
<li> A variável deve estar associada a um produto ou uma tabela de preço</li>
<li> Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.</li>
<li> Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.

 
</dd>
'''Definição da formula de preço'''
 
<dd>
<li> Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.</li>
<li> Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.</li>
<li> Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.</li>

<li>Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.</li>

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

</dd>

== Processamento da Tabela ==
 

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

== tabela Preço ==

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001':

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}


As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpFc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+'''''

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar (requisito não funcional).

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

== Protótipos ==

[[Arquivo: 1200px-tela-de-cadastro-de-precificacao-mantiqueira.png|600px]]

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T17:29:47Z

Leo2s: /* tabela */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio cliente consiga fazer esta composição. 
O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.



=== Implementação ===

O processo terá como bases os seguintes passos: 

1. Criação de Tabela; 

2. Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela); 
3. Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos; 
4. Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços. 

== tabela ==
Para criação da tabela de preço, será criada uma tela para o usuário fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado. Ao entrar na tela o sistema deve apresentar campos de filtros, os quais o usuário poderá localizar um cadastro já inserido e realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela o acesso a realizar um novo cadastro os quais o usuário vai preencher os seguintes campos.

{| class="wikitable"
! Campo
! Tipo
! Utilização
|-
| Descrição || Texto || O campo de descrição é um texto que aceita no máximo 70 caracteres
|-
| Data inicial vigência || Data || O campo de data inicial irá determinar o início da vigência para tabela de preço
|-
| Data final vigência || Data || O campo de data final irá determinar o fim da vigência para tabela de preço
|-
|}

<li>Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar em seu intervalo de data validade, colocando a data final inferior a data atual;</li>
<li>Caso uma tabela de preço esteja com a data de validade vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;</li>
<li>Os campos de datas não serão obrigatórios, quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;</li>
<li>A função de cadastro da tabela de preço está disponível no pacote Evolution.</li>
<li>Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo. Sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utiliza os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.</li>

== '''Declaração de variáveis''' ==

<dd>
Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:
<li> O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e nao ser mais que 8 caracteres</li>
<li> A variável deve estar associada a um produto ou uma tabela de preço</li>
<li> Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.</li>
<li> Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.

 
</dd>
'''Definição da formula de preço'''
 
<dd>
<li> Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.</li>
<li> Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.</li>
<li> Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.</li>

<li>Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.</li>

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

</dd>

== Processamento da Tabela ==
 

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

== tabela Preço ==

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001':

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}


As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpFc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+'''''

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar (requisito não funcional).

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

== Protótipos ==

[[Arquivo: 1200px-tela-de-cadastro-de-precificacao-mantiqueira.png|600px]]

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T17:29:30Z

Leo2s: /* Implementação */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/10/2020 || Ana Júlia || Criação do documento
|-
| 01/04/2021 || João Ramon || Atualização do documento
|-
|}

== Necessidade ==

No processo de formação de preços, conta-se com um número definido de variáveis que irão fazer a composição do valor final que será apresentado ao cliente final. Informações como custos operacionais, inclusão de markups, fatores de compensação por quebra e/ou comissionamento de venda devem estar contemplados na composição dos preços. A empresa deseja fazer esta composição dentro da Plataforma GeoSales EVO, inserindo todas as informações de custo, taxas e demais dados customizáveis, permitindo que o próprio cliente consiga fazer esta composição. 
O cenário de precificação atual não possui um processo uniformizado para cada cliente. Portanto, a necessidade de criar um processo padronizado para composição de preços, assim como a atualização customizável de algumas dessas variáveis, por se tratarem de variáveis cujos valores podem oscilar por motivos externos (oscilações de mercado, variação na política de preços, etc), é imperativa.

== Solução ==

Visto que a formação de preços, e seu processo de elaboração, devem ser totalmente customizáveis pelo cliente, primeiramente deve ser possível que ele não apenas determine quais as variáveis e seus respectivos valores devem ser atribuídos na plataforma para precificação, mas também como estas variáveis se relacionarão matematicamente, a fim de formular um preço baseado nas entradas fornecidas pelo cliente. Além disso, tais variáveis, uma vez inseridas no cadastro de preços, deverão ser passíveis de edição, feitas pelo próprio cliente, de forma manual.

Como instrumento de parametrização das fórmulas contendo as variáveis criadas e seus operadores apropriados, será utilizada a '''''notação polonesa reversa (RPN)''''', ferramenta de uso familiar a pessoas ligadas ao trabalho que envolva matemática financeira. Assim, a formação de preço deverá ser mais flexível e intuitiva na sua formação, além de facilitar em eventuais futuras modificações. As formulas serão definidas dentro de uma tabela de preço para um determinado grupo de produto facilitando o cadastro.

Também visando a facilidade da manutenção dos valores de cada variável da fórmula, iremos construir o preço por um conjunto de parâmetros, podendo ser definido de forma atrelada às seguintes dimensões: produto e tabela de preço.

Após a definição dos parâmetros, a fórmula será construída por meio da utilização destes. Finalizando esta etapa, basta pedir para processar a tabela, onde a mesma passará a ser vigente para a equipe de venda.



=== Implementação ===

O processo terá como bases os seguintes passos: 

1. Criação de Tabela; 

2. Definição de Variáveis que deverão compor a fórmula de criação de preço, além da definição do atributo a qual tal variável está vinculada (produto ou Tabela); 
3. Definição de fórmula de formação de preços, utilizando RPN, e vinculações a grupos de produtos; 
4. Concluída a fórmula, com as relações operacionais entre as variáveis, os valores gerados devem ser processados para compor a Tabela de Preços. 

== tabela ==
Para criação da tabela de preço, será criada uma tela para o usuário fazer o cadastro da tabela de preço. Nela será possível fazer a inserção e edição de cadastros, não sendo possível excluir qualquer cadastro de tabela de preço já realizado. Ao entrar na tela o sistema deve apresentar campos de filtros, os quais o usuário poderá localizar um cadastro já inserido e realizar edição dos campos descrição e datas inicial e final de vigência. Além, disso no rodapé da tela o acesso a realizar um novo cadastro os quais o usuário vai preencher os seguintes campos.

{| class="wikitable"
! Campo
! Tipo
! Utilização
|-
| Descrição || Texto || O campo de descrição é um texto que aceita no máximo 70 caracteres
|-
| Data inicial vigência || Data || O campo de data inicial irá determinar o início da vigência para tabela de preço
|-
| Data final vigência || Data || O campo de data final irá determinar o fim da vigência para tabela de preço
|-
|}

<li>Uma tabela de preço não poderá ser excluída, só poderá ser desativada ou ativada através dos campos de data inicial e data final. Para desativar, basta colocar em seu intervalo de data validade, colocando a data final inferior a data atual;</li>
<li>Caso uma tabela de preço esteja com a data de validade vencida, a tabela de preço não será exibida para seleção no cadastro do pedido;</li>
<li>Os campos de datas não serão obrigatórios, quando não estiverem preenchidos, indica que aquela tabela estará disponível para uso;</li>
<li>A função de cadastro da tabela de preço está disponível no pacote Evolution.</li>
<li>Não será possível utilizar a integração e cadastro da tabela de preço ao mesmo tempo. Sendo necessário que haja uma única escolha: Integrar a tabela de preço do ERP ao GeoSales ou cadastrar a tabela de preço no próprio GeoSales. Caso tentem utiliza os dois cadastros ao mesmo tempo ERP e GeoSales, a integração apagará todos os registros cadastrados no GeoSales.</li>

'''Declaração de variáveis'''

<dd>
Dentro da tela de Variáveis de preço, deve ser possível definir uma variável de forma livre, mas que atenda as seguintes regras:
<li> O campo chave, que será utilizado como referência na formula de preço, não deve conter caracteres especiais, espaço em branco e nao ser mais que 8 caracteres</li>
<li> A variável deve estar associada a um produto ou uma tabela de preço</li>
<li> Para valores do tipo '''numérico (18,6)''', serão aceitos como possibilidade, podendo ser positivos ou negativos.</li>
<li> Será criado um log de históricos de alterações de valores destas variáveis e passível de ser exportado em relatórios em excel.

 
</dd>
'''Definição da formula de preço'''
 
<dd>
<li> Será necessário selecionar uma tabela de preço, a organização de venda e um ou mais produtos aos quais o preço deve ser inserido.</li>
<li> Para a regra de preço teremos que informar a '''formula''' do preço mínimo, sugerido e máximo com a quantidade mínima, que valida sua aplicação.</li>
<li> Nos campos de preço (mínimo, sugerido e máximo) teremos um espaço para a inserção da fórmula para composição de preço. Esta fórmula fará a relação matemática entre as variáveis criadas no processo anterior, por meio de '''operadores matemáticos (+, -, *, / )''', organizados em '''RPN''', notação comum para analistas financeiros, sendo bastante difundido, inclusive, na lógica de cálculo das calculadoras HP 12 C.</li>

<li>Será possível visualizar uma prévia da fórmula escrita, além do valor encontrado, a fim de que o usuário possa confirmar os valores que foram inseridos pelas variáveis e seus respectivos operadores.</li>

Como exemplo de notação polonesa reversa, tomemos a expressão '''''(A+B)*C'''''. Em RPN, a notação ficaria '''''AB+C*'''''.

</dd>

== Processamento da Tabela ==
 

É importante frisar que os valores estão vinculados a uma tabela de preços, que consequentemente está vinculada a um cliente, organização de vendas, vendedores, e tabelas afins.

As variáveis comuns a todos os clientes deverão ter valores diferenciados de acordo com a cidade onde a organização de vendas está alocada.
Há dois grupos de variáveis: aquelas que são relacionadas ao '''produto''' em si (tamanho, cor, embalagem, Tipo) e aquelas relacionadas à '''Tabela''' (Valor de partida, comissão promotor, frete, por exemplo). É importante determinar corretamente para qual grupo tal variável estará vinculada.

Se mais de um produto possui a mesma característica, será possível fazer a precificação por grupos de produtos.

== tabela Preço ==

=== Cenário 1 ===

Elaborando o preço do produto 'P001' para o cliente 'C001':

Enumeração das variáveis 

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 106,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 0,00 || Tabela
|-
| Pr || Promotor || 1,02 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,02 || Tabela
|}


As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpFc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo, a fórmula irá apresentar o valor final: '''"R$ 86,21"'''.

=== Cenário 2 ===

Realizando o cadastro de preço do produto 'P002' para o cliente 'C002'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ 3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 12,20 || Produto
|-
| Fr || Frete || R$ 3,00 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1,11 || Tabela
|-
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Fr+Pr*Qu*Cf*'''''

Ao final do processo de cálculo da fórmula, o valor do preço será '''"R$ 100,86"'''.

=== Cenário 3 ===

Realizando o cadastro de preço do produto 'P003' para o cliente 'C003'

{|class = "wikitable"
! Variável
! Descrição da Variável
! Valor
! Tipo Grupo
|-
| Pp || Preço de Partida || R$ 110,50 || Tabela
|-
| P1 || Adicional de Preço || R$ -3,00 || Tabela
|-
| Fc || Fator de Conversão || 1,5 || Produto
|-
| Ce ||Custo de Embalagem || R$ 8,67 || Produto
|-
| Ce2 || Custo de Embalagem 2 || R$ 2,00 || Produto
|-
| Fr || Frete || R$ 2,5 || Tabela
|-
| Pr || Promotor || 1 || Tabela
|-
| Qu || Fator Quebra || 1 || Tabela
|-
| Cf || Contrato de Fidelidade || 1 || Tabela
|-
| K || Constante || 23,67 || Tabela
|}



As variáveis estão relacionadas matematicamente de acordo com a notação: 

'''''P= PpP1+Fc/Ce+Ce2+Fr+Pr*Qu*Cf*K+'''''

Ao final do cálculo da forma, o valor final do preço será: '''"R$ 108,50"'''.



A composição de preço tem como objetivo construir um preço de venda. Esse cadastro conta com tipos de variáveis para compor preço. Para que a composição de preço seja aplicada corretamente no cadastro do pedido, é necessário que as seguintes premissas sejam atendidas.

=== Composição de preço ===

Visto que há variação de preços de produtos para diferentes localidades, a formula criada para a composição de preços deverá, além de compor toda a regra de cálculo de precificação de determinado produto, a sua parametrização vinculada ao seu respectivo Estado, Cidade e Filial. 

Em outras palavras, através da composição de preço, o usuário poderá informar a fórmula que o sistema irá aplicar para definir o preço unitário do produto. Essa regra poderá ser parametrizado por: filial, estado e cidade.

== Regras de Negócios ==

'''[RN1] - ''' Não poderá conter a mesma regra para o mesmo estado e filial;

'''[RN2] - ''' Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

'''[RN3] - ''' Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

'''[RN4] - ''' Durante o processo, o portal não deverá travar (requisito não funcional).

'''[RN5] - ''' Os históricos do log de alterações das variáveis ficarão registrados por um período de 1 (um) ano.

'''[RN6] - ''' Um determinado produto poderá ser vinculado a mais de um grupo, mas a quantidade deve ser diferente.

== Protótipos ==

[[Arquivo: 1200px-tela-de-cadastro-de-precificacao-mantiqueira.png|600px]]

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

{| class="wikitable"
! 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 ||
|-
|}

Precificação

2021-04-08T17:06:00Z

Leo2s: /* Implementação */

Precificação

2021-04-08T17:00:10Z

Leo2s: /* Implementação */

Precificação

2021-04-08T16:59:30Z

Leo2s: /* Implementação */

Precificação

2021-04-08T16:58:56Z

Leo2s: /* Implementação */

Precificação

2021-04-08T16:58:36Z

Leo2s: /* Implementação */

Precificação

2021-04-08T16:48:32Z

Leo2s: /* Implementação */

Precificação

2021-04-08T16:45:57Z

Leo2s: /* Implementação */