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

Informações Gerais

(Obrigatório)

Objetivo

<Nesta etapa informar o objetivo da especificação do requisito, ou seja, o que a funcionalidade deve fazer - Detalhamento do Epic. Exemplo: Permitir que o usuário defina o percentual mínimo em espécie (dinheiro), a referência mínima para cálculo dos débitos do aluno e o período de validade do parâmetro de negociação>.

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.

(Obrigatório)

Definição da Regra de Negócio

<Regra de negócio é o que define a forma de fazer o negócio, o processo definido e/ou as regras que devem ser contempladas. Devem ser descritas restrições, validações, condições e exceções do processo. Incluir as telas do sistema com o objetivo de facilitar o entendimento do requisito, apresentar conceitos e funcionalidades do software. Caso necessário, incluir neste capítulo também regras de integridade que devem ser observadas no momento do desenvolvimento - É o Detalhamento das Story linkadas no Epic>.

<Na tabela abaixo informe quais são as rotinas envolvidas, o tipo de operação, a opção de menu e se necessário uma breve descrição das regras de negócio relacionadas a rotina>.

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, 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. 

Exemplo de Aplicação:

• Criar o campo “% Mínimo Espécie” (AAA_PERESP) onde o usuário informará o % que o aluno pagará em dinheiro. Esse % poderá ser alterado durante a negociação.
• Criar o campo “Referência Mínima para Cálculo” (AAA_REFCAL) onde o usuário informará um dos 4 valores disponíveis para pagamento das mensalidades  como a referência mínima para calcular o débito total do aluno.
• Criar o parâmetro MV_ACPARNE que definirá se as informações de “% Mínimo Espécie” e “Referência Mínima para Cálculo” serão obrigatórias.
• O parâmetro MV_ACPARNE deve ter as seguintes opções: 1=Obrigatório e 2=Opcional. Deve ser inicializado como opcional>.

Tabelas Utilizadas

• SE2 – Cadastro de Contas a Pagar
• FI9 – Controle de Emissão de DARF>.

(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)

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:

Opcional

Fluxo do Processo

<Nesta etapa incluir representações gráficas que descrevam o problema a ser resolvido e o sistema a ser desenvolvido. Exemplo: Diagrama - Caso de Uso, Diagrama de Atividades, Diagrama de Classes, Diagrama de Entidade e Relacionamento e Diagrama de Sequência>. 

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 um item de OS gerada pelo Manutenção de Ativos (TITMMOV.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 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 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 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 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.

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 Movimento.
• 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

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

Opcional

Dicionário de Dados

Arquivo ou Código do Script: AAA – Negociação Financeira / *Versao=CP.2014.12_03*/

Campo

<AAA_PERESP>

Tipo

<N>

Tamanho

<6>

Valor Inicial

<Varia de acordo com o tipo informado. Por exemplo, quando o campo “tipo” for date, neste campo pode ser informado uma data>. 

Mandatório

Sim (  ) Não (  )

Descrição

<Referência Mínima para Cálculo>

Título

<Ref.Calc.>

Picture

<@E999.99>

Help de Campo

<Informar o % que o aluno pagará em dinheiro. Esse % poderá ser alterado durante a negociação>