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 é 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

Image Added

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

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

Image Added

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

Image Added

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: 

Image Added

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:

Image Added

Confirmando a guia, foi gerada a guia 000120240700000274 com o protocolo 88888820240723300062.

Image Added

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.

Image Added

Clicando em Exibir Log, podemos acessar os dados do atendimento realizado como Soap de Envio e Resposta:

Image Added

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:

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

Image Added