Tempo aproximado para leitura: 00:10:00 min
Dúvida:
Integração Protheus x PIMS: Problemas Comuns na Integração, causas e soluções.
Ambiente:
Cross Segmento - TOTVS Backoffice (Linha Protheus) - Estoque/Custos - Todas as versões.
Solução:
Existem vários motivos pelos quais a integração entre o Protheus e o PIMS pode não ocorrer de forma adequada. Abaixo estão algumas das causas mais comuns, como identificá-las e solucioná-las, além de orientações para obter Suporte.
-
Desbalanceamento entre o campo XX4_FILIAL e XX4_FILEXE.
Uma das principais causas para a integração não funcionar corretamente é os campos XX4_FILIAL e XX4_FILEXE possuirem tamanhos diferentes. O efeito colateral neste caso seria o sistema não gerar registro na XX3 (independente de quais rotinas estão configuradas as integrações).
Solução:
Efetue o backup de sua XX4 para não ocorrer a necessidade de cadastrar novamente os ADAPTER's. Efetue o DROP da XX4, e após isso feche a tabela. Abra o SIGACFG e entre no cadastro de ADAPTER's. Abra novamente a XX4 e efetue o Apeend do Backup.
Documentação de apoio: SIGAEST - Ao realizar integração não ocorre erro, porém não gera mensagem na XX3
Em caso de dúvida, abra um ticket com o Suporte Framework.
-
Falta de cadastro dos agentes / Schedule:
O Protheus não fará o envio e nem recebimento das mensagens de integração caso o cadastro dos agentes no schedule esteja incorreto (independente de quais rotinas estão configuradas as integrações). É necessário que haja cadastro de Agent e do job/schedule FWEAISEND iniciado para o Grupo de Empresas específico para o qual está tentando integrar. Sendo necessário também estar configurado o job/schedule FWEAI para garantir e suportar envio e recebimento juntamente com o FWEAISEND e FWEAIRECE.
Solução:
Verifique se todos os agentes/schedule necessários para a integração estão cadastrados corretamente, com a Empresa/Filial apropriada. Também verifique o tempo de execução.
Documentação de apoio: Schedule Protheus | Configurar-o-Agent-do-Schedule
Em caso de dúvida, abra um ticket com o Suporte Framework.
Obs: Caso deseje, é possível ativar o job FWEAICLEAR para executar com recorrência a limpeza de fila da tabela XX3 dos registros com status 'Finalizado', mantendo a tabela íntegra e evitando lentidão e travamentos da integração (quando a tabela contém muitos dados). Dúvidas, acionar o suporte Framework. -
Erro na configuração do adapter:
Neste caso, o erro será isolado em um adapter especifico, ou seja, apenas na integração em que o adapter apresenta falhas de cadastro (e não de modo generalizado para qualquer integração). Nestes casos é ideal avaliar se existe alguma condição impactando no envio ou se ocorre alguma mensagem. Verifique através da tabela XX3 se o campo XX3_RETURN gerou alguma mensagem sobre o erro.
Solução:
Verifique se os adapters necessários para a integração estão cadastrados corretamente, com a Empresa/Filial apropriada.
Documentação de apoio: Cadastro de Adapters no Configurador Protheus X PIMS
Em caso de dúvida, abra um ticket com a equipe de Suporte responsável pela rotina. -
Erro no cadastro de rota EAI integração no Protheus ou PIMS/ Bloqueio de porta:
A integração é basicamente uma mão de via dupla, onde em cada sistema, devemos realizar a configuração do link de comunicação do sistema oposto, ou seja:
- No Protheus configuramos o link de comunicação com o PIMS (pelo parâmetro MV_EAIURL2);
- No PIMS configuramos o link de comunicação com o Protheus.Atenção à diferença entre o IP Interno e Externo
É comum que muitas empresas configurem a integração apontando para urls internas ou locais (localhost), como modo de obter maior agilidade / performance na comunicação entre os sistemas. No entanto, quando os sistemas estão instalados em estruturas e/ou servidores diferentes, é necessário utilizar o IP externo (e alterar a porta, se necessário). Por exemplo: Um sistema está armazenado em ambiente local e outro está armazenado em nuvem.(Atenção especial à clientes com servidor em Cloud TOTVS pois, se os ambientes não estiverem no mesmo servidor, o IP interno não irá funcionar. Exemplo: Ambiente do PIMS criado no Datacenter físico do Cloud e o Protheus migrado para TCloud).
Obs: Esta definição é generalizada para quaisquer integrações EAI ativas em seu ambiente. Por exemplo: Mingle, Fluig, etc.
Importante: verificar também se a porta dos ambientes envolvidos não estão com algum tipo de bloqueio. Acione seu administrador de Cloud para conferir as restrições e bloqueios de acesso à url e IP.
Solução:
Verifique se o cadastro das rotas EAI utilizadas no Protheus e no PIMS estão corretos e consistentes. Caso o Protheus esteja em uma estrutura diferente do PIMS (principalmente para clientes Cloud), será necessário utilizar o link externo para estabelecer a comunicação entre os sistemas.
Documentação de apoio: Cadastro de rotas de integração (EAI Protheus x PIMS)
Em caso de dúvida, é possível abrir um ticket com o Suporte responsável pela rota (PIMS ou Protheus). Se for um cliente Cloud, acione o Suporte Cloud PIMS ou Protheus. -
Coleta de logs de integração:
Caso tenha validado todos os pontos acima e estejam corretos, porém a inconsistência ainda persista, é possível coletar os logs da integração através da configuração abaixo no AppServer.ini
[env]
FWLOGMSG_DEBUG=1
FWTRACELOG=1[general]
LogHttpFuncs=1
Documentação de apoio: https://tdn.totvs.com/display/public/framework/Chaves+para+controle+de+logs
Em caso de dúvidas abra um ticket ao Suporte Framework.
ATENÇÃO
Caso tenha avaliado todos os pontos acima, porém ainda não tenha conseguido localizar a causa do problema, acione o suporte, com as seguintes informações:
1 - Print demonstrando o tamanho dos campos XX4_FILIAL e XX4_FILEXE. da XX4;
2 - Print das rotas utilizadas, no Protheus e no PIMS (obs: caso esteja hospedado em Cloud, informe o número do ticket onde foi validada a url interna/externa)
3 - Encaminhe um vídeo demonstrando o processo;
4 - Encaminhe a XX3 e XX4 em DTC;
5 - Logs gerados no passo 5;
6 - Inspetor de Objetos
Saiba mais:
https://tdn.totvs.com/display/public/framework/A+camada+do+EAI
Clique aqui e veja mais artigos sobre Integrações no Estoque
0 Comentários