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/
...
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.
...
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