Árvore de páginas

Versões comparadas

Chave

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

...

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:

Jira
serverJIRA
serverId0c783de1-186e-383b-975c-a1acd7d76cb5
keyDSAUGPSAUTOR-19153

02. SITUAÇÃO/REQUISITO

Com o objetivo de dar continuidade à estratégia de Visando a evolução tecnológica dos produtos da linha 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.

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

03. SOLUÇÃO

Migrando 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çã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 no cliente.

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

1. Acesse o menu Importação Menu Datasul (men706aa) e importe o arquivo men_hat.d.

2. Acesse o menu Programa Produto Datasul (bas_prog_dtsul) e altere o registro "hat.ptuOnlineParam" para liberar as permissões de acesso ao menu "PTU Online" da Central de Integrações Saúde Planos (hgp.integrationsParams

).

Totvs custom tabs box items
defaultno
referenciapasso2
Totvs custom tabs box
tabsServidor de Aplicação,Tela de Parâmetros,Certificado Digital,Broker Escalável,CPC's,Autenticação
idsconf1,conf2,conf3,conf4,conf5,conf6
Totvs custom tabs box items
defaultyes
referenciaconf1

Com o novo serviço, o PTU Online deixa de ser executado em A comunicação TISS agora se integra ao ERP, eliminando a necessidade de uma infraestrutura separada (JBoss) e passa a ser um serviço do próprio ERP, rodando no mesmo servidor (Tomcat) do sistema. Com essa mudança, a gestão do serviço é otimizada.

Aviso

A aplicação htzfoundation.ear

passa a ser totvs-hgp-ptuonline.war, contendo somente os Webservices do PTU Online.

, que anteriormente integrava os Webservices da TISS, agora está dividida em duas estruturas distintas a partir da versão TISS:

Versão TISSWAR
4.01.00totvs-java-hgp-tiss-webservices-40100.war
4.00.01totvs-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.

Na Central de Integrações Saúde Planos (hgp.integrationsParams) foi criado o novo menu PTU Online, contendo as parametrizações do serviço:Essa funcionalidade é similar à pasta "xmlwslog" que existia no servidor do Foundation, com a diferença que os arquivos serão gerados em formato JSON e não mais XML. Para verificar os XMLs que trafegaram de fato pelo WSD da Unimed do Brasil, pode ser utilizada a consulta de fases da transação pela Interface Única.

  


Totvs custom tabs box items
defaultno
referenciaconf2

Image Removed

Aviso

Este menu contém as configurações que anteriormente eram realizadas no arquivo foundation-exchange.properties do JBoss.

Com o novo serviço, essas configurações passam a ser realizadas diretamente no sistema.

Comunicação

  • Apesar de ser um serviço do próprio ERP, este parâmetro é necessário para que aplicações externas consigam acessar. Ex: Autorizador Web realizando a comunicação de uma guia de intercâmbio.
  • Nesse momento de funcionamento híbrido, a versão do PTU Online continua sendo definida na Manutenção Parâmetros Globais Sistema (hpr1410p/hcg.globalParameters). Quando ocorrer a descontinuação definitiva do módulo Foundation Saúde, o parâmetro será migrado para essa tela.
  • Endpoints

    • Quando o campo relacionado ao endpoint
    estiver preenchido, o sistema realizará a comunicação através do
    • apontar para o novo serviço,
    via Tomcat.Quando o campo relacionado ao endpoint estiver vazio,
    • o sistema realizará a comunicação
    através do Foundation, via JBoss. 
    • 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.

    Aviso

    As mensagens de Pedido de Autorização (0600), Ordem de Serviço (0806) são dependentes pois quando ocorre o recebimento de uma ordem de serviço (0806), o sistema encaminha o pedido de autorização (0600) referente à aquela O.S., portanto devem ser migradas juntas.

    As demais não possuem dependência e podem ser migradas individualmente conforme evolução dos testes.

    Exemplo:
    Editando e preenchendo o campo do endpoint da mensagem de Solicitação Status

    da Transação (0360)

    Protocolo


    Image Removed

    Ao realizar uma consulta de Status

    da Transação através da Consulta Status da Transação (hat0110p/hat.transactionStatusInquiry),

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

    Log Auxiliar

  • Habilita/desabilita a geração de arquivos auxiliares  contendo os dados de entrada e saída das comunicações realizadas no PTU Online, úteis para ambientes de homologação e validação de informações.
  • Os arquivos serão gerados seguindo a nomenclatura: "Operação" + "Código da transação" + "Descrição da transação" + "Data" + "Hora"

    .

    json

  • Operação poderá ser: Envio, Resposta, Recebimento ou Resposta de Recebimento
  • Exemplo de arquivos gerados:

  •                 Image Removed

    • Quando habiitado é necessário informar um diretório válido para exportação, normalmente um diretório de rede que o PASOE consiga acessar.
    • Quando desabilitado nenhum arquivo será exportado.

             Image Removed

    Aviso
    Totvs custom tabs box items
    defaultno
    referenciaconf3

    O processo de certificação digital segue o padrão de conectores https no Tomcat e é similar à configuração anteriormente existente no JBoss. Na página SSL/TLS Configuration How-To é possível verificar a documentação da Apache a respeito desse processo.

    É necessário habilitar o conector https no arquivo server.xml do servidor, referenciando a um keystoreFile que tenha importado o certificado digital disponibilizado pela Unimed do Brasil. Também é necessário importar esse certificado para o Java utilizado na inicialização do Tomcat. Dessa forma será possível realizar as comunicações de envio e recebimento de transações com o WSD de intercâmbio.

    Exemplo:

    Image Removed

    Na página Configuração de HTTPS para o Datasul for THF é possível verificar maiores detalhes sobre essa configuração.

    Totvs custom tabs box items
    defaultno
    referenciaconf4

    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-ptuonline40001.war para o Progress enviará na requisição a chave "x-totvs-server-alias" como "totvs-saudehgp-planos-ptuonlinewebservices", 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-saudehgp-planos-ptuonlinewebservices": 

    Image Added


    Image RemovedImage Added


    Aviso

    Caso o cliente deseje isolar a parte Progress do PTU Online 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-saudehgp-planos-ptuonlinewebservices" 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
    referenciaconf5

    Para os 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 no processo do PTU Online, deverão atentar-se para as orientações abaixo: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.

              


    Totvs custom tabs box items
    defaultno
    referenciaconf6


    • 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 Added
    • Autenticação de usuário e senha no formato MD5
      Exemplo:
      Image Added



    1. Regra de Negócio do Sistema
      No menu Manut. Usuários Portal Prestador (hat.secretary):
      Image Added 
      1. Deve existir um registro do usuário e na aba de Cadastro conter as informações de Login e Senha :
        Image Added


        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 Added

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

    • Exemplo Mensagem TISS (Solicitação Status Protocolo):
      Image Added


    Totvs custom tabs box items
    defaultno
    referenciapasso3

    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:

    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


              Exemplo:
              Image Added


    Totvs custom tabs box items
    defaultno
    referenciafase2



    Os programas cpc-api-recebe-ptu91.p e cpc-atconstrans.p foram substituídos pelo cpc-bosau-recebe-ptu-online.p.

    Para funcionamento correto das rotinas no processo, é necessário criar o novo programa e migrar a lógica existente para ele.

    Foundation: cpc/cpc-api-recebe-ptu91.p                Tomcat: cpc/cpc-bosau-recebe-ptu-online.p

    Totvs custom tabs box items
    defaultno
    referenciafase3


    Aviso

                       

    cpc/cpc-api-recebe-ptu91.i  cpc/cpc-bosau-recebe-ptu-online.icpc/cpc-atconstrans.p


    Totvs custom tabs box items
    defaultno
    referenciafase4


    cpc/cpc-atconstrans.i


    Totvs custom tabs box items
    defaultno
    referenciafase5


    Estruturas Convertidas

    • Prestador - Operadora

      Image Added
    • Operadora - Prestador
      Image Added

              

    • A nova nomenclatura não contém o número da versão do PTU, não sendo mais necessário criar um novo programa a cada atualização
    • Os nomes dos pontos de chamada foram mantidos os mesmos. Ex: "ORDEM-SERVICO", "ALTERA-PREST"
    • O novo programa deve conter somente 2 parâmetros: a tabela de entrada e a de saída:

              Image Removed

    • Para migração da lógica da CPC, deve ser considerada a nova nomenclatura das temp-tables do programa (todos os campos anteriormente existentes foram mantidos):

              Image Removed


    Totvs custom tabs box items
    defaultno
    referencia
    passo3

    Não houve alteração no processo de utilização das funcionalidades que envolvem o PTU Online. Todas as regras de negócio e operações em tela foram mantidas.

    Exemplo: Ao solicitar uma guia de intercâmbio pelo AT0110Z, o processo de inclusão/comunicação percebido pelo usuário será o mesmo, com a diferença que o sistema estará direcionando a chamada para a Unimed do Brasil através do novo serviço e não mais pelo Foundation.

    03. ASSUNTOS RELACIONADOS

    fase6
    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

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

    Solicitação Status Protocolohttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/solicitacaoStatusProtocolohttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/solicitacaoStatusProtocolo
    Solicitação Status de Autorizaçãohttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/solicitacaoStatusAutorizacaohttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/solicitacaoStatusAutorizacao
    Solicitação Procedimentohttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/solicitacaoProcedimentohttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/solicitacaoProcedimento
    Solicitação Status  Recurso Glosahttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/solicitacaoStatusRecursoGlosahttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/solicitacaoStatusRecursoGlosa
    Cancela Guiahttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/cancelaGuiahttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/cancelaGuia
    Verifica Elegibilidade

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

    http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/pedidoElegibilidade
    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
    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
    Recurso Glosahttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/recursoGlosahttp://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/recursoGlosa

    Lote Anexo

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

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

    Lote Guias

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

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



              


    03. ASSUNTOS RELACIONADOS


    Templatedocumentos