Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


Com mudança de paradigma aplicada no Portal Autorizador HAT em 2022/2023, o mesmo passa a ser cada vez mais acoplado ao Sistema de Gestão SIGAPLS. A maioria das informações utilizadas e processadas no HAT são acionadas de maneira instantânea no SIGAPLS através de API´s.

Este documento tem como objetivo explicar alguns conceitos para que auxiliar principalmente o Suporte na análise de dúvidas e problemas.

Importante: Todos os prints e testes abaixo foram utilizado nosso ambiente de DEV integrado com o Ambiente Único. Quando for realizar uma análise de um cliente, basta realizar os mesmos passos com os dados de acesso do cliente.


O primeiro passo é saber qual a URL do PLS o HAT vai acionar ao realizar uma solicitação. Para isso, acesse o Portal de Administração, no menu acesse Configurações / Configurações de Integração. Nesta tela, indicamos várias URL´s, cada uma para uma finalidade diferente, mas a maioria dos casos, a URL a ser utilizada é a Integrações genéricas Protheus PLS.



Ou seja, para a maioria dos casos nossa URL que será utilizada no PLS será http://10.171.80.125:3269/rest/totvshealthplans/v1/


ANÁLISE DE REQUISIÇÕES REST


Agora vamos para alguns exemplos práticos. Geralmente o acesso ao PLS se dá por duas maneiras. Uma é através de alguma regra específica no Backend do HAT onde indicamos a chamada ou atráves da chamada de frontend genericPLS. Toda a chamada no PLS tem também um parâmetro que controla se realizará a chamada ou não, exemplos: 

Não é uma regra, mas geralmente parâmetros que indicam acesso ao SIGAPLS tem PLS no nome


Vamos usar um exemplo que busca o SIGAPLS com regra de Backend: Elegibilidade de Usuário. Pressione a tecla F12 ao realizar uma Elegibilidade em alguma jornada de atendimento.

Perceba que foi realizada uma solicitação para uma API do HAT. Na aba Headers, nos conseguimos ver a requisição POST que foi realizada:


Na aba Payload teremos o JSON de envio (quando existir) e na aba Response, o JSON de resposta:


Porém, a requisição acima foi feita para o HAT. Como vou faço para saber se essa requisição foi feita para o SIGAPLS? No Portal de Administração, acesse Monit. de Integrações / Solicitações REST. Quase todas as requisições realizadas para o SIGAPLS são registradas nessa rotina. Vamos acessar a Elegibilidade de Beneficiário utilizada no exemplo acima:


Acessando ela, conseguimos mais dados dessa requisição:


Agora, vamos testar ela via POSTMAN.

Vamos utilizar a URL http://10.171.80.125:3269/rest/totvshealthplans/v1/ que pegamos no início do documento no Portal de Administração.  Veja acima que o HAT fez um GET para o PLS. A API que utilizada será a beneficiaryElegibility. Os queryparams utilizados são cardNumberOrCpf=439.027.288-84&authorizationType=2&healthProviderCode=000004. Com essas informações, vamos montar a chamada para o SIGAPLS


Acionando o botão SEND, essa requisição é enviada para o PLS, e na caixa inferior é nos exibido a resposta.


Com isso nós fechamos o ciclo onde realizamos uma requisição no FrontEnd do HAT e vamos até o SIGAPLS para processar uma informação quando a mesma é registrada na rotina de Requisições REST. Há porém, um modelo que não é registrado lá, que é o genericPLS. Vamos realizar um teste com ele. Uma rotina que aciona ela é o Consultar Guias:



Perceba que a requisição realizada foi: https://10.171.40.51:4200/api/healthcare/hat/v1/genericPls?apiName=authorizationsList&queryParam=healthProvider=000004%26page=1%26pageSize=10

Para montar a URL utilizada devemos utilizar:

  • URL do SIGAPLS: http://10.171.80.125:3269/rest/totvshealthplans/v1/ 
  • Nome da API - Extraímos do apiName acima. Neste exemplo será authorizationsList
  • QueryParams - Extraímos do queryParam acima. Neste exemplo termos healthProvider=000004%26page=1%26pageSize=10
Informações
titleIMPORTANTE

Note que no exemplo acima, os query params são separados pelos caracteres %26. Isso porque no esquema de Encode, esses caracteres indicam & (caracter padrão de quebra de queryparams). A lista geral pode ser encontrada aqui: https://www.w3schools.com/tags/ref_urlencode.ASP



Com essas informações, conseguimos montar na requisição para o SIGAPLS: http://10.171.80.125:3269/rest/totvshealthplans/v1/authorizationsList?healthProvider=000004&page=1&pageSize=10