Integração GPU com o GIU

CONTEÚDO

1. Visão Geral
2. Configuração Integração GPU com GIU
   
   1. Certificado HTTPS 
   2. Ambiente TOMCAT
   3. Serviços e Endpoints
3. Autenticação Reversa
4. Endpoints
   1. Solicitação de Protocolo
      
   2. Resposta Atendimento
   3. Cancelamento de Atendimento
   4. Complemento Protocolo
   5. Status Protocolo
   6. Histórico Protocolo
   7. Encaminhar Execução
   8. Solicitar Protocolo Não Cliente
5. Demais Informações

01. VISÃO GERAL 

Integração do GPU (Gestão de Protocolos Unimed) com o GIU (Gestão Institucional Unimed), plataforma que possibilita o acesso às ferramentas institucionais do sistema da Unimed. 

O processo na utilização dos programas continuará o mesmo, apenas as configurações do sistema precisam ser ajustadas. Também é necessário ressaltar que essa implementação é expedida juntamente com o TOTVS12, não sendo mais necessário atualizar a aplicação externa FOUNDATION.

02. CONFIGURAÇÃO INTEGRAÇÃO GPU COM GIU 

Para realizar a integração do GPU com GIU, necessário adicionar as informações no programa Central de Integrações Saúde Planos (hgp.integrationsParams) na opção de menu GPU.

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

• Para demais informações, consultar a documentação da Central de Integrações Saúde Planos.

a. Certificado HTTPS

Conforme a Unimed do Brasil define, os servidores do cliente que receberão as requisições do ambiente da Unimed necessitam ter o certificado HTTPS. Vale ressaltar que a configuração ao acesso dos endpoints no ambiente local deverá ser verificada com a própria Unimed do Brasil (são eles que cadastram essas informações).

Para maiores informações de instalação e configuração de um certificado HTTPS, verifique Datasul com HTTPS para TOMCAT.

b. Ambiente TOMCAT

Os endpoints para o ambiente TOMCAT devem ser parametrizados da seguinte forma: /totvs-hgp-webservices/gpu/v1/acao

Os serviços e endpoints disponíveis estão na sessão Serviços e Endpoints.

Exemplos:

• https://138.219.88.165/totvs-hgp-webservices/gpu/v1/solicitar-protocolo
• https://138.219.88.165/totvs-hgp-webservices/gpu/v1/cancelamento

Para correta configuração do ambiente TOMCAT, os passos estão descritos na documentação Configurar servidor de aplicação TOMCAT.

c. Serviços e Endpoints

Para parametrização na Unimed Brasil, deverão ser colocados os serviços com seus endpoints respectivos (com a URL completa, como descrito acima nos exemplos para Ambiente TOMCAT).

Para detalhes de cada serviço, sua descrição está na sessão Endpoints.

03. AUTENTICAÇÃO REVERSA

Conforme a URL a ser preenchida no campo Endpoint de validação do token na tela  Central de Integrações Saúde Planos, esta é utilizada para realização da autenticação reversa com o GPU.

Dessa forma, como as requisições provenientes do GIU possuem o bearer token e o cookie da solicitação, estes valores serão autenticados na URL parametrizada. Caso o status retornado seja diferente de 200 (STATUS OK) a requisição irá retornar erro impedindo o processamento da solicitação, caso contrário o fluxo irá prosseguir normalmente.

04. ENDPOINTS 

a. Solicitar Protocolo de Atendimento 

Envia uma mensagem para a Unimed de uma manifestação de um beneficiário, cujo retorno é um protocolo conforme padrão ANS.

b. Responder Atendimento 

Envia mensagem para a Unimed relativo à resposta de manifestação de seu beneficiário.

c. Cancelar Atendimento 

Envia uma mensagem para a Unimed que cancela o atendimento.

d. Complemento Protocolo

Receber uma solicitação para complementar uma ocorrência, com isso, é possível também fazer a associação dela com uma guia de autorização.

e. Status Protocolo 

Envia uma mensagem para a Unimed referente à consulta de status de um protocolo existente.

f. Histórico Protocolo 

Envia uma mensagem para a Unimed referente à consulta do histórico de protocolos do beneficiário.

g. Encaminhar Execução

Envia uma mensagem da Unimed Origem do Beneficiário para a Unimed Repasse resolver uma manifestação (conforme acordo prévio entre as Singulares). No cenário descrito, a Unimed Origem já enviou o número do Protocolo para a Unimed Solicitante e apenas está encaminhando a manifestação para resolução da Unimed Repasse.

h. Solicitar Protocolo Não Cliente 

Envia uma mensagem para a Unimed responsável pela área de atuação informada pelo "não cliente".

Para configuração deste endpoint, verificar a documentação de liberação: DT GPU - Solicitar Protocolo Não Cliente - CRM

i. Responder Protocolo Não Cliente 

Enviar uma mensagem para a Unimed referente à resposta de manifestação de um não cliente.

Este endpoint é acionado na resposta ou solução de um protocolo não cliente no CRM.

Não requer configurações, pois é acionado apenas para protocolos não cliente, cuja as configurações são citadas no item "H".

05. DEMAIS INFORMAÇÕES 

• Central de Integrações Saúde Planos
• Datasul com HTTPS para TOMCAT
• Importação de Certificado HTTPS

• Configurar servidor de aplicação TOMCAT

• DMANADVEN-11894 - Adequação dos Valores Tipo Manifestação e Categoria Manifestação