01. DADOS GERAIS
Produto: | TOTVS Saúde Planos |
---|---|
Linha de Produto: | Datasul |
Segmento: | Saúde |
Módulo: | HAT - Atendimento ao Público |
Função: | Serviços TISS |
País: | Brasil |
Requisito: |
02. SITUAÇÃO/REQUISITO
Visando a evolução tecnológica dos produtos TOTVS Saúde - Linha Datasul, é necessário disponibilizar um novo serviço para comunicação dos serviços TISS, eliminando a dependência do Foundation Saúde.
03. SOLUÇÃO
Migrando do TISS no JBoss para o TISS no TOMCAT: Um Guia Detalhado para Substituição e Aprimoramento Tecnológico.
A versão mínima para utilização do serviço é a 12.1.2407, com liberação da release no dia 01/07/2024.
É possível utilizar o serviço de forma híbrida com o Foundation Saúde, realizando a migração parcialmente, conforme detalhado na aba Procedimento para Configuração.
A implementação descrita no documento estará disponível a partir da atualização do pacote no cliente.
O pacote está disponível no portal (https://suporte.totvs.com/download).
A comunicação TISS agora se integra ao ERP, eliminando a necessidade de uma infraestrutura separada (JBoss). Com essa mudança, a gestão do serviço é otimizada.
A aplicação htzfoundation.ear, que anteriormente integrava os Webservices da TISS, agora está dividida em duas estruturas distintas a partir da versão TISS:
Versão TISS | WAR |
---|---|
4.01.00 | totvs-java-hgp-tiss-webservices-40100.war |
4.00.01 | totvs-java-hgp-tiss-webservices-40001.war |
Para que a comunicação com o Progress funcione corretamente, é necessário que as variáveis TOTVS_HOST, TOTVS_USERNAME e TOTVS_PASSWORD estejam configuradas no servidor, podendo ser via parâmetros de inicialização do Tomcat (como serviço do Windows/Linux ou arquivo de configuração) ou variáveis de ambiente no servidor em que o Tomcat é inicializado.
Esse padrão é utilizado por outras aplicações e é possível que já estejam disponíveis em seu ambiente, e nesse caso, nenhuma ação é necessária.
Na página Configurar servidor de aplicação TOMCAT é possível verificar um exemplo de configuração.
Comunicação
- A URL do serviço deve ser o servidor + porta onde a aplicação está rodando:
Endpoints
- Quando o campo relacionado ao endpoint apontar para o novo serviço, o sistema realizará a comunicação via Tomcat.
Exemplo:
Editando e preenchendo o campo do endpoint da mensagem de Solicitação Status Protocolo:
Ao realizar uma consulta de Status Protocolo a comunicação será realizada através do novo serviço e não mais pelo Foundation.
Versão TISS | Exemplo |
---|---|
4.01.00 | /totvs-hgp-tiss-webservices-40100/api/solicitacaoStatusProtocolo |
Assim como as URL's devem ser preenchidas para cada mensagem, sendo elas:
- Solicitação Demonstrativo de Retorno: https://<servidor>:<porta>/totvs-hgp-tiss-webservices-40100/api/solicitacaoDemonstrativoRetorno
- Solicitação Status Protocolo: https://<servidor>:<porta>/totvs-hgp-tiss-webservices-40100/api/solicitacaoStatusProtocolo
- Envio de Documentos: https://<servidor>:<porta>/totvs-hgp-tiss-webservices-40100/api/envioDocumentos
- Cancela Guia: https://<servidor>:<porta>/totvs-hgp-tiss-webservices-40100/api/cancelaGuia
- Verifica Elegibilidade: https://<servidor>:<porta>/totvs-hgp-tiss-webservices-40100/api/pedidoElegibilidade
- Comunicação Beneficiário: https://<servidor>:<porta>/totvs-hgp-tiss-webservices-40100/api/comunicacaoBeneficiario
- Solicitação Status de Autorização: https://<servidor>:<porta>/totvs-hgp-tiss-webservices-40100/api/solicitaçãoStatusAutorizacao
- Solicitação Status Recurso Glosa: https://<servidor>:<porta>/totvs-hgp-tiss-webservices-40100/api/solicitaçãoStatusRecursoGlosa
- Recurso Glosa: https://<servidor>:<porta>/totvs-hgp-tiss-webservices-40100/api/recursoGlosa
- Solicitação Procedimento: https://<servidor>:<porta>/totvs-hgp-tiss-webservices-40100/api/solicitacaoProcedimento
- Lote Anexo: https://<servidor>:<porta>/totvs-hgp-tiss-webservices-40100/api/loteAnexo
- Lote Guias: https://<servidor>:<porta>/totvs-hgp-tiss-webservices-40100/api/loteGuias
É necessário substituir o <servidor> e <porta> conforme seu ambiente.
O novo serviço utiliza o conceito de Broker Escalável, onde é possível direcionar as chamadas ao Progress para um broker específico, isolando o back-end de outras aplicações, como o ERP por exemplo.
Toda comunicação encaminhada da aplicação totvs-java-hgp-tiss-webservices-40100.war ou totvs-java-hgp-tiss-webservices-40001.war para o Progress enviará na requisição a chave "x-totvs-server-alias" como "totvs-hgp-webservices", sendo necessário que o cliente inclua através dos Parâmetros Foundation (btb962aa) um novo registro contendo esse alias.
Exemplo:
No programa BTB962AA (Parâmetros Foundation), criar um novo registro contendo o alias "totvs-hgp-webservices":
Caso o cliente deseje isolar a parte Progress da Comunicação TISS em um broker separado, deve ser criada uma nova instância do PASOE, referenciando-a através do campo "Servidor Aplicação". Para maiores detalhes sobre a criação da instância no PASOE, ver a documentação: Criando uma instância PASOE através do OpenEdge Explorer
Caso o cliente não deseje fazer essa separação, basta criar o registro com o alias "totvs-hgp-webservices" referenciando para o mesmo "Servidor Aplicação" existente.
Na página Broker Escalável - Exemplo de como fazer uso do aplicativo e alias para chamadas REST é possível verificar maiores detalhes sobre essa configuração.
Gostaríamos de informar que a recente migração para o novo serviço TISS ao TOMCAT não afetou o uso das funcionalidades para clientes que utilizam programas de CPC na comunicação TISS.
O que isso significa para você:
- Processo de Utilização Usual: As regras de negócio e operações em tela do TISS permanecem inalteradas, garantindo uma experiência familiar e intuitiva.
- Funcionalidades Acessíveis: Todas as funcionalidades do TISS que você já conhece e utiliza continuam disponíveis, sem necessidade de adaptação.
- Comunicação TISS: O processo de comunicação TISS via CPC permanece inalterado, sem interrupções ou modificações.
- Autenticação de Usuário na mensagem TISS
O padrão TISS já prevê uma segurança via usuário e senha, essas informações agora passam a ser validadas conforme as regras de negócio do sistema.
Segue abaixo a imagem das tags: - Autenticação de usuário e senha no formato MD5
Exemplo:
- Regra de Negócio do Sistema
No menu Manut. Usuários Portal Prestador (hat.secretary):
Deve existir um registro do usuário e na aba de Cadastro conter as informações de Login e Senha :
Ao preencher o campo Senha a senha é criptografada, para manter a segurança da privacidade da senha o campo na mensagem TISS é preenchido no formato MD5.
Exemplo:
- Na aba Prestadores Associados deve haver um registro do prestador da mensagem com os devidos parâmetros:
O campo "Papel" deve ser preenchido como Serviço/Prestador caso esteja como Padrão o usuário não terá permissão para realizar a comunicação TISS.
O campo "Status" deve estar Ativo.
Exemplo:
- Exemplo Mensagem TISS (Solicitação Status Protocolo):
O Padrão TISS define um conjunto abrangente de mensagens eletrônicas para viabilizar a troca de informações entre operadoras de planos de saúde, prestadores de serviços de saúde e a ANS. Cada mensagem possui uma função específica dentro do fluxo de comunicação, otimizando e padronizando os processos.
Para facilitar a consulta, uma lista das principais mensagens TISS existentes, agrupadas por Tipo de Serviço:
Solicitação Demonstrativo de Retorno
Mensagem TISS Endpoint TISS 4.01.00 Endpoint TISS 4.00.01 Solicitação Demonstrativo de Retorno http://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/solicitacaoDemonstrativoRetorno http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/solicitacaoDemonstrativoRetorno
Solicitação Procedimento
Mensagem TISS Endpoint TISS 4.01.00 Endpoint TISS 4.00.01 Solicitação Procedimento http://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/solicitacaoProcedimento http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/solicitacaoProcedimento
Exemplo:
Solicitação Status Protocolo
Mensagem TISS Endpoint TISS 4.01.00 Endpoint TISS 4.00.01 Solicitação Status Protocolo http://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/solicitacaoStatusProtocolo http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/solicitacaoStatusProtocolo Solicitação Status Recurso Glosa
Mensagem TISS Endpoint TISS 4.01.00 Endpoint TISS 4.00.01 Solicitação Status Recurso Glosa http://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/solicitacaoStatusRecursoGlosa http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/solicitacaoStatusRecursoGlosa Solicitação Status de Autorização
Mensagem TISS Endpoint TISS 4.01.00 Endpoint TISS 4.00.01 Solicitação Status de Autorização http://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/solicitacaoStatusAutorizacao http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/solicitacaoStatusAutorizacao
Exemplo:
Comunicação de Beneficiário
Mensagem TISS Endpoint TISS 4.01.00 Endpoint TISS 4.00.01 Comunicação Beneficiário http://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/comunicacaoBeneficiario
http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/comunicacaoBeneficiario Verifica Elegibilidade
Mensagem TISS Endpoint TISS 4.01.00 Endpoint TISS 4.00.01 Verifica Elegibilidade http://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/pedidoElegibilidade
http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/pedidoElegibilidade Recurso Glosa
Mensagem TISS Endpoint TISS 4.01.00 Endpoint TISS 4.00.01 Recurso Glosa http://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/recursoGlosa http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/recursoGlosa Cancela Guia
Mensagem TISS Endpoint TISS 4.01.00 Endpoint TISS 4.00.01 Cancela Guia http://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/cancelaGuia http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/cancelaGuia
Exemplo:
Lote de Guias
Mensagem TISS Endpoint TISS 4.01.00 Endpoint TISS 4.00.01 Lote Guias
http://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/loteGuias
http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/loteGuias
Lote Anexo
Mensagem TISS Endpoint TISS 4.01.00 Endpoint TISS 4.00.01 Lote Anexo
http://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/loteAnexo
http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/loteAnexo Envio Documentos
Mensagem TISS Endpoint TISS 4.01.00 Endpoint TISS 4.00.01 Envio de Documentos http://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/envioDocumentos
http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/envioDocumentos
Exemplo:
Estruturas Convertidas
- Prestador - Operadora
- Operadora - Prestador
03. ASSUNTOS RELACIONADOS