Impedir Salvamento de Pedido CIF sem Regra de Frete
Histórico de Alterações
| Data | Quem | Comentários |
|---|---|---|
| 08/09/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á:
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] -
Regras de Integração
[RI1] - [RI2] -
[RI3] -
[RI4] -
Fluxograma
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 |