Histórico da Página
Roteiro de Instalação e Configuração
Introdução
A finalidade deste documento é descrever um roteiro para instalação e configuração do "Foundation Saúde", para a utilização dos serviços TISS, SIB XML e PTU XML em uma nova instalação.
Atenção: Nesta mídia é disponibilizado o instalador do "JBOSS", para sua conveniência, no entanto dúvidas sobre sua instalação e configurações de componentes nativos devem ser direcionadas ao suporte do fornecedor do "JBOSS".
Quando o produto já estiver em operação, a TOTVS disponibilizará no Portal de Clientes atualizações do produto englobando alterações para correções de erros, correções legais e novas implementações.
Para efetuar a atualização de seu ambiente deverão ser seguidos os procedimentos indicados neste guia; se necessário auxílio adicional favor entrar em contato com o serviço de consultoria
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”.
...
- 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:
...
- 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 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".
| Âncora | ||||
|---|---|---|---|---|
|
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.
...
Clique com o botão direito em Meu computador\Propriedades\Avançado\Variáveis de ambiente. |
|---|
Para o Windows® Vista/Seven voce deve fazer da seguinte maneira:
| Clique com o botão direito em Meu computador\Propriedades\Configurações avançadas do sistema\Variáveis de ambiente. |
|---|
Na tela que irá se abrir clique em "Variáveis de Sistema", conforme a imagem abaixo:
Clique em "Variáveis de ambiente", logo após clique em "Novo" e crie à variável "JAVA_HOME" com o valor “C:\Java\jdk1.6.0_18”, conforme a imagem abaixo:
Clique em "OK", para finalizar a configuração da variável "JAVA_HOME". Procure na lista “Variáveis do sistema” e a variável “Path”, clique em "Editar" e no campo "Valor da variável", acrescente no final do campo o valor “;%JAVA_HOME%\bin”, conforme a imagem abaixo:
Instalação do Java para Linux
- Acesse com o usuário "Root".
...
$ 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.
...
Roteiro de Instalação e Configuração - Foundation Saúde_vX.X.pdf: Este documento.
| Âncora | ||||
|---|---|---|---|---|
|
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®.
Criando o banco de dados do sistema
Este capítulo tem o objetivo de auxiliar o cliente na criação de uma base de dados no Progress®. Todos os passos abaixo foram realizados com a versão 10.1C do Progress®.
Criando uma Base de Dados Progress
- No menu "Iniciar", clique na pasta "Progress", e clique em "Database Administration".
- Clique no menu "Database\Create", será exibida a janela conforme a imagem abaixo:
- Clique em "Files" e selecione o local "c:\totvs\database" (criar os diretórios caso não exista), para criar os arquivos do banco. Exemplo: “.db” do Progress®. O nome padrão para o arquivo do banco de dados será "emssaude", conforme a imagem abaixo:
Observação: Os arquivos ".db", são o banco de dados do Progress®, sempre manter um backup deste arquivo pois se for corrompido, toda a estrutura de base do "Foudation" terá que ser recriada. - Clique em "OK", e na próxima tela clique novamente em "OK".
- Para poder conectar ao banco de dados é necessário criar o usuário "sysprogress".
- No "Database Administration" acesse "Admin\Security\Edit User List".
- Será exibida a tela para edição de usuários para o banco de dados recém criado.
- Clique em "Add" e na próxima tela preencha os campos "User ID" com "sysprogress", "User Name" com um nome qualquer e o "Password" com a senha (usuário do banco).
- No diretório onde foi criado os arquivos do banco de dados (.db, .lg, etc...), crie o arquivo “start.bat” e “shutdown.bat”.
- O primeiro arquivo será utilizado para iniciar o banco com o "broker SQL" e o segundo será utilizado para derrubar o banco quando necessário.
Edite o arquivo "start.bat" com um editor de textos, copie o conteúdo abaixo e cole no arquivo.
@echo off
echo Iniciando o banco de dados do sistema Foundation
echo.
echo.
:: Setar as variaveis Progress
set DLC=C:\DIRETORIO_INSTALACAO_PROGRESS
set PROMSGS=%DLC%\promsgs
set PATH=%DLC%\bin;%PATH%
:: Carregar o Banco
%DLC%\bin\_mprosrv emssaude -S 10000 -numsep 46 -numsep 44 -L 20000 -B 200 -bithold 1800 -n 200 -Mn 200 -Mpb 2 -Ma 200 -Mm 4096 -ServerType SQL -basetable 1 -tablerangesize 3500 -Mxs 32
pause
pause
Altere a linha “set DLC=C:\...“ e informe o diretório de instalação do Progress (c:\DLC101A, c:\DLC101C, etc...).
Edite o arquivo "shutdown.bat" com um editor de textos qualquer, copie o conteúdo abaixo e cole no arquivo.
@echo off
echo Derrubando o banco de dados do sistema Foundation
echo.
echo.
:: Setar as variaveis Progress
set DLC=C:\DIRETORIO_INSTALACAO_PROGRESS
set PROMSGS=%DLC%\promsgs
set PATH=%DLC%\bin;%PATH%
:: Derrubando o Banco
%DLC%\bin\proshut emssaude -by
pause
No diretório onde foi criado o banco de dados deve ficar semelhante a imagem abaixo:
Após a criação dos arquivos, inicie a base de dados e acesse para a execução dos scripts SQL.
Execute o arquivo "start.bat", será carregado o banco de dados, execute “shutdown.bat” para derrubar se necessário.
Como o "broker" iniciado é do tipo SQL, não podemos usar o Editor do Progress® para a criação das tabelas.
Utilize a ferramenta "sqlexp", encontrada na pasta "bin" da instalação do Progress®.
Para se logar no banco de dados, será necessário utilizar a linha de comando do Windows® conforme os passos a seguir:
Clique no "Menu Iniciar\Executar" e digite "cmd", pressione "Enter".
Será exibida a tela do console do Windows® semelhante a imagem abaixo:
Digite o comando conforme o exemplo abaixo:
- %DLC%\bin\sqlexp -db C:\Totvs\database\emssaude -S 10000 -user sysprogress -password sysprogress
Observação: Se o "Path" da máquina estiver configurado com o diretório "bin" da instalação do Progress®, não será necessário informar o caminho completo do executável "sqlexp" (c:\dlc101a\bin\sqlexp.bat), o executável poderá ser chamado sem o caminho (c:\dlc101a).
Quando aparecer a linha:
- SQLExplorer>
Estará conectado ao banco de dados com o usuário "sysprogress".
Para a criação do usuário que será utilizado para criação as tabelas, inclusão de registros e nas configurações do "JBOSS", no arquivo "progress-ds.xml", que será feito na próxima seção.No "SQLExplorer" (sqlexp) que está conectado, execute os comandos abaixo para criar o usuário e dar as permissões necessárias.
- SQLExplorer>
Copie e cole o bloco abaixo:
create user 'htzfoundation','htzfound123';
grant dba to htzfoundation;
commit;
Saia do "SQLExplorer" com o comando “exit” e conecte novamente com o usuário “htzfoundation”.
Copie todo o conteúdo do arquivo "CREATE_POPULATE.sql", que é disponibilizado na DISTRO de instalação e cole no SQLExplorer.
Feche o "SQLExplorer".
Criando uma Base de Dados Oracle
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.
...
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.
Crie o usuário do banco:
CREATE USER htzfoundation IDENTIFIED BY "htzfound123";
- Inclua as permissões necessárias para a criação das tabelas.
Insira os registros e execute o sistema "Foundation".
GRANT CONNECT, RESOURCE TO htzfoundation;
- Feche a sessão do DBA.
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
- 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.
- Configure o descriptor conforme a base em uso em seu sistema.
- No diretório “docs\examples\jca”, há modelos para vários tipos de bancos.
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.
| Â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
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.
Demais Configurações
Esta seção tem o objetivo de mostrar configurações adicionais e opcionais.
Consumo de Memória
Atualmente o JBoss vem configurado com 1024mb de memória. Segue abaixo os passos para alterar a configuração de memória no sistema.
Windows®
Editar o arquivo JBOSS_HOME/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 “/JBOSS_HOME/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
Âncora acessoExterno acessoExterno
Acesso Externo
| acessoExterno | |
| acessoExterno |
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 Foundation Saúde possui atualmente o domínio www.operadorasaudeexemplo.com.br.
Ao criar o subdomínio, sugerimos o nome 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.
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 editando o arquivo JBOSS_HOME\server\default\deploy\jboss-web.deployer\server.xml.
No arquivo, retire do comentário da linha a seguir: <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.
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".
Inicialização do Servidor
IMPORTANTE: Antes de realizar a inicialização do sistema, é necessário garantir que todas as propriedades obrigatórias estejam devidamente configuradas. A página Propriedades do Foundation Saúde documenta essa informação.
Na estrutura de diretório JBOSS_HOME/bin, localize e execute o arquivo start.bat, para instalações em Windows®, ou start.sh, para instalações em Linux®.
O servidor estará iniciado quando a tela do JBoss for semelhante a essa:
Também é possível iniciar o Foundation a partir dos serviços do Windows®, conforme imagem abaixo:
Pagina Web do Foundation Saúde
A URL de acesso do Foundation Saúde, possui a seguinte estrutura: http://foundation.operadorasaudeexemplo/htz.
A porta padrão é 80. Se foi reconfigurado pode-se verificar no arquivo JBOSS_HOME/server/default/deploy/jboss-web.deployer/server.xml a tag correta, usando como critério os atributos address e protocol.
<Server> <!-- ... --> <Service name="jboss.web"> <!-- ... --> <Connector port="29090" address="${jboss.bind.address}" ... protocol="HTTP/1.1" ... /> <!-- ... --> </Service> <!-- ... --> </Server> |
Primeiro acesso ao sistema
- Acesse a tela de login e informe o usuário “medical” e senha “medical”
Observaçã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.
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:
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.
...
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas