Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Revisão QA Documentação

...

Painel
borderColorgrey
borderStylesolid
Âncora
topo
topo
 



Manual de utilização do SOAP



Sumário

» Objetivo

» Funcionalidade

» Configurações

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

» Operacionalização

» Críticas (inserir link)

» Dúvidas Frequentes (inserir link)

» Links úteis

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


Âncora
objetivo
objetivo

Painel
borderColorgrey
titleColorWhite
borderWidth1px
titleBGColor#B4044A
titleObjetivo
  • Promover conhecimento ao setor de TI para que tenha habilidade de criar o processo processos para testar seus processos a Emissão de emissão de guias , a partir de serviços externos para , a fim de validar a geração da guia via WebServiceTISS.

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

Âncora
funcionalidade
funcionalidade

  1. 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.
  2. Criar novos Expandir
    Ao clicar no nome do componente > pressionar CTRL + C para copiar, posteriormente pressionar CTRL + V para colar.
  • Enviar xml via ferramenta ServerTiss, apontando aos seus terceiros o que podem corrigir no envio que estão realizando.
Painel
borderColorgrey
titleColorWhite
borderWidth1 px
titleBGColor#B4044A
titleFuncionalidade

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
titleTrocar descrição
Nome Descrição

Âncora
config
config

Manter apenas o requisito a ser escrito.
Painel
borderColorgrey
titleColorWhite
titleBGColor#B4044A
titleConfigurações, Parâmetros e/ou Permissões de direitos


Painel
borderWidth2 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
titleConfigurações/Requisitos
Aviso
Painel
borderWidth2 px
Expandir
titleParâ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

note

Cheque o Manual de instalação do SOAP.



Âncora
operacion
operacion

Painel
borderColorgrey
titleColorWhite
borderWidth1px
titleBGColor#B4044A
titleOperacionalização


Expandir
titleUtilização do SOAP

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

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

Image RemovedAntes, 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 IP externo liberado pela TI da Operadora e da configuração da TISS , Projeto este que se localiza do projeto. Este está no Netbeans.

Image Modified


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 é possivel possível localizar no acesso liberado no serviço.

Os endpointes endpoints podem ser os que demonstramos acima, nas paginas páginas do navegador a exemplo . 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 .WSDLO Sistema Carrega


Image Added


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

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

Image Modified


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

Image Added


Abaixo, segue um exemplo doscampos dos campos que precisam conter para realizar a solicitação de solicitar um procedimento. Os campos, os campos de maneira geral pode , podem ficar da forma como no exemplo, com exessão 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 Operadora e demais informações necessárias, . Lembrando que o trecho demarcado abaixo é o que deve esta estar compreendido entre as tags inicio <soapenvinício <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>
Âncora
linkslinks
Painel
borderColorgrey
titleColorWhite
borderWidth1 px
titleBGColor#B4044A
titleLinks ú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".



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


Image Added


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
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ç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)