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 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 (SIGAMNT) com o BackOffice RM .Para seguir as configurações descritas abaixo é importante que já se tenha o ambiente Protheus instalado.

Protheus : a partir da versão 12.1.0.25

RM : a partir da versão 12.1.26

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
Projeto	Exclusivo	Exclusivo	Exclusivo	MPRJ	AF8
Obra	Exclusivo	Exclusivo	Exclusivo	MTAREFA	AFC
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	Exclusivo	Exclusivo	Exclusivo	PFUNC	SRA \| SRF \| SR3 \| SR7
Cargos	Exclusivo	Compartilhado	Compartilhado	PCARGO	SQ3
Função	Exclusivo	Compartilhado	Compartilhado	PFUNCAO	SRJ
Turno de Trabalho	Exclusivo	Compartilhado	Compartilhado	AHORARIO	SR6
Saldo em Estoque	Exclusivo	Compartilhado	Compartilhado		SB2

* 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 * 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.).
** Para utilizar esta integração é premissa que o cadastro de Cliente\Fornecedor esteja parametrizado como Global, obrigatoriamente deve-se compartilhar a tabela referente no Protheus por empresa.

Card

id	3
label	Adapters - Protheus
title	Adapters Protheus

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

Image Added

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:

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

Card

id	3
label	Adapters - Protheus
title	Adapters Protheus

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:

CTBA140CURRENCYMoedaSim2001MATA010ITEMProdutoNão4005MATA020CUSTOMERVENDORFornecedor2002NGMUCanMnOCANCELMAINTENANCEORDERCancelamento OS 000NGMUInfParINFOOFPARCELVALUESInformações ParcelasNão000NGMUStoTuOSTOCKTURNOVER Baixa de EstoqueSim1006NGMUTRAREQTRACEABILITYREQUESTConsulta Níveis de EstoqueNão1001PMSA200PROJECTProjeto2PMSA201Obra (EDT) Síncrono2PMSA201AEtapa (EDT)000TarefaSim2QIEA030UNITOFMEASUREUnidade de medida2

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

12.000002

XML

Sim

ATFA012MATA030

ASSETSCUSTOMERVENDOR

Ativo FixoCliente

Não

Sim

Síncrono

Todas

EAI - REST

12.001002

XML

Sim

CTBA030MATA360

COSTCENTERPAYMENTCONDITION

Centro Condição de CustoPagamento

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

MATA030NGMUMntOrd

CUSTOMERVENDORMAINTENANCEORDERCliente

Ordem de Serviço

NãoSim

Sim

Síncrono

Todas

EAI - REST

21.002

XML

Sim

MATA360

PAYMENTCONDITION

NGMUOrder

ORDER

Pedido Compra

SimCondição de Pagamento

Não

Sim

Síncrono

Todas

EAI - REST

23.000002

XML

Sim

NGMUReques

REQUEST

Solicitação de

Armazém/Compra

Sim

Não

Síncrono

Todas

EAI - REST

1.

010

XML

Sim

NGMUCanReqNGMUStoLvl

CANCELREQUEST STOCKLEVEL

Cancelamento Consulta de Requisição Saldo

SimSim

Não

Síncrono

Todas

EAI - REST

1.000001

XML

Sim

NGMUStoTuO

STOCKTURNOVER

Baixa de

Estoque

Sim

Síncrono

Todas

EAI - REST

1.

006

XML

Sim

NGMUMntOrdNGMUTRAREQ

MAINTENANCEORDERTRACEABILITYREQUEST

Ordem Consulta Níveis de ServiçoEstoque

SimSim

Não

Síncrono

Todas

EAI - REST

1.002001

XML

Sim

PMSA200

PROJECTNGMUOrder

ORDERProjeto

Pedido CompraNão

SimNão

Síncrono

Todas

EAI - REST

32.002000

XML

Sim

PMSA201

NGMUReques

REQUEST

SUBPROJECT

Obra (EDT)

NãoSolicitação de Armazém/Compra

Sim

Não

Síncrono Síncrono

Todas

EAI - REST

12.010000

XML

Sim

NGMUStoLvl

STOCKLEVEL

Consulta de Saldo

Sim

PMSA201A

STEPPROJECT

Etapa (EDT)

Não

SimNão

Síncrono

Todas

EAI - REST

12.001000

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

SUBPROJECT

ROLE

Função

Não

Sim

Síncrono

Todas

EAI-REST

1.000

XML

Sim

GPEA010

STEPPROJECT

EMPLOYEE

Funcionário

Não

Sim

Síncrono

Todas

EAI-REST

2.

003

XML

Sim

PMSA203

TASKPROJECT

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

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

2 – Clique em Pesquisar.

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

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

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.	<produto>
MV_PRODTER	Item de estoque que indica terceiros no SIGAMNT	<produto>
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.	<produto>
MV_PRODTS2	Item de estoque que indica documentos no MNT.	<produto>
MV_PRODTS8	Item de estoque que indica honorários no MNT.	<produto>
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)	<Almoxarifado>

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

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	<codigo>
MV_NGSTAGR	Código do Status para Aguardando Reforma	<codigo>
MV_NGSTAEU	Código do status para Estoque Usado.	<codigo>
MV_NGSTAER	Código do Status para Estoque Reformado	<codigo>
MV_NGSTAAT	Código do Status para Aguardando Análise Técnica	<codigo>
MV_NGSTARS	Código do Status para Removido de Serviço	<codigo>
MV_NGSTAEN	Código do Status para Estoque Novo	<codigo>

Pneu
Parâmetro	Descrição	Valor
MV_NG1ANAT	Indica quais serão os destinos que sofrerão entradas/baixas no estoque.	<codigo>
MV_NGSECON	Código de serviço para conserto de pneus.	<codigo>
MV_NGSEREF	Código do serviço para Reforma de Pneus	<codigo>
MV_NGSERPN	Indica o código do serviço que sera utilizado para movimentação de pneus.	<codigo>
MV_NGRODIZ	Código de serviço que será utilizado para o.s. de rodízio de pneus.	<codigo>
MV_NGSERCA	Indica o código do serviço para CANIBALISMO (Desmontagem da estrutura de rodados).	<codigo>
MV_NGSINSP	Indica o código do serviço de inspeção de pneus.	<codigo>
MV_NGSTACA	Indica o código do status para Canibalismo.	<codigo>
MV_NGSTAGC	Código do status para Aguardando Conserto.	<codigo>
MV_NGSTEST	Indica o status para o pneu no estoque da filial.	<codigo>
MV_NGBEMTR	Código do Status para Bem Transferido.	<codigo>
MV_NGSTEP	Indica se pode movimentar o pneu de STEP no processo do rodizio.	<codigo>
MV_NGMOROD	Código do motivo padrão para o rodizio de pneus.	<codigo>
MV_NGMODEF	Código dos motivos de defeito nos pneus.	<codigo>

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 Modified

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

Image Modified

No Menu EAI 2.0, acesse o sub-menu Parâmetros adapter:

Image Modified

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.

Image Modified

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 Modified

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

Card

id	6
label	De-Para Protheus/RM
title	De-Para

RM:

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

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)

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)

Protheus:

Acessar o Configurador > Ambiente > Schedule > Emp Filial Mensagem Unica

Incluir o De/Para > Incluir

Preencher os campos conforme exemplo abaixo:

Observação: O código da Empresa e Filial podem alterar de acordo com a estrutura utilizada.

Páginas filhas

Versões comparadas

Versão antiga 15

Nova versão 24

Chave