CONTEÚDO
- Visão Geral
- Configuração Integração GPU com GIU
- Certificado HTTPS
- Ambiente TOMCAT
- Serviços e Endpoints
- Autenticação ReversaExemplo de utilização
- Endpoints
- Solicitação de Protocolo
- Resposta Atendimento
- Cancelamento de Atendimento
- Complemento Protocolo
- Status Protocolo
- Histórico Protocolo
- Encaminhar Execução
- Solicitar Protocolo Não Cliente
- 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 na página hgp.endpointRegistration:
Image RemovedPara mais informações, ler o item 2, letra d da seguinte documentação: no programa Central de Integrações Saúde Planos (hgp.integrationsParams) na opção de menu GPU.
Os serviço jboss está disponível em:
...
Image Added
- 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 |
- 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.
| Informações |
|---|
Observação: Os certificados não podem ser auto assinados e, além disso, devem estar na data de validade para correta integração. |
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; (Exemplo: /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 | Âncora |
|---|
| serv_endpoints |
|---|
| serv_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.
| Serviço | Endpoint |
| Solicitar Protocolo | solicitar-protocolo |
| Responder Atendimento | resposta-atendimento |
| Cancelar Protocolo | cancelamento |
| Complementar Protocolo | complemento-protocolo |
| Consultar Status do Protocolo | consulta-status |
| Consultar Histórico do Beneficiário | consulta-historico |
| Encaminhar Execução | encaminhar-execucao |
| Solicitação Protocolo Não Cliente |
...
| solicitar-protocolo-nao-cliente |
| Responder Protocolo Não Cliente | resposta-atendimento-nao-cliente |
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 | Âncora |
|---|
| solicitar_protocolo |
|---|
| solicitar_protocolo |
|---|
|
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 | Âncora |
|---|
| responder_atendimento |
|---|
| responder_atendimento |
|---|
|
Envia mensagem para a Unimed relativo à resposta de manifestação de seu beneficiário.
c. Cancelar
...
Atendimento | Âncora |
|---|
| cancelar_atendimento |
|---|
| cancelar_atendimento |
|---|
|
Envia uma mensagem para a Unimed que cancela o atendimento.
d. Complemento Protocolo| Âncora |
|---|
| complemento_protocolo |
|---|
| 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 | Âncora |
|---|
| status_protocolo |
|---|
| status_protocolo |
|---|
|
Envia uma mensagem para a Unimed referente à consulta de status de um protocolo existente.
f. Histórico Protocolo | Âncora |
|---|
| historico_protocolo |
|---|
| historico_protocolo |
|---|
|
Envia uma mensagem para a Unimed referente à consulta do histórico de protocolos do beneficiário.
g. Encaminhar Execução| Âncora |
|---|
| encaminhar_execucao |
|---|
| encaminhar_execucao |
|---|
|
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 | Âncora |
|---|
| solicitar_protocolo_nao_cliente |
|---|
| solicitar_protocolo_nao_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 | Âncora |
|---|
| responder_protocolo_nao_cliente |
|---|
| responder_protocolo_nao_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
| HTML |
|---|
<!-- esconder o menu -->
<style>
div.theme-default .ia-splitter #main {
margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
display: none;
}
#main {
padding-left: 10px;
padding-right: 10px;
overflow-x: hidden;
}
.aui-header-primary .aui-nav, .aui-page-panel {
margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
margin-left: 0px !important;
}
</style>
|
...