Cadastro de Fabricante

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

Para que serve

Criar e editar fabricantes de produtos. Fabricantes identificam a empresa que produz o item e podem ser usados para classificar e filtrar produtos no catálogo. Cada fabricante 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 fabricante:

1. Acesse Menu > Produtos > Fabricantes e clique em Novo Fabricante.
2. Preencha a descrição (obrigatório).
3. Informe a comissão padrão se necessário.
4. Clique em Cadastrar Fabricante. O sistema redireciona para a tela de edição do fabricante recém-criado.

Editar um fabricante:

1. Na Lista de Fabricantes, clique no ícone Editar (lápis) na linha do fabricante 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 fabricante	Mensagem: "Informe a descricao"
Comissão %	Não	Percentual de comissão padrão para produtos deste fabricante	Padrão: 0. Mín: 0, Máx: 100; precisão: 2 casas decimais
Imagem	Não	Upload de imagem/logo do fabricante (somente na edição)	Armazenada no S3; suporta visualização e exclusão

Validações e regras

• Descrição é o único campo obrigatório.
• Ao criar, o sistema redireciona para /fabricantes/: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.
• Fabricantes não têm hierarquia.

Mensagens de erro e o que fazer

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

Integrações e dependências

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

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. Ver Cadastro de Marca.

Para que serve a comissão padrão do fabricante? Define um percentual de comissão padrão aplicável a produtos deste fabricante

O fabricante deve ser uma empresa já cadastrada como fornecedor? Não necessariamente. O cadastro de fabricante é independente do cadastro de fornecedor. Um fornecedor pode ser o próprio fabricante, mas não há vínculo obrigatório entre os dois cadastros.

Histórico de alterações

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