Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Painel
borderColorgrey
borderStylesolid
Âncora
topo
topo
 



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

Âncora
objetivo
objetivo

Painel
borderColorgrey
titleColorWhite
borderWidth1px
titleBGColor#B4044A
titleObjetivo
  • 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.


Âncora
funcionalidade
funcionalidade

Painel
borderColorgrey
titleColorWhite
borderWidth1 px
titleBGColor#B4044A
titleFuncionalidade

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

Âncora
config
config

Painel
borderColorgrey
titleColorWhite
titleBGColor#B4044A
titleConfigurações, Parâmetros e/ou Permissões de direitos


Painel
borderWidth2 px


Expandir
titleConfigurações/Requisitos

Checar manual de instalaçao do SOAP




Âncora
operacion
operacion

Painel
borderColorgrey
titleColorWhite
borderWidth1px
titleBGColor#B4044A
titleOperacionalização


Expandir
titleUtilizaçã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 Operadora, 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




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



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.


Exemplo de guia emitida pelo ServiceTiss pelo módulo Guias



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>

Expandir
titleExemplo de XML Solicitação de procedimentos


Bloco de código
languagexml
titleExemplo 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>


Bloco de código
languagexml
titleResposta 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. Neste caso o SOAP faz a busca automática do tipo que esta no caminho .WSDL






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>

Expandir
titleExemplo de XML Verifica Elegibilidade


Bloco de código
languagexml
titleExemplo 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>
 


Bloco de código
languagexml
titleRetorno 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>




Expandir
titleErros que podem ocorrer

Quando o serviços Web ServiceTISS estiver fora, ou seja por algum motivo deixou 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.

Image Added


Quando estou enviando com um código de um prestador que não existe na base da operadora.


Image Added


Quando estou verificando a elegibilidade de um usuário em que há números errado da carteirinha ou que faltam.


Image Added


Quando estou enviando uma solicitação de procedimento e a carteirinha esta errada, o sistema pode gerar a guia mas com criticas e a mesma cai parcialmente liberada, ou em auditoria


Image Added

Guia Gerada pode estar com a mensagem na aba críticas, mas sem liberação.

Image Added


Quando o procedimento não esta na tabela, ou esta errado.


Image Added


Na guia gerada pode ser que gere negada ou ainda em auditoria, com as criticas de procedimento inválido.


Image Added





Âncora
links
links

Painel
borderColorgrey
titleColorWhite
borderWidth1 px
titleBGColor#B4044A
titleLinks úteis

InstalaçãoSoap



Aviso

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)

...