O Harpia (Gestão 360) é o sistema usado pela ApexBrasil para gerir convênios e contratos firmados com entidades parceiras (conveniadas), do setor público e privado. O sistema é organizado em módulos:
- Convênios — cobre todo o ciclo de vida de um convênio: cadastro, elaboração do plano de trabalho, execução financeira (aplicações de recurso, solicitações de desembolso, lançamentos, conciliação bancária) e prestação de contas.
- Administração — concentra os cadastros e parâmetros usados de forma transversal por todos os convênios, como o catálogo de Itens Orçamentários, usuários e perfis de acesso.
- Migração de Convênios — traz, de uma vez, todos os dados de um convênio já existente no sistema legado (Fênix) para o Harpia.
Cada módulo tem seu próprio conjunto de guias, listados na página inicial da Wiki. Este documento cobre apenas o que é comum a todos eles: visão geral do sistema, pré-requisitos de acesso e o passo a passo de login.
Servir como ponto de partida para qualquer novo usuário do Harpia (Gestão 360): apresentar o sistema, os pré-requisitos genéricos de acesso e como fazer login e chegar ao módulo desejado. Os guias de cada funcionalidade específica assumem que o leitor já passou por este documento, e não repetem esse conteúdo.
Requisitos Técnicos:
-
Conexão estável com a internet.
-
Navegador atualizado (Google Chrome, Microsoft Edge ou Firefox nas versões mais recentes).
-
Resolução de tela recomendada: 1366x768 ou superior.
Requisitos de Acesso:
-
Credenciais de login válidas (usuário interno ApexBrasil ou usuário de entidade conveniada).
-
Um perfil de acesso configurado pela área de Administração do sistema, com as permissões necessárias para as telas e ações que o usuário precisa usar. Cada guia de funcionalidade cita, quando relevante, a permissão específica exigida por aquela tela ou ação.
-
Abra o navegador e acesse o endereço do sistema Harpia (Gestão 360) fornecido pela sua organização.
-
Na tela inicial, clique em "Entrar".
-
Escolha a forma de acesso: "APEX Brasil" (para usuários internos da ApexBrasil) ou "Acesso Externo" (para usuários de entidades conveniadas).
-
Informe seu e-mail e senha e clique em "Entrar".
Obs: se o seu usuário tiver vínculo com mais de uma entidade/perfil, o sistema exibe uma tela adicional pedindo para você selecionar qual vínculo deseja usar na sessão atual, antes de continuar.
- No menu lateral, clique no módulo desejado — por exemplo, "Convênios".
Obs: se o seu perfil estiver vinculado a mais de um cargo dentro de um convênio (por exemplo, um cargo interno e um de aprovador), use o seletor "Perfil" no topo do sistema para trocar de contexto — o conjunto de ações disponíveis muda conforme o cargo selecionado. Cada guia de funcionalidade explica, quando relevante, qual cargo é necessário para aquela ação específica.
| Regra | Descrição |
|---|
| RN57.3 | Quando o usuário tem simultaneamente vínculo interno ativo e vínculo(s) externo(s), ou mais de um fornecedor ativo, o sistema não loga direto: exibe uma tela adicional para o usuário escolher qual vínculo/perfil usar. |
| RN57.4 | Com apenas o vínculo interno ativo (sem vínculo externo ativo), o login é automático como usuário interno, sem tela de seleção. |
| RN57.5 | Com apenas um vínculo externo ativo e exatamente um fornecedor associado (sem vínculo interno ativo), o login é automático para aquele fornecedor, sem tela de seleção. |
| RN57.9 | Quando o perfil do usuário está vinculado a mais de um cargo dentro de um convênio, o conjunto de ações e permissões disponíveis muda conforme o cargo selecionado no seletor "Perfil", no topo do sistema. |
| RN57.17 (somente front) | A tela de login replica a mesma árvore de decisão do backend (RN57.3–57.5): autentica no Keycloak e, se a resposta trouxer mais de um vínculo, exibe o seletor antes de continuar; caso contrário, prossegue direto. |
| Campo | Descrição |
|---|
| Sistema | Harpia (Gestão 360) |
| Versão | 1.8 |
| Data de Atualização | 2026-10-05 |
| Responsável | Amanda Galvão |
| Público-alvo | Todos os usuários do sistema — internos da ApexBrasil e de entidades parceiras |
| Objetivo | Apresentar o sistema, os pré-requisitos gerais de acesso e o passo a passo de login, comuns a todos os guias |
| Tipo | Documento de referência / treinamento |
| Versão | Data | Descrição da Alteração | Responsável pela Aprovação |
|---|
| 1.8 | 2026-10-05 | Ajustes no Design de Interface e Experiência do Usuário. | Amanda Galvão |
| 1.7 | 2026-09-25 | Removido o texto de aviso sobre a origem das regras de negócio (catálogo oficial vs. inferida do código) da seção Regras de Negócio Relacionadas, alinhando ao padrão já adotado nas demais páginas | Amanda Galvão |
| 1.6 | 2026-09-24 | Adicionada a seção "Regras de Negócio Relacionadas" ao Sumário (estava presente na página, mas não linkada no Sumário) | Amanda Galvão |
| 1.5 | 2026-09-24 | Adicionado o módulo Migração de Convênios à lista de módulos do sistema | Amanda Galvão |
| 1.4 | 2026-09-22 | Adicionadas referências às regras de negócio (RN57.4, RN57.5, RN57.17) | Amanda Galvão |
| 1.3 | 2026-09-21 | Removidas as citações de "Fonte" (arquivo:linha) das Regras de Negócio Relacionadas | Amanda Galvão |
| 1.2 | 2026-09-21 | Adicionadas referências às regras de negócio (RN57) | Amanda Galvão |
| 1.1 | 2026-09-17 | Campo "Responsável" definido como Amanda Galvão | Amanda Galvão |
| 1.0 | 2026-09-17 | Versão inicial da documentação | Amanda Galvão |
Harpia (Gestão 360) — Introdução
Sumário
Sobre o Sistema
Objetivo do Documento
Pré-Requisitos do Sistema
Acessos e Navegação Inicial
Regras de Negócio Relacionadas
Informações do Documento
Histórico de Versões