Web services de Demonstrativos padrão TISS 3.02.01
Linha de Produto: | Microsiga Protheus | ||||||||||||||
Segmento: | Saúde | ||||||||||||||
Módulo: | SIGAPLS - Plano de Saúde | ||||||||||||||
Rotina: |
| ||||||||||||||
Chamados Relacionados | TSBAKR | ||||||||||||||
País(es): | Brasil | ||||||||||||||
Banco(s) de Dados: | Todos relacionais homologados. | ||||||||||||||
Tabelas Utilizadas: | B4D - Cabeçalho Recurso de glosa B4E - Itens Recurso de glosa BVO - Tentativas de Recurso de glosa BCT - Motivos de glosas | ||||||||||||||
Sistema(s) Operacional(is): | Windows® / Linux® |
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=01Verificar 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.
- 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)
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.
- 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.
- 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.
- Logo, na tag <numeroProtocolo> deverá ser inserido o número de alguma PEG, como por exemplo: <ans:numeroProtocolo>000006</ans:numeroProtocolo>
- 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*) - 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
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
- 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.
- 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.
- Com este XML de retorno, o prestador pode trabalhar com as informações dentro de seus sistemas, de forma independente da Operadora
- 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/