Histórico da Página
Descrição
| Aviso | ||
|---|---|---|
| ||
Documentação descontinuada. |
Procedimento para Utilização
Webservices 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 | Informe o(s) chamado(s) relacionado(s). | ||||||||
País(es): | Brasil | ||||||||
Banco(s) de Dados: | Todos relacionais homologados. | ||||||||
Tabelas Utilizadas: | BD7 - Part Honorários Prestado Itens | ||||||||
Sistema(s) Operacional(is): | Windows® / Linux® |
Descrição
Disponibilizado a funcionalidade de retorno em formato XML dos Demonstrativos de Análise de Conta, Pagamento e Pagamento Odontológico, conforme padrão TISS 3.02.01 da ANS.
Agora, é possível enviar um XML para o servidor do Protheus com as informações das solicitações e o tipo de relatório desejado, que o sistema irás retornar o arquivo XML com os dados - de acordo com o relatório solicitado - no formato padrão, para ser tratado por outros sistema. 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 destes dados dos relatórios, foi utilizado o webservice tissSolicitacaoDemonstrativoRetorno, que dever ser baixado 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 demonstrativos.
Abaixo, iremos colocar os pontos de observação principais, para que haja a correta utilização da funcionalidade:
Configurações iniciaisVerificar se na pasta Schemas possui o arquivo wsdl de no tissSolicitacaoDemonstrativoRetorno.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
- 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.
Características dos Relatórios - Envio de Solicitação
Abaixo, listamos as características de cada relatório na solicitação, ou seja, o que é necessário para que seja possível a solicitação do XML.
- Logo, na tag <numeroProtocolo> deverá ser inserido o número de alguma PEG, como por exemplo: <ans:numeroProtocolo>000006</ans:numeroProtocolo>
Figura 2 - Exemplo de um arquivo XML de Solicitação de Demonstrativo de Análise de Conta (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, acrescido do nome do servidor de transação desejado - tissSolicitacaoDemonstrativoRetorno - 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 | ||
|---|---|---|
| ||
http://minhaoperadora:3580/tisssolicitacaodemonstrativoretorno.apw |
Figura 3 - Estrutura da pasta caixasaida, onde temos uma pasta com o código da RDA que solicitou algum tipo de relatório de demonstrativo. Dentro desta pasta, temos o XML gerado.
Figura 4 - Exemplo de XML de Retorno do Demonstrativo de Análise de Conta (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/
Vídeo
- Vídeo hospedado no youtube e inserido no template por meio da macro Widget Connector.
** Canal do youtube e software de vídeoem definição.
Título do Vídeo: | Disponibilizado pelo Marketing. |
Introdução: | Disponibilizado pelo Marketing. |
Passo a Passo: | Capturar diretamente do sistema. |
Finalização: | Disponibilizado pelo Marketing. |
Ponto de Entrada
Descrição: | Informe o Menu em que estará localizada a rotina | ||||||||||||||||
Localização: | Informe o Submenu em que estará localizada a rotina | ||||||||||||||||
Eventos: | Informe o Título da rotina | ||||||||||||||||
Programa Fonte: | Informe o Fonte da rotina | ||||||||||||||||
Função: | Informe o Nome do(s) produto(s) a ser utilizado ou “Todos” | ||||||||||||||||
Retorno: |
|
Exemplo:
#Include 'Protheus.ch'
User Function CN120ALT()
Local aCab:= PARAMIXB[1]
Local cTipo:= PARAMIXB[2]
If cTipo == '1'
aCab[4][2]:= 'NF' //Validações do usuário
EndIf
Return aCabImport HTML Content
Visão Geral
Conteúdo das Ferramentas