Histórico da Página

Documento de configurar o EAI do Protheus: Como iniciar um servidor de Webservices no Protheus

Documento de Serviço REST: 1. Configuração do REST do Protheus

Módulo – APWEBWIZARD

Usuário = Administrador do Protheus

Incluir um novo Módulo Web

Módulo Web = WS – Migrossiga Protheus Web Services

Nome da Instancia = inserir nome da Instância web do Protheus

Parâmetro: Habilitar processos na inicialização do Servidor = marcado faz o processo subir automaticamente com o Appserver.ini e criará a TAG ONSTART

Neste assistente é necessário informar no Host.

• LocalHost + Porta  = Relacionar com a Filial
• IP do Servidor + Porta  = Relacionar com a Filial
• Nome do Servidor  + Porta  = Relacionar com a Filial

Nesta etapa é informado o número mínimo e máximo de usuários.

Iniciando o módulo EAI do Protheus

Iniciando o Appserver.ini

Testando o EAI do Protheus

Caminho padrão do EAI : ( http://localhost:89/EAISERVICE.apw?WSDL )

Porta inserida no configurador do EAI e Appserver.ini

Serviço REST – configuração

Configuração do REST no Appserver.ini

Reiniciar o serviço Appserver.ini após e testando serviço REST

Testando serviço Rest

Caminho padrão do REST : ( http://localhost:8013/rest/ )

Caminho seguido da porta incluída no HTTPREST

Configurando WebService do RM: Como Expor os Web Services do RM através do Host (recomendado)

Localizar a pasta RM.Net

Localizar os Arquivos :

• RM.exe.config
• RM.Host.exe.config  ou
• RM.Host.Service.exe.config

Editar os Arquivos para inserir TAGS precisas para que possa subir o WebServiçe do RM.

Configurando o RM.exe.config

Incluir a Tag:

• <add key="Host" value="BHN050102870" />

Servidor que irá subir o WebServiçe do RM.

Configurando o RM.Host.exe.config

Incluindo as Tags:

• <add key="DefaultDB" value="CorporeRM" />
• <add key="HttpPort" value="8051" />

Incluindo o Alias do Banco de dados RM e Porta do WebService

Localizar o arquivo: _Broker.dat e eliminar

Localizar em seguida o arquivo: RM.Host.exe e iniciar como Administrador

Host iniciado

 Testando o WebService do RM

Caminho para testar o WebServiçe do RM : ( http://10.31.73.79:8051/wspageindex/ ) 

Informar o IP do servidor ou nome.

DEFAULTDB: Informado o Alias configurado no Host.config

Link para incluir no parâmetro MV_EAIURL2 do Protheus

Clicar em :

EAIService/MEX?wsdl

 Comando que será informado no parâmetro ( MV_EAIURL2 ) http://bhn050102870.bh01.local:8051/EAIService/IConWSEAIServic

Servidor na qual encontra-se ativo o WebServiçe RM.

 TOTVS utiliza uma solução customizada do c-treeACE ISAM Server, desenvolvido pela FairCom, para arquivos temporários, arquivos de help, arquivos de senhas, gerenciamento do dicionário de dados e para banco de dados ISAM, através da linguagem AdvPL e RDD CTREECDX e CTREETMP.

Como configurar Ctree : c-tree - Guia de instalação

O processo de conversão para EAI 2.0 é preciso que o cadastro de Convênio seja enviado do BackOffice Protheus para o RM

Veja como efetuar o cadastro : Cadastro Bancário e Convênio (BackOffice Protheus & Totvs Incorporação.)

Como Atualizar a Versão de base RM: Atualizador RM

Executar ( RM.Atualizador.exe )

Selecionar o ALIAS da base de dados que será atualizada ( Base de dados RM )

Avançar

Avançar

Não desejo analisar os possíveis impactos ou já realizei este procedimento

Avançar

Avançar

Avançar

Não marcar o parâmetro e em seguida ( Avançar )

Iniciar Atualização

Sim

OK em em seguida – Avançar

Avançar

Concluir

Configurações que devem ser realizadas antes da Conversão:

Desabilitando fórmulas visuais

Gestão | Fórmula Visual | Fórmula Visual

Selecionar a Fórmula = MENSAGEM PADRÃO - Lançamentos Financeiros 1.002

Inativar

Formula = Mensagem única - Obra / Etapa / Tarefa

Inativar a fórmula

Formula = Mensagem Única - Projeto

Inativar

Fórmula = Mensagem Única - Contrato

Inativar

Parametros de Integração

Parâmetro : PRJ_URLAPIRESTPROTHEUS

Valor = http://10.31.73.79:8013/rest ( Serviço Rest do Protheus )

Informar IP do servidor na qual o Serviço REST encontra-se ATIVO.

Parâmetro : PRJ_USRAPIRESTPROTHEUS

Valor = Usuário Administrador do Protheus

Parâmetro : PRJ_PASSAPIRESTPROTHEUS

Valor = Senha do usuário Administrador do Protheus

Parâmetro : AJUSTECAMPOPARCELATIN

Valor = Marcado ( True )

Obs- este tem que ser criado

Convertendo a base RM para EAI 2.0

Para Habilitar o processo de conversão para EAI 2.0 favor entrar em contato com a TOTVS!

Entrar no RM ( Módulo – Integração )

Verificar se o Contexto encontra-se todo preenchido.

• Coligada
• Filial

RM Conector | Mensagem Única | Conversor EAI 2.0

Avançar

Continuar conversão – Marcado

Avançar em seguida

OK

Avançar

Executar

OBS : Este processo irá converter o RM do EAI 1.0 para 2.0 automaticamente

1- Converter os dados relacionados às estruturas pertinentes às integrações (a saber: cadastro de integrações, entidades, mensagens, de/para, ... etc) para uma nova estrutura de dados

2- Converter os dados relacionados à integração TOP + Protheus

3- Converter os dados relacionados à integração TIN + Protheus.

a. Os valores de integração dos lançamentos financeiros (RM) são convertidos em valores acessórios dos títulos (Protheus);

b. Todos os adapters relacionados à integração são cadastrados no RM nas versões necessárias para o correto funcionamento da integração;

c. É ligado o parâmetro de Reajuste Online

OK e em seguida – Fechar

Abre automaticamente a tela – Processo de carga de dados de apropriação nos Pedidos de Compra integrada

 Avançar

Marcar todas coligadas que deverão sofrer a conversão!

Executar o processo

Processado com sucesso ( Fechar em seguida )

PARÂMETRO PAÍS

BackOffice | Gestão Fiscal

Cadastros | Globais | Mais ... | Países

Selecionar – Brasil e em seguida  ( Editar )

Anexos | Codificação de País

Selecionar Classificação

Neste exemplo – Classificação = 1 que será colocada nos Parâmetros de Integração.

Código do Brasil no BackOffice Protheus = 105, como mostra a figura abaixo:

Código = 105

Parâmetro : CODCLASSIFICPAIS

Valor = 1

Configurando Parâmetros do Protheus

SIGACFG

Base de Dados | Bases de Dados

Parâmetros | Pesquisar

MV_RMTINVE = 2

Observação: Este parâmetro será automaticamente criado pelo conversor do TIN EAI2.0. Caso ele não exista ou esteja criado de forma diferente, a conversão irá recriá-lo.

MV_EAIURL2 = WEB SERVIÇE DO RM

Ambiente | Shedule | Adapter E.a.i

ROTINA :FINI070LST                                    

NOME : LISTOFACCOUNTRECEIVABLESETTLEMENTS

ROTINA : FINI035LST                                       

NOME : LISTOFCOMPLEMENTARYVALUE  

Observação: _{O sistema irá bloquear o módulo TIN enquanto a base não estiver com a conversão totalmente finalizada. Assim que a conversão EAI 1 para EAI 2 finalizar o módulo será liberado para utilização.}

Cadastros Contábeis ( TIN & PROTHEUS )

Adpaters utilizados na Integração Contábil

Módulo - SIGACTB

Atualizações | Entidades | Plano de Contas

Plano de Contas inserido no Protheus

Mensagem enviada para o RM.

Plano de contas enviado para o RM.

Atualizações | Entidades | Centro de Custo

Centro de Custo cadastrado no Protheus

Mensagem enviada para o RM.

Centro de Custo enviado para o RM.

Segue o Link com orientações de como criar os Adapters no TIN: DI_POC_TOTVS_Incorporação_BackOffice_Protheus

Configurações | Configurações Contábeis

Configurações de Custos

Editar - Item Conta e Cod Cl Val

Contr Saldo?

1 = SIM

2 = NÃO

Editar para que fiquem = 1 e passarem a ser utilizados.

Item Conta = 1 - OK em seguida!

Cod Cl Val = 1 - OK em seguida!

Atualizações | Entidades | Item Contábil

Cadastro de Item contábil no Protheus.

Mensagem envaida para o RM.

Item Contábil enviado para o RM.

Atualizações | Entidades | Classe de Valor

Cadastro da Classe de Valor no Protheus

Mensagem enviada para o RM

Classe de Valor enviada para o RM.

Incluindo um novo Lançamento contábil

Selecionar o Lançamento - ABA ( Dados Adicionais )

Tipo Contábil = Contábil ou Baixa Contábil.

Clicar em seguida = Inclusão

Inserido o Lançamento Contábil no RM.

Mensagem enviada do RM.

Atualizações | Movimentos | Lancam Contabeis

Lançamento Contábil enviado para o Protheus.

Ao migrar para o EAI 2 o sistema entregará um maior ganho de funcionalidades nas quais o controle de recebíveis por parte do TIN já possui, e estão sempre em evolução:


Valores Acessórios no Contas a Receber

Com a migração dos Valores de Acréscimos/Decréscimos para Valores Acessórios no EAI 2.0, a funcionalidade dos Valores Acessórios permitirá maior flexibilização das regras de acréscimos e decréscimos nos títulos a receber.

Através desta funcionalidade será possível definir regras para que o sistema efetue o cálculo de acréscimos ou decréscimos em títulos a receber, de forma automática, com base nas regras pré-definidas, permitindo regras específicas para cada título a receber, de forma individual. Mais detalhes clique Aqui.

O cadastro de 'Valores Acessórios' no Protheus será preenchido pelo conversor, a partir do cadastro de componentes do Imobiliário, respeitando as ações de acréscimo e decréscimo desse cadastro.

Serão migrados títulos a receber que estão em aberto ou com baixas parciais no Protheus. Os valores de acréscimos/decréscimos serão zerados e terão os valores acessórios preenchidos com base nos valores de integração do financeiro do RM, exceto os componentes que tenham a ação nada.  O campo ‘Valor Original’ do Protheus receberá o ‘Valor Original’ do lançamento do financeiro do RM.

Após a migração, os valores dos títulos serão os mesmos de antes e serão visualizados na subtela de Valores Acessórios dentro da visualização de Contas a Receber.

As baixas parciais dos Títulos a Receber serão migradas seguindo a mesma regra acima, onde os itens de baixas serão refeitos e discriminados por valores acessórios na baixa.

Antes

Depois

.