ER_PCREQ-8605_Eliminação_Resíduos

Informações Gerais

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

Objetivo

O objetivo e atender a necessidade de realizar uma nova solicitação com os itens não atendidos no TOP¹ .

A eliminação de resíduos é a forma de liberar as quantidades não atendidas de um pedido. No processo de integração entre o TOP e o PROTHEUS, serve para ajustar as quantidades atendidas de forma a liberar para o usuário do TOP a possibilidade de realizar um novo pedido no limite da quantidade não atendida e de acordo com a necessidade do produto no projeto.

¹ TOP é a sigla de TOTVS Obras e Projetos que será utilizada neste documento para definir o módulo RM.

Definição da Regra de Negócio

Sistemas Envolvidos

Este processo envolve o TOP e o modulo de compras do BackOffice PROTHEUS.

Visa refletir no TOP as quantidades solicitadas que não são atendidas e consequentemente eliminadas no processo de Eliminar Resíduos do modulo de Compras.

Integração

O usuário gera uma solicitação no TOP e submete ao Compras do PROTHEUS, para que proceda com a liberação ou com a aquisição dos mesmos. Em alguns casos não há possibilidade de realizar o atendimento do total solicitado, nestas situações, o usuário no modulo de Compras poderá usufrui do processo de Eliminar Resíduos para finalizar a demanda.

A partir desta demanda o sistema de Compras passará a refletir no TOP as quantidades não atendidas e por consequência permitirá ao usuário criar uma nova solicitação.

• Premissas
  A integração TOTVS Obras e Projetos x BackOffice Protheus deve está configurada no RM e no BackOffice PROTHEUS.
• Arquitetura (Tecnologia)
  Será utilizada a arquitetura de comunicação por Mensagem Única. São trafegados XMLs estruturados e padronizados pela TOTVS. 

Escopo

As solicitações e pedidos são gerados no TOP através das funcionalidades ”Geração de Pedidos”. Quando associado a um contrato, será enviado um “Pedido de Compra” e quando não associado será enviada uma “Solicitação de Compra”.

Ao executar o processo “Eliminar Resíduos” do modulo de compras do PROTHEUS e a quantidade atendida for diferente do solicitado, a mesma será enviada para ajuste no TOP.  É enviada uma alteração referente ao movimento gerado no TOP, com exceção da eliminação realizada em um pedido que foi criado através de uma solicitação. Neste caso, o Protheus enviará a quantidade atendida e a referência do item da solicitação original. Para demais situações sempre será enviada a quantidade atendida.

Os seguintes cenários serão contemplados conforme descrito:

• O TOP gera uma solicitação e a eliminação de resíduos no PROTHEUS ocorre nesta solcitação. No Compras, ao eliminar o resíduo na solicitação será enviada a quantidade atendida para o TOP, que por sua vez, ajusta a quantidade estornada de acordo com a quantidade atendida. Caso ocorra uma exclusão do pedido no PROTHEUS após a eliminação de resíduos, é enviado uma mensagem com a referência da solicitação, o TOP recebe a mensagem e ajusta a quantidade estornada. Caso tenha ocorrido a criação de um novo pedido, será retornado um erro para o PROTHEUS informando que a realização do estorno irá superar a necessidade e, neste caso o PROTHEUS aborta a exclusão do pedido.
  
  
• O TOP gera um pedido e a eliminação de resíduos no PROTHEUS ocorre no pedido. No Compras, será bloqueado a utilização de eliminação de resíduos para pedidos associados a contratos.
  
  
• O TOP gera uma solicitação. No Compras é gerado um pedido com base nesta solicitação e a eliminação ocorre no pedido criado.  Após a geração da nota fiscal poderá executar a eliminação de resíduos no pedido e caso a quantidade comprada seja inferior a quantidade do pedido, será enviada a quantidade atendida para o TOP através de um pedido, informando qual o item da solicitação está sendo ajustado. O TOP verifica a existência da solicitação, ajusta a quantidade estornada de acordo com a quantidade atendida. O Pedido enviado será gravado como histórico com um tipo de movimento especifico criado pela integração. Caso ocorra uma exclusão da nota fiscal no PROTHEUS após a eliminação de resíduos, é enviado uma mensagem com a referência do pedido e da solicitação originada pelo TOP. O TOP recebe a mensagem e ajusta na solicitação a quantidade estornada e elimina o pedido de histórico gerado pela eliminação de resíduos. Caso tenha ocorrido uma nova solicitação e o total solicitado supere a necessidade do projeto, será retornado um erro para o PROTHEUS informando que a realização do estorno irá superar a necessidade e, neste caso o PROTHEUS aborta a exclusão da nota fiscal. Não ocorrendo o erro, a quantidade estornada da solicitação será ajustada e o pedido histórico será excluído.

Para esta demanda é utilizada exclusivamente a integração denominada como TOTVS Obras e Projetos X BACKOFFICE Protheus. Onde serão atualizadas as mensagens definidas para transacionar as solicitações, pedidos e movimentos de entrada.

Para melhor entendimento consulte o tópico Fluxo de Processo deste documento.

Protheus

A integração por mensagem única deve estar ativa com o EAI devidamente configurado.

Os ADAPTERS necessários para integração devem estar configurados.

RM

O TBC (TOTVS Businnes Connect) deve estar devidamente instalado e configurado.

As atividades do projeto no TOP devem estar devidamente programadas.

Instalação/Atualização

As atualizações são disponibilizadas na área de download em: https://suporte.totvs.com/portal/home

Protheus

Informações e instalação do WebService podem ser encontradas em: http://tdn.totvs.com/display/tec/Web+Services+--+23597

RM

Informações sobre o gerenciamento e instalação do TBC podem ser encontradas em: http://tdn.totvs.com/display/public/rm/TBC e http://tdn.totvs.com/pages/releaseview.action?pageId=82477609. 

Transações/Entidades/Mensagens únicas

Solicitações

Identificador da Mensagem: REQUEST

Versão: 1.010

Módulo RM: TOTVS Obras e Projetos

Módulo Protheus: SIGACOM

Tipo de Envio: Síncrono

Pedidos

Identificador da Mensagem: ORDER

Versão: 3.004

Módulo RM: TOTVS Obras e Projetos

Módulo Protheus: SIGACOM

Tipo de Envio: Síncrono

Nota Fiscal

Identificador da Mensagem: INVOICE

Versão: 3.006

Módulo RM: TOTVS Obras e Projetos

Módulo Protheus: SIGACOM

Tipo de Envio: Síncrono

Notas:

Somente os campos adicionados nas respectivas versões foram mapeados neste documento. Para maiores detalhes relacionados a estas transações, consulte a documentação referente a integração em: http://tdn.totvs.com/pages/releaseview.action?pageId=152802572

Limitações/Restrições

A integração por mensagem única deve conter somente um mapeamento de cada entidade do lado RM para um mesmo web service de destino.

Protótipo de Tela

Não se aplica. 

Fluxo do Processo