Escrito por: H. S.

Manual de utilização do SOAP

Sumário

» Operacionalização

Objetivo

Promover conhecimento ao setor de TI para que tenha habilidade de criar o processos para testar a Emissão de guias a partir de serviços externos, a fim de validar a geração da guia via WebServiceTISS.

Funcionalidade

Enviar xml via ferramenta ServerTiss, apontando aos seus terceiros o que podem corrigir no envio que estão realizando.

Configurações, Parâmetros e/ou Permissões de direitos

Configurações/Requisitos

Cheque o Manual de instalação do SOAP.

Operacionalização

Utilização do SOAP

Para utilizar o recurso, siga a instalação do Manual do SOAP. Feita a instalação, é necessário ter o endpoint da Operadora para os serviços que se pretendem executar, e gerar os testes pelo SOAP.

Antes, verifique o link dos serviços que se deseja utilizar, que podem ser de solicitação de procedimentos, de verificação de elegibilidade ou cancelamento de guias. Estes links estão na estrutura do projeto no Netbeans.

O serviço demonstrado no navegador é um IP externo liberado pela TI da Operadora e da configuração da TISS do projeto. Este está no Netbeans.

Abra a tela do SOAP e clique no botão "new Soap".

Será demonstrada a tela de solicitação da URL/Endpoint, que é possível localizar no acesso liberado no serviço.

Os endpoints podem ser os que demonstramos acima, nas páginas do navegador. Exemplo: http://(IP_Externo_operadora):8080/TISSSolus40100/tissSolicitacaoProcedimento

Também pode ser informado no "Initial WSDL" pela linha do WebService. Neste caso, o SOAP faz a busca automática do tipo que está no caminho .WSDL

http://(IP_Externo):8080/TISSSolus40100/tissSolicitacaoProcedimento?wsdl

O sistema carrega a tela e abre uma janela com XML modelo.

Dessa forma, abra com duplo clique o Request, e aparecerá o modelo e o local para inserir o Endpoint Externo para o serviço.

Exemplo de guia emitida pelo ServiceTiss pelo Módulo Guias.

Abaixo, segue um exemplo dos campos que precisam conter para solicitar um procedimento. Os campos, de maneira geral, podem ficar como no exemplo, com exceção dos campos informados com interrogação (???), que devem ser preenchidos conforme dados do beneficiário, dados do procedimento, dados do prestador, dados da Operadora e demais informações necessárias. Lembrando que o trecho demarcado abaixo é o que deve estar compreendido entre as tags início <soapenv:Body> e fim </soapenv:Body>.

Exemplo de XML Solicitação de procedimentos

Exemplo SolicitaçãoProcedimento

<sch:solicitacaoProcedimentoWS>
  <cabecalho>
    <identificacaoTransacao>
      <tipoTransacao>SOLICITACAO_PROCEDIMENTOS</tipoTransacao>
      <sequencialTransacao>???</sequencialTransacao>
      <dataRegistroTransacao>2024-02-09</dataRegistroTransacao>
      <horaRegistroTransacao>15:09:49</horaRegistroTransacao>
    </identificacaoTransacao>
    <origem>
      <identificacaoPrestador>
        <codigoPrestadorNaOperadora>???</codigoPrestadorNaOperadora>
      </identificacaoPrestador>
    </origem>
    <destino>
      <registroANS>???</registroANS>
    </destino>
    <Padrao>4.01.00</Padrao>
  </cabecalho>
  <solicitacaoProcedimento>
    <solicitacaoSP-SADT>
      <cabecalhoSolicitacao>
        <registroANS>???</registroANS>
        <numeroGuiaPrestador>???</numeroGuiaPrestador>
      </cabecalhoSolicitacao>
      <tipoEtapaAutorizacao>1</tipoEtapaAutorizacao>
      <dadosBeneficiario>
        <numeroCarteira>???</numeroCarteira>
        <atendimentoRN>N</atendimentoRN>
      </dadosBeneficiario>
      <dadosSolicitante>
        <contratadoSolicitante>
          <codigoPrestadorNaOperadora>???</codigoPrestadorNaOperadora>
        </contratadoSolicitante>
        <nomeContratadoSolicitante>?????</nomeContratadoSolicitante>
        <profissionalSolicitante>
          <nomeProfissional>?????</nomeProfissional>
          <conselhoProfissional>06</conselhoProfissional>
          <numeroConselhoProfissional>???</numeroConselhoProfissional>
          <UF>51</UF>
          <CBOS>225250</CBOS>
        </profissionalSolicitante>
      </dadosSolicitante>
      <caraterAtendimento>1</caraterAtendimento>
      <dataSolicitacao>2024-02-09</dataSolicitacao>
      <procedimentosSolicitados>
        <procedimento>
          <codigoTabela>22</codigoTabela>
          <codigoProcedimento>????</codigoProcedimento>
          <descricaoProcedimento>??????</descricaoProcedimento>
        </procedimento>
        <quantidadeSolicitada>1</quantidadeSolicitada>
      </procedimentosSolicitados>
      <dadosExecutante>
        <codigonaOperadora>????</codigonaOperadora>
        <CNES>9999999</CNES>
      </dadosExecutante>
      <anexoClinico/>
    </solicitacaoSP-SADT>
  </solicitacaoProcedimento>
  <hash>357657f746acc9d31ea3998db8f2038c</hash>
</sch:solicitacaoProcedimentoWS>

Resposta de Solicita Procedimento

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <autorizacaoProcedimentoWS xmlns="http://www.ans.gov.br/padroes/tiss/schemas" xmlns:ns2="http://www.w3.org/2000/09/xmldsig#">
         <cabecalho>
            <identificacaoTransacao>
               <tipoTransacao>RESPOSTA_SOLICITACAO</tipoTransacao>
               <sequencialTransacao>106</sequencialTransacao>
               <dataRegistroTransacao>2024-10-02</dataRegistroTransacao>
               <horaRegistroTransacao>11:09:49</horaRegistroTransacao>
            </identificacaoTransacao>
            <origem>
               <registroANS>123456789</registroANS>
            </origem>
            <destino>
               <identificacaoPrestador>
                  <codigoPrestadorNaOperadora>0000000</codigoPrestadorNaOperadora>
               </identificacaoPrestador>
            </destino>
            <Padrao>4.01.00</Padrao>
         </cabecalho>
      </autorizacaoProcedimentoWS>
   </S:Body>
</S:Envelope>

Verifica Elegibilidade pelo SOAP, também deve-se criar um new Soap.

Também pode ser informado no Initial WSDL pela linha do WebService. Nesse caso, o SOAP faz a busca automática do tipo que está no caminho .WSDL

http://(IP_Externo):8080/TISSSolus40100/tissVerificaElegibilidade?wsdl

Abaixo, segue um exemplo dos campos que precisam conter para realizar a verificação de elegibilidade. Os campos, de maneira geral, podem ficar como no exemplo, com exceção dos campos informados com interrogação (???), que devem ser preenchidos conforme dados do beneficiário, dados do procedimento, dados do prestador, dados da Operadora e demais informações necessárias. Lembrando que o trecho demarcado abaixo é o que deve estar compreendido entre as tags início <soapenv:Body> e fim </soapenv:Body>.

Exemplo de XML Verifica Elegibilidade

Exemplo VerificaElegibilidade

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sch="http://www.ans.gov.br/padroes/tiss/schemas" xmlns:xd="http://www.w3.org/2000/09/xmldsig#">
	<soapenv:Header/>
	<soapenv:Body>
		<ans:pedidoElegibilidadeWS xmlns:ans="http://www.ans.gov.br/padroes/tiss/schemas" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.ans.gov.br/padroes/tiss/schemas http://www.ans.gov.br/padroes/tiss/schemas/tissWebServicesV4_01_00.xsd">
			<ans:cabecalho>
				<ans:identificacaoTransacao>
					<ans:tipoTransacao>VERIFICA_ELEGIBILIDADE</ans:tipoTransacao>
					<ans:sequencialTransacao>767</ans:sequencialTransacao>
					<ans:dataRegistroTransacao>2024-02-14</ans:dataRegistroTransacao>
					<ans:horaRegistroTransacao>11:59:07</ans:horaRegistroTransacao>
				</ans:identificacaoTransacao>
				<ans:origem>
					<ans:identificacaoPrestador>
						<ans:codigoPrestadorNaOperadora>???</ans:codigoPrestadorNaOperadora>
					</ans:identificacaoPrestador>
				</ans:origem>
				<ans:destino>
					<ans:registroANS>???</ans:registroANS>
				</ans:destino>
				<ans:Padrao>4.01.00</ans:Padrao>
			</ans:cabecalho>
			<ans:pedidoElegibilidade>
				<ans:dadosPrestador>
					<ans:codigoPrestadorNaOperadora>???</ans:codigoPrestadorNaOperadora>
				</ans:dadosPrestador>
				<ans:numeroCarteira>?????</ans:numeroCarteira>
				<ans:validadeCarteira>1899-12-30</ans:validadeCarteira>
			</ans:pedidoElegibilidade>
			<ans:hash>cc8cc97157431d8873d34743fa8a64e3</ans:hash>
		</ans:pedidoElegibilidadeWS>
	</soapenv:Body>
</soapenv:Envelope>

Retorno de VerificaElegibilidade

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <respostaElegibilidadeWS xmlns="http://www.ans.gov.br/padroes/tiss/schemas" xmlns:ns2="http://www.w3.org/2000/09/xmldsig#">
         <cabecalho>
            <identificacaoTransacao>
               <tipoTransacao>SITUACAO_ELEGIBILIDADE</tipoTransacao>
               <sequencialTransacao>108</sequencialTransacao>
               <dataRegistroTransacao>2024-02-14</dataRegistroTransacao>
               <horaRegistroTransacao>11:59:07</horaRegistroTransacao>
            </identificacaoTransacao>
            <origem>
               <registroANS>00000</registroANS>
            </origem>
            <destino>
               <identificacaoPrestador>
                  <codigoPrestadorNaOperadora>00000</codigoPrestadorNaOperadora>
               </identificacaoPrestador>
            </destino>
            <Padrao>4.01.00</Padrao>
         </cabecalho>
         <respostaElegibilidade>
            <reciboElegibilidade>
               <numeroCarteira>000000000000</numeroCarteira>
               <nomeBeneficiario>CARLOS JOSE TISS</nomeBeneficiario>
               <tipoIdent>01</tipoIdent>
               <respostaSolicitacao>S</respostaSolicitacao>
            </reciboElegibilidade>
         </respostaElegibilidade>
         <hash>d41d8cd98f00b204e9800998ecf8427e</hash>
      </respostaElegibilidadeWS>
   </S:Body>
</S:Envelope>

Erros que podem ocorrer

Quando o serviço Web ServiceTISS estiver fora, ou seja, por algum motivo deixar de funcionar, ao tentar fazer elegibilidade ou solicitação de procedimento, receberá a mensagem abaixo da caixa de solicitação do Request. Perceba que o local de resposta do XML não recebe informação, ficando em branco.

Quando se envia com um código de um prestador que não existe na base da Operadora:

Quando se verifica a elegibilidade de um usuário em que há números errado da carteirinha ou que faltam:

Quando se envia uma solicitação de procedimento e a carteirinha está errada, o sistema pode gerar a guia, mas com críticas e esta cai parcialmente liberada, ou em auditoria.