Árvore de páginas

CONTEÚDO

  1. Visão Geral 
  2. Parâmetros de Integração
    1. WebServices Unimed X GPS
    2. Reconhecimento Facial
    3. Carol
    4. Gestão de Protocolos - GPU
    5. Chat
    6. Saúde Pay
    7. PTU A510
    8. Pré-Cadastro
    9. PTU Online
    10. HUB de Guias
    11. PTU Movimentação

01. VISÃO GERAL

Este programa tem como objetivo os cadastros e parametrizações para integração do GPS com aplicações externas ao Saúde Planos.

02. PARÂMETROS DE INTEGRAÇÃO

O programa possui um menu lateral com todas as telas de parâmetros de integração. Cada menu possui cadastro e permissões de acesso distintas, que serão exibidas de acordo com a permissão do usuário. Caso o usuário conectado não tiver permissão de acesso a um dos menus, o mesmo será ocultado.

a. WebServices Unimed X GPS 

Este menu possibilita realizar a manutenção dos registros referentes aos endpoints e tokens relacionados ao CMB e ao Software de Pacotes, e também as parametrizações do Cartão Virtual. Sua permissão de acesso necessita do direito de menu hgp.endpointRegistration.


Principais campos e Parâmetros CMB e Software de Pacotes

Campo

Descrição

UsuárioCódigo do usuário.
SenhaSenha do usuário.
Endpoint CMBURL que contêm o endpoint CMB.
Token CMBToken referente ao endpoint CMB.
Endpoint Classificação da RedeURL que contêm o endpoint Classificação da Rede.
Token Classificação da RedeToken referente ao endpoint Classificação da Rede.
Endpoint Software de PacotesURL que contêm o endpoint Software de Pacotes.
Token Software de Pacotes

Token referente ao endpoint Software de Pacotes.


Principais campos e Parâmetros Cartão Virtual

CampoDescrição
Integração com TokenSe a integração com token está ativa ou não
UsuárioCódigo do Usuário.
SenhaSenha do Usuário.
EndpointURL que contêm o endpoint do token.
TokenToken referente ao endpoint.

b. Reconhecimento Facial 

Este menu possibilita realizar a manutenção do registro referente ao sistema de integração para reconhecimento facial. Sua permissão de acesso necessita do direito de menu hac.facialRecognitionParam.

Principais campos e Parâmetros  

CampoDescrição
Acuracidade AceitávelPercentual de acuracidade aceitável para a validação de autenticidade da face do beneficiário. (Mínimo 65%).
Sistema de IntegraçãoSistema utilizado para realizar o reconhecimento facial.
Token\Carol Connector IDToken ou conector referente à autenticação das API's do sistema selecionado.
URL API'sCaminho das API's de integração do sistema selecionado.

c. Carol 

Este menu possibilita realizar a manutenção do registro referente ao sistema de integração Carol. Sua permissão de acesso necessita do direito de menu hac.carolIntegrationParam.

Principais campos e Parâmetros  

Campo

Descrição

UsuárioNome do usuário.
Senha Senha do usuário.
URLCaminho das API's de integração do sistema selecionado.
PathCaminho das requisições de autenticação. 
TokenToken referente à autenticação das API's do sistema selecionado.
SubdomínioNome do Subdomínio 

d. Gestão de Protocolos - GPU 

Este menu possibilita realizar a manutenção do registro referente ao sistema de integração GPU com o GIU. Sua permissão de acesso necessita do direito de menu hgp.endpointRegistration.


Principais campos e Parâmetros  

Campo

Descrição

Integração com GPUIdentifica se a integração está ativa ou não.
UsuárioUsuário de acesso.
Senha Senha do usuário.
Endpoint de serviçoEndpoint de serviço de acesso ao GPU
Endpoint de autenticaçãoEndpoint parametrizado para geração do token de acesso ao GPU 
Endpoint de validação do tokenEndpoint parametrizado para validar o token de acesso recebido pelo GIU
  • Os valores referentes aos endpoints se encontram atualizados no manual de integração do PTU da Unimed Brasil. Os valores abaixo são referentes aos endpoints presentes até a versão 6.2:

e. Gestão de Protocolos - GPU 

Documentação em construção...

f. Saúde Pay

Este menu tem a funcionalidade de manter as configurações provenientes dos dados necessários para o correto funcionamento dos modos de pagamento Cartão de Crédito ou Débito, Pix Instantâneo e Pix Cobrança. Para que o mesmo esteja habilitado na tela, o usuário deve ter em seu cadastro de permissão acesso a tela hgp.totvsPaymentDigital.

f-1. Saúde Pay - Guia Conciliador

Nesta guia são informados os dados necessários para que a integração do ambiente de conciliação possa se comunicar com o ambiente EMS.

Tipo de AmbienteEspecificação do tipo de ambiente que está sendo executado que foi informado no campo HostName
HostNameEndereço do ambiente do conciliador que está em execução
PortaPorta do endereço do ambiente do conciliador que está em execução
UsuárioUsuário utilizado pela integração dos dados do Conciliador com o EMS
SenhaSenha do usuário utilizado pela integração dos dados do Conciliador com o EMS

f-2. Saúde Pay - Guia Totvs Pag

Nesta guia são informados dados referentes ao token do adquirente que fez a intermediação do sistema com a operadora de Cartão de Crédito.

Token ClientToken client utilizado para a integração
Token ApplicationToken application utilizado para a integração

f-3. Saúde Pay - Guia Totvs Pagamento Digital

TenantNome da instância tenant do gerenciador multitenancy do banco de dados
UsuárioUsuário da API utilizado pela integração dos dados do Conciliador com a Carteira
SenhaSenha do usuário da API utilizado pela integração dos dados do Conciliador com o Carteira
Client IDIdentificador do registro do usuário no serviço da Carteira
Client SecretChave privada do registro do usuário no serviço da Carteira
ID Externo Unidade NegócioIdentificador da transação para o utilizador da API
ID Externo Ponto de VendaIdentificador externo do ponto de venda cadastrado no Configuring.App
CarteiraIdentificação do serviço de terceiro responsável pela integração de pagamentos digitais


g. PTU A510

Este menu possibilita realizar a manutenção do registro referente ao sistema de integração PTU A510 com o processo de Baixas de Inadimplência da Unimed Brasil. Sua permissão de acesso necessita do direito de menu hgp.endpointRegistration.

Serviço

Endpoint do serviço

URL do serviço para o processo de Baixas de Inadimplência da Unimed Brasil

Última alteração

Serviço - Endpoint do serviçoUsuário que realizou a última alteração no parâmetro
Última alteração Usuário

Data em que o foi realizada a última alteração deste parâmetro


h. Pré-Cadastro 

Este menu possibilita realizar a manutenção do registro referente ao sistema de integração de Pré-Cadastro de Beneficiários (CADBENEF).

Sua permissão de acesso necessita do direito de menu hvp.beneficiaryRegister:



Principais campos e Parâmetros  

Campo

Descrição

IntegraçãoIdentifica se a integração está ativa
UsuárioUsuário de acesso
Senha Senha do usuário
Endpoint de serviçoEndpoint de serviço de acesso ao Pré-Cadastro de Beneficiários (CADBENEF)
Endpoint de autenticaçãoEndpoint parametrizado para geração do token de acesso ao Pré-Cadastro de Beneficiários (CADBENEF)
Enviar CarênciasPermite configurar se as carências serão consideradas no envio dos dados
ModalidadesPermite configurar quais modalidades serão consideradas no envio dos dados 


  • Os valores referentes aos endpoints se encontram atualizados no manual de integração do PTU da Unimed Brasil. Os valores abaixo são referentes aos endpoints presentes até a versão 6.8:


i. PTU Online

Este menu possibilita realizar o registro dos endpoints utilizados no sistema de Transações entre unidades, para que o sistema realize o processo via TOMCAT, atualmente o processo é realizado via Foundation Saúde, ambos serviços estarão disponíveis.

Acessando o menu "Central de Integrações Saúde Planos - hgp.integrationsParam", navegando até o menu lateral "PTU Online" para 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. 
  1. Navegue até o menu lateral "PTU Online"


  2. Preencha com o endereço url o campo relacionado ao serviço.

     


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

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




Principais campos e Parâmetros  

Campo

Descrição

URL de ComunicaçãoEndpoint do serviço de comunicação TOMCAT. 
VersãoVersão PTU. 
Pedido de Autorização (0600)Endpoint do serviço de Pedido de Autorização (0600).
Pedido de Complemento de Autorização (0605)Endpoint do serviço de Pedido de Complemento de Autorização (0605).
Pedido de Insistencia (0302)Endpoint do serviço de Pedido de Insistência (0302).
Resposta de Auditoria (0404)Endpoint do serviço de Resposta de Auditoria (0404).
Cancelamento (0311)Endpoint do serviço de Cancelamento (0311).
Consulta de Dados do Beneficiário (0412)Endpoint do serviço de Consulta de Dados do Beneficiário (0412).
Status da Transação (0360)Endpoint do serviço de Status da Transação (0360).
Comunicação de Decurso de Prazo (0700)Endpoint do serviço de Comunicação de Decurso de Prazo (0700).
Comunicação de Internação ou Alta (0750)Endpoint do serviço de Comunicação de Internação ou Alta (0750).
Ordem de Serviço (0806)Endpoint do serviço de Ordem de Serviço (0806).
Autorização de Ordem de Serviço (0804)Endpoint do serviço de Autorização de Ordem de Serviço (0804).
Consulta de Dados do Prestador (0418)Endpoint do serviço de Consulta de Dados do Prestador (0418).
Contagem de Beneficiários (0430)Endpoint do serviço de Contagem de Beneficiários (0430).
Transações Respondidas pelo WSD (1100)Endpoint do serviço de Transações Respondidas pelo WSD (1100).
UsuárioUsuário da ultima atualização. 
Data Data da ultima atualização. 


j. HUB de Guias

Este menu possibilita realizar a parametrização da integração com o HUB de Guias do sistema Unimed-RS.

Sua permissão de acesso necessita do direito de menu hat.sendGuidesHubParams.


Principais campos e Parâmetros  

Campo

Descrição

IntegraçãoIdentifica se a integração está ativa ou não.
UsuárioUsuário de acesso.
Senha Senha do usuário.
Client IDId de acesso.
Endpoint de autenticaçãoEndpoint de autenticação com o usuário e senha informados anteriormente e geração do token para acesso aos demais serviços.
Endpoint de inclusão de guiasEndpoint de envio das guias para o HUB
Endpoint de envio de execuçãoEndpoint de envio de execução/baixa de procedimentos para o HUB
Endpoint de busca por guiaEndpoint de busca de guia pelo seu código
Endpoint de busca por carteiraEndpoint de busca de guias pela carteira do beneficiário
Tipo de guia ao carregar dadosTipo de guia utilizado ao importar os dados da guia retornados do HUB, deve ser exclusivamente de exames, podendo ser selecionado mais que uma. Para definição de Exames, é necessário que no cadastro "Manutenção Associativa Classe de Atendimento" o tipo de guia esteja vinculada a classe de nota 2 - Exames SADT.
Local de autorizaçãoLocal de autorização utilizado ao importar guia do HUB. 

k. PTU Movimentação

Este menu possibilita realizar a manutenção do registro referente ao sistema de integração do PTU Movimentação (PTU-INTEGRATIONS-PARAMS).

Sua permissão de acesso necessita do direito de menu hgp.ptuMovement:



Principais campos e Parâmetros  

Campo

Descrição

IntegraçãoIdentifica se a integração está ativa.
UsuárioUsuário de acesso.
Senha Senha do usuário.
Endpoint de autenticaçãoEndpoint de autenticação.
Endpoint do serviço de beneficiáriosEndpoint do serviço de Movimentação de Beneficiários.
Endpoint do serviço de contratosEndpoint do serviço de Movimentação de Contratos.
Endpoint do serviço de repasse de pré-pagamento (A800)Endpoint do serviço de repasse de pré-pagamento (A800)
ModalidadesPermite configurar quais modalidades serão consideradas no envio dos dados.
Enviar contratos

Indica se a opção para envio do contrato, da massa inicial dos beneficiários e o encerramento do contrato está habilitado.

Essa opção somente estará disponível com a versão 02.2025 do PTU.

Envia Campos Opcionais

Indica se campos considerados opcionais de produtos não assistenciais, como medicina ocupacional, auto gestão e APS serão enviados.

Cálculo de carência deve ser a nível de módulo

Indica se as carências devem ser calculadas a nível de módulo.

Enviar atualização de beneficiários ao alterar o plano, proposta ou contratante

Indica se ao alterar o plano, proposta ou contratante deve ser enviados atualizações de beneficiários 

Motivo de suspensão

Indica o motivo de suspensão padrão para os beneficiários de compartilhamento de risco recebidos em situação de suspensão de atendimento.

Endpoint de validação do tokenEndpoint parametrizado para validar o token de acesso recebido pelo GIU
Usuário de validação do tokenUsuário para validação de token (mesmo usado no GPU)
Senha de validação do tokenSenha para validação de token (mesmo usado no GPU)
VersãoIndica a versão do processo de PTU Integrações que será considerado pelo sistema


URLs do serviço


Scripts de parâmetros opcionais

Desabilitar validação do token
find first param-geral
           where param-geral.cod-indic-tab    = "PTU-INTEGRATIONS-PARAMS"
             and param-geral.cod-param        = "bypassTokenAuth"
      exclusive-lock no-error.
      
      
if not avail param-geral
then do:
    create param-geral.
    assign param-geral.cod-indic-tab    = "PTU-INTEGRATIONS-PARAMS"
           param-geral.cod-param        = "bypassTokenAuth".

end.


assign param-geral.des-param = "true".
Habilitar informações de debug
find first param-geral
           where param-geral.cod-indic-tab    = "PTU-INTEGRATIONS-PARAMS"
             and param-geral.cod-param        = "isDebugEnabled"
      exclusive-lock no-error.
      
      
if not avail param-geral
then do:
    create param-geral.
    assign param-geral.cod-indic-tab    = "PTU-INTEGRATIONS-PARAMS"
           param-geral.cod-param        = "isDebugEnabled".

end.


assign param-geral.des-param = "true". //Por padrão deve ser false. Usar com true apenas para coleta de informações.
  • Sem rótulos