CONTEÚDO
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ário | Código do usuário. |
Senha | Senha do usuário. |
Endpoint CMB | URL que contêm o endpoint CMB. |
Token CMB | Token referente ao endpoint CMB. |
Endpoint Classificação da Rede | URL que contêm o endpoint Classificação da Rede. |
Token Classificação da Rede | Token referente ao endpoint Classificação da Rede. |
Endpoint Software de Pacotes | URL 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
Campo | Descrição |
Integração com Token | Se a integração com token está ativa ou não |
Usuário | Código do Usuário. |
Senha | Senha do Usuário. |
Endpoint | URL que contêm o endpoint do token. |
Token | Token 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
Campo | Descrição |
Acuracidade Aceitável | Percentual de acuracidade aceitável para a validação de autenticidade da face do beneficiário. (Mínimo 65%). |
Sistema de Integração | Sistema utilizado para realizar o reconhecimento facial. |
Token\Carol Connector ID | Token ou conector referente à autenticação das API's do sistema selecionado. |
URL API's | Caminho 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ário | Nome do usuário. |
Senha | Senha do usuário. |
URL | Caminho das API's de integração do sistema selecionado. |
Path | Caminho das requisições de autenticação. |
Token | Token referente à autenticação das API's do sistema selecionado. |
Subdomínio | Nome 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 GPU | Identifica se a integração está ativa ou não. |
Usuário | Usuário de acesso. |
Senha | Senha do usuário. |
Endpoint de serviço | Endpoint de serviço de acesso ao GPU |
Endpoint de autenticação | Endpoint parametrizado para geração do token de acesso ao GPU |
Endpoint de validação do token | Endpoint 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:
Endpoint | Ambiente de Homologação | Ambiente de Produção |
---|---|---|
Serviço | https://gpupainelhml.unimed.coop.br/gpu-core/rest | https://gpupainel.unimed.coop.br/gpu-core/rest |
Autenticação | https://giuapihml.unimed.coop.br/api/token | https://giuapi.unimed.coop.br/api/token |
Validação do Token | https://autenticacaoreversahml.unimed.coop.br/api/token | https://autenticacaoreversa.unimed.coop.br/api/token |
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 Ambiente | Especificação do tipo de ambiente que está sendo executado que foi informado no campo HostName |
---|---|
HostName | Endereço do ambiente do conciliador que está em execução |
Porta | Porta do endereço do ambiente do conciliador que está em execução |
Usuário | Usuário utilizado pela integração dos dados do Conciliador com o EMS |
Senha | Senha 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 Client | Token client utilizado para a integração |
---|---|
Token Application | Token application utilizado para a integração |
f-3. Saúde Pay - Guia Totvs Pagamento Digital
Tenant | Nome da instância tenant do gerenciador multitenancy do banco de dados |
---|---|
Usuário | Usuário da API utilizado pela integração dos dados do Conciliador com a Carteira |
Senha | Senha do usuário da API utilizado pela integração dos dados do Conciliador com o Carteira |
Client ID | Identificador do registro do usuário no serviço da Carteira |
Client Secret | Chave privada do registro do usuário no serviço da Carteira |
ID Externo Unidade Negócio | Identificador da transação para o utilizador da API |
ID Externo Ponto de Venda | Identificador externo do ponto de venda cadastrado no Configuring.App |
Carteira | Identificaçã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ço | Usuá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ção | Identifica se a integração está ativa |
Usuário | Usuário de acesso |
Senha | Senha do usuário |
Endpoint de serviço | Endpoint de serviço de acesso ao Pré-Cadastro de Beneficiários (CADBENEF) |
Endpoint de autenticação | Endpoint parametrizado para geração do token de acesso ao Pré-Cadastro de Beneficiários (CADBENEF) |
Enviar Carências | Permite configurar se as carências serão consideradas no envio dos dados |
Modalidades | Permite 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:
Endpoint | Ambiente de Homologação | Ambiente de Produção |
---|---|---|
Serviço | https://cadbenefapigiuhml.unimed.coop.br/api/ativacao-pre-cadastro | https://cadbenefapigiu.unimed.coop.br/api/ativacao-pre-cadastro |
Autenticação | https://giuapihml.unimed.coop.br/api/token | https://giuapi.unimed.coop.br/api/token |
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.
- Navegue até o menu lateral "PTU Online"
- 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ção | Endpoint do serviço de comunicação TOMCAT. |
Versão | Versã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ário | Usuá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ção | Identifica se a integração está ativa ou não. |
Usuário | Usuário de acesso. |
Senha | Senha do usuário. |
Client ID | Id de acesso. |
Endpoint de autenticação | Endpoint 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 guias | Endpoint de envio das guias para o HUB |
Endpoint de envio de execução | Endpoint de envio de execução/baixa de procedimentos para o HUB |
Endpoint de busca por guia | Endpoint de busca de guia pelo seu código |
Endpoint de busca por carteira | Endpoint de busca de guias pela carteira do beneficiário |
Tipo de guia ao carregar dados | Tipo 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ção | Local 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ção | Identifica se a integração está ativa. |
Usuário | Usuário de acesso. |
Senha | Senha do usuário. |
Endpoint de autenticação | Endpoint de autenticação. |
Endpoint do serviço de beneficiários | Endpoint do serviço de Movimentação de Beneficiários. |
Endpoint do serviço de contratos | Endpoint 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) |
Modalidades | Permite 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 token | Endpoint parametrizado para validar o token de acesso recebido pelo GIU |
Usuário de validação do token | Usuário para validação de token (mesmo usado no GPU) |
Senha de validação do token | Senha para validação de token (mesmo usado no GPU) |
Versão | Indica a versão do processo de PTU Integrações que será considerado pelo sistema |
URLs do serviço
Scripts de parâmetros opcionais