Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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
idconfiguracao
Card
id1
labelConfiguração
titleConfiguraçã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
id2
labelCompartilhamento de Tabelas Protheus
titleCompartilhamento 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

MoedaCompartilhadoCompartilhadoCompartilhadoGMOEDACTO
Unidade de MedidaCompartilhadoCompartilhadoCompartilhadoTUNDSAH
Centro de CustoExclusivoCompartilhadoCompartilhadoGCCUSTOCTT
ProjetoExclusivoExclusivoExclusivoMPRJAF8
ObraExclusivoExclusivoExclusivoMTAREFAAFC
TarefaExclusivoExclusivoExclusivoMTAREFAAF9
EtapaExclusivoExclusivoExclusivoMTAREFAAFC
Condição de PagamentoExclusivoCompartilhadoCompartilhadoTCPGSE4
ProdutoExclusivo *CompartilhadoCompartilhadoTPRODUTOSB1
Cliente/FornecedorCompartilhado **CompartilhadoCompartilhadoFCFOSA1 (Cliente) e SA2 (Fornecedor)
PatrimônioExclusivoExclusivoExclusivoIPATRIMONIOSN1
Local de EstoqueExclusivoExclusivoExclusivoTLOCNNR
FuncionárioExclusivoExclusivoExclusivoPFUNCSRA | SRF | SR3 | SR7
CargosExclusivoCompartilhadoCompartilhadoPCARGOSQ3
FunçãoExclusivoCompartilhadoCompartilhadoPFUNCAOSRJ
Turno de TrabalhoExclusivoCompartilhadoCompartilhadoAHORARIOSR6
Saldo em EstoqueExclusivoCompartilhadoCompartilhado
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
id3
labelAdapters - Protheus
titleAdapters 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 ÚnicaRotinaMensagemDescriçãoEnviaRecebeMétodoOperaçãoCanal de EnvioVersãoFormato
SimAGRA045WAREHOUSELocal de EstoqueNãoSimSíncronoTodasEAI - REST1.000XML
SimATFA012ASSETSAtivo FixoNãoSimSíncronoTodasEAI - REST1.001XML
SimNGMUAmpPat ASSETSVALUATION Ampliação PatrimonialSimNãoSíncronoTodasEAI - REST1.000XML
SimCTBA030COSTCENTERCentro de CustoNãoSimSíncronoTodas
2.000XML
SimCTBA140CURRENCYMoedaNãoSimSíncronoTodasEAI - REST2.001XML
SimMATA010ITEMProdutoNãoSimSíncronoTodasEAI - REST4.005XML
SimMATA020CUSTOMERVENDORFornecedor
Card
id3
labelAdapters - Protheus
titleAdapters 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 ÚnicaRotinaMensagemDescriçãoEnviaRecebeMétodoOperaçãoCanal de EnvioVersãoFormato
SimAGRA045WAREHOUSELocal de EstoqueNãoSimSíncronoTodasEAI - REST12.000002XML
SimATFA012MATA030ASSETSCUSTOMERVENDORAtivo FixoClienteNãoSimSíncronoTodasEAI - REST12.001002XML
SimCTBA030MATA360COSTCENTERPAYMENTCONDITIONCentro Condição de CustoPagamentoNãoSimSíncronoTodasEAI - REST2.000XML
SimNGMUCanMnOCANCELMAINTENANCEORDERCancelamento de OS SimNãoSíncronoTodasEAI - REST1.000XML
SimNGMUCanReqCANCELREQUEST Cancelamento de Requisição SimSimSíncronoTodasEAI - REST1.000XML
SimNGMUInfParINFOOFPARCELVALUESInformações de ParcelasNãoSimSíncronoTodasEAI - REST1.000XML
SimMATA030NGMUMntOrdCUSTOMERVENDORMAINTENANCEORDERClienteOrdem de ServiçoNãoSimSimSíncronoTodasEAI - REST21.002XML
SimMATA360PAYMENTCONDITIONNGMUOrderORDERPedido CompraSimCondição de PagamentoNãoSimSíncronoTodasEAI - REST23.000002XML
SimNGMURequesREQUEST Solicitação de Armazém/CompraSimNãoSíncronoTodasEAI - REST1.010XML
SimNGMUCanReqNGMUStoLvl CANCELREQUEST STOCKLEVEL Cancelamento Consulta de Requisição Saldo SimSimNãoSíncronoTodasEAI - REST1.000001XML
SimNGMUStoTuOSTOCKTURNOVER Baixa de EstoqueSimSimSíncronoTodasEAI - REST1.006XML
SimNGMUMntOrdNGMUTRAREQMAINTENANCEORDERTRACEABILITYREQUESTOrdem Consulta Níveis de ServiçoEstoqueSimSimNãoSíncronoTodasEAI - REST1.002001XML
SimPMSA200PROJECTNGMUOrderORDERProjetoPedido CompraNãoSimNãoSíncronoTodasEAI - REST32.002000XML
SimPMSA201NGMURequesREQUEST SUBPROJECTObra (EDT)NãoSolicitação de Armazém/CompraSimNãoSíncrono SíncronoTodasEAI - REST12.010000XML
SimNGMUStoLvl STOCKLEVEL Consulta de Saldo SimPMSA201ASTEPPROJECTEtapa (EDT)NãoSimNãoSíncronoTodasEAI - REST12.001000XML
SimPMSA203TASKPROJECTTarefaNãoSimSíncronoTodasEAI - REST2.000XML
SimQIEA030UNITOFMEASUREUnidade de medidaNãoSimSíncronoTodasEAI - REST2.000XML
SimGPEA370EMPLOYEEPOSITION CargoNãoSimSíncronoTodasEAI-REST1.000XML
SimGPEA030SUBPROJECTROLEFunçãoNãoSimSíncronoTodasEAI-REST1.000XML
SimGPEA010STEPPROJECTEMPLOYEEFuncionárioNãoSimSíncronoTodasEAI-REST2.003XML
SimPMSA203TASKPROJECTNGMUGETSITGETEMPLOYEESITUATIONSSituação do FuncionárioSimNãoSíncronoTodasEAI-REST1.000XML
SimGPEA080 SHIFTWORK TurnoNãoSimSíncronoTodasEAI-REST1.000XML
Card
id4
labelParâmetros - Protheus
titleParâ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
NomeDescriçãoValor
MV_EAIURL2Endereço do WebService RMExemplo: http://localhost:8051/eaiservice/IConWSEAIService               
MV_EAIUSERUsuário para autenticação no RM.Exemplo: mestre
MV_EAIPASSSenha do usuário para autenticação no RM.Exemplo: totvs




Parâmetros da Integração
ParâmetroObservaçãoValor
MV_NGINTERL=Logix; R=RM; M=Mensagem única.M
MV_NGGERSAIndica se deve gerar Solicitação de Armazém ao invés de Solicitação de ComprasS

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_NGMNTPCIntegração com PCP.S
MV_PRODFERItem de estoque que indica ferramentas no SIGAMNT.<produto>
MV_PRODTERItem 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_NGSALHODefine se o campo salário do funcionário da manutenção é integrado com o GPE.S
MV_NGMNTRHIntegração Manutenção (MNT) com Recursos Humanos (RH).N
MV_RASTRODetermina a utilização ou não da rastreabilidade dos lotes de produção (S para ‘sim’ ou N para ‘não’).
MV_LOCALIZIndica se produtos poderão usar controle de localização ou não (S para ‘sim’ ou N para ‘não’).
MV_NGMNTCMIntegração do Manutenção de Ativos (MNT) com Compras (COM). Informar S para sim e N para não.S
MV_NGMNTFIIntegração do Manutenção de Ativos (MNT) com Financeiro (FIN). Informar S para sim e N para não.S
MV_PRODTRXItem de estoque que indica multas no MNT.<produto>
MV_PRODTS2Item de estoque que indica documentos no MNT.<produto>
MV_PRODTS8Item de estoque que indica honorários no MNT.<produto>
MV_NGPRSB2Busca 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âmetroObservaçãoValor
MV_NGMULOSPermite a abertura de mais de uma OS por SS.S
MV_NGMNTFRIndica que a empresa utiliza o sistema Gestão de Frotas.S
MV_NGPNEUSIndica 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 estoqueS/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âmetroDescriçãoValor
MV_NGSTAPLCódigo do Status para Aplicado<codigo>
MV_NGSTAGRCódigo do Status para Aguardando Reforma<codigo>
MV_NGSTAEUCódigo do status para Estoque Usado.<codigo>
MV_NGSTAERCódigo do Status para Estoque Reformado<codigo>
MV_NGSTAAT Código do Status para Aguardando Análise Técnica<codigo>
MV_NGSTARSCódigo do Status para Removido de Serviço<codigo>
MV_NGSTAENCódigo do Status para Estoque Novo<codigo>




Pneu

ParâmetroDescriçãoValor
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_NGBEMTRCó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
id5
labelConfigurando o RM
titleConfigurador 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
id6
labelDe-Para Protheus/RM
titleDe-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.