Histórico da Página
TISS
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.
Para padronizar e regulamentar os protocolos de troca de informações de operadoras com operadoras, e operadoras com prestadores, a ANS criou o protocolo Troca de Informação em Saúde Suplementar (TISS).
Os documentos das normas ANS TISS podem ser verificados no endereço eletrônico da ANS, em http://www.ans.gov.br, opção "TISS → Normas.".
O Foundation Saúde suporta as especificações da ANS em formato eletrônico, atendendo às normas TISS, onde as mensagens são transmitidas em XML cujo schema também é especificado pela ANS:
- Transações de serviços via WebServices com ou sem segurança (certificados);
- Transações com envio ou troca de mensagens XML através de arquivos (upload e download).
Além dos serviços normativos, o Foundation Saúde oferece:
- Armazenamento e validação de Biometria de usuários;
- Um facilitador acessado diretamente pelo navegador web para digitação de guias
...
Mensagens Contempladas
As transações, versões e respectivas mensagens WebService suportadas pelo Foundation Saúde, estão estruturadas conforme mostrado abaixo:
Transação | Versão | WebService |
Verificar Elegibilidade | 2.01.03 | TISSEligibilityV2_01_03WS |
2.02.01 | TISSEligibilityV2_02_01WS | |
2.02.02 | TISSEligibilityV2_02_02WS | |
2.02.03 | TISSEligibilityV2_02_03WS | |
3.02.00 | TISSVerificaElegibilidadeV3_02_00WS | |
Solicitação de Procedimentos | 2.01.03 | TISSProcedureSolicitationV2_01_03WS |
2.02.01 | TISSProcedureSolicitationV2_02_01WS | |
2.02.02 | TISSProcedureSolicitationV2_02_02WS | |
2.02.03 | TISSProcedureSolicitationV2_02_03WS | |
3.02.00 | TISSSolicitacaoProcedimentoV3_02_00WS | |
Solicitação Status de Autorização | 2.01.03 | TISSProcedureSolicitationAuthorizationStatusV2_01_03WS |
2.02.01 | TISSProcedureSolicitationAuthorizationStatusV2_02_01WS | |
2.02.02 | TISSProcedureSolicitationAuthorizationStatusV2_02_02WS | |
2.02.03 | TISSProcedureSolicitationAuthorizationStatusV2_02_03WS | |
3.02.00 | TISSSolicitacaoStatusAutorizacaoV3_02_00WS | |
Solicitação Status do Protocolo | 2.01.03 | TISSProcedureSolicitationStatusV2_01_03WS |
2.02.01 | TISSProcedureSolicitationStatusV2_02_01WS | |
2.02.02 | TISSProcedureSolicitationStatusV2_02_02WS | |
2.02.03 | TISSProcedureSolicitationStatusV2_02_03WS | |
3.02.00 | TISSSolicitacaoStatusProtocoloV3_02_00WS | |
Solicitação de Demonstrativos de Retorno e Pagamento | 2.01.03 | TISSProcedureSolicitationReturnDemoV2_01_03WS |
2.02.01 | TISSProcedureSolicitationReturnDemoV2_02_01WS | |
2.02.02 | TISSProcedureSolicitationReturnDemoV2_02_02WS | |
2.02.03 | TISSProcedureSolicitationReturnDemoV2_02_03WS | |
3.02.00 | TISSSolicitacaoDemonstrativoRetornoV3_02_00WS | |
Cancelamento de Guias | 2.01.03 | TISSProcedureSolicitationCancelV2_01_03WS |
2.02.01 | TISSProcedureSolicitationCancelV2_02_01WS | |
2.02.02 | TISSProcedureSolicitationCancelV2_02_02WS | |
2.02.03 | TISSProcedureSolicitationCancelV2_02_03WS | |
3.02.00 | TISSCancelaGuiaV3_02_00WS | |
Lote de Guias | 2.01.03 | TISSInvoiceGroupV2_01_03WS |
2.02.01 | TISSInvoiceGroupV2_02_01WS | |
2.02.02 | TISSInvoiceGroupV2_02_02WS | |
2.02.03 | TISSInvoiceGroupV2_02_03WS | |
3.02.00 | TISSLoteGuiasV3_02_00WS | |
Transmite Mensagem | 2.01.03 | TISSMessageSenderV2_01_03WS |
2.02.01 | TISSMessageSenderV2_02_01WS | |
2.02.02 | TISSMessageSenderV2_02_02WS | |
2.02.03 | TISSMessageSenderV2_02_03WS | |
Transmite Mensagem Zip | 2.02.02 | TISSBroadcastsMessageZIPV2_02_02WS |
2.02.03 | TISSBroadcastsMessageZIPV2_02_03WS | |
Recurso de Glosa | 3.02.00 | TISSRecursoGlosaV3_02_00WS |
Status do protocolo de recurso de glosa | 3.02.00 | TISSSolicitacaoStatusRecursoGlosaV3_02_00WS |
6.2 Configurações
6.2.1 Propriedades do Sistema
As propriedades do sistema são configuradas no arquivo ”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, acesse-o pelo caminho ”C:/totvs/jboss-4.2.3.GA/server/default/conf”.
Arquivo “tiss.ini”:
- Propriedade: tiss.versao.atual
- Valor padrão: 3.02.00
- Descrição: Versão atual da especificação TISS, última versão suportada
- Propriedade: tiss.schema
- Valor padrão: tiss.V3_02_00.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.
6.2.2 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.
- 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 atribuidos 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”.
6.2.3 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
- 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”
Segue abaixo as propriedades referentes ao processo de geração dos arquivos do SIB no UNICOO.
- Propriedade: datasul.query.inclusion
- Valor: select * from v_rem_remessa_benef rb where rb.tipotransacao = 1
- Descrição: Propriedade referente à busca de informação de inclusão do SIB.
- Propriedade: datasul.query.retification
- Valor: select * from v_rem_remessa_benef rb where rb.tipotransacao = 2
- Descrição: Propriedade referente à busca de informação de retificação do SIB.
- Propriedade: datasul.query.contract
- Valor: select * from v_rem_remessa_benef rb where rb.tipotransacao = 3
- Descrição: Propriedade referente à busca de informação de mudança contratual do SIB.
- Propriedade: datasul.query.cancelation
- Valor: select * from v_rem_remessa_benef rb where rb.tipotransacao = 4
- Descrição: Propriedade referente à busca de informação de cancelamento do SIB.
- Propriedade: datasul.query.reactivation
- Valor: select * from v_rem_remessa_benef rb where rb.tipotransacao = 5
- Descrição: Propriedade referente à busca de informação de reativação do SIB.
6.3 Envio de Mensagem por WebService
O envio de mensagens de serviço pode ser feito por meio de "Web Services" com certificado de segurança. Os Serviços disponíveis e a estrutura da mensagem são obtidos por meio do endereço: “http://<host-name>[:port]/jbossws/services”.
Todos os "Web Services" relativos aos serviços TISS, que utilizam certificado de segurança, estão sob o contexto “/htz-foundation-tiss”.
Exemplo de "URL" para listar os "WebServices":
- Nome do Servidor: localhost
- Porta: 80
Endereço: http://localhost/jbossws/services
A tabela abaixo exemplifica como ficam os caminhos para os "WebServices", que não utilizam certificação digital seguindo este exemplo:
A tabela abaixo exemplifica como ficam os caminhos para os "WebServices", que utilizam certificação digital seguindo este exemplo:
...
Transação
...
Versão
...
Caminho do WebService
...
...
Verificar Elegibilidade
...
2.01.03
...
https://localhost/htz-foundation-tiss/TISSEligibilityV2_01_03WS?wsdl
...
...
2.02.01
...
https://localhost/htz-foundation-tiss/TISSEligibilityV2_02_01WS?wsdl
...
...
2.02.02
...
https://localhost/htz-foundation-tiss/TISSEligibilityV2_02_02WS?wsdl
...
...
2.02.03
...
https://localhost/htz-foundation-tiss/TISSEligibilityV2_02_03WS?wsdl
...
...
3.02.00
...
https://localhost/htz-foundation-tiss/TISSVerificaElegibilidadeV3_02_00WS?wsdl
...
...
Solicitação de Procedimentos
...
2.01.03
...
https://localhost/htz-foundation-tiss/TISSProcedureSolicitationV2_01_03WS?wsdl
...
...
2.02.01
...
https://localhost/htz-foundation-tiss/TISSProcedureSolicitationV2_02_01WS?wsdl
...
...
2.02.02
...
https://localhost/htz-foundation-tiss/TISSProcedureSolicitationV2_02_02WS?wsdl
...
...
2.02.03
...
https://localhost/htz-foundation-tiss/TISSProcedureSolicitationV2_02_03WS?wsdl
...
...
3.02.00
...
https://localhost/htz-foundation-tiss/TISSSolicitacaoProcedimentoV3_02_00WS?wsdl
...
...
Solicitação Status de Autorização
...
2.01.03
...
https://localhost/htz-foundation-tiss/TISSProcedureSolicitationAuthorizationStatusV2_01_03WS?wsdl
...
...
2.02.01
...
https://localhost/htz-foundation-tiss/TISSProcedureSolicitationAuthorizationStatusV2_02_01WS?wsdl
...
...
2.02.02
...
https://localhost/htz-foundation-tiss/TISSProcedureSolicitationAuthorizationStatusV2_02_02WS?wsdl
...
...
2.02.03
...
https://localhost/htz-foundation-tiss/TISSProcedureSolicitationAuthorizationStatusV2_02_03WS?wsdl
...
...
3.02.00
...
https://localhost/htz-foundation-tiss/TISSSolicitacaoStatusAutorizacaoV3_02_00WS?wsdl
...
...
Solicitação Status do Protocolo
...
2.01.03
...
https://localhost/htz-foundation-tiss/TISSProcedureSolicitationStatusV2_01_03WS?wsdl
...
...
2.02.01
...
https://localhost/htz-foundation-tiss/TISSProcedureSolicitationStatusV2_02_01WS?wsdl
...
...
2.02.02
...
https://localhost/htz-foundation-tiss/TISSProcedureSolicitationStatusV2_02_02WS?wsdl
...
...
2.02.03
...
https://localhost/htz-foundation-tiss/TISSProcedureSolicitationStatusV2_02_03WS?wsdl
...
...
3.02.00
...
https://localhost/htz-foundation-tiss/TISSSolicitacaoStatusProtocoloV3_02_00WS?wsdl
...
...
Solicitação de Demonstrativos de Retorno e Pagamento
...
2.01.03
...
https://localhost/htz-foundation-tiss/TISSProcedureSolicitationReturnDemoV2_01_03WS?wsdl
...
...
2.02.01
...
https://localhost/htz-foundation-tiss/TISSProcedureSolicitationReturnDemoV2_02_01WS?wsdl
...
...
2.02.02
...
https://localhost/htz-foundation-tiss/TISSProcedureSolicitationReturnDemoV2_02_02WS?wsdl
...
...
2.02.03
...
https://localhost/htz-foundation-tiss/TISSProcedureSolicitationReturnDemoV2_02_03WS?wsdl
...
...
3.02.00
...
https://localhost/htz-foundation-tiss/TISSSolicitacaoDemonstrativoRetornoV3_02_00WS?wsdl
...
...
Cancelamento de Guias
...
2.01.03
...
https://localhost/htz-foundation-tiss/TISSProcedureSolicitationCancelV2_01_03WS?wsdl
...
...
2.02.01
...
https://localhost/htz-foundation-tiss/TISSProcedureSolicitationCancelV2_02_01WS?wsdl
...
...
2.02.02
...
https://localhost/htz-foundation-tiss/TISSProcedureSolicitationCancelV2_02_02WS?wsdl
...
...
2.02.03
...
https://localhost/htz-foundation-tiss/TISSProcedureSolicitationCancelV2_02_03WS?wsdl
...
...
- .
...
https://localhost/htz-foundation-tiss/TISSCancelaGuiaV3_02_00WS?wsdl
...
...
Lote de Guias
...
2.01.03
...
https://localhost/htz-foundation-tiss/TISSInvoiceGroupV2_01_03WS?wsdl
...
...
2.02.01
...
https://localhost/htz-foundation-tiss/TISSInvoiceGroupV2_02_01WS?wsdl
...
...
2.02.02
...
https://localhost/htz-foundation-tiss/TISSInvoiceGroupV2_02_02WS?wsdl
...
...
2.02.03
...
https://localhost/htz-foundation-tiss/TISSInvoiceGroupV2_02_03WS?wsdl
...
...
3.02.00
...
https://localhost/htz-foundation-tiss/TISSLoteGuiasV3_02_00WS?wsdl
...
...
Transmite Mensagem
...
2.01.03
...
https://localhost/htz-foundation-tiss/TISSMessageSenderV2_01_03WS?wsdl
...
...
2.02.01
...
https://localhost/htz-foundation-tiss/TISSMessageSenderV2_02_01WS?wsdl
...
...
2.02.02
...
https://localhost/htz-foundation-tiss/TISSMessageSenderV2_02_02WS?wsdl
...
...
2.02.03
...
https://localhost/htz-foundation-tiss/TISSMessageSenderV2_02_03WS?wsdl
...
...
Transmite Mensagem ZIP
...
2.02.02
...
https://localhost/htz-foundation-tiss/TISSBroadcastsMessageZIPV2_02_02WS?wsdl
...
...
2.02.03
...
https://localhost/htz-foundation-tiss/TISSBroadcastsMessageZIPV2_02_03WS?wsdl
...
...
...
Recurso de Glosa
...
3.02.00
...
https://localhost/htz-foundation-tiss/TISSRecursoGlosaV3_02_00WS?wsdl
...
Status do Protocolo de Recurso de Glosa
...
3.02.00
...
https://localhost/htz-foundation-tiss/TISSSolicitacaoStatusRecursoGlosaV3_02_00WS?wsdl
Configuração para suporte a versões antigas
#Informa que a versão 2.02.02 não será suportada. Este arquivo esta disponível no seguinte caminho:
C:\totvs\jboss-4.2.3.GA\server\default\deploy\properties-service.xml
com.totvs.saude.tiss.suportversion.2.02.02=false
#Informa que a versão 2.02.01 não será suportada. Este arquivo esta disponível no seguinte caminho:
C:\Totvs \server\default\deploy\properties-service.xml
com.totvs.saude.tiss.suportversion.2.02.01=false
Observação: Como padrão esta propriedade assume o valor = “true”, quando não configurada. Esta configuração não deixa de disponibilizar o "WebService" no servidor, quando configurado para não ser suportado, porém quando 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.
6.4 Referências
Os documentos das normas ANS TISS podem ser verificados no endereço eletrônico da ANS, em http://www.ans.gov.br, opção "TISS → Normas."
...