Cálculo de frete por quilometragem

Histórico de Revisões

Data	Quem	Comentários
16/04/2018	Ryvane Maria	Criação do Documento
23/04/2018	Luan Lima	Validado pelo desenvolvimento
17/10/2018	Ryvane Maria	Inclusão da obrigatoriedade do campo quilometagem

Necessidade

No momento da tiragem do pedido é calculado o valor de frete para aquele pedido. Porém, esse cálculo de valor de frete não leva em consideração a quantidade de volumes, o preço da tonelada do frete e a quilometragem total do percurso, como é feito atualmente pela SERVENG.

Para que o cálculo de frete do GeoSales seja adaptado ao cálculo de frete da Serveng é necessário incluir, no momento do cadastro do pedido, um campo onde o vendedor possa digitar a quilometragem que será percorrida na entrega.

Capturada a informação de quilometragem e do preço da tonelada do frete, o valor total do frete deve resultar da multiplicação das três informações: quantidade de volumes, preço da tonelada do frete e quilometragem total do percurso.

Solução

Para que o cálculo do frete seja feito devidamente, serão realizadas modificações na tela de pedido, de forma que atenda as necessidades descritas.

Inicialmente, será inserido na tela de pedido, no pop-up onde o usuário cadastra o endereço de entrega, um campo para que seja inserido a informação de quilometragem.

Além disso, será trazida do ERP a variável “preço da tonelada do frete”, via integração, para que esta variável também componha o cálculo de frete.

Capturadas todas as informações necessárias, o seguinte cálculo será realizado:

Frete = (quantidade*peso unitário)* distância(km) * preço da tonelada do frete

Após o cálculo realizado, será apresentado o resultado do frete na tela de pedido, no pop-up Resumo do pedido.

Implementação

O campo distância(km) estará disponível para preenchimento no momento do cadastro do endereço de entrega, e será inserido na mesma pop-up onde o vendedor insere o endereço de destino daquele pedido, que pode ser visualizada na imagem abaixo:

Nesta tela deverá ser criado um novo campo chamado "Distância em quilômetros", onde o usuário deverá inserir o valor em quilômetros da distância do endereço de entrega. A informação digitada será utilizada para compor o cálculo de frete.

A informação do campo "Distância em quilômetros" deverá ser salva no campo QT_QUILOMETROS_ENTREGA da tabela PEDIDO.

Este campo não deve aceitar letras, caracteres especiais(somente vírgulas),ou números negativos. Essas são as únicas validações que serão feitas pelo GeoSales, e a informação digitada neste campo será de responsabilidade exclusiva do usuário. Este campo deverá ser preenchido sempre que o usuário informar um novo endereço de entrega.

É importante salientar que o campo 'Distância em quilômetros' tem preenchimento obrigatório caso o usuário informe um endereço de entrega. Para que isso seja possível, deverá ser criada a configuração ID_EXIGE_DISTANCIA_QUILOMETROS com a finalidade de tornar obrigatório o campo 'Distância em quilômetros', essa configuração pode assumir os valores 'S', para tornar o campo obrigatório, 'N', para tornar o campo não obrigatório, sendo seu valor nulo 'N'.

Além da distância em quilômetros é necessário, também, obter a informação do “preço da tonelada do frete”. Essa informação deverá ser inserida, no ERP, através do campo VR_PRECO_KG da tabela FRETE, que salvará a informação de preço de carregamento por tonelada. É importante salientar que será necessário realizar a conversão Tonelada x Quilos.

Essa informação, cadastrada no ERP, será trazida via integração, como já ocorre atualmente, para o GeoSales.

Mediante a captura dessas informações, o frete será calculado de acordo com a seguinte equação:

Frete = (quantidade*peso unitário) * distância(km) * preço da tonelada do frete.

O valor total resultante do cálculo acima será exibido no resumo do pedido. Clicando no botão "Resumo do Pedido", o usuário visualiza a seguinte tela:

A informação do valor final do cálculo do frete será exibida nesta tela, e carregada no campo "Valor Frete".

Tabelas a serem alteradas:

PEDIDO
Coluna	Tipo	Obrigatório	Chave Primária	Explicação
QT_QUILOMETROS_ENTREGA	DECIMAL(18,6)	NAO	NAO	Distância em quilometros percorridos na entrega

Integração

PENDÊNCIAS DE INTEGRAÇÃO NO CÁLCULO DE FRETE POR QUILOMETRAGEM

- Onde iremos capturar a informação de preço da tonelada do frete no ERP? -

Regras de Negócio

RN1 - Os dados do campo de quilometragem são de responsabilidade do usuário, e o GeoSales não validará essa informação.

RN2 - O campo de distância(km) é essencial para que o cálculo de frete customizado seja realizado corretamente,caso o campo não seja informado, o sistema irá considerar o valor '0km', aplicando a fórmula sem essa variável.

RN3 - O valor final do frete do pedido será definido pela soma de cálculo de frete individual de todos os itens do pedido.

RN4 - O valor do frente irá ser somado ao valor final do pedido. Porém, não irá influenciar no valor unitário dos itens, ou seja, não serão aplicados impostos sob o valor do frete.

RN5 - A variável “preço da tonelada do frete” será extraída da tabela de preço que está vinculada ao produto. Essa informação deverá ser cadastrada no ERP na tabela FRETE, no campo VR_PRECO_KG.

RN6 - Para que o campo 'Distância em quilômetros' tenha preenchimento obrigatório, a configuração ID_EXIGE_DISTANCIA_QUILOMETROS deve estar ativada.

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.

Setor	Aprovado Por	Data	Assinatura
Gerente TI
Gerente Projeto
Gerente Comercial