Cadastro de Grupo

Módulo: Produtos Caminho na aplicação: Menu > Produtos > Grupos > "Novo Grupo" ou ícone Editar na lista Última atualização: 20/04/2026

Para que serve

Criar e editar grupos de produtos. Grupos organizam o catálogo em categorias hierárquicas simples (grupo e subgrupo). Cada grupo pode ter uma comissão padrão e uma imagem associada.

Quem pode usar

Qualquer usuário com acesso ao módulo de Produtos.

Como usar (passo a passo)

Criar um grupo:

1. Acesse Menu > Produtos > Grupos e clique em Novo Grupo.
2. Preencha a descrição (obrigatório).
3. Selecione um Grupo Pai se este for um subgrupo; deixe em branco para criar um grupo raiz.
4. Informe a comissão padrão se necessário.
5. Clique em Cadastrar Grupo. O sistema redireciona para a tela de edição do grupo recém-criado.

Editar um grupo:

1. Na Lista de Grupos, clique no ícone Editar (lápis) na linha do grupo ou subgrupo desejado.
2. Altere os campos e clique em Salvar Alterações. O sistema permanece na tela de edição.

Adicionar imagem (somente na edição):

1. No modo de edição, localize o card "Imagem".
2. Use o componente de upload para enviar a imagem ao S3.

Campos da tela

Campo	Obrigatório	O que preencher	Observações
ID	Não (leitura)	—	Exibido somente na edição; identificador interno sequencial
Status	Não	Ativo / Inativo	Padrão: Ativo
Descrição	Sim	Nome do grupo	Mensagem: "Informe a descricao"
Grupo Pai (opcional)	Não	Selecione o grupo pai para criar um subgrupo	Placeholder: "Nenhum (grupo raiz)". O grupo atual não aparece nas opções
Comissão %	Não	Percentual de comissão padrão para produtos deste grupo	Padrão: 0. Mín: 0, Máx: 100; precisão: 2 casas decimais
Imagem	Não	Upload de imagem (somente na edição)	Armazenada no S3; suporta visualização e exclusão

Validações e regras

• Descrição é o único campo obrigatório.
• Um grupo não pode ser definido como pai de si mesmo (o próprio grupo é excluído das opções de pai).
• Ao criar, o sistema redireciona para /grupos/:id/editar com replace: true.
• Ao editar, o sistema recarrega o registro após salvar, sem redirecionar.
• Se houver alterações não salvas, o sistema avisa ao tentar sair.
• O upload de imagem só está disponível no modo de edição.

Mensagens de erro e o que fazer

Mensagem	Causa	Como resolver
"Informe a descricao"	Campo Descrição vazio ao salvar	Preencha o nome do grupo
"Grupo criado com sucesso"	Criação bem-sucedida	—
"Grupo atualizado com sucesso"	Edição bem-sucedida	—
"Erro ao carregar grupo"	Falha ao buscar dados do grupo na API	Verifique a conexão; o sistema retorna à lista de grupos
"Erro ao salvar grupo"	—	Verifique mensagem retornada e corrija os dados informados

Integrações e dependências

• Lista de Grupos: ponto de entrada para acessar este formulário.
• Cadastro de Produto: grupos são vinculados a produtos no campo "Grupo".
• AWS S3: imagem do grupo armazenada via upload multipart.
• gruposService — endpoints POST /grupos, PUT /grupos/:id, GET /grupos/:id, POST /grupos/:id/imagem, DELETE /grupos/:id/imagem.

Dúvidas frequentes

Quantos níveis de hierarquia o grupo suporta? O grupo suporta dois níveis: grupo raiz (sem pai) e subgrupo (com grupo pai). Para hierarquias mais profundas, use Categorias que suportam 3 níveis.

Posso mudar o grupo pai depois? Sim. No modo de edição, altere o campo "Grupo Pai" e salve.

A imagem é obrigatória? Não. A imagem é opcional e pode ser adicionada, substituída ou removida a qualquer momento após criar o grupo.

Qual a diferença entre Grupo e Categoria? Ambos organizam produtos, mas grupos têm hierarquia de 2 níveis enquanto categorias suportam 3 níveis. O uso depende da necessidade de organização do tenant.

Histórico de alterações

Data	Alteração
20/04/2026	Documento inicial criado.