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.
Este cenário cobre o cadastro de um novo convênio, da tela inicial até a criação efetiva do registro. Qualquer usuário com a permissão de cadastro de convênios atribuída ao seu perfil — interno ApexBrasil ou de entidade conveniada — pode executar este fluxo; essa permissão é configurada pela área de Administração e não depende do tipo de vínculo.
Obs: este guia cobre especificamente a primeira etapa do ciclo de vida do convênio — o cadastro inicial. As etapas seguintes (elaboração, análise, execução, encerramento) são cobertas em guias próprios.
No menu lateral, clique em "Convênios" e, na listagem, clique no botão "Inserir Convênio".
A tela "Inserir Convênio" é exibida, pronta para preenchimento.
Confira o campo Tipo do Convênio (Campo Obrigatório) — ele já vem preenchido automaticamente pelo sistema (por exemplo, com o valor "Parceria") e não pode ser alterado nesta tela.
Selecione a Categoria (Campo Obrigatório) — por exemplo, "Negócio". Uma das opções disponíveis é "PEIEX" (Programa de Extensão Industrial Exportadora), um programa específico da ApexBrasil.
Obs: Ao escolher a categoria PEIEX, o campo Nome do Convênio (passo 9.2) fica liberado para digitação manual. Nas demais categorias, esse campo é sempre gerado automaticamente pelo sistema.
Selecione o Serviço (Campo Obrigatório) — as opções exibidas mudam de acordo com a Categoria escolhida no passo anterior.
Selecione a Área Setorial (Campo Obrigatório).
Selecione a Unidade (Campo Obrigatório) — a coordenação da ApexBrasil responsável pelo convênio. A lista oferece somente as Unidades vigentes (as que já tiveram a vigência encerrada não aparecem; ver o guia "Unidades", em Administração).
Informe o Início de Vigência e o Fim de Vigência (ambos Campos Obrigatórios), no formato dd/mm/aaaa.
Obs: A data de Fim de Vigência precisa ser posterior à data de Início de Vigência — o sistema não aceita as duas datas iguais.
Selecione a Entidade Executora (Campo Obrigatório) — a entidade conveniada que vai executar o convênio.
9.1. Ao escolher a Entidade Executora, o campo Sigla (Campo Obrigatório) é preenchido automaticamente e não pode ser editado.
Obs: Se a entidade selecionada não tiver uma sigla cadastrada, o sistema exibe o erro "Sigla da entidade executora não cadastrada". Nesse caso, é preciso cadastrar a sigla no cadastro da entidade antes de conseguir prosseguir.
9.2. O campo Nome do Convênio (Campo Obrigatório) também é gerado automaticamente, seguindo o padrão SIGLA-AnoDeInício-AnoDeFim (por exemplo, "ABEDESIGN-2027-2029") — exceto quando a Categoria escolhida é PEIEX, caso em que este campo fica liberado para digitação manual.
Obs: O sistema não permite dois convênios com o mesmo Nome do Convênio. Se o nome gerado automaticamente já existir — por exemplo, duas entidades diferentes iniciando um convênio no mesmo período —, o sistema bloqueia o salvamento com a mensagem abaixo:
Preencha o campo Objeto (Opcional) com uma descrição do propósito do convênio, se desejar. Este campo não é exigido nesta etapa — ele passa a ser obrigatório apenas mais adiante, quando o convênio avançar para a próxima etapa do fluxo de aprovação (fora do escopo deste guia; veja Dados Gerais).
Se desejar, informe os dados bancários — Banco, Agência e Conta Corrente (todos Opcionais nesta etapa).
Obs: Se preenchidos, Agência e Conta Corrente precisam seguir um dos formatos aceitos: apenas números (ex.: 1234), com hífen (ex.: 1234-5), ou terminando em X (ex.: 1234X). Fora desses formatos, o sistema exibe uma mensagem de formato inválido.
Com todos os campos obrigatórios preenchidos, a tela fica assim:
Revise as informações preenchidas e clique em "Salvar".
O sistema exibe uma confirmação: "Tem certeza que deseja salvar as informações fornecidas?". Clique em "Sim" para confirmar.
Com todas as informações corretas, o sistema exibe a mensagem "Inserido com sucesso" e leva você automaticamente para a tela de detalhamento do convênio recém-criado, na aba "Dados Gerais".
Obs: O convênio recém-criado nasce com o status NOVO. Nesse status, apenas as abas "Inconsistências", "Dados Gerais", "Equipe Interna", "Equipe Externa" e "Logs" ficam disponíveis. As demais abas (Documentos, Metas, Ações, Solicitações de Desembolso, entre outras) só aparecem depois que o convênio avança para as próximas etapas do fluxo de aprovação — fora do escopo deste guia; veja Envio para Elaboração.
O que acontece automaticamente ao salvar:
Ao confirmar o cadastro, o sistema executa automaticamente, sem qualquer ação adicional do usuário:
Vincula ao convênio a cotação de câmbio em Real (BRL) vigente no momento — mesmo para um convênio nacional, essa vinculação é necessária para os cálculos financeiros do convênio ao longo do tempo. Se não existir uma cotação BRL ativa cadastrada no sistema, o cadastro do convênio é bloqueado com o erro "Câmbio BRL não encontrado ou não está ativo" — nesse caso, é preciso acionar o time responsável pelo cadastro de câmbios antes de tentar novamente. Esse é o comportamento esperado do sistema.
Gera automaticamente o cronograma de solicitações de desembolso, mês a mês, cobrindo todo o período de vigência informado.
Divide automaticamente o período de vigência em blocos de prestação de contas (a cada 6 meses, por padrão), cada um com prazo próprio de entrega.
Inclui automaticamente, na Equipe Interna do convênio, o usuário que fez o cadastro.
Nome do Projeto deve ser único entre convênios (comparação trim, case-sensitive) na criação.
RN09.2
Código Estruturado deve ser único entre convênios; a checagem só é aplicada na inserção (a atualização não reaplica essa validação).
RN09.3
Fim de Vigência deve ser estritamente maior que Início de Vigência.
RN09.11
O Nome do Convênio é gerado automaticamente como {sigla-do-fornecedor}-{anoInício}-{anoFim} sempre que a Categoria escolhida não for "PEIEX"; para a categoria "PEIEX", o campo fica liberado para edição manual.
RN20.5
Todo convênio novo é vinculado automaticamente, na criação, a um câmbio BRL ativo (com o Valor copiado do câmbio BRL vigente); se não existir nenhum câmbio BRL ativo, a criação do convênio falha inteira.
RN37.1
Todo convênio deve ter uma Área Setorial válida e existente vinculada na criação.
RN37.2
Não existe cadastro manual de Área Setorial no sistema — o catálogo é populado apenas pela migração de dados do sistema legado (Fênix).
RN39.1
Ao listar as categorias disponíveis para um Tipo de Convênio, só categorias ativas são retornadas, ordenadas por descrição.
RN49.1
Na listagem de Serviços por Categoria, só serviços não inativos aparecem como opção de seleção.
RN52.1
Ao selecionar um Tipo de Convênio, só as Categorias vinculadas a ele (e não inativas) aparecem no dropdown de Categoria.
RN54.1
A listagem de Unidades usada nos formulários de convênio traz somente as Unidades vigentes (sem data de fim de vigência), ordenadas por Nome.
Removida a seção "Vídeo Explicativo" (seção e card do Sumário).
Amanda Galvão
1.10
2026-10-15
Adicionado o bloco "Veja Também" com links para os guias relacionados e o card correspondente no Sumário; atualizados os screenshots do formulário vazio, preenchido e da confirmação
Amanda Galvão
1.9
2026-10-09
A lista de Unidades do cadastro do convênio passa a oferecer somente Unidades vigentes; atualizada a RN54.1.
Amanda Galvão
1.8
2026-10-06
Adicionada a seção "Vídeo Explicativo" com o vídeo da funcionalidade Inserir Convênio.
Amanda Galvão
1.7
2026-10-05
Ajustes no Design de Interface e Experiência do Usuário.
Amanda Galvão
1.6
2026-09-25
Removido o disclaimer antigo de proveniência das Regras de Negócio (RN01–RN08 oficial vs. inferidas), obsoleto desde a decisão de 2026-09-22 de não distinguir a origem das regras na página publicada
Amanda Galvão
1.5
2026-09-25
Adicionada referência à regra de negócio RN20.5 (vínculo automático do câmbio BRL na criação do convênio)
Amanda Galvão
1.4
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.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 (RN09, RN37, RN39, RN49, RN52, RN54)
Amanda Galvão
1.1
2026-09-17
Campo "Responsável" alterado de Pedro Rocha para Amanda Galvão