Web services de Demonstrativos padrão TISS 3.02.01 

Descrição

Disponibilizado a funcionalidade de retorno em formato XML da solicitação de Recurso de Glosa e Solicitação de Status do Recurso de Glosa, conforme padrão TISS 3.02.01 da ANS.

Agora, é possível enviar um XML para o servidor do Protheus com as informações dos recursos de eventuais glosas feitas em protocolos, guias e itens das guias, bem como consultar o status das solicitações de recursos de glosa. O sistema irá gravar o recurso solicitado ou buscar na base de dados a situação de determinado recurso de glosa já realizado anteriormente e retornar um arquivo XML com os dados recursados no formato padrão, para ser tratado por outros sistemas. O arquivo enviado com as informações das solicitações deve obedecer o padrão da TISS 3.02.01.

Para que seja possível o retorno tanto do recurso de glosa ou do status do mesmo, foram utilizados os webservices tissRecursoGlosa e tissSolicitacaoStatusRecursoGlosa, que devem ser baixados da Agência Nacional de Saúde - ANS.

Procedimento para Utilização

Para o correto funcionamento da funcionalidade, todo o ambiente da TISS já deve estar configurado, bem como a necessidade de rodar o Wizard, para que ocorra a atualização da Tabela BVR, que armazena as chamadas das funções responsáveis pelo recurso de glosa e pela solicitação do status de recurso de glosa.

Abaixo, iremos colocar os pontos de observação principais, para que haja a correta utilização da funcionalidade:

• Configurações iniciais
  • Verificar se na pasta Schemas possui os arquivos wsdl de nomes tissRecursoGlosaV3_02_01.wsdl e tissSolicitacaoStatusRecursoGlosaV3_02_01.wsdl na versão 3.02.01. A pasta Schemas fica localizada na seguinte estrutura: protheus_data\tiss\schemas (ou seja, a pasta Schema está dentro da pasta Tiss, que fica dentro da pasta protheus_data)
    
    
    Figura 1 - Estrutura da pasta TISS e suas subpastas, demonstrando a pasta Schemas com os arquivos wsdl (ServiceWeb) da TISS 3.02.01
    
    
  • Caso não encontre este webservice ou queira atualizar a pasta apenas com a versão vigente, será necessário baixar a versão 3.02.01 no site da ANS, no endereço: http://www.ans.gov.br/prestadores/tiss-troca-de-informacao-de-saude-suplementar/padrao-tiss-versao-3-02-01, devendo baixar o item chamado de Componente de Comunicação. Realize a descompactação dos arquivos na pasta Schemas (conforme item anterior) e verifique se todos os arquivos estão na pasta.
  • O arquivo de configuração do servidor deverá estar com as configurações corretas para trabalhar com a TISS online.
    • Verificar se na seção [HTTP] do arquivo de configuração do servidor está presente a configuração de UPLOADPATH (apenas para efeito de exemplo: UPLOADPATH=\tiss\online\caixaentrada)

    • Verificar na seção referente ao Portal que irá receber as solicitações (exemplo; [localhost:8021])  se está configurado o JOB de processamento para a TISS e as variáveis JEMP (código da empresa) e JFIL (filial da empresa). Veja um exemplo abaixo:

      [localhost:8021]
      ENABLE=1
      .......................
      RESPONSEJOB=JOB_TISS
      JEMP=99
      JFIL=01

    • Verificar a existência do JOB para processamento da TISS (citado no tópico acima) que deverá ser identificado pelo colchetes. Exemplo: [JOB_TISS]

    • Caso haja dúvidas, entrar em contato com o suporte.

  • Rodar o Wizard, para atualização da tabela BVR, que contêm a chamada para função do recurso de glosa e solicitação de status do mesmo.
    
    

Características dos arquivos - Recurso de glosa

Abaixo, listamos as características de cada tipo de Recurso de glosa (Protocolo, Guia, Item) na solicitação, ou seja, o que é necessário para que seja possível a solicitação do XML.

1. O arquivo XML que será enviado para o servidor da Operadora que irá retornar os dados deverá estar no formato esperado pela TISS 3.02.01 de Recurso de Glosa.
2. O Recurso de glosa possui como único campo de pesquisa (conforme padrão TISS) a tag <numeroProtocolo>. Nesta caso, o prestador deverá enviar como número de Protocolo o número da PEG. Somente é válido e considerado o número da PEG para pesquisa da glosa para gravar os recursos. Caso seja inserido outra informação, os dados não serão gravados.
   1. Logo, na tag <numeroProtocolo> deverá ser inserido o número de alguma PEG, como por exemplo: <ans:numeroProtocolo>000006</ans:numeroProtocolo>
3. A tag <objetoRecurso> identifica se o recurso de glosa é de Protocolo (valor 1) ou guia (valor 2)
   
   
   Figura 2 - Exemplo de um arquivo XML de Recurso de Glosa de Protocolo (validado pelo programa ValidadorTISS*)
   
   
   Figura 3 - Exemplo de um arquivo XML de Recurso de Glosa de guia com guia completa (validado pelo programa ValidadorTISS*)
   
   
   Figura 4 - Exemplo de um arquivo XML de Recurso de Glosa de Guia com itens(validado pelo programa ValidadorTISS*)
   

    

4. Solicitação de Status de Recurso de Glosa - Para solicitar o status de um recurso de glosa o arquivo XML é simples, a principal tag que deve ser informada é a tag <numeroProtocolo> que é composta pelo número da PEG + número sequencial que é gerado no envio do recurso de glosa.
   
   Figura 5 - Exemplo de um arquivo XML de Solicitação de Status de Recurso de Glosa (validado pelo programa ValidadorTISS*)

Funcionamento do WebService

1. Após as configurações (caso seja necessário), basta apenas acessar o endereço do Portal da Operadora que está configurado para a TISS com a porta de acesso, acrescido do nome do servidor de transação desejado - tissRecursoGlosa ou tissSolicitacaoStatusRecursoGlosa - mais a terminação .apw, para que o sistema identifique que se trata de um acesso para o webservice. Ficaria da seguinte maneira:

   Exemplo de chamada WebService

   http://enderecoOperadora:3580/tissRecursoGlosa.apw

   http://enderecoOperadora:3580/tissSolicitacaoStatusRecursoGlosa.apw

   Deve ser obrigatoriamente deste jeito a chamada, onde informamos o endereço do servidor que será usado mais o webservice que será chamado (no caso, tissRecursoGlosa ou tissSolicitacaoStatusRecursoGlosa) e a terminação .apw, para que o sistema possa processar e entender que se trata de uma solicitação via webservice

2. O sistema irá receber a solicitação, verificar qual o tipo de recurso de glosa (protocolo, guia completa ou item), ou se é uma solicitação de status de recurso de glosa  e checar se o xml está de acordo com o schema para solicitação destes serviços. Caso o XML de solicitação esteja incorreto, os dados não serão gravados ou então o sistema não encontrará os dados do recurso de glosa caso se trate de uma solicitação de status de recurso de glosa.
3. Caso esteja em ordem, o sistema irá realizar as verificações necessárias e no final, irá devolver um arquivo XML com os dados do recurso de glosa solicitado ou consultado.
4. Com este XML de retorno, o prestador pode trabalhar com as informações dentro de seus sistemas, de forma independente da Operadora
5. Para cada recurso de glosa gravado com sucesso ou solicitação de status de recurso de glosa encontrada com sucesso, o sistema grava o XML gerado numa pasta com o código da RDA, dentro da pasta caixasada, que fica em tiss\online\caixasaida (a pasta TISS é a pasta que fica dentro do protheus_data). Ou seja, se o RDA de código 000002 solicitar/consultar um recurso de glosa, o sistema irá criar uma pasta chamada "000002" dentro da pasta caixasaida. Se já existir uma pasta com o código da RDA, o XML gerado será salvo dentro da mesma
   
   Figura 6  - Estrutura da pasta caixasaida, onde temos uma pasta com o código da RDA que solicitou/consultou um recurso de glosa. Dentro desta pasta, temos o XML gerado.
   
   
   Figura 7 - Exemplo de XML de Recebimento de recurso de glosa de Protocolo (validado pelo programa ValidadorTISS*)
   
   
   Figura 8 - Exemplo de XML de Recebimento de recurso de glosa de guia completa (validado pelo programa ValidadorTISS*)
   
   
   

            Figura 9 - Exemplo de XML de Recebimento de recurso de glosa de guia com itens (validado pelo programa ValidadorTISS*)

            Figura 10 - Exemplo de XML de Resposta a consulta de status do recurso de glosa (validado pelo programa ValidadorTISS*)

Programas de Apoio

• Validador TISS - Programa que visa validar os arquivos XML no padrão TISS. Realiza a validação de arquivos de Envio e Retorno. O programa pode ser baixado no endereço: http://blog.aplataforma.com.br/validador-tiss/
• SOAPUI - Programa Open Source, que pode ser utilizado para testar se as configurações do Webservice estão corretas. para maiores informações, consulte o endereço: https://www.soapui.org/