Valor de frete por obra

Histórico de Alterações

Data	Quem	Comentários
10/09/2018	Ana Júlia	Criação do documento
12/09/2018	Ryvane Maria	Ajustes no documento

Necessidade

Na construção da faixa de preço do produto existe uma alteração no preço de um mesmo produto, para situações diferentes. Essa diferenciação ocorre quando é selecionado o tipo de frete (CIF ou FOB), ou quando é selecionada, além do tipo de frete, uma obra. Além disso, o preço é diferenciado também de acordo com a filial (organização de venda) selecionada.

Nesta situação, uma obra é o local onde os produtos inseridos no pedido serão utilizados, ou seja, onde é necessário que esse pedido seja entregue. As informações de obra, por sua vez, se referem ao endereço da obra em que será entregue o pedido.

Existem cenários distintos para composição do valor do produto. Existem alguns cenários onde o preço do produto pode ser modificado. Esses cenários envolvem parâmetros como o tipo de frete (CIF ou FOB) e a obra (caso se aplique).

Para os tipos de frete CIF ou FOB em que não é selecionado a obra, é levado em consideração um determinado valor para o produto. Quando for selecionado os tipos de frete CIF ou FOB, além de uma obra de destino, é considerado um outro valor para a faixa de preço. Ou seja, existem formas de construção de preço distintas para um mesmo produto.

Tendo em vista as situações de formação de preço distintas, é necessário associar os dados das tabelas de preço cadastradas no ERP com as informações selecionadas pelo usuário no momento do cadastro do pedido, trazendo então o valor de preço correto para cada situação descrita.

Solução

Inicialmente, para que o valor do produto seja corretamente aplicado, de acordo com o tipo de frete, a filial e a obra selecionada, os valores possíveis para um produto deverão ser trazidos do ERP para o GeoSales através da integração de dados.

A partir dos diferentes valores para um determinado produto (de acordo com o frete e a obra selecionada), será definido um valor padrão que será utilizado como base de cálculo para que sejam aplicados descontos ou acréscimos, de forma a resultar nos diferentes valores para um mesmo produto.

Por exemplo, caso seja definido que o valor padrão para o produto é o valor aplicado quando selecionado o tipo de frete CIF, sem obra. A partir do valor do produto nessa situação (frete CIF sem obra), serão aplicados descontos ou acréscimos para que esse valor alcance os valores adotados para outras situações (frete FOB sem obra, frete CIF com obra e frete FOB com obra).

Ao passo da seleção de um tipo de frete e de uma obra, no momento do cadastro do pedido, o valor padrão do produto será definido, e sob ele serão aplicados os descontos ou acréscimos necessários, de acordo com a seleção do tipo de frete e de uma obra.

Para que isso seja possível, serão definidos dois tipos de desconto, um categorizado por cliente, produto e frete, e outro categorizado por cliente, produto, frete e obra. Desta forma, a manipulação do valor padrão a ser definido resultará em todos os outros valores possíveis para um mesmo produto.

Implementação

Desenvolvimento

- Criar e popular tabelas de desconto:

Como proposto na solução, desconto serão aplicados para definir o preço final de um produto.

Com a finalidade de aplicar descontos ou acréscimos de forma a construir o preço final do produto, serão utilizadas duas tabelas de desconto, a tabela DESCONTO_CLIENTE_PRODUTO_FRETE será aplicada quando o usuário selecionar um frete, sendo ele CIF ou FOB, e não selecionar uma obra. Nesta tabela está parametrizado o percentual de desconto a ser aplicado por cliente, produto, filial (organização de venda) e frete.

Além disso, deverá ser criada a tabela DESCONTO_CLIENTE_PRODUTO_FRETE_OBRA (com estrutura definida na aba de "estrutura de banco"), que irá ser aplicada quando o usuário selecionar um frete, sendo ele CIF ou FOB, e uma obra. Nesta tabela está parametrizado o percentual de desconto a ser aplicado por cliente, produto, filial (organização de venda), frete e obra.

- Vincular uma filial :

Atualmente as informações de vínculos de cliente e filial para calcular frete não estão sendo enviadas ao GeoSales, ou seja, para que o frete seja calculado, as vinculações de cliente e filial por frete, deverão ser integrados.

- Como deverá funcionar

O valor do frete deverá se basear de acordo com os parâmetros integrados por: cliente, filial e obra. Caso o cliente não possua obra, na tabela CLIENTE_OBRA, o sistema deverá considerar a faixa de preço do cliente e filial. Porém, se o cliente estiver associado a uma filial e obra, o sistema deverá aplicar o valor da faixa de preço da obra.

Integração

O frete se encontra dividido em dois tipos: CIF e FOB. Para que o GeoSales consiga tratar o calculo de frete de acordo com a hierarquia de frete, deverá ser realizada a integração da tabela FRETE.

TABELA DE FRETE
DESCRIÇÃO	TABELA - GEOSALES	CAMPO - GEOSALES	TABELA - ERP	CAMPO - ERP
Código do frete	FRETE	CD_FRETE	SZI020	ZI_FILIAL + ZI_CLIENTE + ZI_LOJA
Filial	FRETE	CD_ORG_VENDA	SZI020	ZI_FILIAL
Região cliente	FRETE	CD_REGIAO	-	-
Praça cliente	FRETE	CD_PRACA	-	-
Código do cliente	FRETE	CD_CLIENTE	SZI020	ZI_CLIENTE + ZI_LOJA

- Cliente que possuir filial, mas não obra

Caso o cliente possua vinculo com filial, mas não possua vinculo com obra, e o tipo de frete selecionado for CIF ou FOB, o sistema deverá levar em consideração os seguintes dados de preço:

TABELA ERP	CAMPO ERP	TIPO FRETE
SZI	ZI_PRECO	CIF
SZI	ZI_PRECOF	FOB

- Cliente que possua filial e obra

Caso o cliente possua filial e obra, ou seja, esteja na tabela CLIENTE_OBRA e tabela FRETE, o sistema deverá considerar a tabela de preço cadastrada para a obra.

Nessas condições o sistema deverá levar em consideração os seguintes vínculos de preço:

TABELA ERP	CAMPO ERP	TIPO FRETE
ZA2	ZA2_PRC01	CIF
ZA2	ZA2_PRC01F	FOB

Estrutura de banco

DESCONTO_CLIENTE_PRODUTO_FRETE_OBRA
Coluna	Tipo	Obrigatório	Chave Primária	Explicação
CD_ORG_VENDA	Varchar(20)	Sim	Não	Código da organização de venda
CD_CLIENTE	Int	Sim	Não	Código do cliente
CD_PRODUTO	Int	Sim	Não	Código do produto
ID_TIPO_FRETE	Varchar(1)	Sim	Não	Tipo de frete
PR_DESCONTO	Decimal(18,6)	Sim	Não	Percentual de desconto
CD_OBRA	Int	Sim	Não	Código da obra

Regras de Negócios

[RN1] - Decomposição de preço.

[RN2] - Para que seja exibido o valor do frete por obra e por cliente, deverá existir dados da na tabela CLIENTE_OBRA, caso não exista dados o sistema levará em consideração a tabela frete, que conterá dados do cliente e filial, ou seja, o valor do frete se dará de acordo com o cliente e filial selecionados.

[RN3] -

Regras de Integração

[RI1] - Caso não exista dados de preço por obra na tabela CLIENTE_OBRA, ou cliente e filial na tabela FRETE, o sistema não calculará valores de frete CIF ou FOB.

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
Integração - GeoSales	Rilston Soares	11/09/2018

Empresa solicitante

Setor	Aprovado Por	Data	Assinatura
Gerente TI - Cliente
Gerente de Projeto - Cliente
Gerente Comercial - Cliente