Cadastro de Marca

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

Para que serve

Criar e editar marcas de produtos. Marcas são usadas para classificar e filtrar produtos no catálogo. Cada marca pode ter uma comissão padrão e uma imagem associada (ex.: logo da marca).

Quem pode usar

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

Como usar (passo a passo)

Criar uma marca:

1. Acesse Menu > Produtos > Marcas e clique em Nova Marca.
2. Preencha a descrição (obrigatório).
3. Informe a comissão padrão se necessário.
4. Clique em Cadastrar Marca. O sistema redireciona para a tela de edição da marca recém-criada.

Editar uma marca:

1. Na Lista de Marcas, clique no ícone Editar (lápis) na linha da marca desejada.
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 (ex.: logo) 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 da marca	Mensagem: "Informe a descricao"
Comissão %	Não	Percentual de comissão padrão para produtos desta marca	Padrão: 0. Mín: 0, Máx: 100; precisão: 2 casas decimais
Imagem	Não	Upload de imagem/logo da marca (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 /marcas/: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.
• Marcas não têm hierarquia (diferente de grupos e categorias).

Mensagens de erro e o que fazer

Mensagem	Causa	Como resolver
"Informe a descricao"	Campo Descrição vazio ao salvar	Preencha o nome da marca
"Marca criada com sucesso"	Criação bem-sucedida	—
"Marca atualizada com sucesso"	Edição bem-sucedida	—
"Erro ao carregar marca"	Falha ao buscar dados na API	Verifique a conexão; o sistema retorna à lista de marcas
"Erro ao salvar marca"	—	Verifique a mensagem retornada e corrija os dados

Integrações e dependências

• Lista de Marcas: ponto de entrada para acessar este formulário.
• Cadastro de Produto: marcas são vinculadas a produtos no campo "Marca".
• Lista de Produtos: o filtro "Marca" na lista de produtos usa as marcas cadastradas aqui.
• AWS S3: imagem da marca armazenada via upload multipart.
• marcasService — endpoints POST /marcas, PUT /marcas/:id, GET /marcas/:id, POST /marcas/:id/imagem, DELETE /marcas/:id/imagem.

Dúvidas frequentes

Marca e fabricante são a mesma coisa? Não. Fabricante é a empresa que produz o item. Marca é o rótulo comercial. Um fabricante pode ter várias marcas. Ver Cadastro de Fabricante.

Para que serve a comissão padrão da marca? Define um percentual de comissão padrão aplicável a produtos desta marca

A imagem da marca aparece em algum documento?

Histórico de alterações

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