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 uma 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 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 poderá seguir com o processo normal de faturamento, 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 atender a esta demanda foi necessário realizar a seguinte implementação:

Vínculo de Itens de Contrato x Itens de Solicitação

• Criado uma nova tabela de relacionamento entre o item de contrato e o item de movimento (TITMCNTMOV) para que seja gravado o 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 processo, onde o usuário precisará executá-lo para fazer o vínculo com os itens de solicitação. 
  • Criado uma nova tag de segurança para este processo;
  • Este processo estará disponível na visão de Manutenção de Contratos;
  • 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 irá apresentar ao usuário todos os itens de movimentos de SA/SC Pendentes ou Parcialmente Faturados (TMOV.STATUS IN ('A', 'G')) e que estejam associados a uma OS gerada pelo Manutenção de Ativos (TMOV.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 o tipo de movimento parametrizado na integração TOTVS Manutenção de Ativos x BackOffice RM está definido por coligada. Caso esteja, 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 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 do Item de Solicitação;
      
    • QUANTIDADE: Quantidade Vinculada.
      
  • A Quantidade Original do Item de Solicitação e a Quantidade Vinculada será convertida para a mesma unidade selecionada no do Item de ContratoSolicitação, desde que ambas 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 de Mov. Relacionado ao Contrato alterado para "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 de Mov. Relacionado ao Contrato alterado para nulo. O cancelamento do vínculo será permitido somente se não existir faturamento do item de contrato.

Edição do Item do Contrato

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

Exclusão de Item do Contrato

Não será permitido excluir os itens de contrato vinculados aos itens de solicitação da SA/SC.

Cancelamento do Contrato

Ao efetuar o cancelamento de um contrato que possui itens de contrato 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.

Faturamento do Contrato

Ao efetuar o faturamento de um item de contrato....

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
• 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 da release 12.1.20. 

Procedimento para Utilização

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:
   
   
   
   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. O botão para Executar o processo somente será habilitado após existir pelo menos um vínculo 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.
   
   
   
   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.
   3.3. Veja também, que ao realizar o vínculo a coluna Saldo do Item de Contrato e a coluna Quantidade do Item de Solicitação foi zerada, uma vez que foi consumida toda a quantidade de ambos.
   3.4. Não será possível realizar vínculos cujo o Saldo e/ou a Quantidade estejam zerados.
   3.4. Não será possível realizar vínculos de produtos diferentes.
   
   
4. Clicar em Executar para efetivar o vínculo a ser realizado.
   
   
   
   4.1. Se não houver nenhuma inconsistência, o vínculo 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.
   
   
   
   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.
   
   

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:
   
   
   
   
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:
   
   
   

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:
   
   

Fluxo do Processo