Histórico da Página

A partir da versão 12.1.26 a Integração TOTVS Manutenção de Ativos x BackOffice RM tem uma nova versão 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 únicas, evitando dessa forma, o processo de transformação de mensagens.

O 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 Manutenção de Ativos (SIGAMNTTOTVS Rental (SIGALOC) com o 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.2533

RM : a partir da versão 12.1.2633

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.

AFCExclusivoPCARGO

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
Projeto	Exclusivo	Exclusivo	Exclusivo	MPRJ	AF8
Obra	Exclusivo	Exclusivo	Exclusivo	MTAREFA
Tarefa	Exclusivo	Exclusivo	Exclusivo	MTAREFA	AF9
Etapa	Exclusivo	Exclusivo	Exclusivo	MTAREFA	AFC
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)	Patrimônio
Exclusivo	Exclusivo	Exclusivo	IPATRIMONIO	SN1	Local de Estoque	Exclusivo	Exclusivo	Exclusivo	TLOC	NNR
Funcionário	Vendedor	Exclusivo	Exclusivo	PFUNC	SRA \| SRF \| SR3 \| SR7	Cargos	Exclusivo	Compartilhado	Compartilhado	TVEN	SQ3
Função	Exclusivo	Compartilhado	Compartilhado	PFUNCAO	SRJ
Turno de Trabalho	Exclusivo	Compartilhado	Compartilhado	AHORARIO	SR6
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:

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 - ProtheusConfigurando o RM
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

ATFA012

ASSETS

Ativo Fixo

Não

Sim

Síncrono

Todas

EAI - REST

1.001

XML

Sim

NGMUAmpPat

ASSETSVALUATION

Ampliação Patrimonial

Sim

Não

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

NGMUCanMnO

CANCELMAINTENANCEORDER

Cancelamento de OS

Sim

Não

Síncrono

Todas

EAI - REST

1.000

XML

Sim

NGMUCanReq

CANCELREQUEST

Cancelamento de Requisição

Sim

Síncrono

Todas

EAI - REST

1.000

XML

Sim

NGMUInfPar

INFOOFPARCELVALUES

Informações de Parcelas

Não

Sim

Síncrono

Todas

EAI - REST

1.000

XML

Sim

NGMUMntOrd

MAINTENANCEORDER

Ordem de Serviço

Sim

Síncrono

Todas

EAI - REST

1.002

XML

Sim

NGMUOrder

ORDER

Pedido Compra

Sim

Não

Síncrono

Todas

EAI - REST

3.002

XML

Sim

NGMUReques

REQUEST

Solicitação de Armazém/Compra

Sim

Não

Síncrono

Todas

EAI - REST

1.010

XML

Sim

NGMUStoLvl

STOCKLEVEL

Consulta de Saldo

Sim

Não

Síncrono

Todas

EAI - REST

1.001

XML

Sim

NGMUStoTuO

STOCKTURNOVER

Baixa de Estoque

Sim

Síncrono

Todas

EAI - REST

1.006

XML

Sim

NGMUTRAREQ

TRACEABILITYREQUEST

Consulta Níveis de Estoque

Sim

Não

Síncrono

Todas

EAI - REST

1.001

XML

Sim

PMSA200

PROJECT

Projeto

Não

Sim

Síncrono

Todas

EAI - REST

2.000

XML

Sim

PMSA201

SUBPROJECT

Obra (EDT)

Não

Sim

Síncrono

Todas

EAI - REST

2.000

XML

Sim

PMSA201A

STEPPROJECT

Etapa (EDT)

Não

Sim

Síncrono

Todas

EAI - REST

2.000

XML

Sim

PMSA203

TASKPROJECT

Tarefa

Não

Sim

Síncrono

Todas

EAI - REST

2.000

XML

Sim

QIEA030

UNITOFMEASURE

Unidade de medida

Não

Sim

Síncrono

Todas

EAI - REST

2.000

XML

Sim

GPEA370

EMPLOYEEPOSITION

Cargo

Não

Sim

Síncrono

Todas

EAI-REST

1.000

XML

Sim

GPEA030

ROLE

Função

Não

Sim

Síncrono

Todas

EAI-REST

1.000

XML

Sim

GPEA010

EMPLOYEE

Funcionário

Não

Sim

Síncrono

Todas

EAI-REST

2.003

XML

Sim

NGMUGETSIT

GETEMPLOYEESITUATIONS

Situação do Funcionário

Sim

Não

Síncrono

Todas

EAI-REST

1.000

XML

Sim

GPEA080

SHIFTWORK

Turno

Não

Sim

Síncrono

Todas

EAI-REST

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

MV_NGGERSA

Indica se deve gerar Solicitação de Armazém ao invés de Solicitação de Compras

S

MV_ESTNEG

Não permite estoque negativo. O estoque é consultado no RM, independente das movimentações na SD3 e da SB2.
Porém há funções Microsiga que não relevam essa consulta no âmbito do MNT.
Por isso a funcionalidade deveria ser desenvolvida pelo módulo de Estoque (função SaldoSB2).
Em todo caso, o SB2 está sendo alterado conforme o resultado da consulta da integração.

N

MV_NGMNTES

Integração com Estoque.

S

MV_NGMNTPC

Integração com PCP.

S

MV_PRODFER

Item de estoque que indica ferramentas no SIGAMNT.

MV_PRODTER

Item de estoque que indica terceiros no SIGAMNT

MV_NGMNTCP

Indica se a numeração dos itens da solicitação de compras será a mesma.
Este parâmetro sobrepõe o processo padrão de geração do Compras.

N

MV_NGCORPR

Permite gerar empenho e SC’s para OS Corretiva.

S

MV_NGMNTAT

Integração Manutenção (MNT) c/ Ativo (ATF).
Informar “” ou “N” não integra;
1= alterações no ATF replicarão no MNT;
2= MNT p/ ATF;
3= MNT p/ ATF e ATF p/ MNT.

3

MV_NGSALHO

Define se o campo salário do funcionário da manutenção é integrado com o GPE.

S

MV_NGMNTRH

Integração Manutenção (MNT) com Recursos Humanos (RH).

N

MV_RASTRO

Determina a utilização ou não da rastreabilidade dos lotes de produção (S para ‘sim’ ou N para ‘não’).

MV_LOCALIZ

Indica se produtos poderão usar controle de localização ou não (S para ‘sim’ ou N para ‘não’).

MV_NGMNTCM

Integração do Manutenção de Ativos (MNT) com Compras (COM). Informar S para sim e N para não.

S

MV_NGMNTFI

Integração do Manutenção de Ativos (MNT) com Financeiro (FIN). Informar S para sim e N para não.

S

MV_PRODTRX

Item de estoque que indica multas no MNT.

MV_PRODTS2

Item de estoque que indica documentos no MNT.

MV_PRODTS8

Item de estoque que indica honorários no MNT.

MV_NGPRSB2

Busca preço médio da tabela SB2.

S

MV_NGLOCPAD

Indica o Almoxarifado padrão para gerar os produto utilizado pelo SIGAMNT (Manutenção/Terceiros)

Outras configurações recomendadas:

Parâmetro

Observação

Valor

MV_NGMULOS

Permite a abertura de mais de uma OS por SS.

S

MV_NGMNTFR

Indica que a empresa utiliza o sistema Gestão de Frotas.

S

MV_NGPNEUS

Indica se utiliza complemento de pneus.

S

MV_NGPNEST

Indica se a empresa utiliza identificação do bem no controle de estoque.

S

MV_NGOSNFE

Indica se consiste integração do Documento de Entrada no recebimento da O.S. em Lote pela Nota Fiscal. (1=Sim;2=Nao)

2

MV_NGMNTSC

Indica o modo de aglutinar os itens da solicitação de compra dos produtos 1 - Normal, 2 - Por OP, 3 - Por Necessidade

1

MV_ESTHOME

Indica o momento que o estoque sera debitado. S = Abastecimento, C = Conciliação, N = Não baixa estoque

S/C

MV_NGMNTAS

Define se aglutina as Solicitações de Armazém para a mesma Ordem de Serviço (1=Sim,2=Não)

1

Configurador RM

Instalando/Configurando a integração

Através do módulo de Integrações, acessar o novo Menu EAI 2.0 | Configurador 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 Added

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

Image Added

Ao final do processo de instalação do pacote de integração você deve configurar os parâmetros necessários à integração.

Abaixo as configurações necessárias ao Gestão de Frotas (MV_NGMNTFR = ‘S’) para utilização do Controle de Pneus. Os parâmetros devem estar configurados
conforme o cadastro de status do MNT.

Parâmetro

Descrição

Valor

MV_NGSTAPL

Código do Status para Aplicado

MV_NGSTAGR

Código do Status para Aguardando Reforma

MV_NGSTAEU

Código do status para Estoque Usado.

MV_NGSTAER

Código do Status para Estoque Reformado

MV_NGSTAAT

Código do Status para Aguardando Análise Técnica

MV_NGSTARS

Código do Status para Removido de Serviço

MV_NGSTAEN

Código do Status para Estoque Novo

Pneu

Parâmetro

Descrição

Valor

MV_NG1ANAT

Indica quais serão os destinos que sofrerão entradas/baixas no estoque.

MV_NGSECON

Código de serviço para conserto de pneus.

MV_NGSEREF

Código do serviço para Reforma de Pneus

MV_NGSERPN

Indica o código do serviço que sera utilizado para movimentação de pneus.

MV_NGRODIZ

Código de serviço que será utilizado para o.s. de rodízio de pneus.

MV_NGSERCA

Indica o código do serviço para CANIBALISMO (Desmontagem da estrutura de rodados).

MV_NGSINSP

Indica o código do serviço de inspeção de pneus.

MV_NGSTACA

Indica o código do status para Canibalismo.

MV_NGSTAGC

Código do status para Aguardando Conserto.

MV_NGSTEST

Indica o status para o pneu no estoque da filial.

MV_NGBEMTR

Código do Status para Bem Transferido.

MV_NGSTEP

Indica se pode movimentar o pneu de STEP no processo do rodizio.

MV_NGMOROD

Código do motivo padrão para o rodizio de pneus.

MV_NGMODEF

Código dos motivos de defeito nos pneus.

Card

id	5
label	Configurando o RM
title	Configurador RM

Inserir aqui a parte do configurador EAI 2.0

Caso o cliente esteja utilizando a integração com o framework RM EAI 1.0, deve-se realizar a conversão para o EAI 2.0. Maiores informações de como realizar esta conversão consulte o documento Conversor do EAI 1.0 para EAI 2.0 do pacote Manutenção de Ativos x BackOffice RM.

Após a conversão, acessar o novo Menu EAI 2.0 | Aplicativos e parametrizar o campo 'Endereço do EndPoint' com o caminho do WebService do Protheus. Informe também o usuário e senha a ser utilizado na autenticação do serviço.

Image Removed

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

Image Removed
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