01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

Na rotina 2316, foi deve ser incplementado uma nova funcionalidade de validação automática de restrições avançadas no momento da inclusão de itens no pedido.

Fluxo de Funcionamento

1. Ao clicar no botão “Confirmar” na tela de inclusão de item, o sistema deve acionar o método de validação de restrições avançadas.

2. O método receberá como parâmetros de entrada os seguintes dados:

   • Item selecionado

   • Cliente vinculado ao pedido

   • Informações do pedido em andamento

3. O retorno do método poderá indicar:

   • Inclusão permitida → o item será adicionado normalmente ao pedido.

   • Inclusão bloqueada → o item não poderá ser incluído no pedido.

4. Em caso de bloqueio, o método retornará os dados da política responsável, que devem ser exibidos ao usuário da rotina em formato de mensagem clara e acessível:

   • Descrição resumida: exemplo: “Venda proibida para cliente inadimplente”

   • Mensagem detalhada: exemplo: “O cliente está com título vencido há mais de 15 dias. Verifique a situação financeira.”

5. É importante ressaltar:

   • Não haverá liberação por senha nesta entrega, mesmo que a política permita essa flexibilização.

   • O pedido não será gravado como “bloqueado” neste momento. A validação ocorre apenas no nível da inclusão de item.

03. SOLUÇÃO

1. Ação de disparo

   • Ao clicar no botão “Confirmar” na tela do item, o sistema deverá chamar o método de validação de restrições avançadas.

   • Essa chamada ocorrerá antes da gravação do item no pedido, garantindo que apenas itens válidos sejam persistidos.

2. Parâmetros de entrada
   O método receberá:

   • Código do item selecionado

   • Identificação do cliente do pedido

   • Dados gerais do pedido (número, tipo, condições comerciais, etc.)

3. Processamento da validação
   O método de validação seguirá a lógica da rotina 3391:

   • Verifica se há campanhas ativas (vigência válida).

   • Avalia se o universo de aplicação (condições) contempla o cliente e/ou item.

   • Aplica as regras definidas para esse universo.

   • Checa exceções, que anulam regras previamente validadas.

   • Identifica se a campanha é de tipo White List (Exclusividade) ou Black List (Proibição).

4. Retorno esperado
   O método deverá retornar:

   • Status da inclusão: permitido ou bloqueado.

   • Dados da política que motivou o bloqueio, quando aplicável:

     • Descrição resumida (ex.: “Venda proibida para cliente inadimplente”)

     • Mensagem detalhada (ex.: “O cliente está com título vencido há mais de 15 dias. Verifique a situação financeira.”)

5. Ações na rotina 2316

   • Se permitido: inclusão do item é concluída normalmente.

   • Se bloqueado:

     • A inclusão do item é impedida.

     • É exibida uma mensagem clara ao usuário, contendo a descrição resumida e a mensagem detalhada retornadas pela política.

     • O pedido não será gravado como bloqueado neste momento.

6. Exclusões da entrega

   • Não será implementada a lógica de liberação por senha.

   • Não haverá gravação de status de bloqueio no pedido, apenas a validação da inclusão do item.

Benefícios da Solução

• Impede automaticamente a inclusão de itens que violem regras comerciais/financeiras.

• Dá visibilidade clara ao usuário sobre o motivo do bloqueio.

• Garante alinhamento com a lógica já consolidada na rotina 3391.

• Facilita a manutenção e evolução futura (ex.: incluir liberação por senha em próxima entrega).

Saiba como Funciona

• Favor atualizar rotina para versão igual ou superior a descrita abaixo:
  • PCSIS2316
    Versão: 37.0.6.248

04. DEMAIS INFORMAÇÕES