Começar de graça

Organizando seu Catálogo de Produtos

Este guia mostra como organizar seu catálogo criando categorias hierárquicas, sugerindo unidades de medida, criando marcas, fornecedores, cadastrando produtos com imagens e gerenciando estoque.

Passo 1: Sugerir Unidades de Medida#

As unidades de medida fazem parte de um catálogo compartilhado da plataforma — você não cria uma unidade diretamente, mas pode sugerir uma nova quando a que precisa ainda não existe. A maioria das unidades comuns (kg, L, peça, caixa, metro) já está disponível.

  1. Acesse Produtos > Unidades
  2. Clique em Sugerir Nova Unidade
  3. Preencha:
    • Nome: ex: Arroba, Dúzia, Fardo
    • Símbolo: ex: @, dz, fd
    • Descrição: quando usar esta unidade (opcional)
    • Permite Quantidades Fracionárias: Sim (permite 1.5 kg, 2.3 kg, etc.) ou apenas valores inteiros (1 peça, 3 caixas)
  4. Clique em Enviar Sugestão

A sugestão é enviada para ser adicionada ao catálogo. Se já existir uma unidade ou sugestão com o mesmo símbolo, o envio é bloqueado.

Dica: Antes de sugerir, procure a unidade desejada na lista — ela provavelmente já existe. Com fracionamento permite vendas como 1.5 kg ou 2.75 litros; sem fracionamento aceita apenas valores inteiros.

Passo 2: Criar Categorias Hierárquicas#

Criar categoria pai#

  1. Acesse Produtos > Categorias
  2. Clique em Nova Categoria
  3. Preencha:
    • Nome: Eletrônicos
    • Descrição: Produtos eletrônicos em geral
    • Categoria Pai: selecione Nenhuma (Categoria Raiz) para criar uma categoria de nível mais alto
  4. Clique em Criar Categoria

Criar subcategoria#

  1. Clique novamente em Nova Categoria
  2. Preencha:
    • Nome: Computadores
    • Descrição: Computadores e notebooks
    • Categoria Pai: Eletrônicos
  3. Clique em Criar Categoria

Dica: Você também pode abrir a categoria pai e usar Nova Subcategoria (na árvore ou na página de detalhes) para já criar a filha com o pai preenchido.

Criar sub-subcategoria#

  1. Clique em Nova Categoria
  2. Preencha:
    • Nome: Notebooks
    • Categoria Pai: Computadores
  3. Clique em Criar Categoria

Resultado da hierarquia:

Eletrônicos
                    └── Computadores
                        └── Notebooks
                    

Passo 3: Cadastrar Marcas#

Marcas permitem organizar seus produtos por fabricante ou linha, facilitando a busca e os filtros no catálogo.

  1. Acesse Produtos > Marcas
  2. Clique em Nova Marca
  3. Preencha:
    • Nome: Dell (nome do fabricante ou linha)
    • Descrição: Fabricante de computadores e periféricos (opcional)
  4. Clique em Criar Marca

Repita para outras marcas do seu catálogo:

  • Samsung
  • Nike
  • Apple

Dica: Você também pode criar marcas diretamente pelo formulário de produto, clicando em Criar nova marca na seção Marca.

Gerenciar marcas#

Na página de detalhes de cada marca você pode:

  • Editar Marca — atualizar nome e descrição
  • Ativar/Inativar Marca — marcas inativas não aparecem no formulário de produto
  • Ver a quantidade de produtos associados

Passo 4: Cadastrar Fornecedores#

Fornecedores permitem registrar os parceiros comerciais que abastecem sua loja, vinculando-os aos produtos com código e preço de custo.

  1. Acesse Produtos > Fornecedores
  2. Clique em Novo Fornecedor
  3. Preencha as informações básicas:
    • Nome: Nome do fornecedor
    • Tipo de Pessoa: Pessoa Física ou Jurídica — define se será pedido CPF ou CNPJ
  4. Clique em Criar Fornecedor

Campos adicionais (opcional)#

O formulário é dividido em seções. Todos os campos abaixo são opcionais:

Seção Campos
Tipo de Pessoa Pessoa Física/Jurídica, CPF ou CNPJ, Gênero e Data de Nascimento (Pessoa Física)
Contato Nome do Contato, E-mail, Telefone, WhatsApp, Website, Observações
Dados Legais Razão Social, Inscrição Estadual, Inscrição Municipal
Endereço CEP, Logradouro, Número, Complemento, Bairro, Estado e Cidade

Dica: Cada fornecedor pode ter vários endereços (Principal, Faturamento, Entrega e Outro). Gerencie-os pela ação Endereços na página de detalhes do fornecedor.

Gerenciar fornecedores#

Na página de detalhes de cada fornecedor você pode:

  • Editar Fornecedor — atualizar todas as informações cadastradas
  • Ativar/Inativar Fornecedor — fornecedores inativos não aparecem no formulário de produto
  • Gerenciar os Endereços do fornecedor
  • Ver os Produtos vinculados

Dica: Cadastre os fornecedores antes de registrar muitos produtos. Assim você pode vincular cada produto ao seu fornecedor com o código e preço de compra.

Passo 5: Cadastrar Produto#

  1. Acesse Produtos > Produtos
  2. Clique em Novo Produto
  3. Na seção Informações Básicas, preencha:
    • Nome: Notebook Dell Inspiron 15
    • Unidade de Medida: Peça (obrigatório)
    • Descrição: Notebook i5, 8GB RAM, 256GB SSD (opcional)
    • Categoria: Notebooks (opcional)
  4. Na seção Preços, informe o Preço de Venda (ex: 3.500,00). A Margem bruta é calculada automaticamente quando você também preenche o preço de custo.
  5. Clique em Criar

Demais campos do formulário (opcional)#

O restante do formulário é dividido em seções:

Seção Campos
Identificação SKU (código interno único, ex: NB-DELL-001) e Código de Barras (EAN, UPC ou outro padrão)
Preços Preço de Custo (usado no cálculo da margem)
Marca Marca do produto (ou Criar nova marca ali mesmo)
Atributos Físicos Peso em gramas (ex: 250), Altura, Largura e Comprimento em cm
Dados Fiscais NCM (8 dígitos), CEST (7 dígitos) e Origem (Nacional, Importado, Nacional com conteúdo importado, Adquirido no mercado interno)
Estoque Estoque Mínimo (quantidade para alerta de estoque baixo)

Vincular fornecedores ao produto#

O vínculo com fornecedores não é feito no formulário de criação. Ele acontece na página de detalhes do produto, na seção Fornecedores:

  1. Abra o produto pela Lista de Produtos
  2. Toque na seção Fornecedores para abrir a página de fornecedores do produto
  3. Clique em Adicionar e selecione um fornecedor já cadastrado (ou use Criar Novo para cadastrar um fornecedor na hora)
  4. Informe os dados do vínculo:
    • Código do Fornecedor — código do produto no catálogo do fornecedor
    • Custo de Compra — valor de aquisição junto a esse fornecedor
    • Fornecedor Principal — marque para definir como fornecedor padrão
  5. Clique em Salvar Alterações

Você pode vincular vários fornecedores ao mesmo produto, editar os dados de cada vínculo ou removê-los pela própria página.

Importante: O vínculo de fornecedores é feito na página de detalhes do produto (seção Fornecedores), e não no formulário de criação.

Passo 6: Adicionar Imagens ao Produto#

A seção Imagens aparece apenas ao editar um produto já existente. Adicione fotos para melhorar a identificação no catálogo.

  1. Abra o produto pela Lista de Produtos
  2. Clique em Editar Produto
  3. Na seção Imagens, clique em Adicionar Imagem e escolha uma foto da galeria (uma imagem por vez; cada produto aceita no máximo 10 imagens)
  4. Toque no ícone de estrela para definir a imagem principal (a foto principal exibe o selo Principal)
  5. Arraste as imagens para reordenar

Dica: A imagem principal aparece na lista de produtos e no módulo de produtos. Use fotos com boa iluminação e fundo limpo para melhor apresentação.

Passo 7: Visualizar e Filtrar#

Ver árvore de categorias#

  1. Acesse Produtos > Categorias
  2. Veja a hierarquia completa na árvore
  3. Clique em uma categoria para ver seus produtos e subcategorias

Filtrar produtos#

Na lista de produtos, use o botão de filtros para refinar a busca:

  • Status: Rascunho, Ativo ou Inativo
  • Marca: Filtra por fabricante ou linha
  • Com imagem: Exibe apenas produtos que possuem fotos
  • Estoque baixo: Exibe produtos abaixo do estoque mínimo

Módulo de Produtos no Hub#

O módulo de produtos exibe duas abas no hub:

Aba Conteúdo
Insights Widget de estoque (scorecards de SKUs, estoque baixo, zerado) e dicas do módulo
Cadastros Acesso rápido a Produtos, Categorias, Unidades, Marcas e Fornecedores

Dicas do Módulo#

O hub exibe dicas contextuais para ajudar na configuração do catálogo:

  • Cadastre seu Primeiro Produto — guia para criar o primeiro produto com preços e categorias
  • Adicione Imagens aos Produtos — como usar fotos para melhorar o catálogo
  • Use SKU e Código de Barras — identificação padronizada para agilizar vendas e estoque
  • Organize Produtos por Marca — cadastre marcas para categorizar por fabricante e facilitar filtros
  • Cadastre seus Fornecedores — registre fornecedores e vincule aos produtos com código e custo de compra

Clique em Saiba mais em qualquer dica para ver o guia completo com exemplos e links de documentação.

Permissões#

Permissão Descrição
catalog:product:list Listar produtos
catalog:product:read Visualizar detalhes do produto
catalog:product:create Cadastrar produtos
catalog:product:update Editar produtos
catalog:category:list Listar categorias
catalog:category:create Criar categorias
catalog:category:read Visualizar categoria
catalog:category:update Editar categorias
catalog:brand:list Listar marcas
catalog:brand:create Criar marcas
catalog:brand:update Editar marcas
supplier:supplier:list Listar fornecedores
supplier:supplier:create Cadastrar fornecedores
supplier:supplier:update Editar fornecedores
inventory:stock:read Ver estoque atual
inventory:stock:add Registrar entradas de estoque

Unidades de medida: listar/visualizar unidades e enviar uma sugestão de nova unidade não exigem permissão específica — qualquer usuário autenticado pode fazê-lo. A administração do catálogo compartilhado de unidades (criar/editar diretamente) é feita pela plataforma.

Dicas#

  • Planeje a hierarquia: Defina suas categorias principais antes de criar subcategorias
  • Nomes descritivos: Use nomes claros para facilitar a busca
  • Unidades consistentes: Padronize unidades por tipo de produto
  • Categorias flexíveis: Você pode mover produtos entre categorias depois
  • Unidade obrigatória: Todo produto precisa de uma unidade de medida
  • Categoria opcional: Produtos podem ficar sem categoria
  • Marcas antes de produtos: Cadastre as marcas antes de cadastrar muitos produtos
  • Fornecedores organizados: Cadastre fornecedores com dados legais e contato para facilitar compras e reposição
  • Nomes oficiais de marca: Use nomes consistentes (ex: "Samsung" em vez de "samsung")
  • SKU único: O SKU deve ser único por tenant — use um padrão como [TIPO]-[MARCA]-[NUM]
  • Imagem principal: Sempre defina uma imagem principal para melhor apresentação no catálogo
  • Estoque mínimo: Configure o estoque mínimo para receber alertas de reposição
  • NCM correto: Informe o NCM correto para garantir a tributação adequada nas notas fiscais