Histórico da Página

A integração TOTVS Rental x Backoffice RM é realizada através do EAI 2.0 na estrutura de sincronismo baseada em Mensagem Única. A mensagem única tem o objetivo de padronizar as integrações com os produtos TOTVS fazendo com que os produtos trabalhem com mensagens XML ou REST/JSON únicas evitando dessa forma o processo de transformação de mensagens.

O TOTVS RM x PROTHEUS - Configurador EAI 2.0 é um novo recurso liberado na versão 12.1.28 para facilitar o processo de configuração e validação da integração, o configurador continua em desenvolvimento e vai ganhar novos recursos ao longo do tempo.

Deck of Cards

id	configuracao

Card

id	1
label	Configuração
title	Configuração

Esta documentação não fará o detalhamento da instalação do Protheus . Ele orientará apenas a configuração do mesmo para integrar com o TOTVS Rental (SIGALOC) com o Backoffice BackOffice RM .Para seguir as configurações descritas abaixo descritas é importante que já se tenha o ambiente Protheus/TOTVS Rental instalado.

Protheus : a partir da versão 12.1.33

RM : a partir da versão 12.1.33

Card

id	2
label	Compartilhamento de Tabelas Protheus
title	Compartilhamento de Tabelas Protheus

O compartilhamento de tabelas no Protheus deve ser coerente com a forma como o BackOffice RM trabalha, conforme descrita tabela abaixo.

Para alterar o compartilhamento das Tabelas acesse: SIGACFG em Dicionário | Base de dados | Base de dados, expande a Empresa e clica em Dicionário de Dados.

Cadastro	Empresa	Filial	Unidade	Tabela RM	Tabela Protheus
Moeda	Compartilhado	Compartilhado	Compartilhado	GMOEDA	CTO
Unidade de Medida	Compartilhado	Compartilhado	Compartilhado	TUND	SAH
Centro de Custo	Exclusivo	Compartilhado	Compartilhado	GCCUSTO	CTT
Condição de Pagamento	Exclusivo	Compartilhado	Compartilhado	TCPG	SE4
Produto	Exclusivo *	Compartilhado	Compartilhado	TPRODUTO	SB1
Cliente/Fornecedor	Compartilhado **	Compartilhado	Compartilhado	FCFO	SA1 (Cliente) e SA2 (Fornecedor)
Local de Estoque	Exclusivo	Exclusivo	Exclusivo	TLOC	NNR
Vendedor	Exclusivo	Compartilhado	Compartilhado	TVEN	SA3

* Independentemente se for utilizado produto global no RM, a tabela referente no Protheus deve ser exclusiva por empresa, ficando a cargo do RM replicar os produtos globais para cada filial no Protheus. A partir do release 12.1.18 da linha RM, a replicação dos dados sempre será realizada na inclusão de um novo produto global. Na alteração o RM irá replicar os produtos globais somente quando for alterado os campos da tabela Produtos Globais (TPRODUTO) que são sincronizados na mensagem única. São eles: Código do Produto; Descrição do Produto; Nome Fantasia; Inativo; Tipo; Peso Bruto; Peso Líquido; Usa Número de Série; Controlado por Lote; Referência; Número da Nomenclatura Comum do Mercosul (NCM).
** Mesmo que a empresa não utilize Cliente/Fornecedor global no RM, deve-se compartilhar a tabela referente no Protheus por empresa.

1 – Acesse: Protheus.exe / SIGACFG / Ambiente / Schedule / Adapter EAI.

Image Removed

2 – Clique em incluir e cadastre os adapters relacionados abaixo.

Nota: Para todos os adapters os campos listados a seguir devem ser preenchidos com o mesmo valor:

Mensagem única: Sim
Método: Sincrono
Operação: Todos
Canal: EAI - REST

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:

Não.002

1 – Acesse: Protheus.exe / SIGACFG / Ambiente / Cadastros / Parâmetros

Image Removed

2 – Clique em Pesquisar.

Image Removed

Informe o nome do parâmetro e clique em Procurar. A pesquisa irá retornar o parâmetro

Image Removed

Segue abaixo a listagem dos parâmetros que devem ser configurados:

Card

id	3
label	Adapters - Protheus
title	Adapters Protheus

Mensagem Única

Rotina

Mensagem

Descrição

Envia

Recebe

Método

Operação

Canal de Envio

Versão

Formato

Sim

AGRA045

WAREHOUSE

Local de Estoque

Não

Sim

Síncrono

Todas

EAI - REST

1.000

XML

Sim

CTBA030

COSTCENTER

Centro de Custo

Não

Sim

Síncrono

Todas

2.000

XML

Sim

CTBA140

CURRENCY

Moeda

Não

Sim

Síncrono

Todas

EAI - REST

2.001

XML

Sim

MATA010

ITEM

Produto

Não

Sim

Síncrono

Todas

EAI - REST

4.005

XML

Sim

MATA020

CUSTOMERVENDOR

Fornecedor

Não

Sim

Síncrono

Todas

EAI - REST

2.002

XML

Sim

MATA030

CUSTOMERVENDOR

Cliente

Não

Sim

Síncrono

Todas

EAI - REST

2.002

XML

Sim

MATA360

PAYMENTCONDITION

Condição de Pagamento

Não

Sim

Síncrono

Todas

EAI - REST

2.000

XML

Sim

NGMUOrder

ORDER

Pedido Compra

Sim

Síncrono

Todas

EAI - REST

3

XML

Sim

NGMUStoLvl

STOCKLEVEL

Consulta de Saldo

Sim

Não

Síncrono

Todas

EAI - REST

1.001

XML

TRACEABILITYORDER

Consulta rastreabilidade pedidos/vendas

EAI - REST

1.000

Sim

QIEA030

UNITOFMEASURE

Unidade de medida

Não

Sim

Síncrono

Todas

EAI - REST

2.000

XML

Card

id	4
label	Parâmetros - Protheus
title	Parâmetros Protheus

Parâmetros EAI

Nome

Descrição

Valor

MV_EAIURL2

Endereço do WebService RM

Exemplo: http://localhost:8051/eaiservice/IConWSEAIService

MV_EAIUSER

Usuário para autenticação no RM.

Exemplo: mestre

MV_EAIPASS

Senha do usuário para autenticação no RM.

Exemplo: totvs

Parâmetros da Integração

Parâmetro

Observação

Valor

MV_NGINTER

L=Logix; R=RM; M=Mensagem única.

M

Outras configurações recomendadas:

Parâmetro

Observação

Valor

Card

id	5
label	Configurando o RM
title	Configurador RM

Inserir aqui a parte do configurador EAI 2.0Instalando/Configurando a integração

Através do módulo de Integrações, acessar o novo "Menu EAI 2.0 | Configurador" e instalar e proceder para instalar o pacote de integração desejado.

Os passos detalhados em TOTVS RM x PROTHEUS - Configurador EAI 2.0 orienta o usuário a instalação dos pacotes de integração e, em nosso contexto, em tal passo a passo, selecione o pacote de integração "TOTVS Rental (SIGALOC) x BackOffice RM" (conforme print mais abaixo) e prossiga as orientações do passo a passo.

Image Modified

Em nosso contexto selecionar instalar o pacote de integração "TOTVS Rental (SIGALOC) x BackOffice RM".

Image Modified

Image Removed

Endereço do EndPoint: http://[IP PROTHEUS]:[PORTA PROTHEUS]/EaiService.apw?WSDL

Image Removed
Ao final do processo de instalação do pacote de integração você deve configurar os parâmetros necessários à integração. No Menu EAI 2.0, acesse o sub-menu Parâmetros adapter:

Image Added

Image RemovedImage Added

Configure o parâmetro CODCLASSIFICPAIS com o código da tabela de classificação utilizada e associada aos países referente à classificação do IBGE.

Informe os Códigos dos Tipos de Movimento criado/configurado anteriormente para cada um dos processos que será utilizado. É permitido configurar parâmetros de tipo de movimento para mais de uma coligada, lembrando que a coligada informada precisa estar integrada.

Image RemovedImage Added

Observação: Este é apenas um exemplo, deve-se informar o Valor com o Código do Tipo de Movimento e Código de classificação de pais criado no ambiente que a integração está sendo implantada.

Confirmando a instalação da integração

Caso deseje verificar, ou se precisar alterar, pode-se acessar os detalhes das configurações/parametrizações da integração através do Menu EAI 2.0, acessando o sub-menu Aplicativos

Image Added

Para visualizar as entidades integradas (sejam cadastros ou consultas) pode-se acessar o anexo de "Rotas" no cadastro de "Aplicativos" (mostrado logo acima).

Image Added

Card

id	64
label	DeAdapters - Para Protheus/RM
title	De-Para	Adapters Protheus

1 – Acesse: Protheus.exe / SIGACFG / Ambiente / Schedule / Adapter EAI.

Image Added

Configuração do adapter para o fonte LOCA076:

Image Added

Configuração do adapter para o fonte MATA410:

Image Added

Configuração do adapter para o fonte MATA410B:

Image Added

Card

id	5
label	Parâmetros - Protheus
title	Parâmetros Protheus

1 – Acesse: Protheus.exe / SIGACFG / Ambiente / Cadastros / Parâmetros

Image Added

Outras configurações recomendadas:
Parâmetro	Observação	Valor
MV_LOCX299	De/Para integração SIGALOC X RM	Exemplo de configuração do parâmetro MV_LOCX299: [003:YYY][004:ZZZ][005:WWW] (sem espaço) Movimentos usados no RM 003 - Solicitação Fatura locação 004 - Solicitação NFS-e 005 - Solicitação NF-e (venda)
MV_LOCX300	Endereço do serviço do RM	Ex.: http://IP:PORTA/EAIService/MEX?wsdl
MV_LOCX301	Usuário para acesso ao serviço do RM	Ex. Totvs
MV_LOCX302	Senha para acesso ao serviço do RM	Ex. 123mudar
MV_QIEICOD	A unidade de medida entre RM e Protheus possui tamanho de campo incompatível, portanto é necessário parametrizar como Falso, para que o Protheus realize o auto incremento.	.F

RM:

Acesse a rotina de cadastramento de De-para no contexto de Integração:

Image Removed

Os passos a seguir devem se repetir para todas as coligadas e filiais a serem integradas.

Efetue o cadastramento do De-Para de Coligadas conforme imagem abaixo, substituindo os valores entre chaves com o valor correspondente pelo código da coligada.

Tabela RM: Fixo valor 'GCOLIGADA'

Campos RM: Fixo valor 'CODCOLIGADA'

Valores RM: Código da Coligada no RM

Aplicativo: Selecionar o Aplicativo configurado para a Integração

Valores Externos: Código da Coligada no RM (mesma do campo Valores RM)

Image Removed

Efetue o cadastramento do De-Para de Filiais conforme imagem abaixo, substituindo os valores entre chaves com o valor correspondente ao descrito internamente a ele.

Tabela RM: Fixo valor 'GFILIAL'

Campos RM: Fixo valor 'CODCOLIGADA|CODFILIAL'

Valores RM: Código da Coligada no RM|Código da Filial no RM

Aplicativo: Selecionar o Aplicativo configurado para a Integração

Valores Externos: Código do grupo de empresa do Protheus + '|' + Código completo da filial no Protheus (composto por Empresa + Filial)

Image Removed