Verba contratual por Cliente II
Histórico de Alterações
| Data | Quem | Comentários |
|---|---|---|
| 28/04/2021 | João Ramon | Criação do documento |
Necessidade
A verba contratual constitui num retorno de crédito financeiro ao cliente proporcional ao fluxo de pedidos realizados. À medida que os pedidos são feitos, um percentual é visualizado ao valor total do produto. Esse percentual será convertido em crédito ao cliente final, ou assumirá outro uso em forma de benefício financeiro de retorno para o cliente.
Atualmente, a plataforma GeoSales EVO apenas apresenta este percentual, no momento da finalização dos pedidos. Em seguida, segue para a ERP do cliente para os tramites posteriores, mas esta verba não é parte integrante do valor do pedido. Por essa razão, é necessário que a verba contratual, uma vez cadastrada na tela apropriada, não apenas seja visualizada na tela de pedidos, mas que seja também inserido como parâmetro de composição dos valores dos produtos, sendo parte integrante do valor apresentado no momento da venda.
Solução
Uma vez que a verba esteja devidamente cadastrada em um determinado cliente, e selecionado o flag de ativação, no momento da formação do pedido, o valor correspondente à verba estará visível nas informações de verbas. Visto que o valor apresentado será uma conversão em bonificações para o cliente final (crédito, desconto em novo pedido, etc), o valor do total do pedido sofrerá esse desconto. A solução apresentada é que, no momento da criação do pedido, o valor desta verba seja utilizado na parametrização dos valores dos produtos dentro daquele pedido.
Implementação
- O valor da verba deverá constituir como parâmetro de formação de preço do produto.
- Quando o flag de ativação de verba estiver positivo, significa que a verba contratual estará ativada e o percentual inserido pelo usuário para um determinado cliente deverá estar vinculado aos parâmetros de composição dos produtos daquele cliente, segundo fórmula de adição de verba contratual, abaixo descrita.
- O valor de verba incidirá sobre o Preço de Venda o Preço de faturamento, dependendo da política comercial do cliente.
O valor inserido na tela de verba contratual e vinculado ao cliente será adicionado ao valor de produto respeitando as seguintes regras:
- A composição do valor final adicionado de verba consiste na relação entre o valor do pedido original e do percentual da verba indicado no sistema, atendendo à seguinte relação:
Valor com verba = valor do produto + valor percentual da verba
- Portanto, para uma verba 'V' de percentual fixo, e um valor de produto 'Vp', o valor adicionado de verba 'Vv' será:
Vv = Vp / (1 - V/100) ou, pela sua RPN
Vv = V 100 / 1 - Vp / - Ao realizar um pedido, na seleção dos produtos, o valor a ser apresentado será o valor do produto já com o acréscimo de verba;
Cenários
Consideremos para a composição dos cenários as seguintes informações, considerando um cliente C001:
Tabela de produtos
| Nome do produto | CD_produto | Valor produto |
|---|---|---|
| Produto 1 | P001 | R$ 100,00 |
| Produto 2 | P002 | R$ 200,00 |
| Produto 3 | P003 | R$ 300,00 |
Tabela de Verbas cadastradas
| Nome do Cliente | percentual da verba (%) - v | ID_ativo |
|---|---|---|
| C001 | 10 | S |
| C001 | 20 | S |
| C001 | 30 | N |
Cenário 1 - Descrição de um pedido genérico, com verba de 10% (Situação atual)
| composição do pedido | valor dos produtos | percentual da verba |
|---|---|---|
| P001 | 100,00 | 10 |
| P002 | 200,00 | 10 |
| P003 | 300,00 | 10 |
Este é o cenário atual. Os valores dos produtos são apresentados da forma em que foram formulados e a verba é exibida apenas para efeito de conhecimento. Atualmente, o valor total do pedido será R$ 600,00.
Após o envio do pedido à ERP, o valor da verba será deduzido do pedido, ficando da seguinte forma:
| composição do pedido | valor dos produtos | percentual da verba | valor após a retirada da verba |
|---|---|---|---|
| P001 | 100,00 | 10 | 90,00 |
| P002 | 200,00 | 10 | 180,00 |
| P003 | 300,00 | 10 | 270,00 |
Portanto, R$ seriam retirados R$ 60,00 do valor da venda, totalizando R$ 540,00.
Cenário 2 - Descrição de um pedido genérico, com verba de 10% (Situação desejada)
| composição do pedido | valor dos produtos | percentual da verba | Valor com inclusão da verba | valor com retirada de verba após integração |
|---|---|---|---|---|
| P001 | 100,00 | 10 | 110,00 | 99,00 |
| P002 | 200,00 | 10 | 220,00 | 198,00 |
| P003 | 300,00 | 10 | 330,00 | 297,00 |
Nota-se que, ao fazer a dedução inversa da verba no pedido, há perda no valor total do produto, explicando a necessidade da utilização da fórmula de verba para corrigir esta falha.
| composição do pedido | valor dos produtos | percentual da verba | valor com inclusão de verba | Valor com retirada de verba após integração |
|---|---|---|---|---|
| P001 | 100,00 | 10 | 111,11 | 100,00 |
| P002 | 200,00 | 10 | 222,22 | 200,00 |
| P003 | 300,00 | 10 | 333,33 | 300,00 |
Este é o cenário desejado. Os valores dos produtos são apresentados conforme descrito na coluna 'valor com inclusão de verba'. Neste caso, o valor final do pedido será R$ 666,66 (ao descontar 10% deste total, teremos os R$ 600,00 originais do pedido).
Cenário 3 - Descrição de um pedido genérico, com verba de 20% (Situação atual)
| composição do pedido | valor dos produtos | percentual da verba |
|---|---|---|
| P001 | 100,00 | 20 |
| P002 | 200,00 | 20 |
| P003 | 300,00 | 20 |
Este é o cenário atual. Os valores dos produtos são apresentados da forma em que foram formulados e a verba é exibida apenas para efeito de conhecimento. Atualmente, o valor total do pedido será R$ 600,00
Cenário 4 - Descrição de um pedido genérico, com verba de 20% (Situação desejada)
| composição do pedido | valor dos produtos | valor da verba | valor com inclusão de verba |
|---|---|---|---|
| P001 | 100,00 | 20 | 125,00 |
| P002 | 200,00 | 20 | 250,00 |
| P003 | 300,00 | 20 | 375,00 |
Este é o cenário desejado. Os valores dos produtos são apresentados conforme descrito na coluna 'valor com inclusão de verba'. Neste caso, o valor final do pedido será R$ 750,00. (ao descontar os 20% deste total, teremos os R$ 600,00 originais do pedido).
Cenário 5 - Descrição de um pedido genérico, com verba de 30% (Situação atual)
- Notemos que, de acordo com a tabela, o id de ativação está com status 'N', o que significa que a verba não deverá ser aplicada.
| composição do pedido | valor dos produtos | percentual da verba |
|---|---|---|
| P001 | 100,00 | 30 |
| P002 | 200,00 | 30 |
| P003 | 300,00 | 30 |
Este é o cenário atual. Os valores dos produtos são apresentados da forma em que foram formulados e a verba é exibida apenas para efeito de conhecimento. Atualmente, o valor total do pedido será R$ 600,00.
Cenário 6 - Descrição de um pedido genérico, com verba de 30% (Situação desejada)
- Notemos que, de acordo com a tabela, o id de ativação está com status 'N', o que significa que a verba não deverá ser aplicada. Para este cenário, vamos considerar que o id de ativação está com o status 'S', a fim de compreendermos melhor o quadro.
| composição do pedido | valor dos produtos | valor da verba | valor com inclusão de verba |
|---|---|---|---|
| P001 | 100,00 | 30 | 142,85 |
| P002 | 200,00 | 30 | 285,71 |
| P003 | 300,00 | 30 | 428,57 |
Este é o cenário desejado. Os valores dos produtos são apresentados conforme descrito na coluna 'valor com inclusão de verba'. Neste caso, o valor final do pedido será R$ 857,13 (ao descontar os 30% deste total, teremos os R$ 600,00 originais do pedido).
Regras de Negócios
[RN1] - O percentual da verba será inserida no valor do produto por meio da relação Vv = Vp / (1 - V / 100);
[RN2] - Não deverá haver sobreposição de cadastros na tela de criação de verbas, 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.
Aprovação
Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.
GeoSales
| Setor | Aprovado Por | Data |
|---|---|---|
| Desenvolvimento - GeoSales | Pessoa que aprovou | 00/00/0000 |
| Integração - GeoSales | Pessoa que aprovou | 00/00/0000 |
| Configurações - GeoSales | Pessoa que aprovou | 00/00/0000 |
Empresa solicitante
| Setor | Aprovado Por | Data | Assinatura |
|---|---|---|---|
| Gerente TI - Cliente | Pessoa que aprovou | 00/00/0000 | |
| Gerente de Projeto - Cliente | Pessoa que aprovou | 00/00/0000 | |
| Gerente Comercial - Cliente | Pessoa que aprovou | 00/00/0000 |