Histórico da Página
...
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 realizados no nosso ambiente de DEV integrado com o Ambiente Único. Quando for realizar uma Ao realizarem a análise de um algum cliente, basta realizar os mesmos passos com os dados de acesso do deste 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 que será utilizada é a Integrações genéricas Protheus PLS.
...
Ou seja, para a maioria dos casos nossa deste documento, a URL que será utilizada no PLS será http://10.171.80.125:3269/rest/totvshealthplans/v1/
ANÁLISE DE REQUISIÇÕES RESTREST
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 SIGAPLS realizada pelo HAT 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. A criação de um parâmetro é necessária porque para acessar a API, o cliente precisa aplicar um patch no SIGAPLS. O parâmetro serve como um controle de acesso, sempre que um novo parâmetro é criado, o default dele é Desabilitado.
CHAMADA VIA BACKEND
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.
...
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.
CHAMADA VIA GENERICPLS
Há porém, um modelo de chamada que não é registrado lá, que é o genericPLS.é registrada na rotina de Requisções REST: genericPLS. Vamos realizar um teste com este modelo.
Uma rotina que utiliza este modelo é 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 | ||
|---|---|---|
| ||
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
Assim, encerremos os dois ciclos que o Portal Autorizador HAT aciona o SIGAPLS através de API´s. Note que ainda algumas API´s que são acionadas somente no HAT, mas a grande maioria hoje tem busca no SIGAPLS e a tendência é cada vez mais ir buscar no SIGAPLS. Importante lembrar também que para realizar a busca no SIGAPLS sempre há um parâmetro para controlar isso. Isso é feito pois o cliente precisa aplicar um patch com a API no SIGAPLS.
Caso precise analisar, ver uma data de alguma API no PLS, as mesmas são definidas neste caminho no TFS: $/Protheus_Padrao/Fontes_Doc/Master/Fontes/Plano de Saude/APIs
TRANSAÇÕES TISS ONLINE - CONFIRMAÇÃO DE GUIAS NAS JORNADAS
Outro ponto crucial no processo de Jornadas do Portal Autorizador, é a confirmação de uma Guia. Neste ponto, o HAT vai criar a guia no SIGAPLS através de EndPoints TISS Online.
Voltando ao Portal de Administração, acesse Configurações / Configurações de Integração:
Os Endpoints TISS Online serão:
- Cancelamento de guia
- Integração Demonstrativos de Pagamento
- Integração Tiss Lote Anexo
- Integração Tiss Solicitação de Procedimentos (este é amplamente o mais utilizado)
Vamos criar uma guia de SADT no HAT:
Confirmando a guia, foi gerada a guia 000120240700000274 com o protocolo 88888820240723300062.
Para consultar esta transação, acesse no Portal de Administração, Monit. de Integrações / Solicitações TISS Online. Na opção Busca Avançada, filtre a guia pelo protocolo de atendimento 88888820240723300062.
Clicando em Exibir Log, podemos acessar os dados do atendimento realizado como Soap de Envio e Resposta:
Todas as solicitações de Guias utilizarão a URL definida na URL Integração Tiss Solicitação de Procedimentos com exceção das guias abaixo que utilizarão a URL indicada em Integração Tiss Lote Anexo:
- Anexo de Radioterapia
- Anexo de OPME
- Anexo de Quimioterapia
- Anexo de Situação Inicial
Como testar esta solicitação no SIGAPLS? Basta enviar um solicitação POST com o Soap Envio no POSTMAN. No caso acima vamos utilizar a URL indicado no Tiss Solicitação de Procedimentos: http://10.171.80.125:2269/tisssolicitacaoprocedimento.apw
É necessário adicionar no começo e fim da requisição os comandos:
<s:Envelopexmlns:s="http://schemas.xmlsoap.org/soap/envelope/"><s:Body>
XML Indicado no SoapEnvio
</s:Body></s:Envelope>
No exemplo acima, ficaria:
| Bloco de código | ||||
|---|---|---|---|---|
| ||||
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<ans:solicitacaoProcedimentoWS xmlns:ns2="http://www.w3.org/2000/09/xmldsig#" xmlns:ans="http://www.ans.gov.br/padroes/tiss/schemas">
<ans:cabecalho>
<ans:identificacaoTransacao>
<ans:tipoTransacao>SOLICITACAO_PROCEDIMENTOS</ans:tipoTransacao>
<ans:sequencialTransacao>000000000897</ans:sequencialTransacao>
<ans:dataRegistroTransacao>2024-07-23</ans:dataRegistroTransacao>
<ans:horaRegistroTransacao>15:36:18</ans:horaRegistroTransacao>
</ans:identificacaoTransacao>
<ans:origem>
<ans:identificacaoPrestador>
<ans:codigoPrestadorNaOperadora>000004</ans:codigoPrestadorNaOperadora>
</ans:identificacaoPrestador>
</ans:origem>
<ans:destino>
<ans:registroANS>888888</ans:registroANS>
</ans:destino>
<ans:Padrao>4.01.00</ans:Padrao>
<ans:loginSenhaPrestador>
<ans:loginPrestador>GELADA</ans:loginPrestador>
<ans:senhaPrestador>dd4b21e9ef71e1291183a46b913ae6f2</ans:senhaPrestador>
</ans:loginSenhaPrestador>
</ans:cabecalho>
<ans:solicitacaoProcedimento>
<ans:solicitacaoSP-SADT>
<ans:cabecalhoSolicitacao>
<ans:registroANS>888888</ans:registroANS>
<ans:numeroGuiaPrestador>HAT</ans:numeroGuiaPrestador>
</ans:cabecalhoSolicitacao>
<ans:tipoEtapaAutorizacao>1</ans:tipoEtapaAutorizacao>
<ans:dadosBeneficiario>
<ans:numeroCarteira>00010101000007012</ans:numeroCarteira>
<ans:atendimentoRN>N</ans:atendimentoRN>
</ans:dadosBeneficiario>
<ans:dadosSolicitante>
<ans:contratadoSolicitante>
<ans:codigoPrestadorNaOperadora>000004</ans:codigoPrestadorNaOperadora>
</ans:contratadoSolicitante>
<ans:nomeContratadoSolicitante>HMU ESSE ? O DO HAT</ans:nomeContratadoSolicitante>
<ans:profissionalSolicitante>
<ans:nomeProfissional>TESTE</ans:nomeProfissional>
<ans:conselhoProfissional>02</ans:conselhoProfissional>
<ans:numeroConselhoProfissional>32323</ans:numeroConselhoProfissional>
<ans:UF>35</ans:UF>
<ans:CBOS>201115</ans:CBOS>
</ans:profissionalSolicitante>
</ans:dadosSolicitante>
<ans:caraterAtendimento>1</ans:caraterAtendimento>
<ans:dataSolicitacao>2024-07-23</ans:dataSolicitacao>
<ans:procedimentosSolicitados>
<ans:procedimento>
<ans:codigoTabela>00</ans:codigoTabela>
<ans:codigoProcedimento>10101013</ans:codigoProcedimento>
<ans:descricaoProcedimento>GLICOSE NA VEIA</ans:descricaoProcedimento>
</ans:procedimento>
<ans:quantidadeSolicitada>1</ans:quantidadeSolicitada>
</ans:procedimentosSolicitados>
<ans:dadosExecutante>
<ans:codigonaOperadora>000004</ans:codigonaOperadora>
<ans:CNES>9999999</ans:CNES>
</ans:dadosExecutante>
<ans:observacao>{"proAte":"88888820240723300062","isExec":true,"indAci":"9","isCons":false,"regAte":"02","tipAte":"01","numLib":""}</ans:observacao>
</ans:solicitacaoSP-SADT>
</ans:solicitacaoProcedimento>
<ans:hash>61ef2445443fd0ff4c16561e4997db9a</ans:hash>
</ans:solicitacaoProcedimentoWS>
</s:Body></s:Envelope> |
Processando a requisição acima:
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas