Grupos CD01¶
Grupo é a categoria principal de um produto (ex.: Ferragem, Bazar, Eletro). Todo produto deve estar vinculado a um grupo — é o primeiro nível de classificação na hierarquia Grupo → Subgrupo → Produto.

Pré-requisitos¶
- Ter permissão Cadastros: gerenciar grupos atribuída ao seu usuário
Passo a passo¶
1. Acessar a tela¶
No menu lateral, clique em Cadastros → Produtos → Grupos.
A lista mostra todos os grupos cadastrados, com ID, Descrição e Situação (Ativo / Inativo).
2. Filtrar e buscar¶
- Filtrar por descrição: digite no campo de busca no topo da tabela
- Filtro Situação: escolha entre Ativos (padrão), Inativos ou Todos
- Clique em Limpar para resetar os filtros
3. Criar um novo grupo¶
- Clique no botão Novo no canto superior direito
- Preencha o campo Descrição (até 30 caracteres) — ex.:
Ferragem,Eletro,Bazar - Deixe o toggle Ativo ligado (padrão)
- Clique em Salvar
Boas práticas de nomenclatura
Use nomes curtos, em maiúsculas ou capitalizados, sem acentos opcionais quando possível. Padronize com a sua equipe — esse nome aparece em relatórios e telas de venda.
4. Editar um grupo¶
Na linha do grupo, clique no botão Editar. Altere a descrição e clique em Salvar.
Edição livre
Você pode renomear o grupo mesmo se houver subgrupos vinculados. O vínculo é por ID, não pelo nome.
5. Desativar um grupo¶
Na edição, desligue o toggle Ativo e salve.
Grupos inativos:
- Não aparecem nos formulários de cadastro de produto
- Continuam visíveis nos produtos já cadastrados com esse grupo
- Podem ser reativados a qualquer momento
Não é possível desativar se houver subgrupos ativos
Se houver subgrupos ativos vinculados ao grupo, o sistema bloqueia a desativação e mostra a mensagem:
Não é possível desativar: existem N subgrupo(s) ativo(s) vinculado(s) a este grupo.
Desative primeiro os subgrupos em Subgrupos (CD02).
6. Excluir um grupo¶
Na linha do grupo, clique em Excluir.
Exclusão definitiva
A exclusão só funciona se nenhum produto estiver vinculado ao grupo. Se houver, o sistema bloqueia com:
Não é possível excluir: existem produtos vinculados a este grupo.
Nesse caso, o caminho correto é desativar o grupo (passo 5), não excluir.
Regras e validações¶
- Descrição obrigatória — não é possível salvar em branco
- Tamanho máximo: 30 caracteres
- Sem duplicatas: já existe checagem case-insensitive —
Ferragemeferragemsão considerados iguais - Grupo padrão "N/A" (ID 1): registro de sistema, não pode ser editado nem excluído
Erros comuns¶
Já existe um grupo com essa descrição
Dois grupos não podem ter o mesmo nome, ignorando maiúsculas/minúsculas. Verifique a lista antes de cadastrar.
Não é possível excluir: existem produtos vinculados
Use Desativar em vez de Excluir. O grupo continua no banco mas some dos formulários novos.