...
- Visão Geral
- Configuração Integração GPU com GIU
Integração GPU com HMR- Certificado HTTPS
- HTTPS
- Ambiente TOMCATAmbiente JBOSS
- Serviços e Endpoints
- Autenticação Reversa
- 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.
...
Essa Também é necessário ressaltar que essa implementação é expedida juntamente com o TOTVS12, não sendo mais necessário atualizar a aplicação foundation.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 Removedno programa Central de Integrações Saúde Planos (hgp.integrationsParams) na opção de menu GPU.
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
...
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. Na sessão abaixo de Demais Informações foi colocado um link para documentação de geração e configuração de um 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 deverão 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 documentação Configurar servidor de aplicação TOMCAT - colocado na sessão abaixo de Demais Informações.
c.
...
Serviços e Endpoints
...
Os endpoints para o ambiente JBOSS deverão ser parametrizados da seguinte forma: /healthmanagementwebservices/rest/gpu/acao
Exemplos:
- https://138.219.88.165/healthmanagementwebservices/rest/gpu/endpoint/solicitar-protocolo
- https://138.219.88.165/healthmanagementwebservices/rest/gpu/endpoint/cancelamento
Para correta configuração do ambiente JBOSS, os passos estão descritos na documentação das propriedades do sistema, na sessão SSO - colocado na sessão abaixo de Demais Informações.
...
Foram adicionados os novos campos nas telas de Manter Motivos de Atendimento (hmr.CallMotiveView) e Manter Categorias de Atendimento (hmr.CallCategoryView), sendo eles:
...
- 7 - Correção reportada
- 8 - Solicitação recebida pelo WhatsApp
...
- 22 - Guias pendentes fora do Prazo de resposta
- 23 - Pedido de Autorização
...
- 24 - Extrato de utilização
...
- 20 - Especialidade/Serviço Incorreto
- 21 - Prestador não atende o plano
| 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.
...
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>
|
...