INTEGRAÇÃO TOTVS Message Core 

Contexto de negócio

O objetivo do pacote de integração TOTVS Message Core é disponibilizar adapters para integração dos cadastros comuns a todas as integrações, como Empresa e Filial.

Sistemas Envolvidos

Lista dos aplicativos no projeto de desenvolvimento e que disponibilizarão os Adapters de integração.

• TOTVS linha RM.
• TOTVS linha Protheus.
• TOTVS linha DataSul.
  
  

Pré-requisitos instalação/implantação/utilização

O ambiente de integração necessita, além dos pré-requisitos de cada módulo individualmente, das seguintes características:

• Permissão de tráfego na rede entre os sistemas e os WebServices de destino.
• Caso existam processos a serem executados de forma assíncrona é importante que o WebServices e os serviços de cada módulo estejam disponíveis durante o agendamento destes processos.
• Devem haver licenças de uso suficientes para o processamento das integrações em conjunto com o uso dos sistemas.
  
  

BackOffice RM

• Configurar o pacote de integração TOTVS Message Core por meio doo menu Integração / Ferramentas / Configuração na versão 12.1.19 ou superior.
• Importação das Fórmulas Visuais de gatilhos de integração ou de carga de dados. Vide anexo "Importação de Fórmulas Visuais".

Protheus

• Utilizar a versão 12.1.8 do Protheus superior.
• Configuração dos adapters utilizados na integração TOTVS Incorporação x BackOffice Protheus, assim como toda a configuração do EAI Protheus.
  • Acessar o Sigacfg
  • Ambiente  > Schedule > Adapter E.a.I.
  • Incluir uma nova Rotina  para os adapters do  sistema Protheus
  • Configurar a Rotina do Adapter  de acordo com  os dados abaixo fornecidos  e que já foram pré estabelecidos  na aplicação do patch de atualização do Protheus:
    • Mensagem única: Sim
    • Rotina: Nome do adapter  com a ultima letra  referenciando o programa (A)
    • Mensagem: Nome da mensagem única  que o Adapter EAI  espera receber.
    • Descrição: Identificação da mensagem
    • Recebe: SIM
    • Método: Síncrono/Assincrono
    • Operação: TODAS

    • Canal de Envio  : EAI

      Mensagem Única	Rotina Protheus	Mensagem	Descrição	Envia	Recebe	Método Protheus	Operação	Canal de Envio	Adapter Protheus	Versão
      Sim	MATA010	Item	Produto	Não	Sim	Síncrono	Todas	EAI	MATI010	3.004

• Caso a integração via ESB tenha sido implantada anteriormente no cliente é necessário efetuar a configuração de novo ambiente Protheus a partir de ambiente vazio.
  • Todos os cupons fiscais e ReduçõesZ devem ser integrados ao BackOffice RM e a base de dados Protheus seja salva somente em caráter de Backup.
  • O novo ambiente Protheus deve ser iniciado a partir de ambiente vazio, evitando assim problemas de relacionamento De-Para ou registros existentes do Protheus que não tenham equivalente no RM.
• Obrigatoriamente o ambiente Protheus deve possuir controle por Grupo de Empresa, mantendo a seguinte disposição:
  • O ambiente deve possuir somente um Grupo de Empresas para cada.
  • Devem haver tantas empresas quanto coligadas no RM.
  • Não deve haver controle por unidade no Protheus.
  • Devem haver tantas Filiais quanto existirem no RM.

Instalação/Atualização

Protheus

Visando maior facilidade na implantação da integração está disponível abaixo um CheckList com os passos padrão necessários para implantação e parametrização da integração no Protheus. 

RM

Visando maior facilidade na implantação da integração está disponível abaixo um CheckList com os passos padrão necessários para implantação e parametrização da integração no RM. 

Controle de Versão

O grupo TOTVS, representado por suas marcas, irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definidas pelo Comitê de Integração TOTVS.

Suporte

O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos RM Conector e Backoffice Protheus estarão aptas a fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.

Observação: Este modelo de suporte está sendo revisado pela TOTVS.

Escopo

O escopo deste projeto se restringe à integração dos cadastros de domínio da equipe de Framework, listados na seção Transações/Entidades/Mensagens.

Transações/Entidades/Mensagens únicas

Segue abaixo tabela com informações sobre as entidades trafegadas na integração.

Obs.: A nomenclatura das Fórmulas Visuais de gatilho ainda se encontram em definição pela equipe de qualidade. Caso necessário entre em contato com o suporte para obtê-las.

Cadastros

Para esta integração todos os cadastros possuem sua origem no respectivo BackOffice, sendo enviados ao sistema de destino via Mensagem Padronizada TOTVS.

Cadastro de Empresas (Coligada)

Identificador da Mensagem: Company

Versão: 2.002

Mandatário: BackOffice

Tipo de Envio: Síncrono

Especificação Linha RM: Integração de Empresas - Linha RM

Notas: 

• Para o BackOffice RM o cabeçalho das mensagens de integração de Coligadas terá as informações de CompanyId e BranchId preenchido a partir do contexto de login.

Cadastro de Filiais

Identificador da Mensagem: Branch

Versão: 2.001

Mandatário: BackOffice

Tipo de Envio: Síncrono

Especificação BackOffice RM: Integração de Filiais - Linha RM

Notas: 

• Para o BackOffice RM o cabeçalho das mensagens de integração de Coligadas terá as informações de CompanyId e BranchId preenchido a partir do contexto de login.

Limitações/Restrições

Limitações / Restrições Gerais

Situações comuns (opcional)

Descreva situações problemáticas comuns que podem ocorrer durante o funcionamento da integração e como solucioná-los. Neste ponto também é importante dar instruções de como reconhecer e investigar problemas que podem vir a ocorrer durante a integração. Se houver, apresente tabelas de códigos e descrições de erros que a integração poderá apresentar.

Este tópico possivelmente será alimentado com as experiências durante o desenvolvimento da integração e poderá ser realimentado durante o uso da integração no cliente.

Checklist de suporte da aplicação

Crie um check-list de verificação de alguns pontos importantes para o funcionamento e atendimento da integração.

Instalação/Configuração

Relacione itens de verificação para garantir que a integração está corretamente instalada e configurada. Isto não pode ser uma cópia do procedimento de instalação/configuração, mas verificações pontuais que podem remeter aos itens da instalação.

Checklist de Verificações:

Relacione itens de verificações para que o atendente possa:

• Identificar o funcionamento da integração;
• Identificar a ocorrências de problemas;
• Coletar evidências do mau funcionamento relatado pelo cliente;
• Realizar possíveis ajustes na integração quanto à configuração ou negócio.

Anexos

Âncora
Configuração da integração Configuração da integração

Configuração da integração na Linha RM

Siga os passos abaixo para efetuar a instalação e configuração da integração no BackOffice RM.

1. Acesse o contexto de integração.
   
   
   
2. Executar o processo 'Configurar' na aba 'Ferramentas'.
   
   
   
3. Selecionar o pacote de integração 'BackOffice RM x PDV Protheus (Novo Modelo)" e executar o processo.
   
   
   
   
4. Acessar a rotina "Integrações" e parametrizar o campo 'URL WebService" com o caminho do WebService do Protheus.
   
   
   
   
   

Âncora
Importacao de Formulas Visuais Importacao de Formulas Visuais

Importação de Fórmulas Visuais

A lista de Fórmulas Visuais referente a cada entidade encontra-se na seção Transações/Entidades/Mensagens.

As Fórmulas Visuais informadas na tabela estão disponíveis na pasta "" de instalação do RM e devem ser importadas conforme apresentado no documento Importação\Exportação de fórmula visual, com atenção à importação dos gatilhos (caso contrário a mesma não será acionada).

Âncora
Execução de Formulas Visuais Execução de Formulas Visuais

Execução de Fórmulas Visuais de Carga de Dados

Segue abaixo a lista de passos para efetuar a Carga de Dados entre o BackOffice RM e o Protheus.

Acessar o processo "Executar" no caminho "Gestão -> Fórmula Visual"

Selecionar a Fórmula Visual de carga desejada e clicar no botão "Executar"

Após a execução é necessário acessar o arquivo de Log para verificação do status dos envios para o Protheus.
O Log estará disponível na pasta "Carga Inicial / Logs" dentro do diretório de instalação do RM (RM.Net).

Configuração do ambiente Protheus