Exibir código-fonte para Faixa de valor de frete

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem 
! Comentários 
|-
| 21/11/2018  || Ryvane Maria || Criação do documento
|-
|}

== Necessidade ==

Serão integrados do ERP, também, e tratados no GeoSales, a faixa de valor de frete a serem aplicadas. O cálculo de frete será dado levando em consideração o valor total do pedido. Serão aplicadas faixas de valores para que, a partir do valor total do pedido, seja definido um percentual a ser aplicado sob este valor, de forma a compor o valor final do frete. As faixas de valores do pedido, bem como o percentual a ser aplicado para cada faixa, será definido exclusivamente no DataSul e integrados ao GeoSales. É importante salientar que o valor do frete irá compor o valor do produto. Sendo assim, os tributos calculados irão ser, consequentemente, aplicados sob esse valor diluído item a item.

== Solução ==

Será criada no Geosales uma nova estrutura de componente de valorização de frete por faixa de valor do pedido. Este componente será utilizado para compor o valor do frete aplicado sob o valor final do pedido.

Este novo componente de formação de frete será criado de forma que possa ser aplicado o percentual sob valor do pedido, para compor o cálculo de frete baseando-se nas informações de estado, cidade, organização de venda, canal de venda e tipo de frete.

== Implementação ==

=== Desenvolvimento ===

'''- Criar novo componente de frete:'''

Inicialmente, deverá ser criado um novo componente de cálculo de frete, para que seja possível determinar o frete baseando-se na faixa de valor do pedido. É importante salientar que este novo componente não deve influenciar ou ser influenciado pelos componentes de frete já existentes no Geosales. Além disso, deve ser permitido utilizar, além desse componente, outros componentes de cálculo de frete existentes no GeoSales.

'''- Integrar informações de parametrização de faixa de frete:'''

Para que as devidas validações sejam feitas no GeoSales, será necessário integrar as informações de cadastros, trazendo-as do DataSul para o GeoSales, e desta forma, parametrizando as faixas de valores para cálculo de frete. 

Os dados de estado, cidade, faixa de valor do pedido mínima, organização de venda, canal de venda, tipo de frete e percentual de aplicação, deverão ser parametrizados no ERP DataSul e serão buscados a partir da tabela XXXX, através dos campos: YZYZ.

'''- Validar informações inseridas no pedido:'''

Ao passo que o usuário cadastra um pedido, deverão ser selecionadas as informações de endereço de entrega, organização de venda e tipo de frete, além dos itens que se deseja cadastrar. Essas informações irão gerar dados para que o cálculo de frete seja realizado. 

O GeoSales irá, inicialmente, validar, através do endereço de entrega selecionado, qual o estado e a cidade de destino do pedido. Serão validadas também as informações de organização de venda, canal de venda e tipo de frete. É importante salientar que o GeoSales irá considerar o estado e a cidade do endereço de entrega selecionado, e não o endereço do cliente a quem o pedido pertence. 

Através dessas informações é que o GeoSales irá verificar sob qual faixa de frete o pedido se aplica. 

'''- Aplicar valor de frete no pedido:'''

Após a validação, o GeoSales busca qual percentual irá definir o valor de frete do pedido. Este percentual será aplicado sob o valor final do pedido, gerando então um valor de frete a ser somado.

Por exemplo: Um pedido de R$1000 reais (mil reais) está alocado em uma faixa de percentual de frete de 10%, após realizar as validações e identificar o percentual da faixa de frete, o GeoSales irá aplicar o percentual sob o valor do pedido, o que irá gerar um frete de R$100 reais. Este frete será somado ao valor final do pedido, que resultará em R$1100 reais totais.

O valor de frete que foi calculado e aplicado será exibido na etapa de finalização do pedido, e o usuário criador do pedido poderá visualizar o frete antes de salvar o pedido.

'''- Validação de cálculo de frete por cliente:'''

Atualmente, a regra de cálculo de frete é parametrizada por região, porém, alguns clientes, devido a acordos específicos estritamente internos, são isentos de cálculo de frete. Por este motivo é necessário parametrizar quais clientes irão ser isentos do cálculo de frete, e não realizar esse cálculo no GeoSales.

Para que isso seja possível, serão viabilizadas regras diferentes de validação e cadastro de frete, uma definindo o frete por região, outra definido o frete por cliente, e desta forma, permitir que o frete não seja calculado para determinados clientes.

Para que isso seja possível, os clientes que não realizam pagamento de frete devem ser sinalizados na tabela de cliente XXXX do ERP.

== Regras de Negócios ==

'''[RN1] - ''' Para alguns clientes, por diversas razões, não é cobrado valor de frete. Esses clientes deverão ser sinalizados no ERP, para que o GeoSales desconsidere o cálculo de frete para esses clientes.

'''[RN2] - ''' O GeoSales só irá calcular valor de frete para os tipos de frete parametrizados para realizar tal aplicação. 

'''[RN3] - ''' Alguns tipos de pedidos não geram custo de frete. Para que isso seja possível o usuário deverá, no cadastro de tipo de pedido, definir que o tipo que está sendo criado não irá abranger cálculo de frete.

'''[RN4] - ''' O valor calculado para frete de um pedido deverá ser exibido tanto na finalização do pedido, quanto no relatório de espelho do pedido.

'''[RN5] - ''' Na edição do pedido, o frete aplicado será o mesmo caso o valor final do pedido não seja alterado, porém, caso o valor do pedido seja movimentado, o GeoSales irá revalidar o frete a ser aplicado no pedido.

'''[RN6] - ''' Para evitar recursividade no cálculo de frete, o GeoSales irá considerar, com finalidade de recalcular o frete, o valor dos produtos com aplicação de descontos (valor do produto - o total aplicado de descontos). Não serão considerados os tributos aplicados (IPI, ICMS e ST), e nem o valor do frete.

== Regras de Integração ==

'''[RI1] - ''' Definir no ERP de quais campos e tabelas os dados serão integrados.

'''[RI2] - ''' O GeoSales não irá tratar cadastros duplicados de faixas de valores de frete. Nestes casos, o GeoSales irá considerar o primeiro valor de frete encontrado. Portanto, é de responsabilidade exclusiva do ERP o cadastro correto de informações de frete.

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

|- 
| Gerente TI - GeoSales || Leonardo Sousa  || 17/12/2018
|-
|}

=== Empresa solicitante === 

{| class="wikitable"
! Setor 
! style="width:200px" |Aprovado Por
! style="width:200px" |Data

|-  
| TI - Montana ||  || 
|- 
| Gestor do Projeto - Montana ||  || 
|- 
| Diretoria - Montana ||  || 
|}