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 (enpoint) |
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 | |
3.02.01 | TISSVerificaElegibilidadeV3_02_01WS | |
3.02.02 | TISSVerificaElegibilidadeV3_02_02WS | |
3.03.00 | TISSVerificaElegibilidadeV_3_03_00WS | |
3.03.01 | TISSVerificaElegibilidadeV_3_03_01WS | |
3.03.02 | TISSVerificaElegibilidadeV_3_03_02WS | |
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 | |
3.02.01 | TISSSolicitacaoProcedimentoV3_02_01WS | |
3.02.02 | TISSSolicitacaoProcedimentoV3_02_02WS | |
3.03.00 | TISSSolicitacaoProcedimentoV_3_03_00WS | |
3.03.01 | TISSSolicitacaoProcedimentoV_3_03_01WS | |
3.03.02 | TISSSolicitacaoProcedimentoV_3_03_02WS | |
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 | |
3.02.01 | TISSSolicitacaoStatusAutorizacaoV3_02_01WS | |
3.02.02 | TISSSolicitacaoStatusAutorizacaoV3_02_02WS | |
3.03.00 | TISSSolicitacaoStatusAutorizacaoV_3_03_00WS | |
3.03.01 | TISSSolicitacaoStatusAutorizacaoV_3_03_01WS | |
3.03.02 | TISSSolicitacaoStatusAutorizacaoV_3_03_02WS | |
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 | |
3.02.01 | TISSSolicitacaoStatusProtocoloV3_02_01WS | |
3.02.02 | TISSSolicitacaoStatusProtocoloV3_02_02WS | |
3.03.00 | TISSSolicitacaoStatusProtocoloV_3_03_00WS | |
3.03.01 | TISSSolicitacaoStatusProtocoloV_3_03_01WS | |
3.03.02 | TISSSolicitacaoStatusProtocoloV_3_03_02WS | |
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 | |
3.02.01 | TISSSolicitacaoDemonstrativoRetornoV3_02_01WS | |
3.02.02 | TISSSolicitacaoDemonstrativoRetornoV3_02_02WS | |
3.03.00 | TISSSolicitacaoDemonstrativoRetornoV_3_03_00WS | |
3.03.01 | TISSSolicitacaoDemonstrativoRetornoV_3_03_01WS | |
3.03.02 | TISSSolicitacaoDemonstrativoRetornoV_3_03_02WS | |
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 | |
3.02.01 | TISSCancelaGuiaV3_02_01WS | |
3.02.02 | TISSCancelaGuiaV3_02_02WS | |
3.03.00 | TISSCancelaGuiaV_3_03_00WS | |
3.03.01 | TISSCancelaGuiaV_3_03_01WS | |
3.03.02 | TISSCancelaGuiaV_3_03_02WS | |
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 | |
3.02.01 | TISSLoteGuiasV3_02_01WS | |
3.02.02 | TISSLoteGuiasV3_02_02WS | |
3.03.00 | TISSLoteGuiasV_3_03_00WS | |
3.03.01 | TISSLoteGuiasV_3_03_01WS | |
3.03.02 | TISSLoteGuiasV_3_03_02WS | |
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 |
3.02.01 | TISSRecursoGlosaV3_02_01WS | |
3.02.02 | TISSRecursoGlosaV3_02_02WS | |
3.03.00 | TISSRecursoGlosaV_3_03_00WS | |
3.03.01 | TISSRecursoGlosaV_3_03_01WS | |
3.03.02 | TISSRecursoGlosaV_3_03_02WS | |
Status do protocolo de recurso de glosa | 3.02.00 | TISSSolicitacaoStatusRecursoGlosaV3_02_00WS |
3.02.01 | TISSSolicitacaoStatusRecursoGlosaV3_02_01WS | |
3.02.02 | TISSSolicitacaoStatusRecursoGlosaV3_02_02WS | |
3.03.00 | TISSSolicitacaoStatusRecursoGlosaV_3_03_00WS | |
3.03.01 | TISSSolicitacaoStatusRecursoGlosaV_3_03_01WS | |
3.03.02 | TISSSolicitacaoStatusRecursoGlosaV_3_03_02WS |
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”
- Propriedade: tiss.webservice.password.required
- Valor: Lista de valores separadas por ";"
- Descrição: Lista de transações TISS que exigem a autenticação do prestador através das tags de usuário e senha do protocolo TISS. Detalhes em: https://tdn.totvs.com/x/KAGaHg
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:
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.