Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

  1. Visão Geral
  2. Configuração Integração GPU com GIU
    Integração GPU com HMR
    1. Certificado HTTPS 
    2. HTTPS 
    3. Ambiente TOMCATAmbiente JBOSS
    4. 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 
Âncora
visao_geral
visao_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 
Âncora
configuracao
configuracao

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:
EndpointAmbiente de HomologaçãoAmbiente de Produção
Serviçohttps://gpupainelhml.unimed.coop.br/gpu-core/resthttps://gpupainel.unimed.coop.br/gpu-core/rest
Autenticaçãohttps://giuapihml.unimed.coop.br/api/tokenhttps://giuapi.unimed.coop.br/api/token
Validação do Tokenhttps://autenticacaoreversahml.unimed.coop.br/api/tokenhttps://autenticacaoreversa.unimed.coop.br/api/token


...

a. Certificado HTTPS
Âncora

...

https

...

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
Âncora
tomcat
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
Âncora

...

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çoEndpoint
Solicitar Protocolosolicitar-protocolo
Responder Atendimentoresposta-atendimento
Cancelar Protocolocancelamento
Complementar Protocolocomplemento-protocolo
Consultar Status do Protocoloconsulta-status
Consultar Histórico do Beneficiárioconsulta-historico
Encaminhar Execuçãoencaminhar-execucao
Solicitação Protocolo Não Clientesolicitar-protocolo-nao-cliente
Responder Protocolo Não Clienteresposta-atendimento-nao-cliente

03. AUTENTICAÇÃO REVERSA
Âncora
autenticacao
autenticacao

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 
Âncora
endpoints
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 
Âncora
info
info


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>

...