Cross Segmento - Backoffice (Linha Protheus) - SIGAEST - INTEGRAÇÃO PIMS x Protheus invokeSOAPService: ERP Service Communication returned an error: INTERNAL SERVER ERROR

Tempo aproximado para leitura: 00:02:00 min

Ocorrência
Ao realizar algum tipo de movimentação no PIMS e salvar é apresentada a mensagem "Internal Server Error".

Ambiente
Cross Segmento - TOTVS Backoffice (Linha Protheus) - Estoque/Custos - Todas as versões.

Solução

O retorno "Internal Server Error" se trata de uma mensagem genérica, indicando apenas algum problema na conclusão do processo, segue abaixo algumas validações já mapeadas:

1° - Quando não é gerado XML na XX3 do Protheus. 

Quando o registro enviado do PIMS para o Protheus, não chega e não é salvo na fila de recepção (Tabela XX3). Pode ser gerado o erro em questão no PIMS, para conferir basta verificar após a tentativa de integração se o sistema adicionou uma nova linha na Tabela XX3 referente ao adapter enviado, caso essa linha não tenha sido criada, segue abaixo validações e tratativas

Procedimento:

• Caso não tenha chegado, verifique se, no PIMS e no Protheus, a URL utilizada para a comunicação dos sistemas estão correta e liberada.
  
  Caminho no PIMS: Administração > Propriedades > PIMSConector > Consultar > mensagemunica.protheus.ws.url no PIMS. (Caso necessite de auxílio nessa verificação, sugerimos que realize contato com o time de Suporte do PIMS Agrícola).
  
  Caminho no Protheus: Parâmetro MV_EAIURL2 
  (Se o ambiente estiver em Cloud, é necessário solicitar verificação dos links para equipe cloud).
  
  IMPORTANTE: Para cenários onde um ambiente está em CLOUD e outro não é necessário se utilizar da configuração dos links Externos e Validar com a equipe Cloud a necessidade da criação de uma Regra de Security para os IP's internos/externos
   
• Se estiver fazendo um envio do Protheus para o PIMS verifique também:
  SIGAEST - Ao realizar integração não ocorre erro, porém não gera mensagem na XX3

2° - Quando é gerado XML na XX3 do Protheus. 

• Caso esteja enviando um registro do PIMS para o Protheus, acesse o SIGACFG na opção Schedule, clique em Schedule EAI e verifique que a mensagem enviada pelo PIMS chegou ao Protheus.
   
• Caso esteja enviando do Protheus para o PIMS, e verifique no monitor de integrações no PIMS que a mensagem foi recebida. (Caso necessite de auxilio nessa verificação, sugerimos que realize contato com o time de Suporte do PIMS Agrícola para auxílio).

Procedimento:

No sistema destino, validar a mensagem de erro apresentada no arquivo de recebimento, e tratar de acordo com a mensagem informada.

3° - A falta ou configuração incorreta da CheckSpecialKey no ini do Serviço de WS

A partir da release 12.1.2410 a chave CheckSpecialKey configurada com 1 passou a ser obrigatória para ambientes Protheus conforme documentação abaixo, em casos onde a mesma não está configurada incorretamente, pode ocorrer esse erro em integrações como por exemplo a STOCKTURNOVER.

Tratativa:

• Verifique se seu ambiente e serviço está devidamente configurado conforme documentação abaixo;
  SIGAFAT - A chave CheckSpecialKey em seu ambiente está desligada, você deve liga-la para seu uso da seção [GENERAL]

4° - Usuário adminstrador do Protheus não cadastrado no PIMS

A partir da release 12.1.2410 o Protheus passou a exigir chave security igual a 1, ou seja, é feita uma validação de autenticação de usuário da aplicação ao qual o Protheus está realizando integração, o que, se não ocorrer, pode gerar o erro em questão.

Procedimento:

• Verifique se seu ambiente PIMS está devidamente configurado conforme documentação abaixo;
  Agro - PIMS MC - ADM - Falha na Finalização do Apontamento Agrícola

5º cenário: Quando é gerado XML, porém não é possível identificar a real mensagem de erro.

Ao validar o arquivo de XML recebido pelo PIMS, ainda consta o erro genérico "Internal Server Error".

Pontos para a análise:

• Se você efetuar um teste no Protheus com as informações que estão sendo enviada pelo o PIMS ocorre algum erro? Se sim, qual?
• Verifique se o serviço webservice está ativo e se está utilizando o Protocolo de segurança HTTPS na url
• Efetue um teste reiniciando o serviço Webservice
• Efetue a coleta do console.log do webservice para análise e validar se a mensagem com o erro real, é identificada para realizar a tratativa de acordo com o erro apresentado.
• Efetue também a coleta do inspetor de Objetos para análise dos fontes envolvidos.

Saiba mais:

Clique aqui e veja mais artigos sobre Integrações no Estoque