Para que o EAI Protheus seja capaz de receber mensagens de outros sistemas da CIASHOP (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. Existe uma ferramenta de edição para esta construção, o ApWebWizard. Consulte o documento relacionado no link abaixo, com detalhes para a realizar este processo: Como iniciar um servidor de Webservices no Protheus
Utilizando a comunicação REST:
Para isso é necessário configurar o REST Padrão do Protheus. Veja mais detalhes nos links abaixo:
Exemplo de configuração Protheus REST:
Inicie o navegador de Internet e informe o endereço do servidor de Web Services.e da porta do serviço REST ex: http://127.0.0.1:8070
Observe a apresentação do serviço da Lista serviços REST:
Passos para identificação de EAISERVICE:
1. Verifique o caminho do Webservice no Appserver.ini.
2. Inicie o navegador de Internet e informe o endereço do servidor de Web Services.
Observe a apresentação do serviço de Web Services:
3. Clique no link EAISERVICE
4. Agora, clique no link EAISERVICE.apw?WSDL
Segue abaixo o exemplo do caminho(URL) de WebService Protheus que deverá ser enviado para a equipe da Ciashop, para que seja realizada a conexão entre os dois sistemas:
http://10.171.67.163:8085/EAISERVICE.apw?WSDL
Importante!
...
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:
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 CIASHOP
5 - Será necessário enviar o Endereço do Serviço Protheus para CIASHOP.
O endereço é formado pelo IP do servidor(IP Externo) e porta definido no serviço REST + 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 | ||
|---|---|---|
| ||
No Protheus, cada grupo de empresas é um aplicativo diferente para o EAI. Desta maneira, cada grupo de empresas deve possuir um endereço REST diferente. Caso seja recebida uma requisição para um endereço cujo grupo de empresas é diferente do enviado, a seguinte mensagem será apresentada: O grupo de empresas do aplicativo não corresponde ao grupo de empresas deste serviço. Grupo recebido - (A). Grupo do serviço - (B) , onde A e B são respectivamente o grupo recebido na requisição e o grupo de empresas do endereço REST |
