INTEGRAÇÃO SIGAMNT - CRIAÇÃO DE SERVIÇO E MENSAGEM ÚNICA PARA RETORNAR STATUS DO MOVIMENTO

Informações Gerais

Objetivo

Implementação do adapter de integração via Mensagem Única TOTVS para retornar o status do movimento para o Manutenção de Ativos (SigaMNT).

Definição da Regra de Negócio

Considera-se como escopo deste requisito a implementação do adapter de recebimento de Mensagens Únicas TOTVS para integração de consulta status do movimento de Solicitação de Armazém ou Solicitação de Compras vinculados à Ordem de Manutenção que foi integrada ao BackOffice RM, estando o adapter de envio desta mesma mensagem fora do escopo do requisito. 

 A análise e o desenvolvimento do adapter será efetuado considerando a integração com o Manutenção de Ativos Protheus, mas também viabilizará a integração com outras fontes de dados desde que respeitado o layout da mensagem.

Tabelas Utilizadas

• TMOV - Movimentos
• HCINTEGRACAOID - Tabela de-para dos identificadores de cada integração

Entidades de Integração

• Transformação
  
  • Id: TraceAbilityRequest
  • Versão: 1_001
• Custom Adapter (GUID): 4291dd00-72a8-4781-abd3-579e814fb1ec
• Fluxo da mensagem: Entrada
• Tipo de Recebimento: Síncrono.

Regras de Integridade:

Ao receber mensagem de Consulta Status do Movimento serão realizadas as seguintes ações:

• Aplica-se a transformação do XSLT de Entrada.
• Recupera na tabela de De-Para qual é o Identificador do Movimento com base no InternalId enviado.
• Busca o status do movimento para montar o retorno que será enviado ao Protheus.

O movimento poderá ser alterado pelo Manutenção de Ativos quando o status do movimento for igual a: Pendente (A) ou Bloqueado (B) ou Normal (N) ou Não Processado (R

). Para estas situações de movimento o no retorno da mensagem o campo Status recebe valor 1 e a Descrição recebe o valor: Permitido alteração da movimentação.

Para os demais status de movimento o Status será 0 (zero) e descrição referente ao status respeitará a tabela abaixo:

Tabela De-Para da mensagem TraceAbilityRequest

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

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

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

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>

Mensagem Única		RM		Observação
Elemento	Descrição	Tabela	Campo
BusinessContentType
InternalId	InternalId da Solicitação	TMOV	CODCOLIGADA|IDMOV	O adapter RM irá usar a informação desta tag para buscar o Identificador do Movimento na tabela de De-Para.
CompanyInternalId	InternalId Empresa
CompanyId	Empresa
BranchId	Filial
Type	Tipo da Solicitação			000 - Solicitação de Armazem 001 - Solicitação de Compra 002 - Ordem de Manutenção
ReturnContentType
InternalId	InternalId da Solicitação
CompanyInternalId	InternalId Empresa
CompanyId	Empresa
BranchId	Filial
Status	Status de alteração			0 - Não é permite alterar movimentação 1- Permite alterar movimentação.
Description	Descrição referente ao status			Será preenchido conforme status do movimento.Consulte a tabela no tópico Regras de Integridade
Type	Tipo da Solicitação			000 - Solicitação de Armazem 001 - Solicitação de Compra 002 - Ordem de Manutenção

Procedimento para Configuração

CONFIGURAÇÃO DE INTEGRAÇÃO

1. No RM, acesse Integração/Ferramentas/Configurar. 
   1. Na janela Assistente de Configuração de Integração avance para a etapa Configuração do banco de dados e informe Usuário e Senha para conectar ao banco. Teste a conexão e avance.
   2. Na etapa Projetos de Integração selecione o item Manutenção de Ativos x BackOffice RM, avance e execute o assistente.
      
      
2. No PROTHEUS acesse Configurador (SIGACFG), acesse Ambiente/Schedule/Adapter E.A.I . Crie o adapter TRACEABILITYREQUEST conforme dados a seguir:
   
   

Image Added

Procedimento para Utilização

1. No  Manutenção de Ativos cadastrar uma O.S. com status liberado possuindo um insumo do tipo produto como previsto.
   
   Image Added
   
   
2. No BackOffice RM baixar (faturar a S.A.) que foi gerada para a O.S. 
   Image Added
   
   
   
3. No  Manutenção de Ativos editar a O.S. criada e deletar o insumo do tipo produto.
   
   Image Added

Help de Campo

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