Exibir código-fonte para Impedir Salvamento de Pedido CIF sem Regra de Frete

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem 
! Comentários 
|-
|  08/09/2026  || Renato Lima || Criação do documento 
|-
|}

== Necessidade ==
Necessita de um controle que impeça o salvamento de pedidos quando a venda for realizada na modalidade de frete CIF e não houver uma regra de frete configurada no GeoSales para realizar o respectivo cálculo.

Atualmente, o GeoSales realiza o cálculo do frete CIF com base nas regras de frete existentes em sua estrutura. Entretanto, em situações nas quais não existe uma regra aplicável ao pedido, o cálculo do frete não é realizado, permitindo que o pedido possa seguir para salvamento sem que essa condição seja identificada.

Para o cliente, é importante que essa situação seja tratada como uma validação obrigatória, evitando que pedidos CIF sejam registrados sem que o frete tenha sido devidamente calculado.

== Solução ==
Implementar uma trava no salvamento do pedido para as vendas realizadas com tipo de frete CIF.

No momento em que o usuário tentar salvar o pedido, o GeoSales deverá verificar se foi possível realizar o cálculo do frete conforme as regras configuradas para a operação.

Quando houver uma regra de frete aplicável, o pedido poderá ser salvo normalmente.
Quando não houver regra de frete aplicável e, consequentemente, o cálculo do frete CIF não for realizado, o sistema deverá impedir o salvamento do pedido.
O usuário deverá receber uma mensagem informando que o pedido não pode ser salvo porque não foi encontrada uma regra de frete válida para realização do cálculo do frete CIF.

Dessa forma, a solução atenderá à necessidade do cliente de garantir que nenhum pedido CIF seja salvo sem que o respectivo cálculo de frete tenha sido realizado.

== Implementação ==

A implementação deverá contemplar uma validação no fluxo de salvamento do pedido, considerando a modalidade de frete selecionada.

O GeoSales deverá identificar se o pedido utiliza frete CIF e, nesse cenário, verificar se o processo de cálculo do frete foi executado com sucesso a partir de uma regra de frete aplicável.

O comportamento esperado será:

'''1. Pedido com frete CIF e regra aplicável:''' o cálculo será realizado e o pedido poderá ser salvo normalmente.

'''2. Pedido com frete CIF sem regra aplicável:''' o sistema deverá interromper o processo de salvamento e apresentar uma mensagem orientando o usuário sobre a ausência da regra de frete.

'''Mensagem Sugerida'''

Não foi possível calcular o frete CIF. Não foi encontrada uma regra de frete aplicável a este pedido. Verifique as configurações ou os dados informados antes de salvar o pedido.

'''3. Pedido com modalidade diferente de CIF:''' a nova trava não deverá ser aplicada, mantendo o comportamento atual do sistema.

A implementação deverá utilizar a estrutura e os mecanismos de cálculo de frete já existentes no GeoSales, acrescentando apenas a validação obrigatória para impedir o salvamento quando o cálculo do frete CIF não puder ser realizado.

Resultado esperado: garantir que pedidos CIF não sejam salvos sem que exista uma regra de frete aplicável e sem que o respectivo cálculo tenha sido realizado com sucesso.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Implementar validação no processo de salvamento de pedidos com modalidade de frete CIF.

* Validar se existe uma regra de frete aplicável ao pedido.

* Validar se o cálculo do frete foi realizado com sucesso antes de permitir o salvamento.

* Implementar a trava de salvamento quando não houver regra de frete aplicável.

* Apresentar mensagem informativa ao usuário quando o salvamento for bloqueado.

* Aplicar a validação nos fluxos de inclusão e/ou alteração de pedido em que o cálculo do frete CIF seja executado.

* Garantir que a validação utilize a estrutura de regras de frete já existente no GeoSales.

* Realizar testes dos cenários com regra de frete válida e sem regra de frete aplicável.

=== Escopo Não Incluso ===
* Criação, alteração ou revisão das regras de cálculo de frete já existentes no GeoSales.

* Alteração da metodologia ou fórmula utilizada atualmente para cálculo do frete.

* Criação de novas modalidades de frete.

* Alteração das condições comerciais ou regras de negócio relacionadas ao pedido que não estejam diretamente relacionadas à trava do frete CIF.

* Cadastro automático de regras de frete.

* Alteração das informações de frete no ERP ou em sistemas externos.

* Implementação de novos critérios para determinação do valor do frete.

* Alterações em integrações que não sejam necessárias para atender à validação proposta.

== Atores ==
'''Vendedor/Usuário do GeoSales:''' responsável pela inclusão e salvamento do pedido.

'''GeoSales:''' responsável por validar a existência da regra e realizar o cálculo do frete.

== Pré-condições ==
* Usuário deve estar autenticado no GeoSales.

* Deve existir um pedido em processo de inclusão ou edição.

* O pedido deve possuir a modalidade de frete CIF.

* As regras de cálculo de frete devem estar configuradas na estrutura do GeoSales.

== Regras de Negócio ==

'''[RN1] - Validação do Frete CIF'''

Para pedidos com modalidade de frete CIF, o GeoSales deverá validar, antes do salvamento, se existe uma regra de frete aplicável e se o cálculo do frete foi realizado com sucesso.   

'''[RN2] - Bloqueio do Salvamento'''

Caso não seja encontrada uma regra de frete aplicável ao pedido CIF, o GeoSales deverá impedir o salvamento do pedido. 

'''[RN3] - Mensagem ao Usuário'''

Ao bloquear o salvamento, o sistema deverá apresentar uma mensagem clara informando que não foi encontrada uma regra de frete válida para o cálculo do frete CIF. 

'''Mensagem Sugerida'''

Não foi possível calcular o frete CIF. Não foi encontrada uma regra de frete aplicável a este pedido. Verifique as configurações ou os dados informados antes de salvar o pedido.

'''[RN4] - Pedido com Frete Calculado'''

Quando existir uma regra aplicável e o cálculo do frete for realizado com sucesso, o pedido poderá ser salvo normalmente.

'''[RN5] - Aplicação da Regra'''

A validação deverá utilizar as regras de frete já existentes na estrutura do GeoSales, não sendo objetivo deste caso de uso alterar a lógica atual de cálculo do frete.

'''[RN6] - Ativar comportamento'''

Está validação deve ser ativada a partir de uma ação, uma vez esta ação ativada para o perfil do usuário, o sistema deve realizar validação.

== Fluxograma ==
[[Arquivo:Diagrama_validar_regra_de_frete.drawio_(1).png|1100px]]

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

|- 
| Integração - GeoSales ||  || dd/mm/aaaa
|-
|}

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