Histórico da Página
Para que o EAI Protheus seja capaz de receber mensagens do TOTVS CRM (para o envio o Protheus não faz o consumo do seu serviço Web, e sim do serviço do outro sistema) é necessário que seja habilitado o protocolo HTTP/REST no servidor e que as configurações de WebServices estejam ativas.
Para isto é necessário configurar o arquivo appserver.ini do servidor Protheus.
Para isso é necessário configurar o REST isso é necessário configurar o REST Padrão do Protheus. Veja mais detalhes nos links abaixo:
- Configuração do serviço serviço REST Configuração REST SERVER - Protheus.
- Mais detalhes sobre o conceito de um serviço REST clique aqui.
- Para mais detalhes sobre serviços REST na arquitetura Protheus clique aqui.
Exemplo Modelos de configuração Protheus Configuração do REST:
...
Inicie o navegador de Internet e informe o endereço do servidor e da porta do serviço REST ex: http://127.0.0.1:8070
Observe a apresentação da Lista serviços REST disponíveis:
Realize o teste de uma rede externa(3G/Outra Rede fora da empresa) para saber se o acesso externo está liberado.
Deve aparecer a lista de serviços como no exemplo abaixo:
Informações |
---|
1 - Configuração padrão usada. Nesta configuração está sendo usado a TAG "PrepareIn" onde tem a necessidade do cliente ter licença para utilização das API, principais licenças usadas "TOTVS I e TOTVS Full": [HTTPV11] [HTTPREST] [HTTPURI] 2 - Configuração com isenção da licença "TOTVS I", válido somente para integrações via mensagem EAI (Customer, Order e EAIMessage). Neste caso não é usado a TAG "PrepareIn" não tendo o consumo da licença. [HTTPV11] [HTTPREST] [HTTPURI] 3 - Caso possua outras integrações utilizando o serviço REST com API que não estão na isenção, será necessário fazer a configuração desta maneira, com duas URI para o REST, uma com a TAG "PrepareIn" e outra sem a TAG: [HTTPV11] [HTTPREST] |
3 - Na lista de Serviço localize o serviço EAISERVICE:
Clique em "For more details" para exibir os detalhes do serviço:
4 - Nos Detalhes do serviço localize o serviço do tipo POST de nome: "standardmessage/v1/transactions"
Esse é o serviço responsável por receber as mensagens da TOTVS CRM
5 - Será necessário enviar o Endereço do Serviço Protheus para TOTVS CRM.
O endereço é formado pelo IP do servidor(IP Externo) e porta definido no serviço REST + totvseai/standardmessage/v1/transactions/
O caminho do serviço completo ficaria assim: http://127.0.0.1:8070/totvseai/standardmessage/v1/transactions/
Dica | ||
---|---|---|
| ||
Caso tenha definido um caminho para o serviço REST em URL o mesmo deve ser considerado no caminho do serviço. Isso evita erros como: {"code":404,"detailedmessage":"","message":"The server can't find the requested resource."} Ex :[HTTPURI] então o caminho ficaria: http://127.0.0.1:8070/rest/totvseai/standardmessage/v1/transactions/ | ||
Aviso | ||
| ||
ipaas [HTTPURI2] |