Lista de Grupos

Módulo: Produtos Caminho na aplicação: Menu > Produtos > Grupos (/grupos) Última atualização: 20/04/2026

Para que serve

Exibir todos os grupos de produtos cadastrados no tenant, com suporte a hierarquia (grupo pai e subgrupos). Permite busca por descrição, visualização da estrutura em árvore e acesso ao cadastro de cada grupo.

Quem pode usar

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

Como usar (passo a passo)

1. Acesse Menu > Produtos > Grupos.
2. A lista carrega automaticamente exibindo apenas grupos raiz (sem pai).
3. Use o campo de busca para filtrar por descrição.
4. Clique em Limpar para remover o filtro.
5. Clique na seta de expansão em um grupo para ver seus subgrupos.
6. Clique no ícone Editar (lápis) na coluna de ações do grupo (ou subgrupo expandido) para abrir o cadastro em modo de edição.
7. Clique em Novo Grupo (canto superior direito) para criar um novo grupo.
8. Para remover um grupo, clique no ícone de lixeira na coluna de ações e confirme o prompt.
9. Role a página para baixo para carregar mais grupos (scroll infinito, 50 por vez).

Campos da tela

Campo	Obrigatório	O que preencher	Observações
Buscar por descrição...	Não	Texto livre	Filtra grupos por descrição em tempo real

Colunas da tabela

Coluna	Descrição
ID	Identificador interno sequencial do grupo no tenant
Descrição	Nome do grupo
Comissão %	Percentual de comissão padrão do grupo
Subgrupos	Quantidade de subgrupos vinculados
Status	Ativo ou Inativo
(ações)	Ícone de lixeira para remover o grupo

Validações e regras

• A lista exibe apenas grupos raiz por padrão (apenas_raiz: true). Subgrupos são exibidos expandindo a linha do grupo pai.
• A remoção é um soft delete: o grupo é desativado, não excluído fisicamente.
• A confirmação de remoção exibe: "O grupo será desativado (soft delete)."
• Scroll infinito: carrega 50 registros por vez ao rolar até o final da página.
• A edição é aberta pelo ícone Editar (lápis) na coluna de ações; clique na linha não abre edição.

Mensagens de erro e o que fazer

Mensagem	Causa	Como resolver
"Erro ao carregar grupos"	Falha na comunicação com a API	Verifique a conexão e recarregue a página
—	Pode ser retorno err?.response?.data?.message da API	Verifique se o grupo está vinculado a produtos ou subgrupos ativos

Integrações e dependências

• Cadastro de Grupo: ícone Editar ou "Novo Grupo" levam ao formulário.
• gruposService.listar — endpoint GET /grupos com parâmetro apenas_raiz=true e paginação.

Dúvidas frequentes

Por que só vejo grupos raiz na lista? A tela filtra automaticamente para exibir apenas grupos sem pai. Para ver subgrupos, expanda o grupo pai clicando na seta.

Como localizar um subgrupo pelo nome? Use o campo de busca. A API pesquisa em todos os grupos, incluindo subgrupos.

O grupo tem produtos vinculados. Posso removê-lo assim mesmo?

Histórico de alterações

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