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.
Um Parâmetro é um valor de configuração global do sistema — usado tanto por telas da própria Administração (por exemplo, o e-mail de destino do suporte técnico) quanto como origem de onde um convênio clona parâmetros próprios ao ser criado.
- Acesse Administração no menu lateral e clique em "Parâmetros".

- Clique no ícone de detalhar para ver o Valor e as Observações completos de um parâmetro.

-
Na listagem, clique em "Inserir Parâmetro".
-
Preencha Código, Descrição, Módulo e Valor (todos Campo Obrigatório), e opcionalmente Observações. Clique em "Salvar".

Obs: no parâmetro de código CONVENIOS-ACOES-AUTOMATICAS (os Tipos de Ação criados automaticamente quando um convênio é enviado para elaboração), o campo Valor é substituído por uma tabela chamada "Tipos de Ação Automáticos", tanto no cadastro quanto na edição. Cada linha da tabela tem um Tipo de Ação e um Item Orçamentário (exibido como "código - descrição"). Clique em "Incluir" para acrescentar uma linha — o botão fica desabilitado enquanto houver uma linha incompleta — e no ícone de lixeira para remover uma linha. Se o mesmo Tipo de Ação aparecer mais de uma vez, o sistema exibe o aviso "Há Tipos de Ação repetidos na lista — apenas a duplicidade é sinalizada, o cadastro não é bloqueado." Linhas incompletas (sem Tipo de Ação ou sem Item Orçamentário) são ignoradas ao salvar. Sem nenhuma linha, a tabela fica vazia, apenas com os cabeçalhos; se as listas de Tipos de Ação e de Itens Orçamentários não carregarem, aparece "Não foi possível carregar os tipos de ação ou os itens orçamentários." com o link "Tentar novamente". O comportamento só vale para o código escrito exatamente como acima; nos demais parâmetros, o Valor continua sendo digitado livremente.


- No detalhe de um parâmetro, clique em "Editar" para alterar Código, Descrição, Módulo, Observações ou Valor.

- No detalhe do parâmetro, clique em "Excluir" para removê-lo do catálogo.
| Regra | Descrição |
| RN62.1 | Um parâmetro global tem Módulo, Código, Descrição e Valor obrigatórios, e Observações opcional; o flag Ativo é sempre verdadeiro na criação e nunca é alterado — não existe ativar/inativar. |
| RN62.2 | Não há verificação de unicidade de Código em nenhuma camada — é possível cadastrar dois parâmetros com o mesmo código, inclusive no mesmo módulo. |
| RN62.3 | Apesar de não haver unicidade garantida, o sistema depende operacionalmente de que o código seja único: a busca "por código" retorna um único registro, com resultado indeterminado em caso de duplicidade. |
| RN62.4 | Os módulos disponíveis para associar a um parâmetro são um cadastro fechado, só leitura — módulos inativos também aparecem na lista, sem filtro de status. |
| RN62.5 | A exclusão de um parâmetro global só valida que ele existe, sem checar se algum convênio já o clonou — pode ser excluído mesmo já em uso, sem bloqueio nem aviso. |
| RN62.6 | A listagem retorna todos os parâmetros, sem filtro por Ativo ou Módulo. |
| RN62.7 | O campo Valor exige, no front, ser número, booleano (true/false) ou JSON válido para habilitar Salvar; o backend só exige que não esteja vazio, aceitando qualquer string livre. |
| RN62.8 | No parâmetro de código "CONVENIOS-ACOES-AUTOMATICAS", o Valor não é digitado: é montado por uma tabela de pares Tipo de Ação / Item Orçamentário e gravado como uma lista desses pares. Linhas incompletas são descartadas ao salvar e a repetição de um mesmo Tipo de Ação só gera um aviso, sem bloquear o cadastro. Essa lista define as Ações criadas automaticamente quando um convênio é enviado para "Em Elaboração". |
| Campo | Descrição |
| Sistema | Harpia (Gestão 360) |
| Versão | 1.7 |
| Data de Atualização | 2026-10-15 |
| Responsável | Amanda Galvão |
| Público-alvo | usuários administradores responsáveis pela configuração técnica do sistema |
| Objetivo | consultar, cadastrar, editar e excluir um Parâmetro global do sistema |
| Tipo | Documento de referência / treinamento |
| Versão | Data | Descrição da Alteração | Responsável pela Aprovação |
| 1.7 | 2026-10-15 | Adicionado o bloco "Veja Também" com links para os guias relacionados e o card correspondente no Sumário | Amanda Galvão |
| 1.6 | 2026-10-09 | Adicionadas as capturas de tela do cadastro de Parâmetro com a tabela "Tipos de Ação Automáticos" (com o aviso de Tipos de Ação repetidos) e corrigida a descrição da tabela sem linhas, que fica vazia. | Amanda Galvão |
| 1.5 | 2026-10-09 | Documentada a tabela "Tipos de Ação Automáticos" do parâmetro CONVENIOS-ACOES-AUTOMATICAS e adicionada a regra RN62.8. | Amanda Galvão |
| 1.4 | 2026-10-05 | Ajustes no Design de Interface e Experiência do Usuário. | Amanda Galvão |
| 1.3 | 2026-09-24 | Corrigido o link do Sumário para "Regras de Negócio Relacionadas" (o anchor não deveria ter o prefixo "h-", pois o heading não começa com dígito) | Amanda Galvão |
| 1.2 | 2026-09-22 | Alteração de texto. | Amanda Galvão |
| 1.1 | 2026-09-22 | Removidas as notas de observação dos Cenários, mantidas as Regras de Negócio | Amanda Galvão |
| 1.0 | 2026-09-22 | Versão inicial da documentação | Amanda Galvão |