Linha Datasul

Árvore de páginas

Versões comparadas

Versão antiga 44

changes.mady.by.user Luis Otavio de Oliveira Rodrigues

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

jiraDSAUGPSAUTOR-1915313147

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:

serverJIRA
serverId0c783de1-186e-383b-975c-a1acd7d76cb5
key

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 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çã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,Parâmetros,Broker Escalável,CPC's,Autenticação
idsconf1,conf2,conf4,conf5,conf6conf3
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.

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
Aviso

Assim como as URL's  devem ser preenchidas para 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-planos-hgptiss-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-hgpplanos-tiss-webservices": 

Image Removed

Image RemovedImage Added


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-saude-planos-hgptiss-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.

          

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

o vínculo do prestador

da mensagem com os devidos parâmetros:

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

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 Removed
  • Exemplo Mensagem TISS (Solicitação Status Protocolo):
    Image Removed

Image Added

Totvs custom tabs box items
defaultno
referenciaconf5
Totvs custom tabs box items
defaultno
referenciaconf6
conf3

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

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 RemovedAutenticaçã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 

.

  • 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
Deve existir um registro do usuário e na aba de Cadastro conter as informações de Login e Senha :
Image Removed
Aviso
Totvs custom tabs box items
defaultno
referenciapasso3

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

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

http://seu-servidor:porta40001 Procedimento
          Exemplo:
          Image Removed

Solicitação Status Protocolo

seu-servidorporta40100seu-servidorporta40001solicitacaoStatusProtocolo

Solicitação Status Recurso Glosa

seu-servidorporta40001solicitacaoStatusRecursoGlosa

Solicitação Status de Autorização

seu-servidorporta40001solicitacaoStatusAutorizacaoExemplo:
Image Removed

Comunicação de Beneficiário

seu-servidorporta40100seu-servidorporta40001comunicacaoBeneficiario

Verifica Elegibilidade

seu-servidorporta40001pedidoElegibilidade
seu-servidorporta40100                                                      
  • Solicitação Procedimento:
seu-servidorporta40001recursoGlosa

Cancela Guia

seu-servidorporta40001cancelaGuiaExemplo:
Image Removed

Lote de Guias

seu-servidorporta40100                                                                 

É necessário substituir o <servidor> e <porta> conforme seu ambiente e a <versao> conforme a TISS (40100 para

Lote Anexo

Endpoint TISS

4.01.00

Endpoint TISS

ou 40001 para 4.00.01

Envio Documentos

Exemplo:
Image Removed

Estruturas Convertidas

Prestador - Operadora
Image Removed
  • Operadora - Prestador
    Image Removed

    •           

    Endpoint TISS 4.00.01

    ).

    Totvs custom tabs box
    defaultno
    tabsSolicitação,Status,Consulta,Envio,Resumo,Endpoints
    idsfase1,fase2,fase3,fase4,fase5,fase6
    referenciapasso3
    Totvs custom tabs box items
    defaultyes
    referenciafase1
    Mensagem TISSEndpoint TISS 4.01.00Endpoint TISS 4.00.01
    Solicitação Demonstrativo de Retornohttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/solicitacaoDemonstrativoRetorno
    Mensagem TISSEndpoint TISS 4.01.00Endpoint TISS 4.00.01
    Solicitação Procedimentohttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/solicitacaoProcedimentohttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/solicitacaoProcedimento
    Totvs custom tabs box items
    defaultno
    referenciafase2
    Mensagem TISSEndpoint TISS 4.01.00Endpoint TISS 4.00.01
    Solicitação Status Protocolo
    Mensagem TISSEndpoint TISS 4.01.00Endpoint TISS 4.00.01
    Solicitação Status  Recurso Glosahttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/solicitacaoStatusRecursoGlosa
    Mensagem TISSEndpoint TISS 4.01.00Endpoint TISS 4.00.01
    Solicitação Status de Autorizaçãohttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/solicitacaoStatusAutorizacao
    Totvs custom tabs box items
    defaultno
    referenciafase3
    Mensagem TISSEndpoint TISS 4.01.00Endpoint TISS 4.00.01
    Comunicação Beneficiário
    Mensagem TISSEndpoint TISS 4.01.00Endpoint TISS 4.00.01
    Verifica Elegibilidade

    http://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/pedidoElegibilidade                        

    Mensagem TISSEndpoint TISS 4.01.00Endpoint TISS 4.00.01
    Recurso Glosa
    Mensagem TISSEndpoint TISS 4.01.00Endpoint TISS 4.00.01
    Cancela Guiahttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/cancelaGuia                                                         
    Totvs custom tabs box items
    defaultno
    referenciafase4
    Mensagem TISSEndpoint TISS 4.01.00Endpoint TISS 4.00.01

    Lote Guias

    http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/loteGuias

    		Mensagem TISS

    Lote Anexo

    http://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/loteAnexo                                                              

    		http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/loteAnexo
    Mensagem TISSEndpoint TISS 4.01.00Endpoint 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
    Totvs custom tabs box items
    defaultno
    referenciafase5
    Totvs custom tabs box items
    defaultno
    referenciafase6
    Mensagem TISSEndpoint TISS 4.01.00


    Exemplo comparativo de endpoints da TISS 4.01.00:

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

    Lote Anexo

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

    Lote Guias

    		http://<servidor>:<porta>/
    seu-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".

    seu-servidorporta40001loteGuias

              

    03. ASSUNTOS RELACIONADOS

    ...

    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