Conceito:

Durante o processo de consolidação de marcas, iniciado pela TOTVS, várias empresas diferentes foram adquiridas e com elas vários produtos passaram a compor o portfólio de ofertas disponível aos clientes. Esta expansão de ofertas permitiu que clientes de uma marca, antes limitados pelas opções com aquela “etiqueta”, pudesse agora compor o seu ambiente de TI utilizando produtos de origens diferentes (Ex.: BackOffice Protheus + TOTVS Obras e Projetos).

Com o objetivo de padronizar a integrações com os produtos TOTVS, foi definida uma nova diretriz para os projetos de integração: todos os produtos TOTVS devem se comunicar com uma mensagem XML única, evitando desta forma o processo de transformação de mensagens. Neste cenário, teríamos o seguinte quadro: 

Neste cenário, qualquer produto TOTVS trabalhará com o mesmo XML para uma mesma entidade, ou seja, supondo que tenhamos um XML correspondente à mensagem de CLIENTES, ela poderá ser enviada para qualquer um dos produtos que suporte o recebimento desta entidade.

Uma vez que os vários produtos TOTVS terão um “idioma” comum (o XML Único), as integrações entre estes produtos não exigirão mais que as mensagens sejam transformadas de um formato para outro. Com isto, será possível conectar diretamente dois produtos, sem a necessidade do TOTVS ESB, como no diagrama abaixo:

Tabelas:

Adapters: 

Os Adapters são responsáveis por realizar o processamento das mensagens enviadas e recebidas, possibilitando a inclusão, alteração e exclusão de dados. Veja a Lista Completa dos Adapters utilizados na integração  EAI  (Enterprise Application Integration).

 As integrações via Mensagem Única propõem dois modelos de envio e recebimento de mensagens: 

Síncronas:  No modelo de mensagens Síncronas a mensagem é enviada e o sistema que enviou aguarda o processamento da mensagem pelo receptor.
Assíncronas:   Já no modelo Assíncrono a mensagem é enviada e o sistema que a enviou não aguarda o seu processamento. Posteriormente a mensagem será processada no receptor.

De/Para de Empresas/Filiais : 

O Cadastro de De/Para de empresas/filiais irá definir quais empresas e filiais serão integradas entre os dois sistemas.

No XML é necessário identificar a Aplicação de Origem, a Empresa e a Filial para cadastrar o De/Para. As tags a serem verificadas são:

• SourceApplication = Aplicação de Origem (XXD_REFER)
• CompanyId = Empresa (XXD_COMPA)
• BranchId = Filial (XXD_BRANCH)

De/Para de Mensagem Única (XXF): 

Na maioria das vezes, os códigos dos registros utilizados nos sistemas que se comunicam via Mensagem Única não são os mesmos, a XXF é a tabela que ira guardar os códigos para relacionar os registros, por exemplo um cliente pode possuir o código  no Protheus, e no RM esse mesmo cliente possui o código C0100001. Por isso o sistema realiza o cadastro de um "De/Para de Mensagem Única". 

Ao realizar a inclusão de um cadastro, o sistema verifica se já existe um "De/Para de Mensagem Única", caso já exista, o sistema entende que trata-se de uma alteração, caso não exista, trata-se de uma inclusão, então ele cria automaticamente o "De/Para de Mensagem Única" (XXF).

Caso trate-se de uma inclusão que referencia códigos de outros cadastros, esses códigos necessitam de um "De/Para de Mensagem Única", por exemplo, ao incluir um Pedido de Vendas você precisa referenciar um código de Produto e um código de cliente, mas, nesse momento, você não está incluindo o cliente ou o produto, você está incluindo o Pedido, portanto o cliente e o produto precisam ter um "De/Para de Mensagem Única" (XXF) cadastrado. 

A configuração inicia-se habilitando o serviço HTTP e configurando a porta que todos os outros serviços dependentes deste irão utilizar para a publicação das informações:

• Acesse o Wizard de configuração dos Serviços;
• Em Servidor Internet (HTTP/FTP), verifique se o serviço de HTTP já existe, confirme se está habilitado e para qual porta está configurada. Pois estas são informações indispensáveis para o correto funcionamento dos WebServices e Portais.
• Caso não tenha o Servidor Internet <HTTP> criado, é necessário seguir o procedimento abaixo:

• Configure o módulo WS em Módulos da Web:

Ferramenta SoapUI: 

É uma ferramenta de mercado onde conseguimos simular o envio do XML na integração via Mensagem Única.

Utilizamos o Soap para enviar o arquivo XML, simulando o envio de outros sistemas (RM ou LOGIX por exemplo) para o Protheus.

Link para baixar o Soap: https://www.soapui.org/downloads/latest-release/

Integração WS protheus X Soap Ui:

1° No Ini do Appserver, busque o caminho do WS.

WEBSERVICELOCATION=http://localhost:92/ws

2° Acesse o WS via browser

3° Busque o EAISERVICE , e clique sobre.

4°Clique sobre a descrição do serviço;

5° Copie o endereço do .

6° Abra o Soap UI - Clique em File - New SOAP Project

7° Cole o endereço do WSDL no campo Initial WSDL, clique em OK.

Pronto o Soap está integrado com o Web Service do Protheus. 

8° Cole o XML entre as seguintes Tags:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tot="http://www.totvs.com/">
<soapenv:Header/>
<soapenv:Body>
<tot:RECEIVEMESSAGE>
<tot:INMSG>
<![CDATA[

Cole aqui o XML

]]>

</tot:INMSG>
</tot:RECEIVEMESSAGE>
</soapenv:Body>
</soapenv:Envelope>

Parâmetros: 

• MV_EAIMETH (não deve ser alterado)
• MV_EAIUSER
• MV_EAIPASS
• MV_EAIURL2 (Endereço do WS para comunicação) - Podemos informar a Rota da integração neste parâmetro ou através da rotina CFGA020.  Saiba mais:  Roteamento EAI Protheus (CFGA020 - SIGACFG)
• MV_EAIWS(Não Precisa ser alterado). 

Principais parâmetros da Integração RM TOP X Protheus:

A integração do Top RM com o Protheus envolve o módulo Gestão de Projetos (SIGAPMS), neste módulo não é necessário realizar alguns cadastros de De/Para na XXF e sim configurar alguns parâmetros. 

Segue a baixo a lista dos parâmetros que envolve as integrações deste módulo:

Link: Parâmetros da Integração

Fontes de Integração:

Todos os fontes de integração contém a letra " I", exemplos:

Cadastro de cliente MATI030

No TFS os fontes do módulo Faturamento estão localizados na pasta Materiais - Mensagem única:

Extraindo o XML do Protheus:

Acesse o ambiente SIGACFG, Menu: Ambiente - Schedule - opção EAI

Na integração do Software com o Protheus, são criados os arquivos de transações:

Selecione o arquivo que integrou e para extrair clique na lupa  , ira apresentar as opções  escolha qual XML deseja extrair.

Visualizar mensagem Origem: XML que o Software envia para o Protheus.

Visualizar mensagem de Resposta: XML que o Protheus envia para o Software.

Documentações para apoio:

Exemplo de XML para testes: