Linha Datasul

Árvore de páginas

Versões comparadas

Versão antiga 22

changes.mady.by.user Ismael Silva Andrade

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Jean Carlo Contini Malvessi

Gravado em

Chave

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

01. DADOS GERAIS

key
Produto:

TOTVS Saúde Planos

Linha de Produto:

Datasul

Segmento:

Saúde

Módulo:HAT - Atendimento ao Público
Função:

Serviços Webservices TISS

País:Brasil
Requisito:
Jira
serverJIRA
serverId0c783de1-186e-383b-975c-a1acd7d76cb5

DSAUGPSAUTOR-1915313147

02. SITUAÇÃO/REQUISITO

Visando a Com o objetivo de dar continuidade à estratégia de evolução tecnológica dos produtos TOTVS Saúde - Linha da linha Datasul, é necessário disponibilizar um novo serviço para comunicação dos serviços os Webservices TISS, eliminando a dependência do Foundation Saúde.

03. SOLUÇÃO

O objetivo deste documento é apresentar os detalhes do novo serviço para os Webservices TISS no Tomcat, criado para a substituir o atualmente em uso no JBoss.

03. SOLUÇÃO

Foi realizada a implementação das funcionalidades destacadas abaixo, dando origem ao novo serviço para os Webservices TISSMigrando do TISS no JBoss para o TISS no TOMCAT: Um Guia Detalhado para Substituição e Aprimoramento Tecnológico.

Aviso

A versão mínima para utilização do serviço é a 12.1.2407, com liberação no patch de 15da release no dia 01/07/2024 para as versões 12.1.2403-7 e 12.1.2311-12.

É 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çãoUtilização.

Totvs custom tabs box
tabsProcedimento para Implantação,Procedimento para Configuração,Procedimento para Utilização
idspasso1,passo2,passo3
Totvs custom tabs box items
defaultyes
referenciapasso1

A implementação descrita no documento estará disponível a partir da atualização do pacote da release no cliente.

O pacote está disponível no portal (https://suporte.totvs.com/download).

Totvs custom tabs box items
defaultno
referenciapasso2
Totvs custom tabs box
tabsServidor de Aplicação,Tela de Parâmetros,Broker Escalável,CPC'sAutenticação
idsconf1,conf2,conf4,conf5conf3
A

Com o novo serviço, a aplicação htzfoundation.ear (JBoss) passa a ser dividida em dois artefatos distintos no Tomcat, contendo somente os Webservices TISS conforme a versão:

Totvs custom tabs box items
defaultyes
referenciaconf1

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.

Aviso
, que anteriormente integrava os Webservices da TISS, agora está dividida em duas estruturas distintas a partir da versão TISS:
Informações
Versão TISS
WAR
Artefato
4.01.00totvs
-java
-hgp-tiss-webservices-40100.war
4.00.01totvs
-java
-hgp-tiss-webservices-40001.war


Versões TISS anteriores à 4.00.01 não estão contempladas.


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.o Tomcat onde é executado o serviço totvs-hgp-tiss-webservices-40100.war e totvs-hgp-tiss-webservices-40001.war reconheça as variáveis abaixo. A configuração pode ser feita diretamente nos scripts de inicialização do Tomcat (mais detalhes e exemplos aqui: Como criar variaveis de ambiente visiveis ao Datasul no Tomcat) ou mesmo diretamente como variáveis de ambiente do sistema operacional:

TOTVS_HOST: <host>:<porta> do serviço do Tomcat do Datasul. Ex: http://meu-datasul:8080

TOTVS_USERNAME: usuário de login que será utilizado para autenticação Basic no Datasul para execução dos serviços

TOTVS_PASSWORD: senha que será utilizada junto ao parâmetro acima

Obs: estas variáveis são utilizadas por outras aplicações, portanto é possível que já estejam configuradas no 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, apenas a conferência.

Na página Configurar servidor de aplicação TOMCAT é possível verificar um exemplo de configuração.

Totvs custom tabs box items
defaultno
referenciaconf2


Informações
titleDica para validar esta etapa

Após configurar as variáveis de ambiente e reiniciar o Tomcat, utilize a URL abaixo para validar se o ambiente as reconheceu corretamente:

http://<SERVIDOR>:<PORTA>/totvs-hgp-webservices/ptu/v8/integrations/gateway/serverInfo

O resultado deve ser semelhante a isto:

Image Added

As variáveis precisam aparecer nesta consulta antes de prosseguir para a próxima etapa. Caso contrário ocorrerão problemas de comunicação.

Comunicação

Endpoints

  • Quando o campo relacionado ao endpoint apontar para o novo serviço, o sistema realizará a comunicação via Tomcat.
Aviso

As URL's a serem informadas são as fornecidas pela Unimed do Brasil para comunicação com o WSD referente à cada mensagem.

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 TISSExemplo
4.01.00/totvs-hgp-tiss-webservices-40100/api/solicitacaoStatusProtocolo
4.00.01/totvs-hgp-tiss-webservices-40001/api/solicitacaoStatusProtocolo
Aviso

Assim como as URL's da Unimed do Brasil devem ser preenchidas nessa tela, é necessário atualizar os endpoints do serviço na Unimed do Brasil para que o WSD comunique com cada mensagem, sendo elas:

É necessário substituir o <servidor> e <porta> conforme seu ambiente.

                

Totvs custom tabs box items
defaultno
referenciaconf4conf2

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-saude-hgpplanos-tiss-webservices", sendo necessário que o cliente inclua através dos Parâmetros do Empresas do Foundation (btb962aahtml.companies) um novo registro contendo esse alias.


Exemplo:
No programa BTB962AA (Parâmetros html.companies (Empresas do Foundation), criar um novo registro nos Cadastros relacionados → Servidores de aplicação, contendo o alias "totvs-saude-planos-hgptiss-webservices": 

Image RemovedImage Added

Image Removed


Aviso

Caso o cliente deseje isolar a parte Progress da Comunicação dos Webservices 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-hgpsaude-planos-tiss-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.

Totvs custom tabs box items
defaultno
referenciaconf5conf3

Para integrar com o novo serviço, deve ser realizada a autenticação do prestador na própria mensagem, conforme previsto pelo manual da TISS:

Image Added

Exemplo de preenchimento no XML:

Image Added


A habilitação do prestador ocorre através do cadastro Manutenção de Usuários Portal do Prestador (hat.secretary).

  • O campo loginPrestador a ser informado no XML será o Usuário informado nesse cadastro
  • O campo senhaPrestador a ser informado no XML será a Senha informada nesse cadastro, em formato MD5


Na aba Prestadores Associados deve haver o vínculo do prestador informado na tag "codigoPrestadorNaOperadora" com o papel de Serviço:

Image Added


Caso o papel esteja como Padrão, o Status como Inativo, o vínculo com o prestador não exista ou a senha não corresponda, o usuário não terá permissão para integrar com o serviço, sendo retornada a mensagem:

  • Falha na autenticação. Usuário ou senha incorretos ou o usuário informado não tem permissão para utilizar esse serviço nesse prestador e/ou versão da TISS
    • Exemplo:

Image Added

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

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, compilei uma lista das principais mensagens TISS existentes, agrupadas por Tipo de Serviço:

  • Solicitação de Autorização (TISS-13): Envia uma solicitação à operadora para autorizar a realização de um procedimento ou evento em saúde.
  • Solicitação de Cancelamento de Glosa (TISS-18): Solicita o cancelamento de uma glosa em um lote de guias enviado anteriormente.
  • Solicitação de Ressarcimento de Glosa (TISS-19): Solicita o ressarcimento de um valor glosado em um lote de guias enviado anteriormente.
  • Solicitação de Estorno de Glosa (TISS-20): Solicita o estorno de um valor glosado em um lote de guias enviado anteriormente.

          

  • Protocolo de Recebimento de Lote de Guias (TISS-2): Confirmação da operadora de que recebeu o lote de guias enviado.
  • Situação de Lote de Guias (TISS-21): Consulta o status de um lote de guias enviado anteriormente.
  • Situação de Autorização (TISS-14): Consulta o status de uma solicitação de autorização enviada anteriormente.
  • Situação de Débito (TISS-17): Consulta o status de um débito gerado para o prestador.
  • Consulta de Beneficiário (TISS-12): Consulta dados básicos de um beneficiário, como nome, plano e cobertura.
  • Consulta de Procedimento (TISS-11): Busca por informações sobre um procedimento específico, como código, descrição e valor de referência.
  • Consulta de Órgão Emissor (TISS-10): Objęcie de dados sobre um determinado órgão emissor de guias, como CNPJ e razão social.
  • Consulta de Operadora (TISS-9): Obtenção de informações sobre uma operadora de plano de saúde, como nome, código ANS e endereços.
  • Consulta de Glosa (TISS-25): Consulta detalhes sobre uma glosa em um lote de guias.
  • Envio de Lote de Guias (TISS-1): Envia um conjunto de guias TISS para a operadora para solicitação de reembolso.
  • Envio de Dados para a ANS (TISS-23): Transmite eletronicamente dados obrigatórios à ANS, como estatísticas de atendimento e produção de serviços.
  • Controle de Erros (TISS-8): Troca de mensagens para identificar e corrigir erros na comunicação entre o prestador e a operadora.
  • Mensagem de Teste (TISS-7): Envio de mensagem para testar a comunicação entre o prestador e a operadora.
  • Mensagem de Cancelamento (TISS-6): Cancela uma mensagem enviada anteriormente.

          

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:Image Removed
  • Autenticação de usuário e senha no formato MD5
    Exemplo:
    Image Removed
    • Regra de Negócio do Sistema
    No menu Manut. Usuários Portal Prestador (hat.secretary):
    Image Removed 
    Deve existir um registro do usuário e na aba de Cadastro conter as informações de Login e Senha :
    Image Removed
    Totvs custom tabs box items
    defaultno
    referenciapasso3
    Totvs custom tabs box
    defaultno
    tabsSolicitação,Status,Consulta,Envio,Outros
    idsfase1,fase2,fase3,fase4,fase5
    referenciapasso3
    Totvs custom tabs box items
    defaultyes
    referenciafase1
    Totvs custom tabs box items
    defaultno
    referenciafase2
    Totvs custom tabs box items
    defaultno
    referenciafase3
    Totvs custom tabs box items
    defaultno
    referenciafase4
    Totvs custom tabs box items
    defaultno
    referenciafase5
    Aviso

    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: 

    Image Removed

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

    03. ASSUNTOS RELACIONADOS

    ...

    Não houve alteração no processo de utilização das funcionalidades que envolvem os Webservices TISS. Todas as regras de negócio (incluindo CPC's) foram mantidas.

    O que irá diferenciar os serviços será o endpoint com que o prestador realizará a integração de cada mensagem, conforme destacado a seguir:


    Aviso

    É necessário substituir o <servidor> e <porta> conforme seu ambiente e a <versao> conforme a TISS (40100 para 4.01.00 ou 40001 para 4.00.01).


    Exemplo comparativo de endpoints da TISS 4.01.00:

    Mensagem TISSEndpoint antigo (JBoss)Endpoint novo (Tomcat)
    Solicitação Demonstrativo de Retornohttp://<servidor>:<porta>/htzfoundation-HTZFoundationEJB/TISSSolicitacaoDemonstrativoRetornoV_4_01_00WShttp://<servidor>:<porta>/totvs-hgp-tiss-webservices-40100/api/solicitacaoDemonstrativoRetorno
    Solicitação Status Protocolohttp://<servidor>:<porta>/htzfoundation-HTZFoundationEJB/TISSSolicitacaoStatusProtocoloV_4_01_00WShttp://<servidor>:<porta>/totvs-hgp-tiss-webservices-40100/api/solicitacaoStatusProtocolo
    Solicitação Status de Autorizaçãohttp://<servidor>:<porta>/htzfoundation-HTZFoundationEJB/TISSSolicitacaoStatusAutorizacaoV_4_01_00WShttp://<servidor>:<porta>/totvs-hgp-tiss-webservices-40100/api/solicitaçãoStatusAutorizacao
    Solicitação Procedimentohttp://<servidor>:<porta>/htzfoundation-HTZFoundationEJB/TISSSolicitacaoProcedimentoV_4_01_00WShttp://<servidor>:<porta>/totvs-hgp-tiss-webservices-40100/api/solicitacaoProcedimento
    Solicitação Status  Recurso Glosahttp://<servidor>:<porta>/htzfoundation-HTZFoundationEJB/TISSSolicitacaoStatusRecursoGlosaV_4_01_00WShttp://<servidor>:<porta>/totvs-hgp-tiss-webservices-40100/api/solicitaçãoStatusRecursoGlosa
    Cancela Guiahttp://<servidor>:<porta>/htzfoundation-HTZFoundationEJB/TISSCancelaGuiaV_4_01_00WShttp://<servidor>:<porta>/totvs-hgp-tiss-webservices-40100/api/cancelaGuia
    Verifica Elegibilidadehttp://<servidor>:<porta>/htzfoundation-HTZFoundationEJB/TISSVerificaElegibilidadeV_4_01_00WShttp://<servidor>:<porta>/totvs-hgp-tiss-webservices-40100/api/pedidoElegibilidade
    Comunicação Beneficiáriohttp://<servidor>:<porta>/htzfoundation-HTZFoundationEJB/TISSComunicacaoBeneficiarioV_4_01_00WShttp://<servidor>:<porta>/totvs-hgp-tiss-webservices-40100/api/comunicacaoBeneficiario
    Envio de Documentoshttp://<servidor>:<porta>/htzfoundation-HTZFoundationEJB/TISSEnvioDocumentosV_4_01_00WShttp://<servidor>:<porta>/totvs-hgp-tiss-webservices-40100/api/envioDocumentos
    Recurso Glosahttp://<servidor>:<porta>/htzfoundation-HTZFoundationEJB/TISSRecursoGlosaV_4_01_00WShttp://<servidor>:<porta>/totvs-hgp-tiss-webservices-40100/api/recursoGlosa

    Lote Anexo

    		http://<servidor>:<porta>/htzfoundation-HTZFoundationEJB/TISSLoteAnexoV_4_01_00WShttp://<servidor>:<porta>/totvs-hgp-tiss-webservices-40100/api/loteAnexo

    Lote Guias

    		http://<servidor>:<porta>/htzfoundation-HTZFoundationEJB/TISSLoteGuiasV_4_01_00WShttp://<servidor>:<porta>/totvs-hgp-tiss-webservices-40100/api/loteGuias


    Para validar se um endpoint está no ar, pode ser acessado o endereço via navegador, acrescido de ".wsdl".

    Image Added


    Informações
    titleDica

    Um prestador pode consumir ambos serviços simultaneamente .

    Exemplo: Para Solicitação de Procedimentos, integrar com o endpoint antigo e para o Cancelamento de Guia, integrar com o endpoint novo.

    Essa abordagem permite à Operadora realizar a homologação/migração de forma parcial, por prestador e por mensagem.

    ...


    Templatedocumentos