VÍNCULO DE CONTRATO / MELHORIAS INTEGRAÇÃO COM SIGAMNT

Informações Gerais 

Objetivo

Criação de funcionalidade para vinculação de contrato do TOTVS Gestão de Estoque, Compras e Faturamento à Ordem de Manutenção (OS) gerada pelo TOTVS Manutenção de Ativos (SIGAMNT), permitindo assim que na baixa seja feita a correta valoração da OS conforme faturamento do contratouma maior rastreabilidade dos movimentos e dos contratos de manutenção envolvidos.

Definição da Regra de Negócio

 Uma vez criada a Ordem de Manutenção (OS) no Manutenção de Ativos, juntamente com ela é criada uma Solicitação de Armazém (SA) ou uma Solicitação de Compra (SC). Caso exista um contrato com um fornecedor para prestação de serviço ou fornecimento de produtos referente aos itens da SA/SC, existe pode existir a necessidade de vinculação desse contrato com a SA/SC.

Para que esse vínculo seja feito, será criado um processo no módulo Módulo de Contratos que permitirá ao usuário fazer esse vínculo.

O processo irá verificar os itens dos movimentos de SA/SC que estiverem Pendentes ou Parcialmente Faturados e que não estejam participando de um processo de Cotação para que o usuário faça o vínculo do item de solicitação com o item de contrato. É importante ressaltar que o movimento de SA/SC não pode estar parametrizado para trabalhar com Faturamento Parcial por Valor.

Após o vínculo, os itens da SA/SC que foram vinculados não ficarão mais disponíveis para faturamento, evitando assim que os itens já vinculados sejam faturados pelo processo de compra ou baixa de estoque. Ao gerar o faturamento do contrato o item vinculado será recebido e o movimento gerado pelo contrato deve-se poderá seguir com o processo normal de faturamento do contrato, até a geração da NF e a criação do movimento de baixa, através de cópia por referência, assim como é feito atualmente.

Para que a baixa seja feita devidamente apontando a OS correta, será criada uma funcionalidade de rastreamento do vínculo com o contrato, que permitirá que a baixa seja feita de forma correta. Essa funcionalidade será transparente ao usuário, não havendo necessidade de execução de processo ou qualquer outra ação pelo usuário. Verificar se será necessário criar esse rastreamento do vínculo com o contrato na baixa

Para atender a esta demanda será foi necessário realizar a seguinte implementação:

Vinculação Vínculo de Itens de Item ao Contrato x Itens de Solicitação

• Criado uma nova Criar um novo campo na tabela de relacionamento entre o item de contrato e o item de movimento (TITMCNTMOVRELACTITMCNTMOV) para que seja gravado o tipo de relacionamento entre o item de contrato e o item de movimento (TIPORELAC).vínculo.
• Criado um novo campo (STSCONTRATO) na TMOV para gravar o Status de Mov. Relacionado ao Contrato.
• O Status de Mov. Relacionado ao Contrato poderá assumir os seguintes valores:
  • "C" - Em Contrato
    
  • "P" - Faturado Parcialmente pelo Contrato
    
  • "T" - Faturado pelo Contrato
    
  • "G" - Gerado pelo Contrato (Esse status somente será visualizado no movimento de faturamento gerado pelo contrato)
    
  • "   " - Vazio 
• Criado um novo processoCriar uma action de processos, onde o usuário precisará executá-lo para fazer o vínculo com os itens de solicitação. 
  • Criar Criado uma nova tag de segurança para este processo;
  • Este processo ficará estará disponível na visão de Manutenção de Contratos;
  • Será O processo será exibido quando a integração TOTVS Manutenção de Ativos x BackOffice RM estiver ativa e o usuário possuir permissão para executar o processo.
• O processo deve irá apresentar ao usuário todos os itens de movimentos de SA/SC pendentes Pendentes ou parcialmente faturados Parcialmente Faturados (TMOV.STATUS IN ('A', 'G')) e que estejam associados a uma um item de OS gerada pelo Manutenção de Ativos (TMOVTITMMOV.INTEGRAAPLICACAO = 'N'). Ao recuperar os itens de movimentos deve-se considerar o tipo de movimento integrado ao SigaMNT (TTMVEXT.INTEGRASIGAMNT = 1 ) e que esteja definido nos parâmetros de integração (TMVSA e TMVSC).
  • Para melhorar a performance do processo, será listado somente os itens de solicitação que sejam iguais aos itens de contrato selecionados.
• Será verificado se Deve-se verificar se o tipo de movimento parametrizado na integração TOTVS Manutenção de Ativos x BackOffice RM está definido por coligada. Caso esteja deve-se considerá-lo, senão considerar , será considerado o tipo de movimento da coligada, senão será considerado o da coligada 0 (zero).
• No término da execução do processo:
  • Deverá ser criado um registro na tabela TITMCNTMOVRELAC onde a coluna TIPORELAC deve receber o valor 1 - Vinculado à solicitação de Manutenção;tabela TITMCNTMOV, preenchendo os seguintes campos:
    • CODCOLCNT: Coligada do Contrato;
      
    • CODCOLMOV: Coligada de Movimento da Solicitação;
      
    • IDCNT: Identificador do Contrato;
      
    • IDMOV: Identificador de Movimento da Solicitação;
      
    • IDSEQUENCIAL: Sequencial do Vínculo;
      
    • NSEQITMCNT: Número Sequencial do Item de Contrato;
      
    • NSEQITMMOV: Número Sequencial do Item de Solicitação;
      
    • QUANTIDADEORIGINAL: Quantidade Original Vinculada;
      
    • QUANTIDADE: Quantidade Vinculada. (Esta será atualizada sempre que um faturamento for realizado)
      
  • A Quantidade será convertida para a mesma unidade do Item de Solicitação, desde que a unidade do contrato e da solicitação tenham a mesma unidade base.
  • O movimento de solicitação (SA/SC) deve ter o seu status Status de Mov. Relacionado ao Contrato alterado para Faturado"Em Contrato".
• Na mesma tela de processo será permitido cancelar o vínculo realizado (desvincular) e o movimento de solicitação (SA/SC) deve ter o seu status Status de Mov. Relacionado ao Contrato alterado para Pendentenulo. O cancelamento do vínculo será permitido somente se não existir faturamento do item de contrato.

Edição do Item do Contrato

Exclusão de Item do Contrato

Será permitido a exclusão de um item de contrato criado a partir de uma solicitação da OS que ainda não sofreu nenhum faturamento. O status do movimento de solicitação será retornado para pendente.

Não há nenhuma restrição para a edição do item de contrato, exceto para os campos Produto e Unidade, onde não será possível a sua alteração caso já tenha sido realizado algum vínculo.

Foi criado também uma nova aba na edição do item de contrato para que o usuário possa visualizar as vinculações existentes. Esta aba estará disponível em Informações Adicionais do item de contrato e somente será apresentada se existir vinculações para o item.

Image Added

Exclusão de Item do Contrato

Não será permitido excluir os itens de contrato vinculados a aos itens de solicitação da OS que já estão faturadosSA/SC.

Cancelamento do Contrato

Ao efetuar o cancelamento de um contrato que possui itens de contrato gerados por vinculados com itens de solicitação de manutenção, não será feita alteração no status do movimento de origem. Isso acontece pois o contrato pode ser “descancelado” e essa característica dificulta o tratamento do movimento de origem.

Rastreabilidade do Movimento

O rastreamento de movimento foi configurado para apresentar o contrato que está vinculado com os itens de um determinado movimento. O vínculo será apresentado na aba Contrato da rastreabilidade de movimento.

Como esta mesma aba é utilizada para apresentar os Contratos que foram gerados por um movimento de Ordem de Compra, foi criado uma nova coluna que irá identificar a Origem desse rastreamento, podendo ser Ordem de Compra ou Vínculo Integração SigaMNT.

Image Added

Tabelas Utilizadas

• TMOV - Movimentos.
• TITMMOV - Itens de Movimento.
• TITMCNT – Cadastro de Itens de Contrato.
• TITMCNTMOV - Vínculo de Itens de Contrato x Itens de Solicitação.
• TITMCNTMOVGERADO - Quantidade Gerada do Item de Contrato.
• TMOVRELAC - Relacionamento entre Movimentos.
• TITMMOVRELAC - Relacionamentos entre Itens de MovimentoTITMCNTMOVRELAC - Relacionamento de itens de movimento e itens de contrato.
• HCPARAMETROS - Parâmetros do RM Conector.
• HCINTEGRACAOID - Tabela de-para dos identificadores de cada integração.

Procedimento para Implantação

O sistema é atualizado logo após a aplicação do pacote de atualizações do patch 12.1.20.23 ou posterior.

Procedimento para Utilização

<Descreva os procedimentos, passo a passo (caso de uso), que serão realizados pelos usuários para que a melhoria seja visualizada identificando as seguintes informações;

Localização da rotina no menu;

Localização dos novos campos e/ou perguntas e respectivas pastas de cadastro que são visualizadas pelo usuário;

Caso seja necessário ter algum cadastro feito previamente, faça uma observação

Se necessário, utilizar prints de tela>.

Procedimento para Configuração

(Estes procedimentos devem ser feitos quando for necessário configurar parâmetros e/ou  rotinas no menu).

CONFIGURAÇÃO DE PARÂMETROS

1. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie/configure (mantenha somente a instrução correspondente) o(s) parâmetro(s) a seguir:
   (É necessário criar uma tabela para cada parâmetro descrito no item Parâmetro(s), da tabela Características do Requisito)

Itens/Pastas

Descrição

Nome:

Tipo:

Informe o Tipo do parâmetro

Cont. Por.:

Informe o Conteúdo padrão

Descrição:

CONFIGURAÇÃO DE MENUS

2.  No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do informe o nome do módulo, conforme instruções a seguir:

Menu

Informe o Menu em que estará localizada a rotina

Submenu

Informe o Submenu em que estará localizada a rotina

Nome da Rotina

Informe o Título da rotina

Programa

Informe o Fonte da rotina

Módulo

Informe o Nome do(s) produto(s) a ser utilizado ou “Todos”

Tipo

Informe a Função

Fluxo do Processo

Image Removed 

1. Acessar o TOTVS Gestão de Estoque, Compras e Faturamento | Contratos | Manutenção de Contrato | Filtrar o(s) contrato(s) a ser(em) selecionado(s) para vinculação.
2. Selecionar o(s) contrato(s) | Processos | Vincular Contrato com Solicitação de Manutenção | A tela abaixo será aberta:
   
   Image Added
   
   2.1. Para realizar o vínculo, é necessário selecionar o Item de Contrato e o Item de Solicitação correspondente, indicado pelas respectivas setas na figura acima.
   2.2. Para realizar o desvinculo ou reverter um desvinculo feito, é necessário selecionar um registro de "Vínculo de Itens de Contrato x Itens de Solicitação".
   2.3. O botão para Executar o processo somente será habilitado após existir pelo menos um vínculo ou desvinculo a ser realizado no processo.
   
   
3. Após selecionado os itens que serão vinculados, é necessário clicar no botão Vincular. Após vincular, será gerado uma nova linha na visão de Vínculo de Itens de Contrato x Itens de Solicitação.
   
   Image Added
   
   3.1. Durante a vinculação, a visão de Vínculo de Itens de Contrato x Itens de Solicitação irá listar todos os vínculos já realizados e gravados na base de dados e os novos vínculos.
   3.2. Sendo assim, para um novo vínculo, se o processo não for executado, o vínculo não será efetivado e gravado na base de dados. O mesmo vale para o desvinculo, só é efetivado e gravado após o processo ser executado.
   3.3. Veja também, que ao realizar o vínculo ou o desvinculo a coluna Saldo do Item de Contrato e a coluna Quantidade do Item de Solicitação é atualizada para que o usuário possa visualizar os Saldos para o vínculo.
   3.4. Não será possível realizar vínculos cujo o Saldo e/ou a Quantidade estejam zerados.
   3.5. Não será possível realizar vínculos de produtos diferentes.
   3.6. Não será possível realizar desvinculo se a quantidade do vínculo for zero, já foi completamente faturada pelo contrato.
   3.7. O desvinculo de um vínculo não processado e simplesmente removido, Saldo do item de Contrato e a coluna Quantidade do item de Solicitação são atualizadas com a devolução do valor que estava vinculado.
   3.8. O desvínculo de um vínculo já processado deixa a quantidade do mesmo negativa, Saldo do item de Contrato e a coluna Quantidade do item de Solicitação são atualizadas com a devolução do valor que estava vinculado. A quantidade devolvida pode ser utilizada em novos vínculos.
   3.9 Ao realizar o desvinculo de um vínculo onde nenhuma quantidade foi faturada, esse é completamente removido da tabela de vinculações. Se for parcialmente faturada, ao invés de remover o vínculo, a quantidade é zerada. 
   
   
4. Clicar em Executar para efetivar o vínculo ou desvinculo a ser realizado.
   
   Image Added
   
   4.1. Se não houver nenhuma inconsistência, o vínculo\desvinculo será realizado com sucesso e um Log completo com as informações para cada item será apresentado.
   
   
5. Acessar o Tipo de Movimento de SA/SC | Verificar que o Status de Mov. Relacionado ao Contrato foi alterado para Em Contrato.
   Também poderia ter o status removido no caso de um desvinculo total. 
   
   Image Added
   
   5.1. Enquanto o Status de Mov. Relacionado ao Contrato estiver Em Contrato não será possível:
      5.1.1. Realizar o Cancelamento do Movimento. 
      5.1.2. Faturar/Receber o Movimento.
      5.1.3. Concluir Pedido.
      5.1.4. Estornar Item não Recebido.
      5.1.5. Editar/Excluir o Item de Solicitação vinculado ao Contrato.
   
   
6. Sempre que o processo de Vincular Contrato com Solicitação de Manutenção for acessado, o sistema irá listar os vínculos já realizados de todos os Itens de Contrato selecionados na visão.
   
   Image Added

Faturamento do Contrato

Ao efetuar o faturamento de um item de contrato (periódico ou não periódico) ou de uma medição do item de contrato, o sistema irá verificar se o item possui vínculo, e no caso afirmativo, irá realizar o faturamento da solicitação vinculada no processo, considerando a quantidade do item de contrato (periódico ou não periódico) ou a quantidade da medição, para faturar a solicitação de acordo com a quantidade vinculada.

Para ficar claro o comportamento explicado acima, vamos à um exemplo prático.

1. Realizada duas operações de vinculação do item de contrato para a mesma solicitação. Inicialmente, tinha-se Quantidade = 9 no item de contrato, e foi realizado o vínculo dessa quantidade com a solicitação. Depois viu-se a necessidade de realizar mais uma operação de vínculo, aumentando a quantidade no item de contrato para atender por completo a solicitação.
   
   Image Added
   
   
   
2. O Item de Contrato em questão é de Medição. Com isso, foi criada uma medição com Quantidade = 1.
   
   Image Added
   
   
3. Selecionada a Medição e realizado o faturamento.
   
   Image Added
   
   3.1 Uma vez que o faturamento foi realizado com sucesso, o sistema deverá ter os seguintes comportamentos:
       3.1 A solicitação deverá ser faturada de acordo com a quantidade vinculada, tendo o seu Status de Mov. Relacionado ao Contrato atualizado de acordo com o faturamento realizado.
       3.2 A tabela de vínculo (TITMCNTMOV) deverá ter o campo QUANTIDADE atualizado, consumindo o valor faturado. O consumo da quantidade será do registro que tiver o menor IDSEQUENCIAL na tabela, para maior.
       3.3 Deverá ser criado o(s) registro(s) na tabela de Quantidade Gerada do Item de Contrato (TITMCNTMOVGERADO), com a Quantidade Gerada do faturamento realizado, de acordo com a quantidade vinculada.  
   
   
4. Ao verificar o movimento de solicitação, podemos observar que nesse cenário, esse foi Parc. Recebido e o Status de Mov. Relacionado ao Contrato alterado para Faturado Parcialmente pelo Contrato.
   
   Image Added
   
   
5. Acessando a Rastreabilidade do Movimento, verificamos que o relacionamento com o movimento gerado pelo contrato foi efetivado.
   
   Image Added

Observações

1. Para faturar a solicitação de SA/SC é necessário que tenha vínculo registrado, do contrário, o faturamento do item de contrato seguirá como é atualmente, ou seja, sem relacionamento.
2. No que diz respeito a quantidade a ser faturada, será considerada toda a quantidade do vínculo, até que este seja zerado. Caso seja realizado o faturamento de um item de contrato, cujo o seu vínculo esteja zerado, o sistema irá gerar movimento normalmente, mas sem relacionamento.

Estornar Item não Recebido Vinculado ao Contrato

Ao realizar o processo de estorno de item não recebido de faturamento cujo status seja igual a "Gerado pelo Contrato", o sistema irá exibir uma mensagem de consistência informando que o movimento selecionado não possui item para ser estornado. Neste caso, apenas o cancelamento é permitido.

Segue abaixo imagem do processo de Estorno:

Image Added

Cancelamento de Movimento Vinculado ao Contrato

Ao realizar o processo de Cancelamento de faturamento cujo status seja igual a "Gerado pelo Contrato", o mesmo será processo processado normalmente e ainda irá atualizar o movimento de solicitação de acordo com os valores cancelados.

Movimento de Solicitação:

Image Added

Vinculo entre os movimentos e o contrato:

Image Added

Processo de cancelamento:

Image Added

Movimento cancelado:

Image Added

Solicitação com status atualizado:

Image Added

Observações

1. Uma vez que o cancelamento foi realizado com sucesso, o sistema deverá ter os seguintes comportamentos:
   1. O item da solicitação deverá ter sua quantidade estornada de acordo com o que foi faturado;
   2. A solicitação deverá ter o seu Status e Status de Mov. Relacionado ao Contrato atualizado de acordo com o cancelamento realizado.
   3. A tabela de vínculo (TITMCNTMOV) deverá ter o campo QUANTIDADE atualizado, estornando-se o valor faturado.
   4. A tabela de Quantidade Gerada do Item de Contrato (TITMCNTMOVGERADO) deverá ser atualizada ou apagada, de acordo com a quantidade que está sendo estornada.

Procedimento para Configuração

CONFIGURAÇÃO DE PARÂMETROS

Cadastro de Perfis

1. No RM.exe acesse o Módulo de Serviços Globais | Segurança | Perfis
2. Selecione o sistema Gestão de Estoque, Compras e Faturamento:
   
   Image Added
   
   
3. Edite o perfil do usuário que será concedida a permissão para executar o processo | Acesso a Menus | 05 - Contratos | 05.01 - Gestão de Contratos | 05.01.07 Manutenção de Contratos | 05.01.07.14 Vincular Contrato com Solicitação de Manutenção:
   
   Image Added
   

Integração com Protheus

1. No RM.exe acesse o Módulo de Integração | Mensagem Única | Integrações
   
2. Edite a integração Manutenção de Ativos x BackOffice RM e verifique se a mesma se encontra Ativa:
   
   Image Added

Fluxo do Processo

Image Added 

Dicionário de Dados

Código do Script: /*$Versao=NU.2017.12_03*/

Campo

TIPORELAC

Tipo

smallint

Tamanho

2

Valor Inicial

0

Mandatório

Sim (  ) Não ( X )

Descrição

Tipo de relacionamento entre o item de contrato e o item de movimento.

Help de Campo

Indica qual o tipo de relacionamento entre o item de contrato e o item de movimento. Os possíveis valores são:

0 - Pedido de Compra.