Processo disponibilizado na visão da funcionalidade de Pedidos de Materiais do TOTVS Obras e Projetos, e que tem como objetivo verificar a existência de resíduos eliminados no Protheus e atualizar a quantidade estornada do respectivo item no pedido, o que possibilitará que essa quantidade estornada possa ser pedida novamente. Esta rotina pode ser executada através da visão de pedidos  ou ser agendada em ambiente configurado em três camadas.

Procedimento para Implantação

O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.

Importante: Este processo aplica-se somente em ambiente onde a integração entre o TOTVS Obras e Projetos e o Backoffice Protheus esteja sendo realizada via EAI1.0 e EAI 2.0.

Para que o processo seja habilitado, é necessário que seja realizada a seguinte parametrização no RM:

  1. No módulo integrações, criar os parâmetros a seguir para o SourceApp e endereço do serviço REST. Esses parâmetros se fazem necessários para que haja comunicação com Protheus via serviços REST:


Geração de Pedido de Material TOP -> Protheus

Solicitação de compras -> REQUEST -> Pedido de Compra

Deve se gerar o pedido de material acessando Projetos -> Construção e Projetos -> Planejamento -> Geração de Pedidos

Ao liberar o movimento para o backoffice é gerado uma solicitação de compras.

Para consultar a solicitação no Backoffice Protheus basta acessar o modulo SIGACOM -> Atualizações -> Solicitar/Cotar -> Solicitação de Compras

 Depois é só vincular a solicitação a um pedido de compra. Caso seja pedido uma quantidade menor que a solicitada ocorre a eliminação de resíduos entre solicitação e pedido que posteriormente poderá ser consultada no Totvs Obras e Projetos através do processo “verifica eliminação de resíduos”.                                               

Seguindo o processo após o vínculo da solicitação de compras com o pedido, é possível cadastrar documento de entrada para o pedido. Caso o documento de entrada tenha quantidade menor do que foi pedido no pedido de compra ocorre a eliminação de resíduos entre pedido e nota. Este processo também pode ser verificado no RM através da consulta “verifica eliminação de resíduos “.


Eliminação de Resíduos

Depois de vincular a solicitação de compras ao pedido é possível executar o processo de eliminação de resíduos no Backoffice Protheus. SIGACOM -> Atualizações -> Pedidos -> Eliminar Resíduos  

Basta informar os paramentos para a execução do processo (de como se deseja eliminar os resíduos), informar o tipo de eliminação neste caso “Solicitação de Compra”, pois a mesma ocorreu entre uma solicitação e um pedido de compra.

Quando a eliminação ocorrer entre um pedido e um documento de entrada o tipo de eliminação deve ser informado como “Pedido de Compra”.

Após preencher essas informações o processo de eliminação de resíduos ocorre automaticamente no Protheus mudando o status da solicitação ou Pedido para legenda na cor cinza “Eliminação de Resíduos”.


Obs.: Vale destacar que este é um exemplo mas as movimentações podem partir também de solicitações de armazém a partir do TOP e o fluxo sera o mesmo com a diferença que a Solicitação de Compra do Protheus estará associada a uma solicitação de armazém.


Procedimento para utilização:

Na Visão de Pedidos de Materiais e Pedidos de Materiais Extras

  1. Execute os processos necessários para eliminação de resíduos no Protheus;
  2. Acesse a visão de pedidos de materiais  e selecione o pedido integrado com o Protheus;
  3. Execute o processo "Verificar Eliminação de Resíduos". A execução dessa rotina não bloqueia o usuário, podendo o mesmo utilizar simultaneamente outras rotinas do sistema;
  4. Analise a quantidade estornada dos itens do pedido.

Quando executada pela visão de pedidos, o sistema permite a escolha de um ou vários pedidos na Eliminação de Resíduos, sendo que todos os pedidos selecionados serão processados mesmo que já tenham sido processados anteriormente. Este comportamento visa possibilitar a atualização da quantidade estornada quando uma nota fiscal é excluída após o processo de Eliminação de Resíduos já ter sido executado no Protheus.

Agendamento (Somente Ambiente 3 Camadas)
  1. Utilize o menu "Executar" à direita da aplicação RM;
  2. Pesquise por "Verificar Eliminação de Resíduos - Agendamento" e execute;
  3. Informe os dados necessários para o agendamento. Este processo necessita que sejam informadas a coligada e o projeto, porém, caso o usuário esteja logado no TOTVS Obras e Projetos em algum projeto, os sistema automaticamente terá essa informação;
  4. Após a execução, analise a quantidade estornada dos itens do pedido.

Na execução por agendamento são verificados todos os pedidos do projeto que não tenham sido analisados em processamentos anteriores, o que significa que a execução por agendamento controla os pedidos verificados, ou seja, caso tenham sido finalizados ou já tenha ocorrido a sua eliminação de resíduos no Protheus o pedido não será reprocessado.

Quando processados via agendamento, os itens dos pedidos são marcados para não serem reprocessados de acordo com as seguintes regras:


Após identificada a quantidade atendida, será automaticamente atualizado o campo quantidade estornada dos itens do pedido de material. Desta forma esta quantidade fica disponível para ser novamente utilizada em um novo pedido.

Informações exemplificadas do Processo:

1. Pedido enviado para o PROTHEUS

2. Solicitação de Compras no PROTHES


3. Pedido com quantidade a menor

4. Solicitação após eliminação de resíduos na SC



5. Nota Fiscal com quantidade a menor

6. Pedido com eliminação de resíduos

7. Resumo a Deduzir no TOP

8. Execução do Processo com sucesso

Para pedidos de Materiais e de Materiais Extras com Contrato, ao executar o processo de Eliminação de Resíduo, é criado um período de estorno no contrato, fazendo com que o saldo daquele item seja estornado no contrato.

Visão dos Pedidos Extras com Contratos Estornados:

Visão do período de estorno no Contrato:


9. Exemplo da estrutura Json de retorno:

{"pageSize":1,

    "data":{"movAssignments":[

                               {"itemNumber":"99|01|000019|0001",

                               "companyInternalId":"99|01",

                               "documentNumberSC":"99|01|000019",

                               "unitofMeasureInternalId":"99||UN",

                               "qujeSC":150000,

                               "quantitySC":200000,

                               "documentNumberPC":"99|01|000020|1",

                               "qujePC":100000,

                               "quantityPC":150000,

                               "residuoPC":"S",

                               "cotacaoSC":"99|01|XXXXXX",

                               "itemInternalId":"99||0003",

                               "residuoSC":"S"},

                              

                               {"itemNumber":"99|01|000019|0002",

                               "companyInternalId":"99|01",

                               "documentNumberSC":"99|01|000019",

                               "unitofMeasureInternalId":"99||UN",

                               "qujeSC":50000,

                               "quantitySC":100000,

                               "documentNumberPC":"99|01|000020|1",

                               "qujePC":40000,

                               "quantityPC":50000,

                               "residuoPC":"S",

                               "cotacaoSC":"99|01|XXXXXX",

                               "itemInternalId":"99||0003",

                               "residuoSC":"S"},

                              

                               {"itemNumber":"99|01|000019|0003",

                               "companyInternalId":"99|01",

                               "documentNumberSC":"99|01|000019",

                               "unitofMeasureInternalId":"99||UN",

                               "qujeSC":50000,

                               "quantitySC":100000,

                               "documentNumberPC":"99|01|000020|1",

                               "qujePC":40000,

                               "quantityPC":50000,

                               "residuoPC":"S",

                               "cotacaoSC":"99|01|XXXXXX",

                               "itemInternalId":"99||0003",

                               "residuoSC":"S"}]}

                               ,"page":1}


Também é possível, através do navegador, "chamar" o serviço REST passando seus parâmetros para obter o retorno do Protheus:


A exclusão da nota fiscal ou pedido do Protheus, interfere no saldo do pedido no TOTVS Obras e Projetos e neste caso, deve ser utilizada a sua visão de pedidos para filtrar aqueles que foram afetados pela exclusão e acionar o processo “Verificar Eliminação de Resíduos” para que o seu saldo seja atualizado.