Ir para o final dos metadados
Ir para o início dos metadados

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 7 Próxima »

Escrito por: H.S.
 


Manual de utilização do SOAP


Sumário

» Objetivo

» Funcionalidade

» Configurações

» Operacionalização

» Links úteis

Módulo para publicação: Software Aplicação SOAP

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


Funcionalidade

Deixar dicas de funcionalidade da aplicação para que os utilizadores da ferramenta tenham o conhecimento para execução e tenham condições de testar o envio de xml via ferramenta ServiceTiss, e apontar 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

Checar manual de instalaçao do SOAP

Operacionalização


 Utilização do SOAP

Para utilizar basta seguir a instalação do manual do SOAP, Feito 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 de mais nada verificar o link dos serviços que se desejam utilizar, que podem ser de solicitação de procedimentos, ou de verificação de elegibilidade, 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 configuração da TISS do projeto este que se localiza no Netbeans



Abrir a tela do SOAP, e já clique no botão new Soap



Será demonstrada a tela de solicitação da URL/Endpoint que é possivel localizar no acesso liberado no serviço

Os endpointes podem ser os que demonstramos acima nas paginas do navegador a exemplo 

http://(IP_Externo_operadora):8080/TISSSolus40100/tissSolicitacaoProcedimento




O Sistema Carrega a tela e abre uma janela com XML modelo

Desta forma Abra com duplo Clique o Request e terás o modelo e o local para inserir o Endpoint Externo para o serviço.

Abaixo segue um exemplo dos campos que precisam conter para realizar a solicitação de um procedimento, os campos de maneira geral podem ficar da forma como no exemplo com exessã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 esta compreendido entre as tags inicio <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>


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




Abaixo segue um exemplo dos campos que precisam conter para realizar a verificação de elegibilidade, os campos de maneira geral podem ficar da forma como no exemplo com exessã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 esta compreendido entre as tags inicio <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>

Links úteis
  • Indicar outros manuais correspondentes ao atual através de link.

          Para incluir um link utilize o atalho Ctrl + K, onde na primeira opção é possível vincular documentos do mesmo ambiente do Confluence e, na opção "Link da web", é possível vincular links externos, sendo necessário indicar uma máscara para o link no campo "Texto do link".

Documentação elaborada com base na versão vigente do sistema.

Voltar ao início

Revisado por: PREENCHER COM A INICIAL DO NOME E ÚLTIMO SOBRENOME, DATA (Exemplo: N. S., 10/06/2022)
  • Sem rótulos