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 |
---|
|
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.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 |
* 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. |
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 | 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 | 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 | 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 | 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 |
---|
| 1 – Acesse: Protheus.exe / SIGACFG / Ambiente / Cadastros / Parâmetros Image Added 2 – Clique em Pesquisar. Image Added Informe o nome do parâmetro e clique em Procurar. A pesquisa irá retornar o parâmetro
Image Added
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 Added Endereço do EndPoint: http://[IP PROTHEUS]:[PORTA PROTHEUS]/EaiService.apw?WSDL Image Added
No Menu EAI 2.0, acesse o sub-menu Parâmetros adapter: Image 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. Image Added
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 Added 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: Image Added Image Added 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 Added 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 Added
Protheus: Acessar o Configurador > Ambiente > Schedule > Emp Filial Mensagem Unica Image Added
Incluir o De/Para > Incluir Image Added
Preencher os campos conforme exemplo abaixo: Image Added Observação: O código da Empresa e Filial podem alterar de acordo com a estrutura utilizada |
|
Este documento tem como objetivo demonstrar os passos para a execução do configurador da integração do TOTVS Rental CRM x Backoffice RM e algumas verificações de como devem estar os cadastros após a execução do configurador.
O configurador da integração "TOTVS Rental x Backoffice RM" pode ser acessado através do menu executar pesquisando por "Configurador EAI 2.0 - MasterCRM" dando acesso a tela:
Image Removed
Informe os campos URL, usuário e senha e execute a validação, se estiver correta vai ser possível executar o configurador.
Image Removed
Image Removed
Image Removed
Após a execução do processo do configurador a tela de LOG será apresentada conforme o print abaixo com as mensagens vinculadas à tal integração
Image Removed
Image Removed
Aplicativos
Image Removed
Transações
Image Removed
Image Removed
Transações com o anexo das versão disponíveis para as mensagens
Image Removed
Pacotes que estão instalados
Image Removed
Rotas para os aplicativos
Image Removed
Parâmetros necessários às integrações
Este em destaque é o tipo de movimento utilizado para a criação do movimento a partir da mensagem ORDER
Image Removed
...