Lista de Fabricantes

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

Para que serve

Exibir todos os fabricantes de produtos cadastrados no tenant. Permite busca por descrição, remoção e acesso ao cadastro de cada fabricante.

Quem pode usar

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

Como usar (passo a passo)

1. Acesse Menu > Produtos > Fabricantes.
2. A lista carrega automaticamente com os primeiros 50 registros.
3. Use o campo de busca para filtrar fabricantes por descrição.
4. Clique em Limpar para remover o filtro.
5. Clique no ícone Editar (lápis) na coluna de ações da linha para abrir o cadastro do fabricante em modo de edição.
6. Clique em Novo Fabricante (canto superior direito) para criar um novo fabricante.
7. Para remover um fabricante, clique no ícone de lixeira e confirme o prompt.
8. Role a página para baixo para carregar mais registros (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 fabricantes por descrição em tempo real

Colunas da tabela

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

Validações e regras

• A remoção é um soft delete: o fabricante é desativado, não excluído fisicamente.
• A confirmação de remoção exibe: "O fabricante 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 fabricantes"	Falha na comunicação com a API	Verifique a conexão e recarregue a página
"Erro ao remover fabricante"	Falha na API ao tentar excluir	—

Integrações e dependências

• Cadastro de Fabricante: ícone Editar ou "Novo Fabricante" levam ao formulário.
• Cadastro de Produto: o campo "Fabricante" no cadastro de produto usa os fabricantes cadastrados aqui.
• fabricantesService.listar — endpoint GET /fabricantes com paginação e filtro de busca.

Dúvidas frequentes

Qual a diferença entre fabricante e marca? Fabricante é a empresa que produz o item. Marca é o rótulo comercial. Um fabricante pode ter várias marcas, e uma marca pode ser de um único fabricante.

O fabricante está em uso por produtos. Posso removê-lo?

Histórico de alterações

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