¶ 
Harpia (Gestão 360) — Guia de Usuário:
Módulo Migração de Convênios
¶ 
Sumário
Cenário: Validar Elegibilidade e Migrar um Convênio
Cenário: Consultar Histórico e Relatório de Migrações
Regras de Negócio Relacionadas
Veja Também
Antes de começar, veja a página "Introdução" para os pré-requisitos gerais do sistema e o passo a passo de login. Em caso de dúvidas, consulte também o FAQ.
¶ Cenários
Migração de Convênios é o módulo usado para trazer, de uma vez, todos os dados de um convênio já existente no sistema legado (Fênix) para o Harpia — convênio, participantes, ações, aplicações de recursos, solicitações de desembolso, lançamentos, conciliação bancária, prestação de contas e documentos.
¶ Cenário: Validar Elegibilidade e Migrar um Convênio
- Acesse "Migração de Convênios" no menu lateral e clique em "Validar Elegibilidade".
- Informe o ID do Projeto FÊNIX (Campo Obrigatório, numérico) e clique em "Buscar Convênio".
Obs: o sistema classifica o convênio em três resultados: "APTO" (pode ser migrado), "SINALIZADO" (pode ser migrado, mas tem advertências que vale revisar antes) ou "NÃO ELEGÍVEL" (não pode ser migrado enquanto os bloqueios não forem resolvidos no Fênix). Cada bloqueio ou advertência aparece agrupado por categoria (Integridade, Desembolso, Mudança, Prestação de Contas), com a mensagem, uma recomendação e uma tabela de detalhes.
Obs: bloqueiam 100% a migração: projeto inexistente no Fênix; fase "Cancelado", "Concluído" ou "Em Prestação de Contas"; inconsistências de integridade (nome/datas ausentes ou invertidas, cadastros obrigatórios ausentes, Classe de Valor ausente e contrato ausente quando a fase é "Em Execução" ou "Suspenso", município não mapeável); mudanças pendentes; e prestações de contas em andamento. Desembolsos fora de "Em Ajuste"/"Rejeitado" também bloqueiam — já desembolsos que estão exatamente em "Em Ajuste" ou "Rejeitado" não bloqueiam, só migram com status pendente.
Obs: um convênio cuja fase no Fênix é "Em Execução" ou "Suspenso" exige que o projeto tenha contrato vinculado (ID_CONTRATO_RM). Sem ele, o resultado é "NÃO ELEGÍVEL", na categoria Integridade, com a mensagem "Contrato (ID_CONTRATO_RM) não informado no FENIX. Convênios em execução exigem contrato vinculado." Para seguir, informe o contrato no projeto, no Fênix, e valide novamente. A mesma conferência é refeita ao confirmar a migração: se o contrato estiver ausente nesse momento, a migração é recusada e a tentativa fica registrada no Histórico com o status "Erro".
Obs: quando o convênio é migrado com contrato, o sistema grava esse contrato no convênio criado no Harpia (o identificador, cortado em até 15 caracteres, e o contrato completo, cortado em até 50 caracteres). Como o contrato passa a ter correspondência no Harpia, o ID_CONTRATO_RM deixa de aparecer na relação de campos do Fênix sem correspondência, que a migração registra na observação do convênio.
-
Se o convênio estiver Apto ou Sinalizado — e não houver migração anterior do mesmo projeto nem outro convênio já cadastrado com o mesmo nome — clique em "Migrar Convênio".
-
O sistema abre um diálogo de confirmação com o nome do projeto, o ID Fênix, a contagem de cada tipo de dado que será migrado (Dados Gerais, Documentos, Mercados Alvo, Verticais, Participantes, Metas, Ações, Aplicações de Recursos, Solicitações de Desembolso, Lançamentos, Conciliação Bancária, Prestação de Contas, Equipe Interna e Equipe Externa) e uma estimativa de tempo.
Obs: se o convênio estiver Sinalizado, o diálogo mostra um aviso extra pedindo para revisar os itens sinalizados antes de confirmar. Em qualquer caso, o diálogo avisa: "Atenção: Esta operação não pode ser interrompida após a confirmação."
- Clique em "Confirmar Migração".
Obs: a migração roda de forma síncrona — a tela fica travada aguardando (com indicador de carregamento) até o processo terminar por completo; não há barra de progresso, e não é possível navegar para outra tela nesse meio tempo. Se você fechar ou recarregar a aba do navegador durante o processo, o sistema registra a tentativa como "Cancelada" no histórico — mesmo que a migração continue rodando no servidor.
- Ao concluir, o sistema exibe "Convênio migrado com sucesso." e mostra, na mesma tela, o relatório completo da migração (ver 1.2).
Obs: essa mensagem de sucesso aparece mesmo quando o resultado real da migração é "Parcial" — o status real (Sucesso ou Parcial) só aparece no relatório, não nessa mensagem.
¶ Cenário: Consultar Histórico e Relatório de Migrações
- Acesse "Migração de Convênios" no menu lateral e clique em "Histórico".
-
Use os filtros Período início/fim, Status (Sucesso, Parcial, Erro, Cancelado ou Em Andamento), Usuário e ID FÊNIX — ou o campo de busca livre — para localizar uma migração específica.
-
Clique no ícone de detalhar, na coluna "Ações", para abrir o relatório completo daquela migração.
- O relatório mostra o status final (Sucesso, Parcial, Erro ou Cancelado), quem executou, quando começou/terminou e quanto durou; a contagem de cada tipo de entidade migrada (com indicação de falhas parciais quando houver, em Documentos, Metas, Aplicações de Recursos ou Solicitações de Desembolso); os resultados das Validações Pós-Migração; e, quando aplicável, uma tabela de Erros de Migração separada de uma tabela de Avisos Informativos.
Obs: avisos informativos não afetam o resultado final da migração — só erros de fato (severidade diferente de "Informativo") derrubam o status de "Sucesso" para "Parcial".
Obs: entre os avisos informativos podem aparecer registros de Aplicação de Recurso criada automaticamente pela migração, para mês divergente ou para moeda divergente. Isso acontece quando um subitem (detalhamento) de uma Aplicação de Recurso do Fênix tem mês de previsão ou moeda diferentes dos do item principal: em vez de manter o subitem no item principal, a migração cria uma Aplicação de Recurso separada para cada combinação de mês e moeda. Subitem sem moeda informada é tratado como Real (BRL).
- Use "Exportar PDF" para baixar o relatório.
Informações do Documento
Histórico de Versões