01. DADOS GERAIS
Produto: | TOTVS Saúde Planos
|
---|---|
Linha de Produto: | Linha Protheus |
Segmento: | Saude |
Módulo: | PLANO DE SAÚDE (SIGAPLS) |
Função: | Protocolo de Negativas (PLSA773) API GPU (PLSGPURest) |
Ticket: | 10771696 |
Requisito/Story/Issue (informe o requisito relacionado) : | DSAUBE-13814 |
02. SITUAÇÃO/REQUISITO
Necessidade de implementar integração com o GPU - Gestão de Protocolos Unimed através de API REST, substituindo a integração via Web Service Soap.
03. SOLUÇÃO
Implementada melhoria no processo da RNº 395 para Operadoras Cooperativas Médicas Unimed, onde Foram criados serviços REST, para gerenciamento de protocolos de atendimento de beneficiários de intercâmbio.
Configuração REST
Para iniciar a instalação do processo, devemos configurar seu INI Protheus com a funcionalidade REST para habilitar o acesso as API´s.
Com o INI Protheus configurado, a nomenclatura das API´s ficará no formato: <url + Porta + Chave rest definidos no INI Protheus> + PLSGPUREST/v1/ + <nome da API>
Importante: Para funcionamento correto do processo de comunicação com o GPU, é necessário configurar o REST na porta 443 e o Endpoint tem que ter o nome domínio do certificado, Exemplo:
https://gpu.xx.unimed.com.br/rest/PLSGPUREST/v1/cancelarAtendimento
Endpoints do GPU - Gestão de Protocolos Unimed
Solicite para a Unimed do Brasil, os Endpoints em Produção do GPU, para que seja informado nos seguintes parâmetros (SX6):
MV_R395SOL | Solicitar Protocolo de Atendimento - Beneficiário |
MV_R395COM | Complementar Protocolo de Atendimento |
MV_R395RES | Responder Atendimento |
MV_R395STA | Consulta Status de Protocolo |
MV_R395HIS | Consultar Histórico do Protocolo |
MV_R395CAN | Cancelar Atendimento |
MV_R395ENC | Encaminhar Execução da Manifestação |
Observação: Para habilitar a API de envio para os Endpoints do GPU, deverá ser ativado o parâmetro MV_PGPURES com o conteúdo igual a "1".
Autenticação de Usuário para o GPU
Para que seja realizada uma requisição a API do GPU, deverá ser realizado a autenticação de uma Conta de Serviço ou Aplicação no GIU:
Operação: Obter Token a partir de login e senha
No Remote, os dados de Login, Senha e Enpoint deveram ser informados no Cadastro de Operadoras de Saúde, na Aba Integrações Unimed:
Login GIU: Login do usuário no GIU/Client ID
Senha GIU: Senha do usuário no GIU / Client Secret
EndPoint GIU: Endpoint Produção da Unimed Brasil
Bearer GIU: Token de autenticação
Cookie GIU: Cookie utilizado para Autenticação
Tempo Exper.: Tempo para expiração do Token. no Formato: Data|Segundos
Observação: Os campos de Bearer, Cookie e Tempo Exper. serão preenchidos automaticamente pelo sistema ao realizar alguma requisição ao GPU. Na questão de expiração do acesso, o sistema irá sempre verificar o campo Tempo Exper. para verificar se será solicitado um novo Token de acesso.
Serviços disponíveis para Integração GPU:
Serviço de Solicitação Protocolo de Atendimento - Beneficiário
Objetivo: Disponibilizar o serviço “Solicitar Protocolo de Atendimento - Beneficiário”.
Enviar uma mensagem para a Unimed referente à uma manifestação de seu beneficiário. O retorno da mensagem será um Protocolo conforme padrão ANS.
Operação: solicitarProtocolo
Endpoint: https://<url>:<porta>/rest/PLSGPUREST/v1/solicitarProtocolo
Tipo: Rest Full
Método requisição: POST
Método resposta: GET
Status Code:
200 - Processado com sucesso!
400 - Dados com erro, verificar o manual de integração da Unimed o tipo de erro que foi retornado através do atributo "id_erro".
Serviço Complementar Protocolo de Atendimento
Objetivo: Disponibilizar o serviço “Complementar Protocolo de Atendimento”.
Enviar uma mensagem para a Unimed referente à uma manifestação de seu beneficiário. Essa mensagem poderá ser vinculada à uma transação de Intercâmbio entre as Unimeds e/ou a um protocolo de atendimento existente.
Operação: complementaProtocolo
Endpoint: https://<url>:<porta>/rest/PLSGPUREST/v1/complementaProtocolo
Tipo: Rest Full
Método requisição: POST
Método resposta: GET
Status Code:
200 - Processado com sucesso!
400 - Dados com erro, verificar o manual de integração da Unimed o tipo de erro que foi retornado através do atributo "id_erro".
Serviço Responder Atendimento
Objetivo: Disponibilizar o serviço “Responder Atendimento”.
Enviar uma mensagem para a Unimed referente à resposta de manifestação de seu beneficiário.
Operação: responderAtendimento
Endpoint: https://<url>:<porta>/rest/PLSGPUREST/v1/responderAtendimento
Tipo: Rest Full
Método requisição: POST
Método resposta: GET
Status Code:
200 - Processado com sucesso!
400 - Dados com erro, verificar o manual de integração da Unimed o tipo de erro que foi retornado através do atributo "id_erro".
Consultar Status do Protocolo
Objetivo: Disponibilizar o serviço “Consulta Status de Protocolo”.
Enviar uma mensagem para a Unimed referente à consulta de status de um protocolo existente.
Operação: consultaStatusProtocolo
Endpoint: https://<url>:<porta>/rest/PLSGPUREST/v1/consultaStatusProtocolo
Tipo: Rest Full
Método requisição: POST
Método resposta: GET
Status Code:
200 - Processado com sucesso!
400 - Dados com erro, verificar o manual de integração da Unimed o tipo de erro que foi retornado através do atributo "id_erro".
Consultar Histórico do Protocolo
Objetivo: Disponibilizar o serviço “Consultar Historico do Protocolo”.
Enviar uma mensagem para a Unimed referente à consulta do histórico de protocolos do beneficiário
Operação: historicoProtocoloConsulta
Endpoint: https://<url>:<porta>/rest/PLSGPUREST/v1/historicoProtocoloConsulta
Tipo: Rest Full
Método requisição: POST
Método resposta: GET
Status Code:
200 - Processado com sucesso!
400 - Dados com erro, verificar o manual de integração da Unimed o tipo de erro que foi retornado através do atributo "id_erro".
Cancelar Atendimento
Objetivo: Disponibilizar o serviço “Cancelar Atendimento”.
Enviar uma mensagem de cancelamento para a Unimed.
Operação: cancelarAtendimento
Endpoint: https://<url>:<porta>/rest/PLSGPUREST/v1/cancelarAtendimento
Tipo: Rest Full
Método requisição: POST
Método resposta: GET
Status Code:
200 - Processado com sucesso!
400 - Dados com erro, verificar o manual de integração da Unimed o tipo de erro que foi retornado através do atributo "id_erro".
Encaminhar Execução
Objetivo: Disponibilizar o serviço “Encaminhar Execução da Manifestação”.
Enviar uma mensagem da Unimed Origem do Beneficiário para a Unimed Repasse resolver uma manifestação (conforme acordo prévio entre as Singulares). O retorno da mensagem será uma Confirmação de recebimento e uma posterior Resposta do Atendimento pela Unimed Repasse. Detalhes em: RN 395 – Fluxo REPASSE.
Premissa: 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.
Operação: encaminharExecucao
Endpoint: https://<url>:<porta>/rest/PLSGPUREST/v1/encaminharExecucao
Tipo: Rest Full
Método requisição: POST
Método resposta: GET
Status Code:
200 - Processado com sucesso!
400 - Dados com erro, verificar o manual de integração da Unimed o tipo de erro que foi retornado através do atributo "id_erro".
Inclusão no Arquivo SX3 - Campos:
Campo | Tipo | Tamanho | Decimal | Titulo | Descrição | Picture | Usado | Exibe Browser | Visual? | Contexto | Obrigatório | Pasta SXA |
---|---|---|---|---|---|---|---|---|---|---|---|---|
BA0_USRGIU | Caracter | 20 | 0 | Login GIU | Login do usuario no GIU | Sim | Não | Alterar | Real | Não | 6 | |
BA0_PASGIU | Caracter | 50 | 0 | Senha GIU | Senha do usuario no GIU | Sim | Não | Alterar | Real | Não | 6 | |
BA0_ENDGIU | Caracter | 60 | 0 | EndPoint GIU | EndPoint GIU | Sim | Não | Alterar | Real | Não | 6 | |
BA0_BEAGIU | Memo | 10 | 0 | Bearer GIU | Bearer Retorno GIU | Sim | Não | Visualizar | Real | Não | 6 | |
BA0_COOGIU | Memo | 10 | 0 | Cookie GIU | Cookie de Retorno GIU | Sim | Não | Visualizar | Real | Não | 6 | |
BA0_TMPGIU | Caracter | 20 | 0 | Tempo Exper. | Tempo de Expericao | @! | Sim | Não | Visualizar | Real | Não | 6 |
Alteração no Arquivo SX3 - Campos:
Campo | Pasta SXA |
---|---|
BA0_URLPAC | 6 |
BA0_STKPAC | 6 |
BA0_USRPAC | 6 |
BA0_PWDPAC | 6 |
BA0_TOKPAC | 6 |
Inclusão no Arquivo SX6 - Parâmetros:
Itens/Pastas | Descrição |
Nome: | MV_PGPURES |
Tipo: | Caracter |
Descrição: | Habilita Protocolos GPU via Rest |
Cont. Por.: | 0 |
Inclusão no Arquivo SXA - Pastas:
Tabela | Ordem | Descrição |
---|---|---|
BA0 | 6 | Integrações Unimed |
Importante
A alteração de dicionário referente a essa implementação estará disponível no próximo pacote de Expedição Contínua do módulo SIGAPLS.
04. DEMAIS INFORMAÇÕES
Não se aplica.
05. ASSUNTOS RELACIONADOS
12045528 DSAUBE-15638 DT GPU - Serviços de Protocolo para não Clientes