Painel

borderColor	grey
borderStyle	solid

Âncora
topo
topo

Título do conteúdo

Manual de utilização do SOAP

Sumário

» Configurações

, Parâmetros e/ou Permissões de Direitos

» Dúvidas Frequentes (inserir link)

» Links úteis

Módulo para publicação: Módulo XXX

Âncora

	objetivo
	objetivo

Painel

borderColor	grey
titleColor	White
borderWidth	1px
titleBGColor	#B4044A
title	Objetivo

Breve explicação da finalidade do manual.

Ex.: (O objetivo deste manual é orientar sobre...)

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.

Âncora

	funcionalidade
	funcionalidade

Para alterar o nome do componente Expandir:
Ao clicar no nome do componente, serão habilitados dois botões no rodapé: "Alterar" e "Eliminar"; clique em "Alterar" e será exibida a tela para trocar o título.
Criar novos Expandir
Ao clicar no nome do componente > pressionar CTRL + C para copiar, posteriormente pressionar CTRL + V para colar.

Descrição

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

Painel

borderColor	grey
titleColor	White
borderWidth	1 px
titleBGColor	#B4044A
title	Funcionalidade

Explicar a funcionalidade do recurso em tópicos.

Ex.:

O ar-condicionado tem a função de ligar e desligar;
Programar a temperatura;
Permite controlar a intensidade do vento.

Expandir

title	Trocar descrição

Nome

Âncora

	config
	config

Manter apenas o requisito a ser escrito.

Painel

borderColor	grey
titleColor	White
titleBGColor	#B4044A
title	Configurações, Parâmetros e/ou Permissões de direitos

Painel

borderWidth	2 px

Inserir aqui todos os Direitos que influenciam nas rotinas tratadas neste manual:

Ex.:

Para poder incluir ou excluir descontos:

Módulo XXXX> Configurações > Restrições de acesso

Expandir

title	Configurações/Requisitos

Aviso

Painel

borderWidth	2 px

Cheque o Manual de instalação do SOAP.

Expandir

title	Parâmetros

Inserir aqui todos os Direitos que influenciam nas rotinas tratadas neste manual:

Ex.:

Para poder incluir ou excluir descontos:

Módulo XXXX> Configurações > Restrições de acesso

Nota

Âncora

	operacion
	operacion

Explique o recurso de forma operacional, ou seja, de como fazer para utilizá-lo.

Ex. Controle de um ar-condicionado:

Para definir a temperatura que desejo, eu utilizo o botão TEMP que tem a opção "+" para aumentar a temperatura e a opção "-" para reduzi-la.

Para definir a intensidade do vento, eu utilizo o botão FAN onde tenho a opção "+" para uma intensidade maior e a opção "-" para uma intensidade menor.

No caso de rotinas onde há abas, criar um Expandir para cada uma delas.

Painel

borderColor	grey
titleColor	White
borderWidth	1px
titleBGColor	#B4044A
title	Operacionalização

Expandir

title	Trocar descrição

Para alterar o nome do componente Expandir:
Ao clicar no nome do componente, serão habilitados dois botões no rodapé: "Alterar" e "Eliminar"; clique em "Alterar" e será exibida a tela para trocar o título.
Criar novos Expandir
Ao clicar no nome do componente > pressionar ctrl + C para copiar, posteriormente pressionar ctrl + V para colar.

Âncoralinkslinks

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

Painel

borderColor	grey
titleColor	White
borderWidth	1 px
titleBGColor	#B4044A
title	Links úteis

Expandir

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

Image Added

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

Image Added

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

Image Added

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

Image Added

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.

Image Added

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

Image Added

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

Expandir

title	Exemplo de XML Solicitação de procedimentos

Bloco de código

language	xml
title	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>

Bloco de código

language	xml
title	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.

Image Added

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

Image Added

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

Expandir

title	Exemplo de XML Verifica Elegibilidade

Bloco de código

language	xml
title	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>

Bloco de código

language	xml
title	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>

Expandir

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

Image Added

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

Image Added

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

Image Added

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.

Image Added

A guia gerada pode estar com a mensagem na aba "Críticas", mas sem liberação.

Image Added

Quando o procedimento não está na tabela ou está errado:

Image Added

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

Image Added

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

F. S.,

10/06/2022)

Versões comparadas

Versão antiga 1

Nova versão Atual

Chave

Âncora
topo
topo

Manual de utilização do SOAP

Sumário

» Objetivo

» Funcionalidade

» Configurações

» Operacionalização

» Dúvidas Frequentes (inserir link)

» Links úteis

Módulo para publicação: Módulo XXX

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

Revisado por:

F. S.,

22 de fev. de 2024

Comparação de Páginas

Versões comparadas

Versão antiga 1

Nova versão Atual

Chave

Âncoratopotopo

Manual de utilização do SOAP

Sumário

» Objetivo

» Funcionalidade

» Configurações

» Operacionalização

» Dúvidas Frequentes (inserir link)

» Links úteis

Módulo para publicação: Módulo XXX

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

Revisado por:

F. S.,

22 de fev. de 2024

Âncora
topo
topo