Foundation Saúde - Roteiro de Instalação e Configuração

Introdução

Pré-Requisitos

Hardware Servidor

• Processador 2.2GHZ ou superior;
• Memória mínima 2GB;
• Rede 100 Mbps ou superior.

Software Servidor

• A versão atual do deploy do Foundation Saúde requer a pré-instalação do “Java JDK 1.6 build 18”.

Observação: Para o funcionamento correto do PTU, a versão do JAVA deve ser a mesma mencionada acima. Para as demais, deve ser a mesma ou superior. Ainda não é suportada a versão 7 ou superior do Java.

• Banco de dados suportados: Oracle, Progress com suporte a SQL ou SQL Server 2005/2008.
• Acesso ao AppServer Progress para comunicação com Gestão de Planos Progress quando utilizado.
• Sistemas operacionais suportados: Windows XP ou superior e Linux.

Software Cliente

Navegadores Web homologados:

• • Microsoft Internet Explorer 7 ou 8
  • Mozilla Firefox 3.6, 4 ou 5
  • Adobe PDF Reader 8.0 ou superior
    

Passos para Instalação e Configuração do sistema Foundation

Baixe a versão mais recente do pacote de instalação no portal de clientes e descompacte em um diretório da máquina local. Segue abaixo o exemplo de como buscar os pacotes:

Entre na pasta Disk1 e execute o “setup.exe” e clique em "Avançar".

Informe o Nome do Usuário e Empresa e clique em "Avançar".

Selecione a Unidade de Disco em que será realizada a instalação. Será criada uma pasta TOTVS na unidade de destino. Clique em "Avançar".

Selecione o Sistema ERP utilizado e clique em "Avançar".

Somente para Gestão de Planos: Selecione o tipo de banco de dados que o Foundation Saúde irá utilizar. Este banco é independente do banco de dados utilizado pelo ERP. Clique em "Avançar".

Somente para Gestão de Planos: Informe o diretório onde o Gestão de Planos está instalado. Esta informação será utilizada para configurar o AppServer Progress utilizado pelo Foundation Saúde. Clique em "Avançar".

Informe os dados de acesso ao banco de dados. Esta informação será utilizada para configurar o acesso ao banco de dados do Foundation configurado na pasta deploy do Jboss. Clique em "Avançar".

Somente para Gestão de Planos: Informe o Nome da Maquina ou IP onde será criado o AppServer utilizado pelo Foundation Saúde para a comunicação com o Gestão de Planos. Clique em "Avançar".

Caso o banco de dados for Oracle, informe o nome da instância do banco de dados e clique em "Avançar".

Somente para Gestão de Planos: Confirmação para alterar arquivo de configuração do Progress para a criação do AppServer. Clique em "Avançar".

Aguarde a instalação finalizar e crie o serviço do Windows. Clique em "Concluir".

1. 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. 
2. Configure o banco de dados conforme as instruções na seção configuração do banco de dados.
3. Para os clientes que utilizarem o sistema Gestão de Planos, será necessário configurar o AppServer, conforme a seção configuração para Gestão de Planos.
4. 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. 
5. 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.
   1. 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".
6. 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".
7. 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".
8. Após a realização destes passos já podemos iniciar o servidor de aplicação conforme a seção 6. Inicialização e Acesso.
9. 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.
10. Para realizar as configurações referentes à norma "IN 40", da TISS, verifique a seção 9.2 IN40 – Obrigatoriedade do CID.
11. 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.
12. 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". 

Instalação e Configuração do Java

Conforme os pré-requisitos do sistema, a versão do Java a ser instalado deve ser o "JDK 1.6 build 18". Esta versão pode ser encontrada no site da Oracle® (http://java.sun.com/products/archive/j2se/6u18/index.html), ao acessar o link será exibida a tela abaixo, selecione a versão conforme o seu sistema operacional e faça o download.

Instalação do Java para Windows

Após ter finalizado o download, execute o "jdk-6u18-windows-i586.exe" (Windows® 32 bits), será inicializado o instalador.

Na próxima tela serão exibidas as opções de instalações do JAVA, altere apenas o diretório onde será instalado o JAVA conforme o exemplo abaixo. O recomendado é deixar o local de instalação em “C:\Java\jdk1.6.0_18”, pois o padrão oferecido pela instalação do JAVA contem espaços no endereço (“C:\Arquivos de programas”), onde pode provocar problemas no sistema.

Aguarde a finalização da barra de progresso:

Após a finalização da barra de progresso é exibida a tela abaixo indicando que a instalação chegou ao fim.

Clique em “Finish” para finalizar a instalação.

Para a configuração da variável de ambiente no Windows® ME/2000/XP, você deve fazer da seguinte maneira:

Instalação do Java para Linux

1. Acesse com o usuário "Root". 

2. Coloque na pasta "opt", o arquivo “jdk-6u18-linux-i586-rpm-bin” baixado.

3. De permissão de execução para o arquivo da seguinte maneira: #chmod 777 jdk-6u18-linux-i586-rpm.bin

4 .Execute o comando abaixo e os passos exibidos na instalação.

5 .Pressione a barra de espaço (teclado) e digite “yes” para concluir à instalação: #./jdk-6u18-linux-i586-rpm.bin

6. O java criará uma pasta no "/usr/java" e outra dentro "/opt/sun" para maiores detalhes: http://java.sun.com/javase/6/webnotes/install/jdk/install-linux.html

Não é necessário fazer as configurações do profile da ultima versão do Java, como outros softwares fazem referência às variáveis de ambiente do Linux®, configure:

1. Abra o arquivo "/etc/profile" com o editor de texto de sua preferência (faça isso com ROOT): # vi /etc/profile

2. Antes do "PATH" e "EXPORT" acrescente as seguintes linhas:

# Variaveis ambiente adicionadas para configuracao do J2SE 6.0_18
JAVA_HOME=/usr/java/jdk1.6.0_18
PATH=$PATH:$JAVA_HOME/bin
CLASSPATH=.:$JAVA_HOME/lib/tools.jar
MANPATH=$MANPATH:$JAVA_HOME/man
export PATH USER LOGNAME MAIL HOSTNAME HISTSIZE INPUTRC JAVA_HOME CLASSPATH MANPATH

3. Salve e clique para sair do arquivo, usuário e execute o comando abaixo para carregar as novas modificações:

# exit
$ source /etc/profile

Para conferir a instalação, abra um terminal e digite os comandos a seguir, deverá ser exibido a versão instalada do Java:

$ java -version

$ javac -version

Distro de Instalação Foundation Saúde

O arquivo de instalação possui a estrutura de uma DISTRO, uma estrutura completa do Servidor de Aplicações JBoss , deploy, e arquivos de configuração, e está compactado, para descompactar escolha o caminho base, ou drive para onde deve ser instalado o servidor.

Se for escolhido como base o drive “C:”, será criado um diretório base semelhante a “C:\Foundation_distro_oracle_standard_11.5_FULL”,  quando o pacote selecionado for Oracle® sem certificado digital por exemplo. Onde ficará toda estrutura do "Servidor de Aplicações JBOSS", juntamente com o "deploy" e os arquivos de configuração do "Foundation Saúde".

Estrutura criada no diretório:

DISTRO: Contém a distribuição do "JBOSS" pré-configurado que deverá ser copiada para o diretório “C:\totvs\jboss-4.2.3.GA”.

Scripts: Contém o arquivo com instruções DDL, para a criação da base de dados utilizada pelo "Foundation".

Release Notes_11_X_X.pdf: Contém informações sobre atualizações, correções e novas funcionalidades do sistema.

Roteiro de Instalação e Configuração - Foundation Saúde_vX.X.pdf: Este documento.

Banco de Dados

Neste capítulo são apresentadas todas as configurações referentes a banco de dados.  Nas seções a seguir são descritos os passos necessários para efetuar a criação do banco de dados do sistema para as versões Oracle® e Progress®.

Para criação da base de dados Oracle® será necessário o usuário e senha de DBA do banco para a criação do usuário do sistema.

Caso tenha duvidas quanto a esse usuário entre em contato com o DBA da empresa.

1. Acesse a maquina de banco de dados onde está instalado o Oracle® e digite no console (Windows®), ou Shell (Linux®), da máquina:

   sqlplus / AS SYSDBA  ‘htzfound%123’;

   Observação: Ao executar o comando acima será necessário da senha de DBA.

2. Crie o usuário do banco:

   CREATE USER htzfoundation IDENTIFIED BY "htzfound123";

3. Inclua as permissões necessárias para a criação das tabelas.

4. Insira os registros e execute o sistema "Foundation".

   GRANT CONNECT, RESOURCE TO htzfoundation;

5. Feche a sessão do DBA.

6. Execute o console, ou o Shell, da máquina e conecte com o novo usuário para a criação dos objetos do banco, conforme o comando abaixo.

   sqlplus htzfoundation/htzfound123@INSTANCIA

7. Após a conexão, execute o "script" do banco que se encontra na DISTRO de instalação.

Configuração do Banco de Dados

A configuração do Banco de Dados é realizada no "DataSource Descriptor", que se encontra no diretório “c:/totvs/jboss-4.2.3.GA/server/default/deploy”. O padrão de nome para esse arquivo é o nome do Tipo de Banco concatenado com “-ds.xml”. Para Oracle® o nome do descriptor é “oracle-ds.xml” ou “oracle-xa-ds.xml”. A Oracle mantém sua documentação para drivers no endereço: http://www.oracle.com/technology/documentation/index.html.

1. Configure o descriptor conforme a base em uso em seu sistema.
2. No diretório “docs\examples\jca”, há modelos para vários tipos de bancos.

3. O valor da tag “jndi-name”, deve ser mantida conforme Tabela 1 abaixo, no modelo Oracle:

   <?xml version="1.0" encoding="UTF-8"?> <!-- ===================================================================== --> <!-- --> <!-- JBoss Server Configuration --> <!-- --> <!-- ===================================================================== --> <!-- $Id: oracle-ds.xml 71535 2008-04-01 07:05:03Z [email protected] $ --> <!-- ==================================================================== --> <!-- Datasource config for Oracle originally from Steven Coy --> <!-- ===================================================================== --> <datasources> <local-tx-datasource> <jndi-name>FoundationAutorizadorDS</jndi-name> <connection-url>jdbc:oracle:oci8:@youroraclehost:1521:yoursid</connection-url> <driver-class>oracle.jdbc.driver.OracleDriver</driver-class> <user-name>htzfoundation</user-name> <password>htzfound%123</password> <exception-sorter-class-name>org.jboss.resource.adapter.jdbc.vendor.OracleExceptionSorter</exception-sorter-class-name> <!-- corresponding type-mapping in the standardjbosscmp-jdbc.xml (optional) --> <metadata> <type-mapping>Oracle9i</type-mapping> </metadata> </local-tx-datasource> </datasources>

    

   Observação: A DISTRO disponibilizada já esta com o arquivo pré-configurado, altere os dados da "URL", usuário e senha do banco de dados, se necessário. Na próxima página, segue o modelo Progress®:

   <?xml version="1.0" encoding="UTF-8"?> <!-- ===================================================================== --> <!-- --> <!-- JBoss Server Configuration --> <!-- --> <datasources> <local-tx-datasource> <jndi-name>FoundationAutorizadorDS</jndi-name> <connection-url>jdbc:datadirect:openedge://IP:PORTA;databaseName=emssaude;WorkArounds=536870912</connection-url> <driver-class>com.ddtek.jdbc.openedge.OpenEdgeDriver</driver-class> <user-name>htzfoundation</user-name> <password>htzfound%123</password> <metadata> <type-mapping>Progress</type-mapping> </metadata> </local-tx-datasource> </datasources>

   Observação: A DISTRO disponibilizada já esta com o arquivo pré-configurado, bastando alterar os dados da "URL", usuário e senha do banco de dados, se necessário.

   Nesse arquivo, para o sistema "UNICOO",  também é necessário a configuração da conexão com o "ERP", conforme exemplo abaixo:

   

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.

Configurações para Gestão de Planos

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

O AppServer é utilizado para fazer a comunicação entre o Foundation X Gestão de Planos. A seguir, os dados para sua criação.

Criação do novo AppServer (HTZFoundation):

Configurações do AppServer:

Para acessar as configurações clique com o botão direito do mouse no AppServer criado e clique em "Propriedades".

Na opção “Broker”, altere o diretório de trabalho, para o qual for utilizado, se necessário altere a porta de comunicação, lembrando que dois AppServers não funcionam na mesma porta

Na opção "Agente\Geral", podem ser alterada as configurações de parâmetros de inicialização do servidor, "Propath" e o caminho para geração do log.

Para clientes que utilizam banco de dados unificado, é necessário a criação do arquivo de "ALIAS" e a configuração no AppServer. Exemplo:

Exemplo de arquivo alias.p:

Configuração de acesso ao AppServer

A configuração de acesso é por meio do arquivo datasul_framework.properties, que ficará localizado no diretório C:\totvs\jboss-4.2.3.GA\server\default\conf.

O arquivo datasul_framework.properties, configura IP e porta onde está o serviço disponível no AppServer, conforme descrito abaixo:

• • Propriedade: 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ção, deverá ser configurado no arquivo C:\totvs\jboss-4.2.3.GA\bin\run.bat ou C:\totvs\jboss-4.2.3.GA\bin\run.sh a 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

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.

6.1 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:

Transação		Versão	Caminho do WebService
Verificar Elegibilidade		2.01.03	http://localhost/htzfoundation-HTZFoundationEJB/TISSEligibilityV2_01_03WS?wsdl
		2.02.01	http://localhost/htzfoundation-HTZFoundationEJB/TISSEligibilityV2_02_01WS?wsdl
		2.02.02	http://localhost/htzfoundation-HTZFoundationEJB/TISSEligibilityV2_02_02WS?wsdl
		2.02.03	http://localhost/htzfoundation- HTZFoundationEJB/TISSEligibilityV2_02_03WS?wsdl
		3.02.00	http://localhost/htzfoundation-HTZFoundationEJB/TISSVerificaElegibilidadeV3_02_00WS?wsdl
Solicitação de Procedimentos		2.01.03	http://localhost/htzfoundation-HTZFoundationEJB/TISSProcedureSolicitationV2_01_03WS?wsdl
		2.02.01	http://localhost/htzfoundation-HTZFoundationEJB/TISSProcedureSolicitationV2_02_01WS?wsdl
		2.02.02	http://localhost/htzfoundation-HTZFoundationEJB/TISSProcedureSolicitationV2_02_02WS?wsdl
		2.02.03	http://localhost/htzfoundation- HTZFoundationEJB/TISSProcedureSolicitationV2_02_03WS?wsdl
		3.02.00	http://localhost/htzfoundation-HTZFoundationEJB/TISSSolicitacaoProcedimentoV3_02_00WS?wsdl
Solicitação Status de Autorização		2.01.03	http://localhost/htzfoundation-HTZFoundationEJB/TISSProcedureSolicitationAuthorizationStatusV2_01_03WS?wsdl
		2.02.01	http://localhost/htzfoundation-HTZFoundationEJB/TISSProcedureSolicitationAuthorizationStatusV2_02_01WS?wsdl
		2.02.02	http://localhost/htzfoundation-HTZFoundationEJB/TISSProcedureSolicitationAuthorizationStatusV2_02_02WS?wsdl
		2.02.03	http://localhost/htzfoundation-HTZFoundationEJB/TISSProcedureSolicitationAuthorizationStatusV2_02_03WS?wsdl
		3.02.00	http://localhost/htzfoundation-HTZFoundationEJB/TISSSolicitacaoStatusAutorizacaoV3_02_00WS?wsdl
Solicitação Status do Protocolo		2.01.03	http://localhost/htzfoundation-HTZFoundationEJB/TISSProcedureSolicitationStatusV2_01_03WS?wsdl
		2.02.01	http://localhost/htzfoundation-HTZFoundationEJB/TISSProcedureSolicitationStatusV2_02_01WS?wsdl
		2.02.02	http://localhost/htzfoundation-HTZFoundationEJB/TISSProcedureSolicitationStatusV2_02_02WS?wsdl
		2.02.03	http://localhost/htzfoundation-HTZFoundationEJB/TISSProcedureSolicitationStatusV2_02_03WS?wsdl
		3.02.00	http://localhost/htzfoundation-HTZFoundationEJB/TISSSolicitacaoStatusProtocoloV3_02_00WS?wsdl
Solicitação de Demonstrativos de Retorno e Pagamento		2.01.03	http://localhost/htzfoundation-HTZFoundationEJB/TISSProcedureSolicitationReturnDemoV2_01_03WS?wsdl
		2.02.01	http://localhost/htzfoundation-HTZFoundationEJB/TISSProcedureSolicitationReturnDemoV2_02_01WS?wsdl
		2.02.02	http://localhost/htzfoundation-HTZFoundationEJB/TISSProcedureSolicitationReturnDemoV2_02_02WS?wsdl
		2.02.03	http://localhost/htzfoundation-HTZFoundationEJB/TISSProcedureSolicitationReturnDemoV2_02_03WS?wsdl
		3.02.00	http://localhost/htzfoundation-HTZFoundationEJB/TISSSolicitacaoDemonstrativoRetornoV3_02_00WS?wsdl
Cancelamento de Guias		2.01.03	http://localhost/htzfoundation-HTZFoundationEJB/TISSProcedureSolicitationCancelV2_01_03WS?wsdl
		2.02.01	http://localhost/htzfoundation-HTZFoundationEJB/TISSProcedureSolicitationCancelV2_02_01WS?wsdl
		2.02.02	http://localhost/htzfoundation-HTZFoundationEJB/TISSProcedureSolicitationCancelV2_02_02WS?wsdl
		2.02.03	http://localhost/htzfoundation-HTZFoundationEJB/TISSProcedureSolicitationCancelV2_02_03WS?wsdl
		3.02.00	http://localhost/htzfoundation-HTZFoundationEJB/TISSCancelaGuiaV3_02_00WS?wsdl
Lote de Guias		2.01.03	http://localhost/htzfoundation-HTZFoundationEJB/TISSInvoiceGroupV2_01_03WS?wsdl
		2.02.01	http://localhost/htzfoundation-HTZFoundationEJB/TISSInvoiceGroupV2_02_01WS?wsdl
		2.02.02	http://localhost/htzfoundation-HTZFoundationEJB/TISSInvoiceGroupV2_02_02WS?wsdl
		2.02.03	http://localhost/htzfoundation-HTZFoundationEJB/TISSInvoiceGroupV2_02_03WS?wsdl
		3.02.00	http://localhost/htzfoundation-HTZFoundationEJB/TISSLoteGuiasV3_02_00WS?wsdl
Transmite Mensagem		2.01.03	http://localhost/htzfoundation-HTZFoundationEJB/TISSMessageSenderV2_01_03WS?wsdl
		2.02.01	http://localhost/htzfoundation-HTZFoundationEJB/TISSMessageSenderV2_02_01WS?wsdl
		2.02.02	http://localhost/htzfoundation-HTZFoundationEJB/TISSMessageSenderV2_02_02WS?wsdl
		2.02.03	http://localhost/htzfoundation-HTZFoundationEJB/TISSMessageSenderV2_02_03WS?wsdl
Transmite Mensagem ZIP		2.02.02	http://localhost/htzfoundation-HTZFoundationEJB/TISSBroadcastsMessageZIPV2_02_02WS?wsdl
		2.02.03	http://localhost/htzfoundation-HTZFoundationEJB/TISSBroadcastsMessageZIPV2_02_03WS?wsdl
	Recurso de Glosa	3.02.00	http://localhost/htzfoundation-HTZFoundationEJB/TISSBroadcastsMessageZIPV3_02_00WS?wsdl
	Status do Protocolo de Recurso de Glosa	3.02.00	http://localhost/htzfoundation-HTZFoundationEJB/TISSBroadcastsMessageZIPV3_02_00WS?wsdl

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
		3.02.00	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."

7. PTU

O sistema "Foundation", esta em conformidade com o PTU versão 3.5 (Protocolo de Transações Unimed - PTU) e oferece suporte a comunicação por meio de WebServices(2) com segurança (certificado digital), exigidos pela Unimed do Brasil.

7.1 Mensagens Contempladas

7.2 Configuração do WebServices

Para a configuração dos "Web Services externos" (Web Services disponibilizados pela Unimed Brasil), é utilizado o arquivo “foundation-exchange.properties”. Neste arquivo, será configurando o "namespace" e a "URL" do "Web Service externo" (UNIMED Brasil), a ser chamado pelo sistema "Foundation PTU", para cada tipo de mensagem.

Este arquivo deve ser distribuído obrigatoriamente no diretório:

C:/totvs/jboss-4.2.3.GA/server/default/conf

O formato para configuração do "namespace", exemplo:

com.totvs.foundation.exchange.connector.ptu.implementation.v01.DefaultExternalConnector.RespostaAuditoria.namespace.URI = http://ptu.unimed.com.br/respostaauditoria/webservices/V3_01_35.

O formato para configuração da "URL" do "Web Service Externo", exemplo:

com.totvs.foundation.exchange.connector.ptu.implementation.v01.DefaultExternalConnector.OrdemServico.WSDL = https://wsd.homologacao.unimed.com.br/wsdintercambio/intercambioservices/ptu_v3_01_35/RespostaAuditoria?wsdl 

Em ambos os casos, a alteração é exclusiva a coluna da direita, sendo que a coluna a esquerda permanece inalterada.

7.3 Demais Configuração PTU

O arquivo “foundation-exchange.properties”, também disponibiliza as seguintes configurações: 

• • • Propriedade: providerCode
    • Descrição: Código da Unimed onde o Foundation se encontra instalado. Ex: 0032 

As demais configurações não devem ser alteradas.

7.4 Envio de Mensagem por WebService

O envio de mensagens de serviço é 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 intermédio do endereço: “http://<host-name>[:port]/jbossws/services”. 
Todos "Web Services" relativos aos serviços "PTU", estão sob o contexto “htz-foundation”.

Exemplo: 

• • • Nome do Servidor: server01
    • Porta: 28080 

Endereço: “http://localhost/jbossws/services” 

• • A tabela abaixo exemplifica como ficam os caminhos para os "WebServices" seguindo este exemplo:

Observação: A Unimed Brasil somente realiza comunicação com "WebServices", publicados na porta 80 e 443 com certificado digital.

7.5 Certificado Digital

A seguir são apresentados os passos para criação e distribuição do Certificado Digital de segurança para os "WebServices". Será usada a ferramenta "Keytool", distribuída junto com a instalação "Java JDK".

Observação: A criação do certificado digital deve ser feita apenas para o uso dos módulos "TISS". Para o uso do módulo "PTU", o certificado deve ser solicitado a Unimed do Brasil.

7.5.1 Criação do Contenedor de Certificados (Keystore)

Utilizando o "Keytool", digite a seguinte linha de comando (cmd):

keytool -genkeypair -alias keystore -dname "<distinguished-name>" -keypass 
medical -keystore c:/totvs/jboss4.2.3.GA/server/default/conf/server.keystore -storepass medical -validity 365

Os valores grifados devem ser substituidos:

• • • • distinguished-name: De preferência em conformidade com a estrutura suportada pelo Keytool^([1]). Para operadoras deve-se usar o nome da máquina hospedeira (host) no campo CN (Common Name), é o mesmo host utilizado na configuração do parâmetro “-b” para a publicação do sistema para acessos externos conforme o capítulo 5.1.

Segue abaixo um exemplo: 
CN = foundation.dominio_operadora.com.br 
OU = Totvs Saúde 
O = Totvs 
L = Joinville 
S = SC 
C = BR 

Estes atributos formam a seguinte "string" para preenchimento do valor: “CN=foundation.dominio_operadora.com.br, OU=Totvs Saude,O=Totvs, L=Joinville, ST=SC, C=BR”. 
Nota: Lembre-se de usar aspas na linha de comando para strings com espaços.

• • • • -keypass: Senha para a chave do certificado digital. O valor padrão é medical.
      • -keystore: Caminho ou diretório onde serão criados o certificado, o arquivo contenedor de certificados, e o arquivo contenedor dos certicados válidos de clientes. O valor padrão é “c:\totvs\jboss-4.2.3.GA”.
      • -storepass: Senha para o arquivo contenedor de certificados. O valor padrão é medical.
      • -validity: Número de dias antes que o certificado se expire. O valor padrão é 365(1 ano);

Atenção: Verifique se o arquivo “server.keystore” foi criado no diretório escolhido (-keystore).

Exemplo de criação do keystore server e client:

>keytool -genkeypair -alias keystore -dname "CN=LOCALHOST, OU=Totvs Saude,O=Totvs, L=Joinville, ST=SC, C=BR" -keypass medical -keystore "client.keystore" -storepass medical -validity 365

>keytool -genkeypair -alias keystore -dname "CN=LOCALHOST, OU=Totvs Saude,O=Totvs, L=Joinville, ST=SC, C=BR" -keypass medical -keystore "server.keystore" -storepass medical -validity 365

7.5.2 Criação do Certificado

Para extrair o certificado do contenedor digite a seguinte linha de comando (cmd) :

keytool -exportcert -alias keystore -file c:/totvs/jboss-4.2.3.GA/server/default/conf/certificate.cer 
-keystore c:/totvs/jboss-4.2.3.GA/server/default/conf/keystore.keystore -storepass medical

Segue abaixo detalhes de cada propriedade:

• • • • -alias: Crie um alias para seu arquivo de chaves, esse nome será usado internamente. Valor padrão é “keystore”.
      • -file: Caminho ou diretório onde serão criados o certificado, o arquivo contenedor de certificados, e o arquivo contenedor dos certicados válidos de clientes. O valor padrão é “c:/totvs/jboss-4.2.3.GA/server/default/conf/”.
      • -storepass: Senha para o arquivo contenedor de certificados. O valor padrão é “medical”.

Atenção: Verifique se o arquivo “certificate.cer” foi criado no diretório escolhido (-file).

Exemplo de criação dos certificados:

>keytool -exportcert -alias keystore -file "c:/totvs/jboss-4.2.3.GA/server/default/conf/client.cer" -keystore "client.keystore" -storepass medical

>keytool -exportcert -alias keystore -file " c:/totvs/jboss-4.2.3.GA/server/default/conf /server.cer" -keystore "server.keystore" -storepass medical

7.5.3 Importação dos Certificados

Cada cliente autorizado a receber ou enviar mensagens "Web Service" deve fornecer seu arquivo de certificado pra ser adicionado à lista de clientes confiáveis.

Também o cliente precisa receber o certificado do provedor(host) dos serviços "Web Service" para adicioná-lo a sua lista de confiabilidade.

Tendo recebido o arquivo do cliente, executar a seguinte linha de comando (cmd): 
keytool -importcert -alias client_truststore -file “<certificado-cliente > -keypass “<senha-cliente>” -keystore “c:/totvs/jboss-4.2.3.GA/server/default/conf/truststore.truststore” 
-storepass medical -noprompt -trustcacerts

Os valores grifados devem ser substituídos, e para palavras-chave iguais devem ser os mesmos usados anteriormente (§ 3.5.1, § 3.5.2):

• • • • -alias: Crie um alias para seu arquivo de armazenamento de certificados de clientes válidos, esse nome será usado internamente. O valor padrão é “client_truststore”.
      • client-certificate: Caminho completo onde se encontra o arquivo certificado do cliente, este certificado será adicionado à lista de confiáveis;
      • senha-cliente: Senha do arquivo de certificado do cliente.
      • -keystore: Caminho ou diretório onde serão criados o certificado, o arquivo contenedor de certificados, e o arquivo contenedor dos certicados válidos de clientes. Valor padrão é “c:/totvs/jboss-4.2.3.GA/server/default/conf”.
      • -storepass: Senha para o arquivo contenedor dos certificados válidos de clientes. Valor padrão é “medical”.

Atenção: Verifique se o arquivo ”truststore.truststore” foi criado no diretório escolhido (-storepass).

Exemplo de importação dos certificados

Importando certificado do cliente no servidor

keytool -importcert -alias clientlocal -file "client.cer" -keypass medical -keystore "server.truststore" -storepass medical -noprompt –trustcacerts

Importando certificado do servidor no cliente

keytool -importcert -alias server -file "server.cer" -keypass medical -keystore "client.truststore" -storepass medical -noprompt –trustcacerts

O proximo passo é copiar os arquivos “server.keystore” e “server.truststore”, para o diretório ”C:/totvs/jboss-4.2.3.GA/server/default/conf”.

7.6 Configuração de Segurança no Servidor de Aplicações

A seguir são mostrados os passos para habilitar, ou desabilitar, o uso do certificado digital. Por padrão algumas configurações estão comentadas para os clientes que utilizarem somente os módulos "TISS" e "SIB" sem o certificado digital. Caso o cliente utilize os módulos "SIB" e "TISS" sem certificado, será necessário fazer as configurações da seção 8.6.2.

7.6.1 Habilitar Certificado Digital - PTU/Tiss/SIB

Na estrutura ”C:/totvs/jboss-4.2.3.GA/server/default/conf”, a partir do diretório de instalação do "JBOSS", é preciso verificar a configuração de dois arquivos: 

Observação: Para configurar o certificado para o módulo do "PTU", deve copiar os arquivos  enviados pela Unimed do Brasil para o diretório “c:\totvs\jboss-4.2.3.GA\server\default\conf”. O nome do arquivo que vai ser configurado é igual ao domínio que é informado no parâmetro “-b”, no arquivo de inicialização do "JBOOS", conforme a seção 6 - Inicialização e Acesso.Ex.: foundation.dominio_operadora.com.br.javaks

• • Arquivo “jboss-service.xml”: incluir ou atualizar a tag “mbean” de segurança, conforme mostrado abaixo. Para o módulo "PTU", o valor “keystore.keystore” e o valor “truststore. truststore”, na linha em negrito abaixo, deve ser substituída pelo arquivo “.javaks” enviado pela Unimed do Brasil e as senhas “medical” dos atributos “KeyStorePass” e “TrustStorePass” pela senha fornecida pela Unimed do Brasil.
    
    

Observação: Para a DISTRO com certificado, este arquivo já se encontra configurado.

• Arquivo “login-config.xml”: incluir ou atualizar a tag “application-police”, conforme mostrado abaixo:
  

  <!-- ... -->   <application-policy name="JBossWS-Secure">   <authentication>     <login-module code="org.jboss.security.auth.spi.BaseCertLoginModule"         flag="required">       <module-option name="password-stacking">useFirstPass</module-option>       <module-option name="securityDomain">java:/jaas/JBossWS-SSL</module-option>       <module-option name="verifier">           org.jboss.security.auth.certs.AnyCertVerifier       </module-option>     </login-module>   </authentication> </application-policy> <!-- ... -->

  Observação: Para a DISTRO com certificado, este arquivo já se encontra configurado na estrutura “C:/totvs/jboss-4.2.3.GA/server/default/deploy”, verificar, incluir, ou atualizar o arquivo “properties-service.xml”, conforme mostrado abaixo:

  <server> <!-- ... -->   <mbean code="org.jboss.varia.property.SystemPropertiesService"       name="jboss:type=Service,name=SystemProperties">     <!-- ... -->     <attribute name="Properties">         javax.net.ssl.keyStore=<caminho-keystore>(*)         javax.net.ssl.keyStorePassword=<senha-keystore>(**)         javax.net.ssl.trustStore=<caminho-truststore>(***)         javax.net.ssl.trustStorePassword=<senha-truststore>(****)     </attribute>     <!-- ... -->   </mbean>   <!-- ... --> </server>

  (*) – Informe o caminho onde está o seu arquivo "keystore", que foi criado em “§ 3.7.1. Criação do contenedor de certificados(keystore)”. Caso o arquivo esteja configurado para o módulo do "PTU", este valor deve apontar para o arquivo “.javaks”, enviado pela Unimed do Brasil.

  (**) – Informe a senha do seu "keystore". Caso o arquivo esteja configurado para o módulo do "PTU", este valor deve ser preenchido com a senha fornecida pela Unimed do Brasil.

  (***) – Informar o caminho onde está seu arquivo "truststore", que foi criado em “§ 3.5.3. Importação de Certificados”. Caso o arquivo esteja configurado para o módulo do "PTU", este valor deve apontar para o arquivo “.javaks”, enviado pela Unimed do Brasil.

  (****) – Informar a senha do seu arquivo "truststore", que foi criado em “§ 3.5.3. Importação de Certificados”. Caso o arquivo esteja configurado para o módulo do "PTU", este valor deve ser preenchido com a senha fornecida pela Unimed do Brasil.

  Obs: Para a DISTRO com certificado, este arquivo já se encontra configurado.

  Na estrutura “C:/totvs/jboss-4.2.3.GA/server/default/deploy/jboss-web-deployer”, a partir do diretório de instalação, verificar, incluir, ou atualizar o arquivo “server.xml”, para o serviço “jboss.web”, conforme mostrado abaixo:

  <Server>   <!-- ... -->   <Service name="jboss.web">     <!-- ... -->     <Connector port="443" protocol="HTTP/1.1" SSLEnabled="true"         maxThreads="150" scheme="https" secure="true"         keystoreFile="C:/totvs/jboss-4.2.3.GA/server/conf/keystore.keystore"             keystorePass="medical"         clientAuth="want" sslProtocol="TLS"         truststoreFile="C:/totvs/jboss-4.2.3.GA/server/conf/truststore.truststore"             truststorePass="medical"/>     <!-- ... -->   </Service>   <!-- ... --> </Server>

  Segue abaixo mais detalhes referente a configuração acima:

   

  • port=”...”: Número da porta para comunicação segura. Valor padrão é 443.
  • keystoreFile=”...”: Caminho ou diretório onde está o certificado, o arquivo contenedor de certificados, e o arquivo contenedor dos certificados válidos de clientes. Diretório padrão de certificado é o “C:/totvs/jboss-4.2.3.GA/server/conf”. Caso o arquivo esteja  configurado para o módulo do "PTU", deve apontar para o arquivo “.javaks”, fornecido pela Unimed do Brasil.
  • keystorePass=”...”: Senha para o arquivo contenedor de certificados. Caso o arquivo esteja configurado para o módulo do "PTU", este valor deve ser preenchido com a senha fornecida pela Unimed do Brasil.
  • senha-truststore=”...”: Senha para o arquivo contenedor dos certificados válidos de clientes. Caso o arquivo esteja configurado para o módulo do "PTU", este valor deverá ser preenchido com a senha fornecida pela Unimed do Brasil.

  Observação: Para a DISTRO com certificado, este arquivo já se encontra configurado.

   

  Nota: A necessidade de configurar portas ocorre principalmente quando há duas instâncias ativas do "JBOSS". Outras situações referentes à infra-estrutura local podem ocasionar essa necessidade e devem ser verificadas com o técnico responsável.
  
  
  

  7.6.2 Desabilitar Certificado Digital - SIB/Tiss

  Na estrutura ”/server/default/conf”, a partir do diretório de instalação do "JBOSS AS," é preciso verificar a configuração de alguns arquivos:

• Arquivo “jboss-service.xml”: comentar a tag “mbean” de segurança, conforme mostrado abaixo:

  <!-- ... --> <!-- <mbean code="org.jboss.security.plugins.JaasSecurityDomain"     name="jboss.web:service=SecurityDomain">   <constructor>     <arg type="java.lang.String" value="JBossWS-SSL"/>   </constructor>   <attribute name="KeyStoreURL"> ${jboss.server.home.dir}/conf/keystore.keystore   </attribute>   <attribute name="KeyStorePass"><senha-keystore></attribute>   <attribute name="TrustStoreURL"> ${jboss.server.home.dir}/conf/truststore.truststore   </attribute>   <attribute name="TrustStorePass"><senha-truststore></attribute>   <depends>jboss.security:service=JaasSecurityManager</depends> </mbean> --> <!-- ... -->

   

  • Arquivo “login-config.xml”: comentar a tag “application-police”, conforme mostrado abaixo:

  <!-- ... --> <!-- <application-policy name="JBossWS-Secure">   <authentication>     <login-module code="org.jboss.security.auth.spi.BaseCertLoginModule"         flag="required">       <module-option name="password-stacking">useFirstPass</module-option>       <module-option name="securityDomain">java:/jaas/JBossWS-SSL</module-option>       <module-option name="verifier">           org.jboss.security.auth.certs.AnyCertVerifier       </module-option>               </login-module>   </authentication> </application-policy> --> <!-- ... -->

Na estrutura “/server/default/deploy”, a partir do diretório de instalação, verificar, comentar o arquivo “properties-service.xml”, conforme mostrado abaixo:

Na estrutura “server/default/deploy/jboss-web-deployer”, a partir do diretório de instalação, verificar, comentar o arquivo “server.xml” para o serviço “jboss.web”, conforme mostrado abaixo:

Na estrutura “/server/default/deploy/jbossws.sar/jbossws.beans/META-INF”, a partir do diretório de instalação, verificar, comentar o arquivo “jboss-beans.xml”, referente a seguranças de portas, conforme mostrado abaixo:

8. 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 no produto.

8.1 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. 

Em caso de verificação de guias repetidas no lote, será gerada uma glosa com o código igual a “1308 – Guia já apresentada”, impedindo que o lote seja encaminhado para o sistema de "Gestão de Planos". Para realizar um novo envio, o prestador deve realizar a correção do lote, eliminando a duplicidade das guias e submeter ao "Foundation Saúde" novamente.

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.

8.2 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 (Troca de Informações em Saúde Suplementar), decorrente de liminar deferida em Ação Civil Pública promovida pelo Conselho Regional de Medicina do Estado do Rio de Janeiro.

Parágrafo Único: Fica vedada a exigência por parte das operadoras de planos privados de assistência à saúde, em quaisquer circunstâncias, o preenchimento dos seguintes campos:

I – Na guia de consulta:

a) 28-CID 10 Principal;

b) 29-CID 10 (2);

c) 30-CID 10 (3); e

d) 31-CID 10 (4).

II – Na guia de SP/SADT:

a) 23-CID 10 Principal.

III – Na guia de solicitação de internação:

a) 30-CID 10 Principal;

b) 31-CID 10 (2);

c) 32-CID 10 (3); e

d) 33-CID 10 (4).

IV – Na guia de resumo de internação:

a) 37-CID 10 Principal;

b) 38-CID 10 (2);

c) 39-CID 10 (3); e

d) 40-CID 10 (4).

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: C:\Totvs\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.

9. TISS – Upload por diretório

Nesta versão, o "Foundation", passa a dar suporte a upload de arquivos TISS por diretório, onde o sistema fará o monitoramento do diretório de entrada conforme veremos abaixo.

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: C:\Totvs\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: C:\Totvs\server\default\tiss-console-log.

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

9.1 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. 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”.

 A partir deste momento o sistema irá monitorar o diretório de entrada configurado para interromper o processo, basta acionar a opção “Stop”, para verificar o status do monitoramento acione a opção “Status”.

10. SIB (Sistema de Informações de Beneficiários)

O "Foundation", passa a dar suporte na geração e retorno dos arquivos XML referentes ao "SIB", de acordo com as regras da ANS e integrado aos sistemas "Gestão de Planos" e/ou "UNICOO". Para tal processo, se faz necessário a configuração de algumas propriedades, ambas encontram-se no diretório do servidor de aplicação (JBOSS), no qual o "Foundation" faz uso, sendo ele, “c:/totvs/jboss-4.2.3.GA/server/deploy”. Nesse diretório, encontra-se o arquivo "properties-service.xml", no qual devem ser adicionadas as seguintes propriedades:

1. 1. sib.connector;
   2. sib.generated.dir;
   3. sib.ans.cnpj;
   4. sib.ans;
   5. sib.upload.return.dir.

A propriedade “sib.connector”, aceita somente dois valores, sendo eles, GPS ou UNICOO, no qual indica a qual sistema o "Foundation" deve executar a comunicação. Para a geração do "SIB", esse valor é de preenchimento obrigatório.

A propriedade “sib.generated.dir”, indica em qual diretório os arquivos XML serão gerados após o processo concluído.

A propriedade “sib.ans.cnpj”, deve ser preenchido com o CNPJ da ANS.

A propriedade “sib.ans”, deve ser preenchida com o registro ANS da operadora.

A propriedade “sib.upload.return.dir”, indica o diretório para "UPLOAD" dos arquivos de retorno. 

Segue abaixo o exemplo de um arquivo configurado com as propriedades acima:

Observação: Podem existir outras propriedades, dependendo da utilização do sistema.

11. RPS (Registro de Plano de Saúde)

O "Foundation" passa a dar suporte na geração dos arquivos de Inclusão, Alteração, Exclusão e Vinculação referentes à "Rede Assistencial da Operadora", para o Sistema "RPS" (Sistema de Registro de Plano de Saúde) da ANS. Para tal processo, se faz necessário a configuração de algumas propriedades, ambas encontram-se no diretório do servidor de aplicação (JBOSS ), no qual o "Foundation" faz uso, sendo ele, “JBOSS_HOME/server/default/deploy”. Nesse diretório, encontra-se o arquivo "properties-service.xml", no qual devem ser adicionadas as seguintes propriedades:

• • Propriedade: rps.generated.dir
  • Valor padrão: Ex: C:/RPS
  • Descrição: Endereço do diretório onde serão gerados os arquivos XML do RPS.

• • Propriedade: rps.connector.base
  • Valor padrão: Valores aceitos: “ORACLE” e “PROGRESS”
  • Descrição: Indica o SGBD utilizado.

• • Propriedade: rps.query.unicoo.prestador
  • Valor padrão: Select p.nopessoa RAZAOSOCIAL, p.nrcgc_cpf CNPJCPF, pr.nrcnes CNES,  pr.cdestado_crm UF,  c.cdcidade_ibge CODIGOMUNICIPIOIBGE,  pr.dtinicio_contratualizacao DATACONTRATUALIZACAO,  pr.dtadmissao DATAINICIOPRESTACAOSERVICO,  pr.tpcontratualizacao TIPOCONTRATUALIZACAO,  pr.tpclassif_estabelec CLASSIFICACAO,  pr.tpdisponibilidade DISPONIBILIDADESERVICO,  pr.aourgencia_emergencia URGENCIAEMERGENCIA,  pr.cdprestador CDPRESTADOR,  decode(tp.tpvinculo, '1', 'P', '2', 'P', '3', 'C') RELACAOOPERADORA  From prestador                 pr,  pessoa                    p,  prestador_estabelecimento pre,  endereco                  e,  cidade                    c,  tipo_de_prestador         tp  Where pr.nrregistro_prest = p.nrregistro  And pr.nrregistro_prest = pre.nrregistro_prest(+)  And pr.nrcnes = pre.nrcnes(+)  And e.nrregistro(+) = pre.nrregistro_prest  And e.tpendereco(+) = pre.cdtipo_endereco  And c.cdcidade(+) = e.cdcidade  And pr.tpprestador = tp.tpprestador(+) [FILTRO]
  • Descrição: Sentença sql para consulta dos prestadores caso o erp utilizado seja UNICOO.

• • Propriedade: rps.query.unicoo.plano
  • Valor padrão: select NOPLANO, CDPLANO, CDREGISTROANS, NOMODALIDADE, AONOVA_LEGISLACAO from (select c.nocontrato NOPLANO, c.cdcontrato CDPLANO, tpc.cdproduto_min_saude CDREGISTROANS, '' NOMODALIDADE, c.aonova_legislacao from contrato_padrao c, tipo_plano_contrato tpc where c.aonova_legislacao = 'S' and tpc.cdcontrato = c.cdcontrato group by c.nocontrato, c.cdcontrato, tpc.cdproduto_min_saude, c.aonova_legislacao union all select c.nocontrato NOPLANO, c.cdcontrato CDPLANO, nvl(p.cdplano_ans, c.cdproduto_min_saude) CDREGISTROANS, '' NOMODALIDADE, c.aonova_legislacao from contrato_plano p, contrato_padrao c where p.cdcontrato = c.cdcontrato and c.aonova_legislacao = 'N' group by c.nocontrato, c.cdcontrato, nvl(p.cdplano_ans, c.cdproduto_min_saude), c.aonova_legislacao) [FILTRO]
  • Descrição: Sentença sql para consulta dos planos de saúde caso o erp utilizado seja UNICOO.

• • Propriedade: rps.query.gps.oracle.prestador
  • Valor padrão: select preserv.nr_cgc_cpf CNPJCPF, substr(preserv.in_class_estabelec,1,1) CLASSIFICACAO, preserv.cd_cnes CNES, preserv.en_uf UF, dzcidade.int_3 CODIGOMUNICIPIOIBGE, preserv.nm_prestador RAZAOSOCIAL, case ptuvinpr.cd_tipo_vinculo_ptu when 1 then 'P' when 2 then 'P' else 'C' end RELACAOOPERADORA, previesp.in_contratualizacao TIPOCONTRATUALIZACAO, preserv.dt_ini_contrato DATACONTRATUALIZACAO, preserv.dt_inclusao DATAINICIOPRESTACAOSERVICO, preserv.int_9 DISPONIBILIDADESERVICO, preserv.cd_prestador CDPRESTADOR, '' URGENCIAEMERGENCIA from unimed, paramecp, preserv, dzcidade, previesp, ptuvinpr where unimed.cd_unimed = paramecp.cd_unimed and unimed.cd_unimed = preserv.cd_unidade and preserv.cd_cidade = dzcidade.cd_cidade and previesp.cd_unidade = preserv.cd_unidade  and previesp.cd_prestador = preserv.cd_prestador and previesp.cd_vinculo = ptuvinpr.cd_tipo_vinculo_serious and previesp.lg_principal = 1 [FILTRO] group by preserv.nr_cgc_cpf, substr(preserv.in_class_estabelec,1,1), preserv.cd_cnes, preserv.en_uf, dzcidade.int_3, preserv.nm_prestador, case ptuvinpr.cd_tipo_vinculo_ptu when 1 then 'P' when 2 then 'P' else 'C' end, previesp.in_contratualizacao, preserv.dt_ini_contrato, preserv.dt_inclusao, preserv.int_9, preserv.cd_prestador
  • Descrição: Sentença sql para consulta dos prestadores caso o erp utilizado seja GPS e o SGBD utilizado seja ORACLE.

• • Propriedade: rps.query.gps.progress.prestador
  • Valor padrão: select preserv."nr-cgc-cpf" CNPJCPF, substr(preserv."in-class-estabelec", 1, 1) CLASSIFICACAO, preserv."cd-cnes" CNES, preserv."en-uf" UF, dzcidade."int-3" CODIGOMUNICIPIOIBGE, preserv."nm-prestador" RAZAOSOCIAL, case ptuvinpr."cd-tipo-vinculo-ptu" when 1 then 'P' when 2 then 'P' else 'C' end RELACAOOPERADORA, previesp."in-contratualizacao" TIPOCONTRATUALIZACAO, preserv."dt-ini-contrato" DATACONTRATUALIZACAO, preserv."dt-inclusao" DATAINICIOPRESTACAOSERVICO, preserv."int-9" DISPONIBILIDADESERVICO, preserv."cd-prestador" CDPRESTADOR, '' URGENCIAEMERGENCIA from PUB."unimed", PUB."paramecp", PUB."preserv", PUB."dzcidade", PUB."previesp", PUB."ptuvinpr" where unimed."cd-unimed" = paramecp."cd-unimed" and unimed."cd-unimed" = preserv."cd-unidade" and preserv."cd-cidade" = dzcidade."cd-cidade" and previesp."cd-unidade" = preserv."cd-unidade" and previesp."cd-prestador" = preserv."cd-prestador" and previesp."cd-vinculo" = ptuvinpr."cd-tipo-vinculo-serious" and previesp."lg-principal" = 1 [FILTRO] group by preserv."nr-cgc-cpf", substr(preserv."in-class-estabelec", 1, 1), preserv."cd-cnes", preserv."en-uf", dzcidade."int-3", preserv."nm-prestador", case ptuvinpr."cd-tipo-vinculo-ptu" when 1 then 'P' when 2 then 'P' else 'C' end, previesp."in-contratualizacao", preserv."dt-ini-contrato", preserv."dt-inclusao", preserv."int-9", preserv."cd-prestador"
  • Descrição: Sentença sql para consulta dos prestadores caso o erp utilizado seja GPS e o SGBD utilizado seja PROGRESS.

• • Propriedade: rps.query.gps.oracle.plano
  • Valor padrão: Select P.NM_PLANO NOPLANO, M.DS_MODALIDADE NOMODALIDADE, p.CD_PLANO CDPLANO, T.CD_REGISTRO_PLANO CDREGISTROANS From TI_PL_SA T, PLA_SAU P, MODALID M Where T.CD_MODALIDADE = P.CD_MODALIDADE And T.CD_PLANO = P.CD_PLANO And M.cd_modalidade = p.cd_modalidade And t.cd_registro_plano Is Not Null [FILTRO] Group By P.NM_PLANO, M.DS_MODALIDADE, p.CD_PLANO, T.CD_REGISTRO_PLANO Order By NM_PLANO, p.cd_plano
  • Descrição: Sentença sql para consulta dos planos de saúde caso o erp utilizado seja GPS e o SGBD utilizado seja ORACLE.

• • Propriedade: rps.query.gps.progress.plano
  • Valor padrão: Select P."NM-PLANO" NOPLANO, M."DS-MODALIDADE" NOMODALIDADE, p."CD-PLANO" CDPLANO, T."CD-REGISTRO-PLANO" CDREGISTROANS From PUB."TI-PL-SA" T, PUB."PLA-SAU" P, PUB."MODALID" M Where T."CD-MODALIDADE" = P."CD-MODALIDADE" And T."CD-PLANO" = P."CD-PLANO" And M."cd-modalidade" = p."cd-modalidade" And t."cd-registro-plano" Is Not Null [FILTRO] Group By P."NM-PLANO", M."DS-MODALIDADE", p."CD-PLANO", T."CD-REGISTRO-PLANO" Order By "NM-PLANO", p."cd-plano"
  • Descrição: Sentença sql para consulta dos planos de saúde caso o erp utilizado seja GPS e o SGBD utilizado seja PROGRESS.

12. Demais Configurações

Este capítulo tem o objetivo de mostrar configurações adicionais.

12.1 Configurações de Memória

Atualmente o "JBOSS" vem configurado com 1024mb de memória. Segue abaixo os passos para aumentar a configuração de memória no sistema: 

• • Windows®

Editar o arquivo “c:/totvs/jboss-4.2.3.GA/bin/run.bat”, com um editor de textos e procurar pelos parâmetros "–Xms", "-Xmx" e "-XX:MaxPermSize", conforme o exemplo abaixo:

Os valores em vermelho representam a quantidade de memória configurada para o servidor de aplicações e devem ser alterados para o valor desejado. 

–Xms512m –Xmx1024m –XX:MaxPermSize=256m

• • Linux®

Editar o arquivo “/totvs/jboss-4.2.3.GA/bin/run.sh”, com um editor de textos e procurar pelos parâmetros "–Xms", "-Xmx" e "-XX:MaxPermSize", conforme o exemplo abaixo:

Os valores em vermelho representam a quantidade de memória configurada para o servidor de aplicações e devem ser alterados para o valor desejado. 

–Xms512m –Xmx1024m –XX:MaxPermSize=256m

13. Inicialização e Acesso

Está seção tem o objetivo de auxiliar nas configurações de acesso externo, inicialização e acesso ao sistema "Foundation".

13.1 Configurações de Acesso Externo

Para liberação do sistema para internet, será necessária a criação de um subdomínio e a configuração no parâmetro “-b”, nos arquivos "start.bat", ou "start.sh", o endereço criado.

 Exemplo:

A operadora de saúde que está configurando o sistema "Foundation" possui atualmente o domínio “www.operadorasaudeexemplo.com.br”.

Deverá ser criado um subdomínio com o nome (sugestão) “foundation.operadorasaudeexemplo.com.br”, a configuração no firewall desta operadora e o redirecionamento de todas as requisições de entrada/saída nas portas 80/443, que forem solicitadas por meio deste endereço, deverá ser redirecionadas para o servidor onde se encontra o servidor de aplicação JBOSS.

Observação: Liberar o tráfego de entrada/saída no firewall para as portas 80/443. Estas são utilizadas pelo módulo "PTU", para a transmissão de XML’s do "PTU".

• • • O arquivo “start.bat“, ficará configurado conforme o exemplo abaixo:

run.bat –b foundation.operadorasaudeexemplo.com.br

O arquivo “start.sh”, ficará configurado conforme o exemplo abaixo:

./run.sh –b foundation.operadorasaudeexemplo.com.br

Ative o SSO no JBOSS:

• • • Edite o arquivo "JBOSS_HOME\server\default\deploy\jboss-web.deployer\server.xml";
    • Retire do comentário da linha abaixo:

<Valve className="org.apache.catalina.authenticator.SingleSignOn" />

IMPORTANTE: Dependendo da configuração do servidor do cliente, pode ser necessário a configuração do "dialect" do banco de dados no arquivo "start.bat", ou "start.sh".

13.2 Inicialização do Servidor

IMPORTANTE: Antes de realizar a inicialização do sistema, é necessário garantir que todas as propriedades obrigatórias presentes no documento "Propriedades_Foundation_Saude.pdf", estejam devidamente configuradas.

Na estrutura de diretório “C:/totvs/jboss-4.2.3.GA/bin”,  localize e execute o arquivo “start.bat” (Windows®) ou “start.sh” (Linux®).

O servidor estará iniciado quando a tela do "JBOSS" for semelhante a essa:

Também é possível iniciar o "HTZFoundation" a partir dos serviços do Windows®, conforme imagem abaixo:

13.3 Pagina Web do Foundation Saúde

A "URL" de acesso do "Foundation Saúde", possui a seguinte estrutura: http://foundation.operadorasaudeexemplo/htz

Onde: 

• • • Porta: O padrão é 80, se foi reconfigurado pode-se verificar no arquivo “C:/totvs/jboss-4.2.3.GA/server/default/deploy/jboss-web.deployer/server.xml”, procure a "tag" correta, usando como critério os atributos "address" e "protocol":

13.4 Primeiro acesso ao sistema

1. Acesse a tela de login e informe o usuário “medical” e senha = “medical”

Atenção: Caso houver alguma inconsistência com relação ao acesso utilizando o usuário e senha padrão, a base de dados estará com alguma divergência, e os "scripts", devem ser revisados.

2. Será apresentada a tela para inclusão dos dados de licença.

3. Contate o AR responsável pela sua conta informando seu CNPJ.