Árvore de páginas

Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

« Anterior Versão 15 Próxima »


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


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.

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.


CHAMADA VIA GENERICPLS

Há porém, um modelo de chamada que não é 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


IMPORTANTE

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:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"><s:Body>

XML Indicado no SoapEnvio

</s:Body></s:Envelope>


No exemplo acima, ficaria:

Exemplo XML
<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:


  • Sem rótulos