| Totvs custom tabs box items |
|---|
| default | yes |
|---|
| referencia | passo1 |
|---|
| 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 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 |
|---|
| default | yesno |
|---|
| referencia | passo2 |
|---|
| | Totvs custom tabs box |
|---|
| tabs | Servidor de Aplicação,Certificado Digital,Tela de Parâmetros,Broker Escalável,CPC's,Problemas Comuns |
|---|
| ids | conf1,conf2,conf3,conf4,conf5,conf6 |
|---|
|
Documentação para configuração do ambiente para utilização das requisições do PTU Online via TOMCAT. Configurar servidor de aplicação TOMCAT Broker Escalável - Exemplo de como fazer uso do aplicativo e alias para chamadas RESTCertificados | | Totvs custom tabs box items |
|---|
|
|
| no | passo3 | | 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 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 Como criar variaveis de ambiente visiveis ao Datasul no Tomcat é possível verificar mais detalhes sobre essa configuração. |
| Totvs custom tabs box items |
|---|
| O serviço oferece suporte a comunicação por meio de WebServices com segurança (certificado digital), exigidos pela Unimed do Brasil. É necessário possuir um keystore (.jks)contendo somente o certificado digital disponibilizado pela Unimed do Brasil e referenciá-lo 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: Colocar nos parâmetros de inicialização do Tomcat as variáveis -Djavax.net.ssl.keyStore e -Djavax.net.ssl.keyStorePassword referenciando ao keystore e reiniciar o Tomcat: - set "JAVA_OPTS=%JAVA_OPTS% -Djavax.net.ssl.keyStore=<pasta>/keystore.jks -Djavax.net.ssl.keyStorePassword=<senha>"
| 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. |
|
| Totvs custom tabs box items |
|---|
| 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 |
|---|
| 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 |
|---|
| 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 |
|---|
| | # | Descrição | Causa | Possíveis soluções |
|---|
| 1 | Ao 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 reconhecida | Verifique se as variáveis de ambiente foram configuradas conforme a documentação Como criar variaveis de ambiente visiveis ao Datasul no Tomcat. | | 2 | Ao 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 |
|---|
| default | no |
|---|
| 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. Parâmetros| Expandir |
|---|
| | 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 | Expandir |
|---|
| - 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| Expandir |
|---|
| 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| Expandir |
|---|
| 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| Expandir |
|---|
| 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| Expandir |
|---|
| 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 |
|---|
| 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 |
|---|
| 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| Expandir |
|---|
| 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 | Expandir |
|---|
| 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| Expandir |
|---|
| 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| Expandir |
|---|
| 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| Expandir |
|---|
| 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 |
|---|
| Consultas transações Respondidas pelo WSD (01100), receberá como resposta Resposta Consultas transações Respondidas pelo WSD (01101).
|
