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 a chamada da função responsável pelo processamento dos demonstrativosas 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 o arquivo wsdl de no tissSolicitacaoDemonstrativoRetornoos 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 Dataprotheus_data\tiss\schemas (ou seja, a pasta Schema está dentro da pasta Tiss, que fica dentro da pasta Protheus Dataprotheus_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 de retorno dos demonstrativosdo recurso de glosa e solicitação de status do mesmo.
    
    

Características dos

arquivos -

Recurso de

glosa

Abaixo, listamos as características de cada relatório 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 Solicitação Recurso de DemonstrativosGlosa.
2. O Demonstrativo Recurso de Análise de Conta 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 do Demonstrativo de Análise de Contada glosa para gravar os recursos. Caso seja inserido outra informação, não será retornado 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>
      Image Removed
      Figura 2
3. A tag <objetoRecurso> identifica se o recurso de glosa é de Protocolo (valor 1) ou guia (valor 2)
   
   Image Added
   Figura 2 - Exemplo de um arquivo XML de Recurso de Glosa de Protocolo (validado pelo programa ValidadorTISS*)
   
   Image Added
   Figura 3 - Exemplo de um arquivo XML
de Solicitação de Demonstrativo de Análise de Conta
4. de Recurso de Glosa de guia com guia completa (validado pelo programa ValidadorTISS*)
   
   Image Added
   Figura 4 - Exemplo de um arquivo XML de Recurso de Glosa de Guia com itens(validado pelo programa ValidadorTISS*)
   

    

5. 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.
   Image Added
   Figura 5 - Exemplo de um arquivo XML de Solicitação de Status de Recurso de Glosa (validado pelo programa ValidadorTISS*)O Demonstrativo de Pagamento e o Demonstrativo de Pagamento Odontológico possuem como parâmetros os campos: código do Prestador na Operadora ou CPF ou CNPJ, Nome do Prestador, Data da Solicitação, tipo da Solicitação (1=Demonstrativo Pagamento, 3=Demonstrativo Pagamento Odonto) e Período (Competência ou Data de Pagamento). Exemplo das tags que estão no XML de solicitação de Demonstrativo:
   Image Removed
   Figura 3 - Exemplo das tags no arquivo de Solicitação de Demonstrativo.

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 - tissSolicitacaoDemonstrativoRetorno 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:

   Informações
   title Exemplo de chamada WebService
   http://enderecoOperadora:3580/tissRecursoGlosa.apw http://minhaoperadoraenderecoOperadora:3580/tisssolicitacaodemonstrativoretornotissSolicitacaoStatusRecursoGlosa.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, tisssolicitacaodemonstrativoretorno 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 Demonstrativo desejado (Análise de Contas / Pagamento / Pagamento Odonto) e 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 relatóriosdestes serviços. Caso o XML de solicitação esteja incorreto, o relatório não será geradoos 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 relatório 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 relatório emitido 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 Dataprotheus_data). Ou seja, se o RDA de código 000002 solicitar/consultar um demonstrativorecurso 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 desta pastada mesma
   
   
   Figura 4 6  - Estrutura da pasta caixasaida, onde temos uma pasta com o código da RDA que solicitou algum tipo de relatório de demonstrativo/consultou um recurso de glosa. Dentro desta pasta, temos o XML gerado.
   Image Removed
   
   
   Image Added
   Figura 7 - Exemplo de XML de Recebimento de recurso de glosa de Protocolo (validado pelo programa ValidadorTISS*)
   
   Image Added
   Figura 8 Figura 5 - Exemplo de XML de Recebimento de Retorno do Demonstrativo recurso de Análise glosa de Conta  guia completa (validado pelo programa ValidadorTISS*)
   Image Removed
   Image Added
   

             Figura 6 9 - Exemplo de XML de Retorno do Demonstrativo de Pagamento de Recebimento de recurso de glosa de guia com itens (validado pelo programa ValidadorTISS*)

              Image RemovedImage Added

              Figura 7 10 - Exemplo de XML de Resposta a consulta de Retorno status do Demonstrativo recurso de Pagamento Odontologia 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/