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 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
    
  • "   " - 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 Item de Contrato, desde que ambas 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

Exclusão de 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 ContratoSerá 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 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 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.

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.

(Opcional)

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)

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:

Fluxo do Processo

Dicionário de Dados

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