Impedir Salvamento de Pedido CIF sem Regra de Frete

Histórico de Alterações

Data	Quem	Comentários
11/06/2026	Renato Lima	Criação do documento

Necessidade

O cliente 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á:

Pedido com frete CIF e regra aplicável: o cálculo será realizado e o pedido poderá ser salvo normalmente. 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. 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.

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

Regras de Integração

[RI1] - [RI2] -

[RI3] -

[RI4] -

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		dd/mm/aaaa

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