TISS

Índice

• Introdução
• Configurações
• Funções

...

A Agência Nacional de Saúde Suplementar (ANS) está vinculada ao Ministério da Saúde, com a finalidade de regulamentar as operadoras do setor quanto às suas relações com prestadores e consumidores, e contribui para o desenvolvimento das ações de saúde no País.

...

• • Armazenamento e validação de Biometria de usuários;
  • Um facilitador acessado diretamente pelo navegador web para digitação de guias.

...

As transações, versões e respectivas mensagens WebService suportadas pelo Foundation Saúde, estão estruturadas conforme mostrado abaixo:

Propriedades do Sistema

As propriedades do sistema são configuradas no arquivo jboss-4.2.3.GA/server/default/conf/tiss.ini. Este arquivo está pré-configurado, porém há algumas propriedades relativas ao caminho de instalação que devem ser verificadas. O arquivo possui descrições explicativas sobre suas propriedades.

Arquivo tiss.ini:

• Propriedade: tiss.versao.atual
• Valor padrão: 3.03.01
• Descrição: Versão atual da especificação TISS, última versão suportada

• Propriedade: tiss.schema
• Valor padrão: tiss.V3_03_01.xsd
• Descrição: Schema de validação da última versão suportada, essa propriedade deve ser preenchida apenas com o código da versão, deve ser sumprimido o caminho do schema.

• Propriedade: tiss.versao.anterior
• Valor padrão: 2.02.03
• Descrição: Versão da especificação TISS anterior a atual, que ainda deve ser suportada

• Propriedade: tiss.schema.anterior
• Valor padrão: tissV2_02_03.xsd
• Descrição: Schema de validação da versão anterior, essa propriedade deve ser preenchida apenas com o código da versão, deve ser sumprimido o caminho do schema.

• Propriedade: tissnet.schema
• Valor padrão: tissnetV2_02_03.xsd
• Descrição: Schema de validação TissNet, essa propriedade deve ser preenchida apenas com o código da versão, deve ser sumprimido o caminho do schema.

• Propriedade: tiss.schema.namespace.uri
• Valor padrão: http://www.ans.gov.br/padroes/tiss/schemas
• Descrição: Namespace das mensagens XML TISS, a leitura das mensagens depende desta variável

• Propriedade: tiss.schema.namespace.prefix
• Valor padrão: ans
• Descrição: Prefixo preferencial para mensagens XML TISS, usado na criação de mensagens XML TISS

• Propriedade: com.datasul.saude.foundation.payerType
• Valor: ANS ou CNPJ
• Descrição: Os valores desta variável devem ser atribuídos conforme a operadora onde o sistema está operando

• Propriedade: com.datasul.saude.foundation.payerCode
• Valor: NNNN
• Descrição: Número do registro na ANS ou CNPJ, deve estar de acordo com o valor da propriedade atribuída acima “com.datasul.saude.foundation.payerType”

Propriedades – Sistema Gestão de Planos

Nesta seção terá algumas configurações específicas para o sistema Gestão de Planos.

• Propriedade: tiss.digestor.webservices.transmitemensagem
• Valor padrão: com.datasul.saude.tissnet42.digestor.GenericMessageDigestor
• Descrição: classe digestora genérica, pode ser usada se não houver digestor específico para algum tipo de mensagem.

• Propriedade: tiss.digestor.webservices.loteanexo
• Valor padrão: com.datasul.saude.tissnet42.digestor.AttachGroupDigestor
• Descrição: classe digestora para processar arquivos em lote.

• Propriedade: tiss.digestor.webservices.VERIFICA_ELEGIBILIDADE
• Valor padrão: com.datasul.saude.tissnet42.digestor.VerifyElegibilityDigestor
• Descrição: classe digestora para serviço de Verificação de Elebibilidade.

• Propriedade: tiss.digestor.webservices.SOLIC_STATUS_PROTOCOLO
• Valor padrão: com.datasul.saude.tissnet42.digestor.ProtocolStatusDigestor
• Descrição: classe digestora para serviço de Solicitação de Status do Protocolo.

• Propriedade: tiss.digestor.webservices.SOLIC_DEMONSTRATIVO_RETORNO
• Valor padrão: com.datasul.saude.tissnet42.digestor.SolicitationReturnDemonstrativeDigestor
• Descrição: classe digestora para serviço de Solicitação de Demonstrativo de Retorno.
• Propriedade: tiss.digestor.webservices.ENVIO_LOTE_GUIAS
• Valor padrão: com.datasul.saude.tissnet42.digestor.InvoiceGroupDigestor
• Descrição: classe digestora para serviço de Envio de Lote de Guias.

• Propriedade: tiss.digestor.webservices.SOLICITACAO_PROCEDIMENTOS
• Valor padrão: com.datasul.saude.tissnet42.digestor.ProcedureSolicitationDigestor
• Descrição: classe digestora para serviço de Solicitação de Procedimentos.

• Propriedade: tiss.digestor.webservices.CANCELA_GUIA
• Valor padrão: com.datasul.saude.tissnet42.digestor.CancelProcedureSolicitationDigestor
• Descrição: classe digestora para serviço de Cancelamento de Guias.
• Propriedade: tiss.digestor.webservices.SOLICITA_STATUS_AUTORIZACAO
• Valor padrão: com.datasul.saude.tissnet42.digestor.AuthorizationStatusDigestor
• Descrição: classe digestora para serviço de Solicitação de Status de Autorização.

• Propriedade: tiss.digestor.webservices. RECURSO_GLOSA
• Valor padrão: com.datasul.saude.tissnet42.digestor.RestrictResourceDigestor
• Descrição: classe digestora para serviço de Recurso de Glosa.

• Propriedade: tiss.digestor.webservices. solicitacaostatusrecursoglosa
• Valor padrão: com.datasul.saude.tissnet42.digestor.RestrictionResourceStatusDigestor
• Descrição: classe digestora para serviço de Status do Protocolo de Recurso de Glosa.

Propriedades – Sistema UNICOO

Nesta seção terá algumas configurações específicas para o sistema UNICOO. 

• Propriedade: tiss.digestor.webservices.transmitemensagem
• Valor padrão:com.datasul.saude.egp.digestores.DigTissTransmiteMensagem
• Descrição: classe digestora genérica, pode ser  usada se não houver digestor específico para algum tipo de mensagem

• Propriedade: tiss.digestor.webservices.verificaelegibilidade
• Valor padrão: com.datasul.saude.egp.digestores.DigTissVerificaElegibilidade
• Descrição: classe digestora para serviço de Verificação de Elegibilidade

• Propriedade: tiss.digestor.webservices. solicitacaostatusprotocolo
• Valor padrão: com.datasul.saude.egp.digestores.DigTissSolicitacaoStatusProtocolo
• Descrição: classe digestora para serviço de Solicitação de Status do Protocolo

• Propriedade: tiss.digestor.webservices.solicitacaodemonstrativoretorno
• Valor padrão: com.datasul.saude.egp.digestores.DigTissDemonstrativoRetorno
• Descrição: classe digestora para serviço de Solicitação de Demonstrativo de Retorno

• Propriedade: tiss.digestor.webservices.loteguias
• Valor padrão: com.datasul.saude.egp.digestores.DigTissLoteGuias
• Descrição: classe digestora para serviço de Envio de Lote de Guias

• Propriedade: tiss.digestor.webservices.solicitacaoprocedimento
• Valor padrão: com.datasul.saude.egp.digestores.DigTissSolicitacaoProcedimento
• Descrição: classe digestora para serviço de Solicitação de Procedimentos

• Propriedade: tiss.digestor.webservices. cancelaguia
• Valor padrão: com.datasul.saude.egp.digestores.DigTissCancelaGuia
Descrição: classe digestora para serviço de Cancelamento
• • de
Guias

• Propriedade: tiss.digestor.webservices. solicitacaostatusautorizacao
• Valor padrão: com.datasul.saude.egp.digestores.DigTissSolicitacaoStatusAutorizacao
• Descrição: classe digestora para serviço de Solicitação de Status de Autorização

• Propriedade: tiss.digestor.webservices.recursoglosa
• Valor padrão: com.datasul.saude.egp.digestores.DigTissRecursoGlosa
• Descrição: classe digestora para serviço de Recurso de Glosa
• Propriedade: tiss.digestor.webservices.solicitacaostatusrecursoglosa
• Valor padrão: com.datasul.saude.egp.digestores.DigTissSolicitacaoStatusRecursoGlosa
• Descrição: classe digestora para serviço de Status do Protocolo de Recurso de Glosa

Recebimento de Mensagem por WebService

O recebimento de mensagens de serviço pode ser feito por meio de Web Services, podendo ser utilizado certificado de segurança. Os serviços disponíveis e a estrutura da mensagem são obtidos na página de serviços do JBoss, acessada no navegador pelo endereço http://<host-name>[:port]/jbossws/services.

Nessa página, os endpoints podem ser encontrados através do seu nome indicado na coluna "WebService(endpoint)" da tabela de mensagens disponíveis.

Por exemplo, para saber o endereço do serviço de Recurso de Glosas na versão 3.03.01, se busca na tabela o nome do endpoint, que é "TISSRecursoGlosaV_3_03_01WS" Ao pesquisar por esse nome na página de serviços do JBoss, verifica-se que o endereço é exibido em "Endpoint Address". Neste exemplo, o valor é "http://fndsauhml.totvs.com.br:28080/htzfoundation-HTZFoundationEJB/TISSRecursoGlosaV_3_03_01WS?wsdl", conforme ilustrado a seguir:

Image Removed

Configuração para suporte a versões antigas

No arquivo de propriedades do Foundation Saúde, jboss-4.2.3.GA\server\default\deploy\properties-service.xml, é possível configurar as versões TISS que a operadora aceita receber, seja através de XML ou WebService.

Essa configuração segue o seguinte formato: com.totvs.saude.tiss.suportversion.<versão_TISS>=[true|false]

Exemplos:

• com.totvs.saude.tiss.suportversion.2.02.01=false
• com.totvs.saude.tiss.suportversion.2.02.02=false
• com.totvs.saude.tiss.suportversion.3.03.01=true

Observação: O valor default é true. Então a ausência da propriedade é interpretada como permissão para receber mensagens nessa versão. Esta configuração não remove o WebService do servidor, porém quando configurado para não ser suportado, se o serviço for acionado será retornada uma mensagem informando que não é suportado.

Logo para demonstrativos retorno

Adicione no diretório “JBOSS_HOME\server\default\conf”, o logo desejado para os demonstrativos. Tamanho máximo: 473x152 pixels. Nome da imagem: logo_demonstrativo.png.

...

Regras de Validação

O Foundation Saúde disponibiliza regras para validação de transações TISS. Estas regras podem ser utilizadas conforme a necessidade de cada cliente e futuramente poderão ser construídas novas regras. A seguir as regras disponíveis na versão mais recente do produto.

Validação de Lote de Guias

• Descrição: Verifica Guias repetidas no lote.
• Objetivo: Realizar a consistência na mensagem TISS “ENVIO_LOTE_GUIAS” para que não seja permitido realizar o envio de um lote que guias que possuam uma ou mais guias repetidas. 

...

• • guias

...

Para a customização de regras, o cliente deve entrar em contato com o consultor ou unidade que realizou a implantação por meio de "FO", solicitando tal customização.

IN 40 – Obrigatoriedade do CID

A Instrução Normativa no. 40, divulgada pela ANS, definiu sobre o não preenchimento do CID (Classificação Internacional de Doenças da Organização Mundial de Saúde), em todas as Guias TISS, decorrente de liminar deferida em Ação Civil Pública promovida pelo Conselho Regional de Medicina do Estado do Rio de Janeiro.

Para atender  a não obrigatoriedade da informação do CID nas guias TISS, será utilizado para controle da obrigatoriedade o arquivo de configuração do sistema chamado "properties-service.xml". Neste arquivo são configurados os parâmetros para obrigatoriedade, ou não, para o CID em cada tipo de guia. Por padrão e em conformidade com a IN 40 nenhum CID será obrigatório.

O arquivo terá como base de configuração (properties-service.xml) a seguinte característica:

Este arquivo esta disponível no seguinte caminho: JBOSS_HOME\server\default\deploy\properties-service.xml.

Caso estas propriedades “icdrequired” não forem definidas, seu valor padrão será considerado como “false”.

Caso algum dos tipos de guia exija que o CID seja obrigatório, basta alterar o parâmetro da guia respectiva. Ex: fazer com o sistema valide o preenchimento do CID nas guias de SADT

com.datasul.medical.web.action.tiss.sadt.icdrequired=true

Observação: para que a configuração seja reconhecida pela aplicação, o "JBOSS" deve ser reinicializado.

As parametrizações ainda preveem o suporte a implementação especifica para a busca dos valores citados acima. Entretanto a aplicação é distribuída com a implementação padrão e em caso de necessidade de desenvolvimento especifico o cliente deve entrar em contato com o consultor ou unidade que realizou a implantação através de "FO", solicitando tal customização.

TISS – Upload por diretório

O Foundation Saúde suporta o upload de arquivos TISS por diretório, onde o sistema fará o monitoramento do diretório de entrada conforme descrito a seguir.

Para realizar upload de XML TISS, por meio de estrutura de diretórios com suporte também a arquivos ".ZIP", realize os passos abaixo.

• • Definir as propriedades "tiss.recepcao" e "tiss.resposta", de acordo com o ambiente já existente ou ambiente novo.

Exemplo: tiss.recepcao=c:/tiss/recepcao e tiss.resposta=c:/tiss/resposta

• • Este arquivo de configuração esta disponível em: JBOSS_HOME\server\default\deploy\properties-service.xml.

Exemplo de configuração do arquivo "properties-service.xml": 

<attribute name="Properties">

      #Informa o diretório de recepção dos arquivos TISS. Deve seguir o padrao UNIX

#Valor padrao = variável "user.dir"/recepcao

      tiss.recepcao=C:/tiss/recepcao 

      #Informa o diretório de resposta dos arquivos TISS. Deve seguir o padrao UNIX

#Valor padrao = variável "user.dir"/resposta

      tiss.resposta=C:/tiss/resposta 

      #Informa se o foundation irá ler/gravar em um subdiretorio com a data atual no padrao AAAAMMDD.

      #Valor padrao = false. Caso esta opcao estaja como true, entao deverá gravar tambem como um diretorio com a data atual.

      tiss.diretorio.dia=false

</attribute>

 Para a integração por diretório, o sistema irá gerar um log auxiliar que pode ser encontrado em JBOSS_HOME\server\default\tiss-console-log.

Os arquivos processados serão movidos do diretório de entrada para o diretório JBOSS_HOME\server\default\xml-processados.

Iniciando e parando o processo de integração por diretório

Para iniciar o processo de monitoramento do diretório de entrada configurado, fazer o seguinte processo:

1. 1. Acessar o sistema "Foundation", pela Web. Ex.: http://localhost:28080/htz;
   2. Logar no sistema com a conta de administrador;
   3. Acessar a opção “Solicitação / Upload”;
   4. Acessar a opção “Console TISS”;
   5. Clicar no botão “Start”.

...

• • .