Histórico da Página
...
- Para o funcionamento do sistema Foundation. É necessária a instalação do pacote do JDK(Java Development Kit) atualizado conforme o capítulo Instalação e Configuração do Java.
- Configure o banco de dados conforme as instruções na seção configuração do banco de dados.
- Para os clientes que utilizarem o sistema " Gestão de Planos", será necessário configurar o " AppServer", conforme a seção 5.4 Configuração seção configuração para Gestão de Planos.
- Se a versão do sistema escolhido utilizar certificado digital, as configurações nas seções 8.5 Certificado Digital e 8.6 Configuração de Segurança no Servidor de Aplicações serão obrigatórios. Estas configurações são válidas para os módulos PTU e TISS. Se for utilizado somente o módulo TISS sem certificado digital, faz-se necessário realizar as configurações conforme seção 8.6.2 Desabilitar Certificado PTU/TISS, por meio desta seção você estará desabilitando o uso do certificado digital no sistema.
- No diretório “C:\totvs\jboss-4.2.3.GA\server\default\conf”, possui o arquivo "tiss.ini", onde são realizadas algumas configurações referentes ao módulo TISS. Verifique a seção 6.2 Configurações para configurar o arquivo de acordo com as necessidades da operadora.
- Observação: Se o sistema "Foundation", for configurado com o sistema "UNICOO", será necessário copiar o arquivo "tiss.ini" para o diretório “C:\totvs\jboss-4.2.3.GA\bin”, contudo, na pasta "BIN" as propriedades "tiss.schema", "tiss.schema.anterior" e "tissnet.schema", devem ser preenchidas com o caminho completo onde se encontram os "schemas".
- Nas seções 8. PTU e 8.3 Demais Configurações PTU possuem as configurações obrigatórias de "WebService", para o uso do módulo "PTU".
- Na seção 10 Processo de Geração do SIB possui as configurações necessárias para configurar o módulo "SIB", no sistema "Foundation".
- Após a realização destes passos já podemos iniciar o servidor de aplicação conforme a seção 6. Inicialização e Acesso.
- A partir do 10º passo serão realizadas algumas configurações referente à parametrização no sistema "Foundation". Em alguns casos será necessário um pouco de conhecimento nas regras de negócios da operadora.
- Para realizar as configurações referentes à norma "IN 40", da TISS, verifique a seção 9.2 IN40 – Obrigatoriedade do CID.
- Se houver a necessidade de fazer upload de XML TISS via diretório, basta realizar as configurações conforme a seção 10. Upload via diretório.
- Faça as configurações mencionadas na seção 12.1 Configuração de Memória caso haja a necessidade de aumentar as configurações de memória utilizadas pelo "JBOSS".
...
Segurança de Acesso para o Banco de Dados
No arquivo “login-config.xml”, localizado na estrutura “C:/totvs/jboss-4.2.3.GA/server/default/conf”, a partir do diretório de instalação, verifique a tag “application-policy” para o nome do "Descritor da Fonte de Dados" (DataSource Descriptor) “FoundationAutorizadorDS”. Exemplo abaixo:
Observação: A DISTRO disponibilizada já esta com o arquivo configurado.
Âncora | ||||
---|---|---|---|---|
|
As seções a seguir são válidas apenas para usuários do sistema Totvs Gestão de Planos. Caso seu ERP, for o Unicoo, vá para o passo 6.
Criação do AppServer
Configuração de acesso ao AppServer
A configuração de acesso é por meio do arquivo “datasuldatasul_framework.properties”properties, que ficará localizado no diretório "C:\totvs\jboss-4.2.3.GA\server\default\conf".
O arquivo “datasuldatasul_framework.properties”properties, configura IP e porta onde está o serviço disponível no " AppServer", conforme descrito abaixo:
- Propriedade: progress progress.server.name
- Descrição: Nome ou IP do servidor AppServer Progress. Obrigatório.
- Propriedade: progress.server.port
- Descrição: porta IP do servidor AppServer Progress. Obrigatório.
- Propriedade: progress.server.application
- Descrição: nome do serviço AppServer Progress. Obrigatório.
- Propriedade: progress.server.maxconnections
- Descrição: numero Maximo de conexões com a AppServer Progress. É o mesmo numero de agentes configurados no AppServer. Obrigatório.
Abaixo um exemplo de configuração:
#+-------------------------------------------+
#| CONFIGURACOES APPServer |
#+-------------------------------------------+
progress.server.name=localhost
progress.server.port=5162
progress.server.application=HTZFoundation
progress.server.maxconnections=2
Para que o arquivo seja localizado pelo servidor de
aplicaçoesaplicação, deverá ser configurado no
arquivo: “arquivo C:\totvs\jboss-4.2.3.GA\bin\run.bat
” ou “ou C:\totvs\jboss-4.2.3.GA\bin\run.sh
”. Aa variável denominada
:"datasul.framework.properties
".
- Configuração para Windows:
- editar o arquivo jboss-4.2.3.GA\bin\run.bat
- set JAVA_OPTS=%JAVA_OPTS% -Ddatasul.framework.properties.dir=C:\totvs\jboss-4.2.3.GA\server\default\conf
- Configuração para Linux: editar o arquivo jboss-4.2.3.GA\bin\run.sh
- JAVA_OPTS=$JAVA_OPTS -Ddatasul.framework.properties.dir=C:\totvs\jboss-4.2.3.GA\server\progress\conf
5.5
Executar Scripts de Banco de Dados
Após finalizar a execução do instalador, será criada a pasta “Scripts” no diretório “C:\totvs\foundation-saude\”. Nessa pasta serão disponibilizados os scripts para criação e preenchimento das tabelas do banco de dados.
6. TISS
A Agência Nacional de Saúde Suplementar (ANS), está vinculado 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).
O "Foundation Saúde", foi criado para suportar as especificações da ANS em formato eletrônico, atendendo as normas TISS, as mensagens transmitidas obedecem a formato XML([3]) também especificado pela ANS:
- Transações de serviços via WebServices([4]) 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;
- E 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:
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:
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.
...