Web services de Demonstrativos padrão TISS 3.02.01 

Características do Requisito

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 do site da Agência Nacional de Saúde - ANS.

Importante

Antes de executar o compatibilizador UPDWSRG é imprescindível:

• Realizar o backup da base de dados do produto que será executado o compatibilizador ( \PROTHEUS11_DATA\DATA) e dos dicionários de dados SXs (\PROTHEUS11_DATA\SYSTEM).
• Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
• Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
• Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-los a partir da ordem original instalada pelo Protheus, o que poderá sobrescrever índices personalizados, caso não estejam identificados pelo nickname.
• O compatibilizador deve ser executado com a Integridade Referencial desativada*.

1. Em TOTVS Smart Client, digite U_UPDWSRG no campo Programa Inicial.
   1. Clique em OK para continuar.
   2. Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado.
2. Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
   1. Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos. 
      É apresentada uma mensagem explicativa na tela.
   2. Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.
   3. Clique em Gravar para salvar o histórico (log) apresentado.
   4. Clique em OK para encerrar o processamento. 

Atualizações do Compatibilizador

1.  Criação de Campos no arquivo SX3 – Campos:

• Tabela BA0 - Operadoras de Saúde

  Campo	BA0_CRIPRZ
  Tipo	C
  Tamanho	12
  Decimal	0
  Título	Glos Prz Rec
  Descrição	Glosa para prazo recurso
  Usado	Sim
  Obrigatório	Não
  Browse	Não
  Val. Sistema	ExistCpo("BTQ", "38"+M->BA0_CRIPRZ,1)
  Help	Indica o código da glosa caso o prazo limite para recurso de glosa seja atingido.

  Campo	BA0_TABPRZ
  Tipo	C
  Tamanho	2
  Decimal	0
  Título	Tab Glos Prz
  Descrição	Tabela da glosa do prazo
  Usado	Sim
  Obrigatório	Não
  Browse	Não
  Help	Indica a tabela padrão que corresponde a glosa escolhida para o prazo limite de recurso de glosa

  Campo	BA0_DESPRZ
  Tipo	C
  Tamanho	100
  Decimal	0
  Formato	@!
  Título	Des glos prz
  Descrição	Descrição glosa do prazo
  Usado	Sim
  Obrigatório	Não
  Browse	Não
  Relação	IIF(!INCLUI,ALLTRIM(POSICIONE("BTQ",1,XFILIAL("BTQ")+BA0->BA0_TABPRZ+BA0->BA0_CRIPRZ,"BTQ_DESTER")),"")
  Help	Descrição da glosa do prazo do recurso

  Campo	BA0_CRILIM
  Tipo	C
  Tamanho	12
  Decimal	0
  Título	Glos Lim Rec
  Descrição	Glosa para limite recurso
  Usado	Sim
  Obrigatório	Não
  Browse	Não
  Val. Sistema	ExistCpo("BTQ", "38"+M->BA0_CRILIM,1)
  Help	Define qual o codigo de glosa será exibido quando o limite de recurso de glosa for atingido

  Campo	BA0_TABLIM
  Tipo	C
  Tamanho	2
  Decimal	0
  Título	Tab Glos Lim
  Descrição	Tabela da glosa de limite
  Usado	Sim
  Obrigatório	Não
  Browse	Não
  Help	Tabela da glosa escolhida para quando o limite de recurso de glosa é atingido

  Campo	BA0_DESLIM
  Tipo	C
  Tamanho	100
  Decimal	0
  Formato	@!
  Título	Des glos lim
  Descrição	Descrição glosa do limite
  Usado	Sim
  Obrigatório	Não
  Browse	Não
  Relação	IIF(!INCLUI,ALLTRIM(POSICIONE("BTQ",1,XFILIAL("BTQ")+BA0->BA0_TABLIM+BA0->BA0_CRILIM,"BTQ_DESTER")),"")
  Help	Descrição da glosa para quando o limite de recurso de glosa é atingido.

• Tabela B4E - Itens Recurso Glosa

  Campo	B4E_QTDIRP
  Tipo	N
  Tamanho	3
  Decimal	0
  Título	Qtd.Rec.Port
  Descrição	Qtd.Rec.Incluidos Portal
  Usado	Sim
  Obrigatório	Não
  Browse	Não
  Help	Quantidade de recursos de glosa efetuados para o item

• Tabela BVO - Histórico de Recurso de Glosa

  Campo	BVO_CODRDA
  Tipo	C
  Tamanho	6
  Decimal	0
  Título	Cod. RDA
  Descrição	Codigo da RDA
  Usado	Sim
  Obrigatório	Não
  Browse	Não
  Help	Código da Rede de Atendimento

  Campo	BVO_LOTEPR
  Tipo	C
  Tamanho	12
  Decimal	0
  Título	Num Lot Pres
  Descrição	Numero Lote Prestador
  Usado	Sim
  Obrigatório	Não
  Browse	Não
  Help	Numero Lote gerado pelo prestador

  Campo	BVO_ENVXML
  Tipo	C
  Tamanho	4
  Decimal	0
  Título	Prot EnvXML
  Descrição	Protocolo Envio XML
  Usado	Sim
  Obrigatório	Não
  Browse	Não
  Help	Protocolo gerado sempre que o prestador envia um xml com recurso de glosa

  Campo	BVO_GUIRGP
  Tipo	C
  Tamanho	20
  Decimal	0
  Título	Gui RecGl Pr
  Descrição	Guia Recurso Glosa Presta
  Usado	Sim
  Obrigatório	Não
  Browse	Não
  Help	Numero da guia do recurso de glosa do prestador

Importante:

O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.

2.  Criação de Consulta Padrão no arquivo SXB – Consulta Padrão:

• Pesquisa BTQBA0:

3.  Criação de Índices no arquivo SIX – Índices:

4.  Criação de Gatilhos no arquivo SX7 – Gatilhos:

• Tabela BA0 – Operadoras de Saúde

Procedimento para Utilização

Para o correto funcionamento da funcionalidade, todo o ambiente da TISS já deve estar configurado, bem como a necessidade de recarregar a versão da Tiss , 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/images/stories/Plano_de_saude_e_Operadoras/tiss/Padrao_tiss/tiss3/padraotiss_comunicacao_030201.zip .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.

  • Recarregar versão da tiss, 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/