Informações Gerais 

   Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos). 

Objetivo

Desenvolver Web Services para manutenção e cancelamento de pedidos de vendas no LOGIX com base no protocolo REST.

O Web Service irá tratar toda a regra de negócio porém não contempla interface. Ou seja, deverá ser chamado por algum aplicativo passar os parâmetros de entrada e receberá o retorno do processamento. A interface ficará sob responsabilidade do cliente. 

Em resumo serão desenvolvidos 6 Web Services, para cada objetivo a seguir:

1) Realizar o bloqueio do pedido afim de evitar que enquanto um processo externo esteja alterando o pedido, algum processo interno do ERP realize uma alteração em paralelo;

2) Realizar o desbloqueio do pedido caso a modificação não seja mais necessária;

3) Realizar a modificação no pedido;

4) Realizar cancelamento parcial de um pedido;

5) Realizar o cancelamento total do pedido;

6) Excluir pedido em análise;

Definição da Regra de Negócio 

Basicamente serão desenvolvidas 5 funções 4gl, sendo 3 API para trabalhar como Web Service, uma função para realizar a validação e modificação do pedido no ERP e uma função para excluir pedido em análise.

A estrutura dos novos fontes seguirá a seguinte divisão: 

1) VDPR0004.4gl – API contendo 2 métodos, um para bloqueio e outro para desbloqueio de pedido.  

Método de bloqueio: vdpr0004_pub_process_bloqueiaPedidoModificacao()

Funcionamento: 1) Validar se o pedido pode ser bloqueado (Idem ao VDP20000). Validações: pedido cancelado, com OM pendente, com reserva ou solicitação de romaneio.

2) Incluir a nova consistência 126 - Pedido bloqueado devido a alteração via WEB SERVICE (Utilizar função vdp90043);

3) Caso o pedido possua as situações 'N','F','C','A', alterar para B - Bloqueado (utilizar função vdp90048).

Parâmetros de entrada:

Parâmetros de saída: 

Método de desbloqueio: vdpr0004_pub_process_desbloqueiaPedidoModificacao()

Funcionamento: 1) Validar o nível de autoridade do usuário para aprovação da consistência 126 (Utilizar função vdp90085)

2) Aprovar consistência 126 utilizando o motivo informado no novo parâmetro "mot_desbloqueio_ped_proc_ext" (Utilizar função vdp90044);

3) Executar função vdp90044_verifica_altera_situacao_pedido(), para alterar ou não a situação "Bloqueado" do pedido.

Parâmetros de entrada:

Parâmetros de saída: 

Observação: A aprovação da nova consistência poderá ser realizada também pelo VDP20021. Fica sob a responsabilidade do cliente o cadastro dos aprovadores no VDP10090. 

2) VDPR0005.4gl – API para modificação de pedido de venda. Deverá receber todos os parâmetros conforme listados abaixo, realizar o SET para a nova função vdp90426 e retornar os parâmetros tbm listados abaixo. 

Função principal: vdpr0005_pub_update_modificaPedidoVenda() 

Parâmetros de entrada (Tipo: PayLoad):

• Validar se o pedido está bloqueado (Tem que existir a consistência 127 sem aprovação);
• Validar dados do pedido, utilizando a nova função vdpr260, conforme é feita na função de inclusão (vdp90420);
• Validar consistências especificas da modificação, por exemplo: Código do item não pode ser alterado se o pedido estiver em carteira;
• Efetivar dados nas tabelas quentes de pedido;
• Gravar auditoria das modificações realizadas (inclusão, alteração ou exclusão de dados);

• Excluir a consistência 127;

• Consistir o pedido (utilizar vdp20023); 

• Executar função vdp90044_verifica_altera_situacao_pedido(), para alterar ou não a situação "Bloqueado" do pedido.

 Obs.: Somente a "qtd_pecas_solic" do item/grade será recebida pela função (demais campos de quantidade serão considerados como 0). Para pedidos em análise será possível diminuir (não poderá ser menor ou igual a zero) ou aumentar essa quantidade. Para pedidos em carteira apenas será possível aumentar.

4)  VDPR0006.4gl – API contendo 3 métodos: cancelamento parcial; cancelamento total  e exclusão de pedidos em análise

Método de cancelamento parcial: vdpr0006_pub_process_cancelaPedidoParcial() 

Funcionamento: 1) Executar as funções de cancelamento parcial em background do vdp90058.

Parâmetros de entrada: 

Parâmetros de saída: 

Método de cancelamento total: vdpr0006_pub_process_cancelaPedidoTotal() 

Funcionamento: 1) Executar as funções de cancelamento total em background do vdp90058.

Parâmetros de entrada: 

Parâmetros de saída: 

Método de exclusão de pedido em análise: vdpr0006_pub_process_excluiPedidoAnalise() 

Funcionamento: 1) Executar a nova função VDPR270 para validar e excluir pedido em análise.

Parâmetros de entrada: 

Parâmetros de saída: 

5) VDPR270.4gl - Função responsável por validar e excluir pedido em análise:

1. Toma como base a função vdp20000_excluir_pedido_analise() do VDP20000.
2. Alterar o VDP20002 e VDP90058 para não permitir o cancelamento (parcial/total) de pedidos em análise.
3. Substituir a função vdp20000_excluir_pedido_analise() pela nova função.
   
   

Outras alterações: 

1) VDP90063.4gl - Criar a nova consistência comercial "126 - Pedido bloqueado devido a alteração via WEB SERVICE". Atualizar o controle de versão; 

2) VDP02527.cnv - Criar novo parâmetro para indicar o motivo utilizado na aprovação da consistência 126.Caminho: processo saídas/pedidos/integrações 

3) VDP20000.4gl / VDP20002.4gl / VDP90058.4gl - Não permitir a modificação/cancelamento caso o pedido possua a consistência 126 pendente, não importando a situação do pedido. 

4) VDP90043.4gl - Alterar para não excluir a nova consistência na função vdp90043_exclui_consistencias(); 

5) VDP90044.4gl – Prever a nova consistência (126) na função vdp90044_pedido_possui_consistencia_de_bloqueio(); 

6) VDPR111.4gl – Preparar para trabalhar em background. Criar função de set do modo de exibição pois é usado em vários fontes padrões. 

7) DMLs - Para todas as DML's utilizadas, alterar as funções "_inclui", "_modifica" e "_exclui" para gerar um texto de auditoria com aquilo que foi incluido/alterado/excluido. Esse texto ficará armazenado em uma                  variável modular que poderá ser recuperada através de uma função GET. 

8) VDP90049 - Alterar função para receber um texto de auditoria de até 4000 caracteres. Quando isso ocorrer quebrar automaticamente em vários registros.

9) VDP90058 - Criar funções para o cancelamento parcial/total de pedidos em background.

Obs.: Para desenvolvimento das API com protocolo REST seguir o padrão estabelecido em: http://tdn.totvs.com.br/display/public/FRAMJOI/LGX+-+Desenvolvimento+de+API  

Conceitos que não serão previstos:

--> Integração com módulo de fluxo de caixa;
--> Conceito de Kit;
--> Integração com módulo de assistência técnica;
--> Cota de representante (Parâmetro "controla_cota");
--> Previsão de produção;

                                  Tabelas previstas

         Tabelas que não foram previstas