Linha Datasul

Árvore de páginas

Versões comparadas

Versão antiga 14

changes.mady.by.user Ismael Silva Andrade

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Alex Antonio Hanauer Boeira

Gravado em

Chave

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

01.

...

 DADOS GERAIS

Produto:

TOTVS Saúde Planos

Linha de Produto:

Datasul

Segmento:

Saúde

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

PTU Online

País:Brasil
Requisito:DSAUGPSAUTOR-11228

02. SITUAÇÃO/REQUISITO

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

O objetivo deste documento é demonstrar as parametrizações e utilização do totvs-hgp-ptuonline, criado visando a substituição dos serviços do PTU Online que se encontram no módulo Foundation Saúde migrando para TOMCAT.

02. Utilização

apresentar os detalhes do novo serviço para o PTU Online 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 do PTU Online.

Aviso

A versão mínima para utilização do serviço é a 12.1.2307, com liberação no patch de 15/01/2024 para as versões 12.1.2307-9 e 12.1.2311-3.

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

Pedido de Autorização (00600), que incorpora todas as transações de solicitação de autorização de consultas, SADT e internações. Receberá como resposta Resposta de Pedido de Autorização (00501).

Transação: 00605 – Pedido de Complementação de Autorização

Pedido de Complemento de Autorização (00605), que serve ao objetivo de promover a prorrogação de uma internação ou a agregação de novos procedimentos a uma autorização
de internação previamente autorizada. Também poderá complementar autorizações, receberá como resposta Resposta de Pedido de Autorização (00501).

Transação: 00700 – Comunicação de Decurso de Prazo

Comunicação de Decurso de Prazo (00700) Consiste na comunicação de atendimento pela Prestadora por Decurso de Prazo, receberá como resposta uma transação de Confirmação (00309).

Transação: 00750 – Comunicação de internação ou alta do beneficiário

Comunicação de Internação ou Alta do Beneficíario (00750) é uma notificação de Internação ou Alta do Beneficiário, não consiste em autorização, receberá como resposta uma transação de Confirmação (00309).

Transação: 00804 – Autorização de Ordem de Serviço

Autorização de Ordem de Serviço (00804) Quando existir triangulação no caso de Ordem de Serviço, essa transação será gerada pela Executora que encaminhará essa transação para a Intermediadora com o objetivo de informar se o beneficiário será atendido.

Transação: 00806 – Ordem de Serviço

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

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

Parâmetros

Acessando o menu "Central de Integrações Saúde Planos - hgp.integrationsParam", parametrização dos endpoints do PTU Online

  • Quando o campo relacionado ao serviço estiver preenchido o sistema seguirá o processo via TOMCAT.
  • Quando o campo relacionado ao serviço estiver vazio, o sistema seguirá o processo via FOUNDATION. 
Navegue até o menu lateral "PTU Online"
Image Removed
  • Preencha com o endereço url o campo relacionado ao serviço.
    Image Removed
    Image Removed 

    • Exemplo:
    Editando o menu e preenchendo o campo do serviço relacionado ao que desejo utilizar. 
    Image Removed

    Campo preenchido, ou seja, ao realizar a requisição de Status da Transação - 0360 o serviço processo será via TOMCAT. 

    Image Removed

    Transação: 00302 – Pedido de Insistência

    • Pedido de Insistência (00302). Na hipótese de uma resposta negativa em que não corresponda às necessidades a iniciativa de pedir ou não a insistência para a Unidade Destino deverá ser tomada pela Unidade Origem, justificando a sua ação.
    • Se a situação da Resposta do Pedido de Autorização (00501) estiver totalmente negada e a unidade Executora não ficar satisfeita com a resposta, poderá solicitar para a Origem do Beneficiário, através de seu software autorizador, um Pedido de Insistência (00302) e receberá como reposta automática (sem interferência humana) uma transação de Confirmação (00309), indicando que a unidade Origem do Beneficiário recebeu e processou a requisição.
    • Se a resposta de auditoria (00404) da unidade Origem for totalmente negada, a Prestadora poderá enviar novamente para auditoria, através de um novo pedido de insistência.
    • Importante: O pedido de insistência (00302), após a resposta de auditoria, poderá ser realizado uma única vez.

    Transação: 00311 – Cancelamento

    O Cancelamento (00311) - Cancela todo o processo. O cancelamento da guia principal, somente pode ocorrer após o cancelamento de todos os complementos, resposta é Confirmação (0309). 

     

    Transação: 00360 – Status da Transação

    O Status da transação (00360) que receberá como resposta uma transação de Resposta Status Transação (00361).
    Essa transação tem como objetivo corrigir as possíveis falhas no fluxo e é utilizada quando o atual status da transação estiver divergente entre as Unidades. Assim poderá utilizar a resposta para atualizar o status da transação no seu sistema.

    Transação: 00412 – Consulta de Dados do Beneficiário

    Consulta de dados do Beneficiário (00412) Consiste na solicitação de dados do beneficiário a partir de seu código ou CPF , Resposta de Consulta de dados do Beneficiário (00413)

    Transação: 00418 – Consulta Prestador

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

    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).
    Totvs custom tabs box items
    defaultyes
    referencia
    		passo2
    conf1

    Com o novo serviço, a aplicação htzfoundation.ear (JBoss) passa a ser totvs-hgp-ptuonline.war (Tomcat), contendo somente os Webservices do PTU Online.


    Para que a comunicação entre os serviços funcione corretamente, é necessário que o Tomcat onde é executado o serviço totvs-hgp-ptuonline.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 seu ambiente, e nesse caso, nenhuma ação é necessária, apenas a conferência.


    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

    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)

    .

    Totvs custom tabs box items
    defaultno
    referencia
    		passo3
    Expandir
    titleDetalhes...
    Expandir
    titleDetalhes...
    Expandir
    titleDetalhes...
    Expandir
    titleDetalhes...
    Expandir
    titleDetalhes...
    Expandir
    titleDetalhes...

    Consulta Prestador (00418) Consiste na solicitação de dados do prestador, Resposta de Consulta Prestador (00419).

    Transação: 00430– Requisição de Contagem de Beneficiários

    Expandir
    titleDetalhes...

    Requisição da Contagem de Beneficiários (00430), deve informar a quantidade de beneficiários ativos no último dia do Mês e Ano de Referência, considerando dados registrados em sua base. Receberá como resposta Resposta Contagem de Beneficiários (00431).

    Transação: 00600 – Pedido de Autorização

    Expandir
    titleDetalhes...
    Expandir
    titleDetalhes...
    Expandir
    titleDetalhes...
    Expandir
    titleDetalhes...
    Expandir
    titleDetalhes...
    Expandir
    titleDetalhes...

    Ordem de Serviço (00806) é uma transação que parte da Origem do Beneficiário para a Prestadora, permitindo que o beneficiário saia da sua unidade com a autorização para a execução de um procedimento, receberá Resposta de Ordem de Serviço (00807).

    Transação: 01100 – Consultas transações Respondidas pelo WSD - consultaA1100WS

    Expandir
    titleDetalhes...

    Consultas transações Respondidas pelo WSD (01100), receberá como resposta Resposta Consultas transações Respondidas pelo WSD (01101).

     
     

    03. ASSUNTOS RELACIONADOS

    conf2

    O serviço oferece suporte a comunicação por meio de WebServices com segurança (certificado digital), exigidos pela Unimed do Brasil.

    Inicialmente é necessário possuir um keystore (.jks)contendo somente o certificado digital disponibilizado pela Unimed do Brasil:


    Aviso

    Um keystore é um arquivo no formato .jks que serve como um repositório de certificados. Para correto funcionamento, é necessário que dentro dele exista somente o certificado disponibilizado pela Unimed do Brasil.

    A criação de um keystore pode ser realizada através do comando keytool -genkeypair.

    A importação de um certificado para um keystore pode ser realizada através do comando keytool -importcert.

    A ferramenta keytool é distribuída junto com a instalação de um Java JDK,:

    Image Added

    Maiores informações sobre a ferramenta podem ser consultadas em sua documentação oficial.

    Aviso

    A Unimed Brasil somente realiza comunicação com os WebServices publicados utilizando o certificado digital fornecido por eles. Para que não haja conflito do PTU Online com outros processos que necessitam de certificado digital na entrada, é recomendado que o cliente utilize um Tomcat exclusivo para o serviço do PTU. Nesse caso, as variáveis de ambiente configuradas no item Servidor de Aplicação devem ser criadas no servidor onde o serviço do PTU estará rodando.


    Após obter o keystore.jks conforme as orientações acima, o mesmo deve ser referenciado na inicialização do Tomcat, adicionando as tags Djavax.net.ssl.keyStore e Djavax.net.ssl.keyStorePassword na variável JAVA_OPTS. Somente atendendo a estas etapas será possível realizar as comunicações de envio e recebimento de transações com o WSD de intercâmbio.

    Exemplo:"JAVA_OPTS=-Djavax.net.ssl.keyStore=<pasta>/keystore.jks -Djavax.net.ssl.keyStorePassword=<senha>"


    Configurando no Linux

    No Linux, adicionar as tags no arquivo de inicialização do serviço, normalmente em /etc/systemd/system/meu_servico.service

    Exemplo:

    Image Added



    Configurando no Windows

    No Windows, adicionar as tags através da tela de configurações ...\tomcat\bin\tomcat9w.exe

    Obs: dependendo da forma com que o serviço foi criado, o arquivo tomcat9w.exe pode ter sido renomeado para o nome do seu serviço. Neste caso, basta usar o seu arquivo.exe

    Neste exemplo, tomcat9w.exe foi renomeado durante a instalação:

    Image Added

    Ao executar o programa acima, será aberta esta tela. Basta adicionar as variáveis e reiniciar o Tomcat:

    Image Added


    Conferência das configurações

    Após realizar as configurações acima, o Tomcat deve ser reiniciado, e as novas variáveis devem aparecer no início do log .../tomcat/logs/catalina.out, conforme o exemplo:

    Image Added

    Se as variáveis não aparecerem no log, revise as configurações antes de prosseguir.


    Totvs custom tabs box items
    defaultno
    referenciaconf3

    Na Central de Integrações Saúde Planos (hgp.integrationsParams) foi criado o novo menu PTU Online, contendo as parametrizações do serviço:

    Image Added


    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

    • A URL do serviço deve ser o servidor + porta onde a aplicação está rodando:
      • Ex: http://servidor1:8080
      • 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 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. 


    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 Status da Transação (0360): 
    Image Added

    Ao realizar uma consulta de Status da Transação através da Consulta Status da Transação (hat0110p/hat.transactionStatusInquiry), a comunicação será realizada através do novo serviço e não mais pelo Foundation.

    Image Added


    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 Added

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

    Aviso

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

    Image Added


    Aviso

    Caso o cliente deseje isolar a parte Progress do PTU Online 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-ptuonline" 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 clientes que utilizam programas de CPC no processo do PTU Online, deverão atentar-se para as orientações abaixo:

    Aviso

    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

                        cpc/cpc-api-recebe-ptu91.i                               cpc/cpc-bosau-recebe-ptu-online.i

                        cpc/cpc-atconstrans.p

                        cpc/cpc-atconstrans.i

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

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


    Totvs custom tabs box items
    defaultno
    referenciaconf6
    #DescriçãoCausaPossíveis soluções
    1Ao realizar uma comunicação de envio é apresentado o erro: "I/O error on POST request for "/null/dts/datasul-rest/resources/prg/hat/v1/ptuOnlineV91_00/<mensagem>"A variável de ambiente "TOTVS_HOST" não foi reconhecidaVerifique se as variáveis de ambiente foram configuradas conforme a documentação Como criar variaveis de ambiente visiveis ao Datasul no Tomcat.
    2Ao realizar uma comunicação de envio ou recebimento é apresentado o erro: "I/O error: Received fatal alert: bad_certificate; nested exception is javax.net.ssl.SSLHandshakeException"O certificado digital não foi reconhecido

    1 - Verifique se o keystore utilizado possui somente o certificado digital da Unimed do Brasil

    2 - Verifique se o keystore foi referenciado corretamente na inicialização do Tomcat através das variáveis -Djavax.net.ssl.keyStore e -Djavax.net.ssl.keyStorePassword

    3 - Verifique se não há conflito com outros certificados, utilizando um Tomcat exclusivo para o PTU Online

    4 - Utilize um proxy reverso para atribuir o certificado digital da Unimed do Brasil nas comunicações de entrada

    Na página Configuração de HTTPS para o Datasul for THF é possível verificar mais informações sobre o processo de certificação digital com Tomcat.

    Totvs custom tabs box items
    defaultno
    referenciapasso3

    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

    ...

    Broker Escalável - Exemplo de como fazer uso do aplicativo e alias para chamadas REST

    ...

    ...