Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

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

 

Image Removed

 Image Added

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

 

Image RemovedImage Added

 

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

Image RemovedImage Added

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

 Image Added

Image Removed

 

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

 

Image RemovedImage Added

 

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

 Image Added

Image Removed

 

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

 

Image RemovedImage Added

 

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

 

Image RemovedImage Added

 

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

 

Image RemovedImage Added

 

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

Image Removed

 Image Added

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

Image RemovedImage Added

 

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

Image RemovedImage Added

 

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

Âncora
installJava
installJava
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.

 

Image Removed

Image AddedInstalaçã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.

Image Removed

 Image Added

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.Image Removed

Image Added

 

Aguarde a finalização da barra de progresso:

 

Image Removed

 Image Added

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

 

Image Removed

 Image Added

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

...

 

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:

 

Image Removed

Image Added

 

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:

 

Image Removed

Image Added

 

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:

 

Image RemovedImage Added

Instalação do Java para Linux

  1. 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
bd
bd
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®.

 

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:
    Image RemovedImage Added
  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 for corrompido, toda a estrutura de base do "FoudationFoundation" terá que ser recriada.
    Image RemovedImage Added
  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".
    Image RemovedImage Added
  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).
    Image RemovedImage Added
  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.

    @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

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

  14. No diretório onde foi criado o banco de dados deve ficar semelhante a imagem abaixo:

    Image RemovedImage Added

  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", será carregado o banco de dados,  execute “shutdown.bat” para derrubar se necessário.

  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:

    Image RemovedImage Added

  22. Digite o comando conforme o exemplo abaixo:

    1. %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).

  23. Quando aparecer a linha:

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

  24. No "SQLExplorer" (sqlexp) que está conectado, execute os comandos abaixo para criar o usuário e dar as permissões necessárias.

    1. SQLExplorer>
    2. 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".

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.

...

  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:

    Image RemovedImage Added

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:
Image RemovedImage Added
Observação: A DISTRO disponibilizada já esta com o arquivo configurado.

Âncora
confGPS
confGPS
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):
Image Removed
Image AddedConfigurações do AppServer:
Image Removed
Image AddedPara 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:
Image Removed
Image AddedExemplo de arquivo alias.p:
Image Removed

Image AddedConfiguraçã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”Scripts no diretório “CC:\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ão3.02.00
      • Descrição: Versão atual da especificação TISS, última versão suportada

 

      • Propriedade: tiss.schema
      • Valor padrãotiss.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ão2.02.03
      • Descrição: Versão da especificação TISS anterior a atual, que ainda deve ser suportada

 

      • Propriedade: tiss.schema.anterior
      • Valor padrãotissV2_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ãotissnetV2_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ãocom.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ãocom.datasul.saude.tissnet42.digestor.AttachGroupDigestor
      • Descrição: classe digestora para processar arquivos em lote.

 

      • Propriedade: tiss.digestor.webservices.VERIFICA_ELEGIBILIDADE
      • Valor padrãocom.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ãocom.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ãocom.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ãocom.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ãocom.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ãocom.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ãocom.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ãocom.datasul.saude.tissnet42.digestor. RestrictResourceDigestor
      • Descrição: classe digestora para serviço de Recurso de Glosa.

 

      • Propriedade: tiss.digestor.webservices. solicitacaostatusrecursoglosa
      • Valor padrãocom.datasul.saude.tissnet42.digestor. RestrictionResourceStatusDigestor
      • Descrição: classe digestora para serviço de Status do Protocolo de Recurso de Glosa.

 

 

      • Propriedade: tiss.schema.namespace.prefix
      • Valor padrãoans
      • Descrição: Prefixo preferencial para mensagens XML TISS, usado na criação de mensagens XML TISS.

 

      • Propriedade: com.datasul.saude.foundation.payerType
      • ValorANS 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ãocom.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ãocom.datasul.saude.egp.digestores.DigTissVerificaElegibilidade
      • Descrição: classe digestora para serviço de Verificação de Elegibilidade

 

      • Propriedade: tiss.digestor.webservices. solicitacaostatusprotocolo
      • Valor padrãocom.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ãocom.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ãocom.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ãocom.datasul.saude.egp.digestores.DigTissSolicitacaoProcedimento
      • Descrição: classe digestora para serviço de Solicitação de Procedimentos

 

      • Propriedade: tiss.digestor.webservices. cancelaguia
      • Valor padrãocom.datasul.saude.egp.digestores.DigTissCancelaGuia
      • Descrição: classe digestora para serviço de Cancelamento de Guias

 

      • Propriedade: tiss.digestor.webservices. solicitacaostatusautorizacao
      • Valor padrãocom.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ãocom.datasul.saude.egp.digestores.DigTissRecursoGlosa
      • Descrição: classe digestora para serviço de Recurso de Glosa
      • Propriedade: tiss.digestor.webservices.solicitacaostatusrecursoglosa
      • Valor padrãocom.datasul.saude.egp.digestores.DigTissSolicitacaoStatusRecursoGlosa
      • Descrição: classe digestora para serviço de Status do Protocolo de Recurso de Glosa

 

 

      • Propriedade: tiss.schema.namespace.prefix
      • Valor padrãoans
      • Descrição: Prefixo preferencial para mensagens XML TISS, usado na criação de mensagens XML TISS

 

      • Propriedade: com.datasul.saude.foundation.payerType
      • ValorANS 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
      • Porta80

Endereçohttp://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

Transação

Versão

WebService

Pedido de Autorização

3.01.35

pedidoAutorizacao_V3_01_35

Pedido de Complemento de Autorização

3.01.35

pedidoComplementoAutorizacao_V3_01_35

Pedido de Insistência

3.01.35

pedidoInsistencia_V3_01_35

Cancelamento

3.01.35

cancelamento_V3_01_35

Consulta de dados do Beneficiário

3.01.35

consultaDadosBeneficiario_V3_01_35

Consulta Prestador

3.01.35

consultaDadosPrestador_V3_01_35

Ordem de Serviço

3.01.35

ordemServico_V3_01_35

Resposta de Pedido de Auditoria

3.01.35

respostaAuditoria_V3_01_35

Pedido de Complemento de Autorização Compatibilidade

3.01.35

pedidoComplementoAutorizacaoCompatibilidade_V3_01_35

Contagem de Beneficiários

3.01.35

requisicaoContagemBeneficiarios_V3_01_35

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 Servidorserver01
      • Porta28080 

Endereçohttp://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.

...

        • -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

...

 

<!-- ... -->

 

<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">medical</attribute>

  <attribute name="TrustStoreURL">

    ${jboss.server.home.dir}/conf/truststore.truststore

</attribute>

  <attribute name="TrustStorePass">medical</attribute>

  <depends>jboss.security:service=JaasSecurityManager</depends>

</mbean>

 

<!-- ... -->

 

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.

 

...

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:

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

...

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:

<server>

<!-- ... -->

  <mbean code="org.jboss.varia.property.SystemPropertiesService"

      name="jboss:type=Service,name=SystemProperties">

    <!-- ... -->

    <attribute name="Properties">

        <!-- javax.net.ssl.trustStore=<caminho-truststore> -->

    </attribute>

    <!-- ... -->

  </mbean>

  <!-- ... -->

</server>

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:

<Server>

  <!-- ... -->

  <Service name="jboss.web">

    <!--

    <Connector port="<porta-ssl>" protocol="HTTP/1.1" SSLEnabled="true"

        maxThreads="150" scheme="https" secure="true"

        keystoreFile="<caminho>/keystore.keystore"

            keystorePass="<senha-keystore>"

        clientAuth="want" sslProtocol="TLS"

        truststoreFile="<caminho>/truststore.truststore"

            truststorePass="<senha-truststore>"/>

-->

  </Service>

</Server>

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:

<deployment ... >

  <!-- ... -->

  <bean name="WSServerConfig" class="org.jboss.wsf.stack.jbws.NativeServerConfig">

    <!--

    <property name="webServiceSecurePort"><porta-ssl></property>

    -->

  </bean>

  <!-- ... -->

<deployment>

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.

#Descrição: Configura a obrigatoriedade do CID nas guias TISS
# true: CID Obrigatório conforme implementação atual
# false: CID opcional conforme instrução normativa 40

#Obrigatoriedade do CID nas guias de Consulta
com.datasul.medical.web.action.tiss.consult.icdrequired=false (valor padrão)
#Obrigatoriedade do CID nas guias de SADT
com.datasul.medical.web.action.tiss.sadt.icdrequired=false (valor padrão)
#Obrigatoriedade do CID nas guias de Internaçao
com.datasul.medical.web.action.tiss.intern.icdrequired=false (valor padrão)
#Obrigatoriedade do CID no fechamento de lote
com.datasul.medical.web.action.tiss.closebatch.icdrequired=false (valor padrão)
#Código do CID padrão caso não informado o CID principal na internação quando utilizado o XML TISS
com.datasul.medical.web.action.tiss.intern.defaulticd=Z00

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

Image Removed

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:

 

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

 

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

 

    • Propriedaderps.query.unicoo.prestador
    • Valor padrãoSelect 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.

 

    • Propriedaderps.query.unicoo.plano
    • Valor padrãoselect 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.

 

 

    • Propriedaderps.query.gps.oracle.prestador
    • Valor padrãoselect 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.

 

    • Propriedaderps.query.gps.progress.prestador
    • Valor padrãoselect 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çãoSentença sql para consulta dos prestadores caso o erp utilizado seja GPS e o SGBD utilizado seja PROGRESS.

 

    • Propriedaderps.query.gps.oracle.plano
    • Valor padrãoSelect 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.

 

 

    • Propriedaderps.query.gps.progress.plano
    • Valor padrãoSelect 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®

...

, com um editor de textos e procurar pelos parâmetros "–Xms", "-Xmx" e "-XX:MaxPermSize", conforme o exemplo abaixo:

...

Image Added

Image Removed

 

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:

Image Removed

 

Image AddedOs 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".

...

Âncora
acessoExterno
acessoExterno
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

...

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:

Image Removed

Image AddedTambém é possível iniciar o

...

Foundation a partir dos serviços do Windows®, conforme imagem abaixo:

Image Removed

 

...

Image AddedPagina Web do Foundation Saúde

A

...

URL

...

de acesso do

...

Foundation Saúde

...

, possui a seguinte estrutura: http://foundation.operadorasaudeexemplo/htz.

Image Removed

Onde: 

...

Image Added

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

  1. Acesse a tela de login e informe o usuário

...

  1. “medical” e senha

...

  1. “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.

 

...

Image Added