Lista de Produtos

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

Para que serve

Exibir todos os produtos cadastrados no tenant, permitindo busca, filtragem por tipo e marca, e acesso rápido ao cadastro de cada produto. É o ponto de entrada do módulo de produtos.

Quem pode usar

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

Como usar (passo a passo)

1. Acesse Menu > Produtos > Produtos.
2. A lista carrega automaticamente com os 50 primeiros registros.
3. Use os filtros para localizar um produto: busque por nome, código ou SKU no campo de texto; filtre por Tipo de produto ou Marca nos seletores.
4. Role a página para baixo para carregar mais registros automaticamente (scroll infinito, 50 por vez).
5. Clique em Limpar para remover todos os filtros ativos.
6. Clique no ícone Editar (lápis) na coluna de ações da linha para abrir o cadastro do produto em modo de edição.
7. Clique em Novo Produto (canto superior direito) para criar um novo produto.
8. Para remover um produto, clique no ícone de lixeira na coluna de ações e confirme o prompt.

Campos da tela

Campo	Obrigatório	O que preencher	Observações
Buscar por nome, código ou SKU...	Não	Texto livre	Filtra a lista em tempo real conforme digitação
Tipo de produto	Não	Selecione um tipo	Opções: Revenda, Matéria-Prima, Produto Acabado, Serviço, Kit, Insumo, Produção
Marca	Não	Selecione uma marca	Lista carregada do cadastro de marcas; suporta pesquisa por digitação

Colunas da tabela

Coluna	Descrição
ID	Identificador interno sequencial do produto no tenant
Nome	Nome do produto
Tipo	Tipo do produto (ex.: Revenda, Serviço)
Marca	Marca associada ao produto
Un. Padrão	Unidade padrão do produto (unidade na qual o estoque é controlado)
Preço Base	Preço base comercial do produto (formato R$)
Status	Ativo ou Inativo
(ações)	Ícone de lixeira para remover o produto

Validações e regras

• A remoção de um produto é um soft delete: o produto é desativado, não excluído fisicamente do banco.
• O sistema confirma a remoção com um prompt antes de executar: "O produto será desativado (soft delete)."
• A lista carrega apenas 50 registros por página; novos registros são carregados automaticamente ao rolar até o final da página.
• O contador de registros é exibido ao lado dos filtros (ex.: "47 registros encontrados").
• 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 produtos"	Falha na comunicação com a API ao listar	Verifique a conexão e recarregue a página
"Erro ao remover produto"	Falha na API ao tentar excluir	—

Integrações e dependências

• Cadastro de Produto: ícone Editar ou botão "Novo Produto" levam ao formulário.
• Lista de Marcas: o filtro "Marca" carrega as marcas cadastradas.
• produtosService.listar — endpoint GET /produtos com paginação e filtros.
• marcasService.listar — endpoint GET /marcas (carrega até 100 marcas para o filtro).

Dúvidas frequentes

Por que o produto desapareceu da lista após a remoção? A remoção desativa o produto (soft delete). Produtos inativos não aparecem na listagem padrão. Reative-o pelo cadastro se necessário.

Como localizar um produto inativo?

Posso filtrar por grupo ou categoria? Ainda não. Os filtros disponíveis na tela são: texto livre, tipo de produto e marca.

Histórico de alterações

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