A partir da versão 12.1.17 a Integração TOTVS Obras e Projetos x BackOffice Protheus 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.
Esta documentação não fará o detalhamento da instalação do Backoffice Protheus . Ele orientará apenas a configuração do mesmo para integrar com o Totvs Obras e Projetos RM .Para seguir as configurações descritas abaixo é importante que já se tenha o ambiente Protheus instalado.
BackOffice Protheus : a partir da versão 12.1.0.17
RM : A partir da versão 12.1.17
Cadastrando Agent e Agendamento
1 – Para cadastrar o Agent acesse: Protheus.exe / SIGACFG / Ambiente / Schedule / Schedule.
2 – Selecione a opção Cadastro, dentro de Agent.
3 – Na tela de cadastro do Agent, selecione a opção de adicionar um agente padrão.
Será incluído automaticamente um agente, com todas as informações preenchidas.
4 – Para cadastrar o Agendamento, Selecione a opção Cadastro, dentro de Agendamentos.
5 – Na tela de cadastro do agendamento, clique em incluir para adicionar um novo registro.
A maior parte das informações serão preenchidas automaticamente, sendo necessário apenas informar:
- Rotina: FWEAI
- Empresa/Filial: clique na lupa ao lado do campo para selecionar as empresas/filiais desejadas.
Após informar estes dados, clique no botão Recorrência.
No Padrão de recorrência, selecione a opção “Sempre ativo”.
Confirme e salve as alterações.
1 – Acesse: Protheus.exe / SIGACFG / Ambiente / Schedule / Adapter EAI.
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
Para visualizar as informações dos adapters a serem cadastrados acesse o link http://tdn.totvs.com/display/public/INT/TOP+x+Protheus+-+EAI+2.0
1 – Acesse: Protheus.exe / SIGACFG / Base de Dados / Dicionário / Base de Dados
2 – No menu à esquerda acesse: Empresa / Dicionário de Dados / Grupo de Campos
3 – Pesquise pelo campo EDT/Tarefa.
Após selecione e edite o registro.
4 – Informe o valor 50 no campo Tamanho. Após confirme a alteração.
5 - Confirme as duas mensagens seguintes para alterar o grupo.
6 – Atualize a base de dados.
7 – Clique em Avançar.
Selecione a linha “014 – Edt / Tarefa [ALTERADO]”, e clique em Avançar.
Aguarde a atualização do dicionário de dados.
Após o processo ser finalizado o tamanho do campo terá sido alterado.
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://bhd000001894:8051/EAIService/IConWSEAIService |
MV_EAIWS | Nome do Client WebSevice do EAI para envio a outro EAI | WSEAISERVICE |
MV_EAIUSER | Usuário para autenticação no RM. | Exemplo: mestre |
MV_EAIPASS | Senha do usuário para autenticação no RM. | Exemplo: totvs |
MV_EAIMETH | Método de envio do EAI para envio a outro EAI. | RECEIVEMESSAGE |
Parâmetros da Integração | ||
---|---|---|
Nome | Descrição | Valor |
MV_PMSITMU | Habilita integração com o TOTVS Obras e Projetos através da mensagem única TOTVS. | 1 |
MV_INTPMS | habilita integração de Gestão de Projetos para outros módulos do Protheus. | S |
MV_INTLOG | Habilita arquivo de log. (Parâmetro opcional) | Exemplo: 1 |
MV_INTPATH | Caminho do log do EAI. (Parâmetro opcional) | Exemplo: \logs\EAI\ |
MV_INTCAL | Calendário padrão a ser utilizado na criação do projeto. | Exemplo: 001 |
MV_SLMNATR | Natureza padrão do Título a Receber. | Exemplo: 03 |
MV_SLMNATP | Natureza padrão do Título a Pagar. | Exemplo: 02 |
MV_SLMNTPV | Natureza padrão do Pedido de Venda. | Exemplo: 03 |
MV_SLMCOND | Condição de pagamento padrão. | Exemplo: 01 |
MV_SLMTS | Tipo de Saída (TES) padrão. | Exemplo: 501 |
MV_SLMCOMP | Define o nome do usuário comprador default para alçada/WS | |
MV_SLMPRER | Define o prefixo dos títulos a receber | Exemplo: REC |
MV_SLMPREP | Define o prefixo dos títulos a pagar. | Exemplo: PAG |
MV_PRJINIC |
Define a fase em que os projetos importados do TOTVS Obras e Projetos serão criados. | Exemplo: 06 |
MV_CXFIN | Define Agencia Banco e conta para titulos no financeiro |
Parametros RM :
Observação : Criado o parâmetro PRJ_CXFINREC para definir banco default para titulos a receber, para utilizar esse parâmetro é necessário atualizar o adapter ACCOUNTRECEIVABLEDOCUMENT (Títulos a Receber) para versão 2.002 e criar o parâmetro na coligada 0 no RM nos parâmetros de integração.
Parâmetros de Integração |
||
---|---|---|
PRJ_CXFINREC | Define Agencia Banco e Conta default para títulos a receber no financeiro | Informar mesmo conteudo usado no parâmetro MV_CXFIN |
Para utilizar o conversor EAI2.0 é importante considerar algumas premissas importantes:
- O ambiente a ser convertido deverá estar na versão do EAI 1.0; caso esteja em stored procedure por exemplo é importante converter primeiro para o EAI 1.0 e somente depois rodar o conversor do EAI2.0.
- É necessário ter script que autoriza a conversão e o mesmo é disponibilizado apenas pela Totvs.
- É necessário dar permissão ao usuário para executar o conversor.
Atendendo estas premissas será possível iniciar a conversão.
Nesta etapa do conversor será realizada uma validação dos serviços necessários para a integração.
No campo 'Endereço Wsdl RM que será configurador no Protheus:' deverá ser informado o endereço que será configurado automaticamente no parâmetro MV_EAIURL2 do Protheus.
É necessário informar também a URL do WebService(Protheus) e do serviço REST(Protheus) juntamente com seus respectivos usuário/senha. Ao clicar em 'Validar' se o retorno for de sucesso para todos os serviços será permitido avançar no configurador.
OBS: É necessário que todos os serviços (DBAccess, DBMonitor e AppServer) do Protheus estejam iniciados para que o teste seja executado com sucesso.
Nesta tela é realizado a associação da Coligada/Filial do RM com o Grupo de Empresas/Empresa/Unidade de Negócio e Filial do Protheus(os níveis de detalhamento irá depender da configuração do Protheus). Ao realizar tal associação, será criado tanto no RM quanto no Protheus o De/Para de empresas para dar inicio a integração.
Ao selecionar a coligada e filial do RM, selecione a linha correspondente aos dados do Protheus e clique em 'Adicionar De/Para'.
Esta etapa permite realizar o diagnóstico das configurações e requisitos necessários para o correto funcionamento de suas integrações.
Exemplo: É realizado a validação do nível de compartilhamento de tabela no Protheus.
Após executar o conversor, a ferramenta de diagnóstico de integração estará disponível ainda com mais recursos:
Compartilhamento Protheus Permitido
Compartilhamento Indevido
Caso seja apresentado algum compartilhamento indevido para a integração, será apresentado a mensagem abaixo e não será possível avançar o configurador até que compartilhamento no Protheus seja ajustado.
Para avançar no processo de configuração de integração, entre RM e Protheus será necessário verificar e ajustar as inconsistências apresentadas.
- Comparação de versão,
- Teste de comunicação através dos Adapter. (Neste momento disponível apenas para Lista Valores Acessórios)
Importante verificar as observações do conversor antes de executar o mesmo.
Selecione as integrações que serão convertidas e informe o sourceaplication de cada uma.
clicar em OK e verificar o Log.
Após executar o conversor será criada uma aba de nome EAI 2.0 onde será realizado todo o gerenciamento da integração como por exemplo o acesso a Rotas, Pacotes Instalados e Gerenciamento de Mensagens.
Após a execução do conversor EAI2.0 é habilitado no RM no Modulo Integrações a aba EAI2.0.
Na aba Aplicativos podera ser consultado as informações geradas a partir da execução do configurador. Não será necessário a alteração de informações diretamente nesta tela, em caso de mudança de configurações se recomenda a re-execução do configurador.
Exemplo:
Na aba DE-PARA é necessário criar manualmente o de -para para coligada e filial tanto no RM como no Protheus
RM
GCOLIGADA
GFILIAL
PROTHEUS
1 - Para criar a fase do projeto acesse: Protheus / SIGAPMS / Atualizações / Cadastros / Fases do Projeto
2 - Clique em "Incluir" para adicionar um novo registro.
3 - Preencha os dados como mostrado abaixo.
Nota: exceto pelo código, os parâmetros devem ser configurados expressamente como mostrados abaixo.
Nesta pagina é possível verificar os fontes Protheus que são utilizados especificamente em rotinas que envolvem a integração Totvs Construção Obras e Projetos X Protheus.
Funcionalidade: Buscar Apropriação BackOffice
Fonte: SUPTASKREST.PRW
API: TASKCOSTASSIGNMENTS
Últimos patches:
12.1.2210: https://suporte.totvs.com/portal/p/10098/download?e=1086133 ;
12.1.27: https://suporte.totvs.com/portal/p/10098/download?e=1086131 ;
12.1.33: https://suporte.totvs.com/portal/p/10098/download?e=1086132 ;
Funcionalidade: API para consultar informações de pedidos
Fonte: SUPPEDINFORREST.PRW
API: ORDERINFORMATION
Últimos patches:
12.1.2210: https://suporte.totvs.com/portal/p/10098/download?e=1079253 ;
12.1.27: https://suporte.totvs.com/portal/p/10098/download?e=1079251 ;
12.1.33: https://suporte.totvs.com/portal/p/10098/download?e=1079252 ;
Funcionalidade: Buscar Informações de Ordem de Produção
Fonte: SUPPCPINFOREST.PRW
API: PRODUCTIONORDERINFORMATION
Últimos patches:
Utilizar útimo RPO disponível
Funcionalidade: Produtos faturados para dedução
Fonte: SUPMOVFATREST.PRW
API: MOVCONTRACTASSIGNMENTS
Últimos patches:
Utilizar útimo RPO disponível
Funcionalidade: Importar Preços de Suprimentos/Faturamento
Fonte: SUPITEMINFOREST.PRW
API: GETITEMSINFORMATION
Últimos patches:
Utilizar útimo RPO disponível