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

Transcrição

1 Foundation Saúde Roteiro de Instalação e Configuração Agosto/2014

2 Indíce Título do documento 1. Histórico de Alterações Introdução Pré-Requisitos Hardware Servidor Software Servidor Software Cliente Passos para Instalação e Configuração do sistema Foundation Instalação e Configuração do Java Instalação do Java para Windows Instalação do Java para Linux Distro de Instalação Foundation Saúde Banco de Dados Criando o banco de dados do sistema Criando uma Base de Dados Progress Criando uma Base de Dados Oracle Configuração do Banco de Dados Segurança de Acesso para o Banco de Dados Configurações para Gestão de Planos Progress Criação do AppServer Configuração de acesso ao AppServer Executar Scripts de Banco de Dados TISS Mensagens Contempladas Configurações Propriedades do Sistema Propriedades Sistema Gestão de Planos Propriedades Sistema UNICOO Envio de Mensagem por WebService Referências PTU Mensagens Contempladas Configuração do WebServices Demais Configuração PTU Envio de Mensagem por WebService Certificado Digital Criação do Contenedor de Certificados (Keystore) Criação do Certificado Versão 1.0

3 Importação dos Certificados Configuração de Segurança no Servidor de Aplicações Habilitar Certificado Digital - PTU/Tiss/SIB Desabilitar Certificado Digital - SIB/Tiss Regras de Validação Validação de Lote de Guias IN 40 Obrigatoriedade do CID TISS Upload por diretório Iniciando e parando o processo de integração por diretório SIB (Sistema de Informações de Beneficiários) RPS (Registro de Plano de Saúde) Demais Configurações Configurações de Memória Inicialização e Acesso Configurações de Acesso Externo 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 Pagina Web do Foundation Saúde Primeiro acesso ao sistema Versão 1.0 3

4 Título do documento Atenção: Copyright 2013 TOTVS. Todos os direitos reservados. Nenhuma parte deste documento pode ser copiada, reproduzida, traduzida ou transmitida por qualquer meio eletrônico ou mecânico, na sua totalidade ou em parte, sem a prévia autorização escrita da TOTVS, que se reserva o direito de efetuar alterações sem aviso prévio. A TOTVS não assume qualquer responsabilidade pelas consequências de quaisquer erros ou inexatidões que possam aparecer neste documento. TOTVS S.A. Av. Braz Leme, 1717 São Paulo-SP Brasil 4 Versão 1.0

5 1. Histórico de Alterações Data Versão Descrição 30/12/ Criação do documento 06/07/ Atualização contemplando PTU e Melhorias TISS 13/07/ Inclusão de Regras de Validação e IN-40 09/08/ /09/ Suporte a TISS , compactação de logs e suporte a mensagem tisstransmitemensagemzip O arquivo tissdatasulmedical.properties passa a ser desnecessário. Eliminação de AppServes Progress antigos Atualização do documento referente à compactação de logs e leitura de diretórios e tisstransmitemensagemzip Alteração de todos os contextos de WebService para htzcomm 15/09/ Foi criado os tópicos e referente a configuração do certificado digital. 16/11/ Suporte a TISS /12/ Foi adicionado na seção 2.3 o passo-a-passo para instalar e configurar i sistema foundation. 17/01/ Processo de Geração do SIB (Sistema de Informações de Beneficiários) 11/02/ Inclusão do tópico referente às configurações do arquivo tiss.ini para o sistema UNICOO 22/02/ Inclusão de criação do banco de dados (Oracle e Progress) Instalação do Java Criação do AppServer 20/07/ Revisão do documento. Versão do documento passa a ser igual a versão do produto 01/08/ PTU On-Line Versão /06/ PTU On-Line Versão 4.0 e SIB reestruturação 30/01/ Melhorias e Correções conforme Release Notes. Configuração do processo para geração do SIB Revisão do documento 17/07/ Revisão do documento Configurações para a TISS 3. Versão 1.0 5

6 2. Introdução Título do documento 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. 3. Pré-Requisitos Segue abaixo os pré-requisitos para o funcionamento do sistema Foundation Hardware Servidor Processador 2.2GHZ ou superior Memória mínima 2GB. Rede 100 Mbps ou superior 3.2. 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 6 Versão 1.0

7 4. Passos para Instalação e Configuração do sistema Foundation 1º. 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: 1. Entre na pasta Disk1 e execute o setup.exe e clique em Avançar. Versão 1.0 7

8 Título do documento 2. Informe o Nome do Usuário e Empresa e clique em Avançar. 3. 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. 8 Versão 1.0

9 4. Selecione o Sistema ERP utilizado e clique em Avançar. Atenção: Abaixo segue as configurações para Gestão de Planos. Caso seu ERP for o Unicoo, vá para o passo 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. Versão 1.0 9

10 Título do documento 6. 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. 7. 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. 10 Versão 1.0

11 Atenção: Abaixo as configurações para Gestão de Planos. Caso seu ERP for o Unicoo, vá para o passo 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. 9. Caso o banco de dados for Oracle, informe o nome da instância do banco de dados e clique em Avançar. Versão

12 Título do documento Atenção: Abaixo as configurações para Gestão de Planos. Caso seu ERP for o Unicoo, vá para o passo Confirmação para alterar arquivo de configuração do Progress para a criação do AppServer. Clique em Avançar. 11. Aguarde a instalação finalizar e crie o serviço do Windows. Clique em concluir. 12 Versão 1.0

13 2º. Para o funcionamento do sistema Foundation. É necessária a instalação do pacote do JDK(Java Development Kit) atualizado conforme o capítulo 4.1 Instalação e Configuração do Java. 3º. Configure o banco de dados conforme as instruções na seção 5.1 Configuração do banco de dados deste documento. 4º. Para os clientes que utilizarem o sistema Gestão de Planos, será necessário configurar o AppServer conforme a seção 5.4 Configuração para Gestão de Planos. 5º. 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 Desabilitar Certificado PTU/TISS, através desta seção voce estará desabilitando o uso do certificado digital no sistema. 6º. No diretório C:\totvs\jboss 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 GA\bin, contudo, na pasta BIN as propriedades tiss.schema, tiss.schema.anterior e tissnet.schema deverão ser preenchidas com o caminho completo onde se encontram os schemas. 7º. 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. 8º. 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. 9º. 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. 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. Versão

14 Título do documento 4.1. 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 ( ao acessar o link será exibida a tela abaixo, selecione a versão conforme o seu sistema operacional e faça o download. 14 Versão 1.0

15 4.2. Instalação do Java para Windows 1. Após ter finalizado o download, execute o jdk-6u18-windows-i586.exe (Windows 32 bits), será inicializado o instalador. 2. 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. 3. Aguarde a finalização da barra de progresso: Versão

16 Título do documento 4. Após a finalização da barra de progresso será exibida a tela abaixo indicando que a instalação chegou ao fim. 5. 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: 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. 16 Versão 1.0

17 6. Na tela que irá se abrir clique em "Variáveis de Sistema", conforme a imagem abaixo: 7. Clique em Variáveis de ambiente e 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: Versão

18 Título do documento 8. Clique em OK para finalizar a configuração da variável JAVA_HOME. 9. 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: 18 Versão 1.0

19 4.3. 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 execute os passos exibidos na instalação. 5. Pressione a barra de espaço (teclado) e digitando 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: Não é mais necessário fazer as configurações do profile da ultima versão do Java, como outros software 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 Abra um terminal e digite: $ java -version $ javac version Versão

20 Título do documento 4.4. Distro de Instalação Foundation Saúde O arquivo de instalação possui a estrutura de uma DISTRO (1) 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 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. 1 - DISTRO: Possui estrutura completa do Servidor de Aplicações (JBoss SA), deploy, e arquivos de configuração. 20 Versão 1.0

21 5. Banco de Dados Neste capítulo serão centralizadas todas as configurações referentes a banco de dados. Nas seções a seguir descrevemos os passos necessários para fazer 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 1. No Menu Iniciar clique na pasta Progress, e clique em Database Administration. 2. Clique no menu Database\Create, será exibida a janela conforme a imagem abaixo: 3. 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 o mesmo for corrompido, toda a estrutura de base do Foudation terá que ser recriada. Versão

22 Título do documento 4. Clique em OK, e na próxima tela clique novamente em OK. 5. Para poder conectar ao banco de dados é necessário criar o usuário sysprogress. 6. No Database Administration acesse Admin\Security\Edit User List. 22 Versão 1.0

23 7. Será exibida a tela para edição de usuários para o banco de dados recém criado. 8. 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). 9. No diretório onde foi criado os arquivos do banco de dados (.db,.lg, etc...) crie o arquivo start.bat e shutdown.bat. 10. 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. 11. Edite o arquivo start.bat com um editor de textos, copie o conteúdo abaixo e cole no arquivo. Versão

24 Título do 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 numsep 46 -numsep 44 -L B 200 -bithold n 200 -Mn 200 -Mpb 2 -Ma 200 -Mm ServerType SQL -basetable 1 -tablerangesize Mxs 32 pause pause 12. Altere a linha set DLC=C:\... e informe o diretório de instalação do Progress (c:\dlc101a, c:\dlc101c, etc...). 13. Edite o arquivo shutdown.bat com um editor de textos qualquer, copie o conteúdo abaixo e cole no 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 14. No diretório onde foi criado o banco de dados deve ficar semelhante a imagem abaixo: 15. Após a criação dos arquivos, inicie a base de dados e acesse para a execução dos scripts SQL. 16. Execute o arquivo start.bat e será carregado o banco de dados e execute shutdown.bat para derrubar se necessário. 24 Versão 1.0

25 17. Como o broker iniciado é do tipo SQL, não podemos usar o Editor do Progress para a criação das tabelas. 18. Utilize a ferramenta sqlexp encontrada na pasta bin da instalação do Progress. 19. Para se logar no banco de dados, será necessário utilizar a linha de comando do Windows conforme os passos a seguir: 20. Clique no Menu Iniciar\Executar e digite cmd, pressione Enter. 21. Será exibida a tela do console do Windows semelhante a imagem abaixo: 22. Digite o comando conforme o exemplo abaixo: a. %DLC%\bin\sqlexp -db C:\Totvs\database\emssaude -S 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). 23. Quando aparecer a linha: a. 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, este usuário será utilizado também nas configurações do JBOSS no arquivo progress-ds.xml que será feito na próxima seção. 24. No SQLExplorer (sqlexp) que está conectado, execute os comandos abaixo para criar o usuário e dar as permissões necessárias. a. SQLExplorer> b. Copie e cole o bloco abaixo: create user 'htzfoundation','htzfound123'; grant dba to htzfoundation; commit; 25. Saia do SQLExplorer com o comando exit e conecte novamente com o usuário htzfoundation. 26. Copie todo o conteúdo do arquivo CREATE_POPULATE.sql que é disponibilizado na DISTRO de instalação e cole no SQLExplorer. 27. Feche o SQLExplorer. Versão

26 Título do documento 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. 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. Insera 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. 26 Versão 1.0

27 5.2. 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 GA/server/default/deploy. O padrão de nome para esse arquivo é o nome do Tipo de Banco concatenado com - ds.xml. Para Oracle (2) o nome do descriptor é oracle-ds.xml ou oracle-xa-ds.xml. 1. Configure o descriptor conforme a base em uso em seu sistema. 2. No diretório docs\examples\jca há modelos para varios 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 :05:03Z adrian@jboss.org $ --> <!-- ==================================================================== --> <!-- 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-classname>org.jboss.resource.adapter.jdbc.vendor.oracleexceptionsorter</exception-sorterclass-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, alterare 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> <connectionurl>jdbc:datadirect:openedge://ip:porta;databasename=emssaude;workarounds= </con nection-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. 2 - A Oracle mantém sua documentação para drivers no endereço: Versão

28 Título do documento Nesse arquivo, para o sistema UNICOO, também é necessário a configuração da conexão com o ERP, conforme exemplo abaixo: 5.3. Segurança de Acesso para o Banco de Dados 1. No arquivo login-config.xml, localizado na estrutura C:/totvs/jboss 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. 28 Versão 1.0

29 5.4. Configurações para Gestão de Planos Progress Os itens abaixo são válidos apenas para usuários do sistema Gestão de Planos 100 e Totvs 11 progress. Caso seu ERP for o Unicoo, vá para o passo Criação do AppServer O AppServer será utilizado para fazer a comunicação entre o Foundation X Gestão de Planos. Segue abaixo os dados para criação do AppServer. 1. Criação do novo AppServer (HTZFoundation) 2. Configurações do AppServer: Versão

30 Título do documento 3. Para acessar as configurações clique com o botão direito do mouse no AppServer criado clique em propriedades. 4. 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. 5. Na opção Agente\Geral pode ser alterada as configurações de parâmetros de inicialização do servidor, Propath e o caminho para geração do log. Observação: Para clientes que utilizam banco de dados unificado, é necessário a criação do arquivo de alias e a configuração no AppServer. Exemplo: 30 Versão 1.0

31 6. Exemplo de arquivo alias.p: Versão

32 Título do documento Configuração de acesso ao AppServer A configuração de acesso é através do arquivo datasul_framework.properties que ficará localizado no diretório C:\totvs\jboss 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çoes, deverá ser configurado no arquivo: C:\totvs\jboss GA\bin\run.bat ou C:\totvs\jboss GA\bin\run.sh. A variável denominada: datasul.framework.properties Configuração para Windows: arquivo run.bat set JAVA_OPTS=%JAVA_OPTS% -Ddatasul.framework.properties.dir=C:\totvs\jboss GA\server\default\conf Configuração para Linux: arquivo run.sh JAVA_OPTS=$JAVA_OPTS -Ddatasul.framework.properties.dir=C:\totvs\jboss GA\server\progress\conf 32 Versão 1.0

33 5.5. Executar Scripts de Banco de Dados Após finalizar a execução do instalador, será criada a pasta Scripts no diretório C:\totvs\foundation-saude\. Nessa pasta serão disponibilizados os scripts para criação e preenchimento das tabelas do banco de dados. 6. TISS A Agência Nacional de Saúde Suplementar (ANS) está vinculado ao Ministério da Saúde, com a finalidade de regulamentar as operadoras do setor quanto às suas relações com prestadores e consumidores, e contribui para o desenvolvimento das ações de saúde no País. Para padronizar e regulamentar os protocolos de troca de informações de operadoras com operadoras, e operadoras com prestadores, a ANS criou o protocolo Troca de Informação em Saúde Suplementar (TISS). O Foundation Saúde foi criado para suportar as especificações da ANS em formato eletrônico, atendendo as normas TISS, as mensagens transmitidas obedecem a formato XML (3) também especificado pela ANS: Transações de serviços via WebServices (4) com ou sem segurança (certificados); Transações com envio ou troca de mensagens XML através de arquivos (upload e download). Além dos serviços normativos, o Foundation Saúde oferece: Armazenamento e validação de Biometria de usuários; E um facilitador acessado diretamente pelo navegador web para digitação de guias. 3 - XML: Linguagem de marcação estruturada e de fácil leitura e montagem. 4 - WebServices: Serviços Web para troca de mensagens em formato XML. Versão

34 6.1. Mensagens Contempladas Título do documento As transações, versões e respectivas mensagens WebService suportadas pelo Foundation Saúde estão estruturadas conforme mostrado abaixo: Verificar Elegibilidade Solicitação de Procedimentos Transação Versão WebService Solicitação Status de Autorização Solicitação Status do Protocolo Solicitação de Demonstrativos de Retorno e Pagamento Cancelamento de Guias Lote de Guias Transmite Mensagem Transmite Mensagem Zip TISSEligibilityV2_01_03WS TISSEligibilityV2_02_01WS TISSEligibilityV2_02_02WS TISSEligibilityV2_02_03WS TISSVerificaElegibilidadeV3_02_00WS TISSProcedureSolicitationV2_01_03WS TISSProcedureSolicitationV2_02_01WS TISSProcedureSolicitationV2_02_02WS TISSProcedureSolicitationV2_02_03WS TISSSolicitacaoProcedimentoV3_02_00WS TISSProcedureSolicitationAuthorizationStatusV2_01_03WS TISSProcedureSolicitationAuthorizationStatusV2_02_01WS TISSProcedureSolicitationAuthorizationStatusV2_02_02WS TISSProcedureSolicitationAuthorizationStatusV2_02_03WS TISSSolicitacaoStatusAutorizacaoV3_02_00WS TISSProcedureSolicitationStatusV2_01_03WS TISSProcedureSolicitationStatusV2_02_01WS TISSProcedureSolicitationStatusV2_02_02WS TISSProcedureSolicitationStatusV2_02_03WS TISSSolicitacaoStatusProtocoloV3_02_00WS TISSProcedureSolicitationReturnDemoV2_01_03WS TISSProcedureSolicitationReturnDemoV2_02_01WS TISSProcedureSolicitationReturnDemoV2_02_02WS TISSProcedureSolicitationReturnDemoV2_02_03WS TISSSolicitacaoDemonstrativoRetornoV3_02_00WS TISSProcedureSolicitationCancelV2_01_03WS TISSProcedureSolicitationCancelV2_02_01WS TISSProcedureSolicitationCancelV2_02_02WS TISSProcedureSolicitationCancelV2_02_03WS TISSCancelaGuiaV3_02_00WS TISSInvoiceGroupV2_01_03WS TISSInvoiceGroupV2_02_01WS TISSInvoiceGroupV2_02_02WS TISSInvoiceGroupV2_02_03WS TISSLoteGuiasV3_02_00WS TISSMessageSenderV2_01_03WS TISSMessageSenderV2_02_01WS TISSMessageSenderV2_02_02WS TISSMessageSenderV2_02_03WS TISSBroadcastsMessageZIPV2_02_02WS TISSBroadcastsMessageZIPV2_02_03WS Recurso de Glosa TISSRecursoGlosaV3_02_00WS Status do protocolo de recurso de glosa TISSSolicitacaoStatusRecursoGlosaV3_02_00WS 34 Versão 1.0

35 6.2. Configurações 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 GA/server/default/conf. Arquivo tiss.ini : Propriedade: tiss.versao.atual Valor padrão: 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: 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. Versão

36 Título do documento 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. 36 Versão 1.0

37 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: 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. Versão

38 Propriedades Sistema UNICOO Título do documento 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 38 Versão 1.0

39 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: 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. Versão

40 Título do documento 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. 40 Versão 1.0

41 6.3. Envio de Mensagem por WebService 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 HTZFoundationEJB/TISSEligibilityV2_02_03WS?wsdl Solicitação de Procedimentos Solicitação Status de Autorização HTZFoundationEJB/TISSProcedureSolicitationV2_02_03WS?wsdl O envio de mensagens de serviço pode ser feito através de Web Services com certificado de segurança. Os Serviços disponíveis e a estrutura da mensagem são obtidos através do endereço: Todos os Web Services relativos aos serviços TISS que utilizam certificado de segurança estão sob o contexto /htzfoundation-tiss. Exemplo de URL para listar os WebServices: Nome do Servidor: localhost Porta: 80 Endereço: HTZFoundationEJB/TISSProcedureSolicitationAuthorizationStatusV2_01_03WS?wsdl HTZFoundationEJB/TISSProcedureSolicitationAuthorizationStatusV2_02_01WS?wsdl HTZFoundationEJB/TISSProcedureSolicitationAuthorizationStatusV2_02_02WS?wsdl HTZFoundationEJB/TISSProcedureSolicitationAuthorizationStatusV2_02_03WS?wsdl Solicitação Status do Protocolo Solicitação de Demonstrativos de Retorno e Pagamento Versão

42 Título do documento Cancelamento de Guias Lote de Guias Transmite Mensagem Transmite Mensagem ZIP Recurso de Glosa Status do Protocolo de Recurso de Glosa 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 Solicitação de Procedimentos Solicitação Status de Autorização Versão 1.0

43 Solicitação Status do Protocolo Solicitação de Demonstrativos de Retorno e Pagamento Cancelamento de Guias Lote de Guias Transmite Mensagem Transmite Mensagem ZIP Recurso de Glosa Status do Protocolo de Recurso de Glosa Configuração para suporte a versões antigas #Informa que a versão não será suportada. Este arquivo esta disponível no seguinte caminho: C:\totvs\jboss GA\server\default\deploy\properties-service.xml com.totvs.saude.tiss.suportversion =false #Informa que a versão 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 =false Versão