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 |
---|
| Card |
---|
id | 0 |
---|
label | Configurando o RM |
---|
title | 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 Removed
Image Removed
Image Removed
Em nosso contexto selecionar instalar o pacote de integração "TOTVS Rental (SIGALOC) x BackOffice RM".
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 Removed
Image Removed
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 Removed
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 Removed
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 Removed
Image Removed
Image Removed
Para visualizar as entidades integradas (sejam cadastros ou consultas) pode-se acessar o anexo de "Rotas" no cadastro de "Aplicativos" (mostrado logo acima).
Image Removed
Image Removed | 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. |
Card |
---|
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: 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 | <nome do parâmetro> | <Texto com explicação/uso do parâmetro> | <valor do parâmetro> | Outras configurações recomendadas: |
---|
Parâmetro | Observação | Valor |
---|
<nome do parâmetro> | <Texto com explicação/uso do parâmetro> | <valor do parâmetro> | Card |
---|
|
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 | JSON | Sim | CTBA030 | COSTCENTER | Centro de Custo | Não | Sim | Síncrono | Todas | 2.000 | JSON | Sim | CTBA140 | CURRENCY | Moeda | Não | Sim | Síncrono | Todas | EAI - REST | 2.001 | JSON | Sim | MATA010 | ITEM | Produto | Não | Sim | Síncrono | Todas | EAI - REST | 4.005 | JSON | Sim | MATA020 | CUSTOMERVENDOR | Fornecedor | Nãoid | 3 |
---|
label | Adapters - Protheus |
---|
title | Adapters Protheus |
---|
| 1 – Acesse: Protheus.exe / SIGACFG / Ambiente / Schedule / Adapter EAI. Image Removed
2 – Conferir se os adapters relacionados abaixo foram criados corretamente ao configurar o pacote: 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: | Sim | Síncrono | Todas | EAI - REST | 2.002 | JSON | Sim | MATA030 | CUSTOMERVENDOR | Cliente | Não | Sim | Síncrono | Todas | EAI - REST | 2.002 | JSON | Sim | MATA360 | PAYMENTCONDITION | Condição de Pagamento | Não | Sim | Síncrono | Todas | EAI - REST | 2.000 | JSON | Sim | NGMUOrder | ORDER | Pedido Compra | Sim | Não | Síncrono | Todas | EAI - REST | 3.002 | JSON | Sim | NGMUStoLvl | STOCKLEVEL | Consulta de Saldo | Sim | Não | Síncrono | Todas | EAI - REST | 1.001 | JSON | 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 | JSON | Card |
---|
id | 4 |
---|
label | Parâmetros - Protheus |
---|
title | Parâmetros Protheus |
---|
| id | 0 |
---|
label | Configurando o RM |
---|
title | 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 Modified
Image Modified
Image Modified
Em nosso contexto selecionar instalar o pacote de integração "TOTVS Rental (SIGALOC) x BackOffice RM". Image Modified
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 Modified
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.
![](/download/attachments/624766281/image2018-9-21_14-58-6.png?version=1&modificationDate=1623939004697&api=v2)
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.
![](/download/attachments/624766281/image2021-6-17_13-3-39.png?version=1&modificationDate=1623945820013&api=v2)
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 Modified
Image Modified
Image Modified
Para visualizar as entidades integradas (sejam cadastros ou consultas) pode-se acessar o anexo de "Rotas" no cadastro de "Aplicativos" (mostrado logo acima). Image Modified
Image Modified
|
Card |
---|
id | 4 |
---|
label | Adapters - Protheus |
---|
title | Adapters Protheus |
---|
| 1 – Acesse: Protheus.exe / SIGACFG / Ambiente / Schedule / Adapter EAI. Image Added
Configuração do adapter para o fonte LOCA076: Image Added
Image Added
Configuração do adapter para o fonte MATA410: Image Added
Image Added
Configuração do adapter para o fonte MATA410B: Image Added
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. |
|
|