Pular para o conteúdo principal

Produtos e SKUs

A tela Produtos e SKUs é a tela mais importante do catálogo do idworks. É aqui que cada produto que sua empresa vende, compra, fabrica ou controla em estoque nasce. Sem cadastro de SKU, nada funciona: não se vende, não se emite nota fiscal, não se controla estoque, não se publica anúncio nos canais. O resto do sistema gira ao redor do que está cadastrado aqui.

A tela tem dois modos de visualização principais:

  • Produtos e SKUs (/app/skus) — lista todos os SKUs cadastrados, um por linha. Variações aparecem como linhas separadas.
  • Listar Produtos (/app/listproducts) — agrupa as variações dentro do produto-pai. Linha = 1 produto; variações ficam expandidas/colapsáveis. Modo recomendado para catálogos com muitas variações (P/M/G, cores etc.).

Os botões da barra superior permitem cadastrar Novo Produto (com dropdown: Produto / Kit / Matéria-prima) ou Novo SKU (variação de um produto existente), importar planilha, importar imagens por URL, imprimir etiquetas, inativar em lote, criar anúncio nos canais e remover selecionados.

Ao clicar duas vezes em uma linha (ou no ícone Editar), abre a ficha completa do SKU com 22 abas — onde mora todo o detalhe: campos básicos, fiscais, especificações, imagens, kit, preços, armazéns, lotes, etc. As abas que aparecem dependem do tipo do produto e dos privilégios do usuário.

As configurações que mudam o comportamento (mostrar custos, abas visíveis, validações) ficam em Configurações → Parametrizações e em Configurações → Perfis de Acesso; estão resumidas no final desta página.

Índice​

Conceito

Cadastro e edição

Ficha completa — abas

Campos da Aba Geral em detalhe

Busca e visualização (lista)

Ações em lote (Mais Ações)

Regras de negócio

Resumo de parametrizações

Referência rápida

Qual a diferença entre Produto e SKU?​

  • Produto (Product) é o registro "mãe" — o nome comercial do que você vende (ex.: "Camiseta Polo Masculina"). Concentra o que é comum a todas as variações: nome, categoria, marca, descrição, imagens principais, ficha técnica.
  • SKU (StockKeepingUnit, sigla para "Stock Keeping Unit") é uma unidade vendável específica — a variação concreta com estoque e preço próprios (ex.: "Camiseta Polo Masculina Cor Azul Tamanho M"). Cada SKU tem seu código de referência (interno), código de barras (EAN/GTIN), dimensões, estoque, preço.

Quando o produto não tem variação, o registro de Produto tem um único SKU — na prática você nem percebe a separação.

Quando o produto tem variações (cor, tamanho, voltagem), você cria um Produto + vários SKUs (um por combinação de variações). Estoque, preço, código de barras são controlados por SKU.

📍 Onde: menu lateral → Produtos → Listar Produtos (modo Produtos) ou Produtos e SKUs (modo SKUs).

O que é uma variação?​

É uma dimensão de escolha do produto que cria SKUs separados. Exemplos:

  • Cor: a Camiseta Polo Azul é um SKU diferente da Camiseta Polo Vermelha.
  • Tamanho: P, M, G, GG cada uma é um SKU.
  • Voltagem: 110V e 220V de um liquidificador são SKUs diferentes.
  • Sabor, Material, Embalagem — qualquer atributo que faça o cliente escolher entre opções.

A combinação de variações define cada SKU. Camiseta Polo em 4 cores × 5 tamanhos = 20 SKUs.

Os tipos de variação disponíveis são cadastrados em Produtos → Tipo Variações (Grade) (cor, tamanho, voltagem, sabor, etc.) e os valores de cada tipo (Cor: Azul, Vermelho, Verde; Tamanho: P, M, G) também ficam lá.

Quais são os tipos de produto?​

TipoQuando usar
SKU (Produto normal)Produto comum com estoque físico. Tipo mais usado.
Produto com variaçãoPai de SKUs variantes (cor, tamanho). O pai não tem estoque — cada variação tem o seu.
KitComposição virtual de outros SKUs (ex.: Cesta Café da Manhã = pão + queijo + café). Estoque do kit é virtual, calculado em função dos componentes.
CaixaProduto que é uma embalagem fechada de outro (ex.: Caixa com 12 unidades do Refrigerante X). Vai para a aba Composição Caixa definir o que tem dentro.
Matéria-primaInsumo usado em Produção Própria (não comercializado direto).
ServiçoMão-de-obra, instalação, conserto. Sem controle de estoque físico.
Uso e consumoMercadoria para uso interno (papelaria, material de limpeza). Não comercializa.
ClubePlano de assinatura (recurso descontinuado na maioria das contas).

A escolha do tipo é feita ao criar o produto (botão Novo Produto) e não pode mudar depois — se errou, é necessário excluir e recriar.

Quais são os status do SKU?​

StatusSignificado
AtivoEstado normal — pode comprar, vender, controlar estoque.
Compra suspensaNão pode mais ser comprado (nova compra), mas continua vendendo o estoque existente.
Venda suspensaNão pode mais vender (esconde dos canais e do PDV), mas continua aceitando entrada.
InativoFora de operação. Não vende nem compra. Usado para produtos descontinuados, mas mantém histórico.
DeletadoStatus final — produto removido. Não aparece em listas nem em buscas.

O status fica no campo Status da aba Geral. Pode ser alterado individualmente (no modal de cadastro/edição) ou em massa pela ação Inativar Produtos no menu Mais Ações.

Quando uso o modo Produtos e SKUs e quando uso Listar Produtos?​

Produtos e SKUs (/app/skus)Listar Produtos (/app/listproducts)
Cada linha =1 SKU1 Produto (variações agrupadas)
Quando usarOperação com poucos produtos sem variação, ou quando você precisa ver/editar SKU individual diretamente.Catálogos grandes com variações; gestão por produto (cadastrar 1 produto com 20 SKUs aparece como 1 linha).
Ações de linhaEditar SKU, ver preços, ver armazém, remover SKU.Editar produto, expandir variações.
Privilégio necessárioVisualizar SkuVisualizar Listar Produtos

Os dois modos usam a mesma ficha (com 22 abas) quando você abre um item. A diferença é só no formato da listagem.

Como criar um produto novo (sem variação)?​

  1. Clique em Novo Produto no canto superior direito.
  2. Escolha Produto no dropdown.
  3. No modal:
    • Nome do Produto — nome comercial.
    • Código de referência — código interno (pode deixar em branco para o sistema gerar).
    • Categoria, Marca, NCM — campos fiscais e organizacionais.
    • Departamento Fiscal — obrigatório para emitir NF.
    • Tipo — Produto (já vem pré-selecionado).
    • Dimensões e peso, EAN, Embalagem, etc.
  4. Clique em Salvar. O produto + seu SKU único são criados juntos.
  5. A ficha do SKU abre automaticamente em uma nova aba para você completar os detalhes (preço, imagens, fornecedores, etc.).

Cadastros que você precisa ter antes:

  • Categoria — cadastre em Produtos → Categorias.
  • Marca — cadastre em Produtos → Marcas.
  • Departamento Fiscal — cadastre em Produtos → Departamento Fiscal.
  • (Opcional) Tipo Variações (Grade) — se for produto com variação.
  • (Opcional) Categoria de Endereço — se usa WMS.

Pré-requisito: privilégio Criar Sku.

Como criar um produto com variações (cor, tamanho)?​

  1. Novo Produto → Produto (mesmo botão).
  2. Preencha os campos básicos do produto (nome, categoria, marca, departamento fiscal).
  3. No modal de cadastro, escolha as variações a usar (Cor, Tamanho — vem da tela Tipo Variações).
  4. Selecione os valores de cada variação (Cor: Azul, Vermelho; Tamanho: P, M, G).
  5. O modal monta automaticamente a grade — você vê uma linha por combinação (Azul/P, Azul/M, Azul/G, Vermelho/P, Vermelho/M, Vermelho/G).
  6. Cada linha pode ter código de referência, código de barras e preço próprios — preencha o que diferencia cada SKU.
  7. Clique em Salvar. O sistema cria 1 Produto + N SKUs (1 por combinação).

Depois é possível adicionar mais SKUs (mais variações) abrindo a ficha do produto-pai e usando a aba SKUs, ou clicando em Novo SKU na barra principal (atalho que abre o modal vinculado ao produto-pai escolhido).

Como criar um Kit?​

  1. Novo Produto → Kit.
  2. Preencha os campos básicos (nome, categoria, marca, departamento fiscal).
  3. Salve. A ficha do kit abre em nova aba.
  4. Vá na aba Kit.
  5. Adicione os componentes: para cada SKU que faz parte do kit, informe a quantidade.
  6. Configure se o sistema deve recalcular o preço do kit automaticamente quando os componentes mudarem de preço.

O kit não tem estoque físico próprio — quando você consulta o saldo, o sistema calcula em função do menor componente disponível. Exemplo: Kit com 1 unidade do A + 2 unidades do B. Se A tem 10 e B tem 30, o kit pode ser montado 10 vezes (limitado por A). Se A tem 5, o kit cai para 2 (5÷2 arredondado para baixo de B, mas A limita).

Como criar uma Caixa (produto agrupado)?​

Caixa é um produto que representa um agrupamento de outro — ex.: "Caixa com 12 unidades do Refrigerante X". Vai e volta como uma unidade no estoque, mas internamente o sistema sabe que equivale a 12 unidades do produto base.

  1. Novo Produto → Caixa (se a opção estiver disponível) ou crie um SKU com tipo Caixa.
  2. Preencha os básicos.
  3. Salve.
  4. Vá na aba Composição Caixa e cadastre qual é o produto base e quantas unidades vão na caixa.

Usado para venda no atacado/distribuidores e para conciliação fiscal quando a NF do fornecedor vem em caixas.

Como criar Matéria-prima?​

  1. Novo Produto → Matéria-prima.
  2. Preencha nome, categoria, fiscal — tudo igual ao Produto normal.
  3. Salve.

A diferença prática é que matérias-primas não aparecem nos canais de venda (não são vendidas direto ao consumidor) e podem ser usadas como componentes em Produção Própria — você cria um SKU Produto com a opção Produção Própria = Sim e cadastra na aba Produção Própria quais matérias-primas vão no processo de fabricação.

Como criar um Serviço?​

  1. Novo Produto → Produto.
  2. Mude o Tipo para Serviço no formulário.
  3. Preencha os campos. Dimensões, peso, EAN ficam em branco (serviço não tem corpo físico).
  4. Departamento Fiscal aponta para o configurado para serviços (com CFOPs apropriados — geralmente sem ICMS, com ISS).
  5. Salve.

O serviço não vai para o estoque, não tem entrada/saída de mercadoria. Aparece na lista, vai para o anúncio, vai para a NF de serviço.

Como editar um SKU?​

  1. Localize na lista.
  2. Clique no ícone Editar (lápis) na coluna direita — ou dois cliques na linha — abre a ficha completa em nova aba do navegador interno.
  3. Edite o que for necessário em qualquer aba.
  4. Os salvamentos acontecem por aba — alterações na Geral são salvas pelo botão Salvar geral; alterações em Imagens, Kit, Lotes etc. são salvas por sub-ações dentro da própria aba.

Pré-requisito: privilégio Editar Sku.

Como remover um SKU?​

  1. Localize na lista.
  2. Clique no ícone Remover (lixeira).
  3. Confirme.

A exclusão bloqueia quando o SKU tem:

  • Movimentos de estoque (entradas ou saídas).
  • Pedidos associados.
  • Kits que o usam como componente (precisa remover dos kits antes).
  • Anúncios ativos nos canais.

Nesses casos, a alternativa é Inativar (mudar status para Inativo) — preserva o histórico.

Pré-requisito: privilégio Deletar Produto/Sku.

Por que não consigo editar o código de referência?​

Porque o Código de Referência (também chamado de "SKU interno" ou "código do produto") é a chave principal que conecta o produto a tudo o que veio antes: notas fiscais, históricos de entrada e saída, anúncios nos canais, integrações. Mudar o código causaria divergência em todos esses pontos.

Por padrão, o campo fica somente leitura depois de criado. Para destravar a edição, o usuário precisa ter o privilégio Editar Código Referência Sku — geralmente reservado a administradores para casos pontuais de correção.

Mesmo com o privilégio, edite com cuidado. Trocar o código pode quebrar:

  • Anúncios em canais que usam o código antigo como identificador.
  • Importações de pedidos que vêm com o código antigo.
  • Relatórios e auditorias.

Aba Geral — o que tem aqui?​

É a aba principal com os campos básicos do SKU. Tudo o que define "o que é esse produto" do ponto de vista comercial e operacional:

  • Identificação: Nome, Código de Referência, Tipo, Marca, Categoria, Status.
  • Códigos: Código de Barras (EAN/GTIN), códigos de barras adicionais (link para outra aba).
  • Físico: Dimensões (altura, largura, comprimento), Peso, Embalagem, Unidade de Medida.
  • Comercial: Curva ABC + ajuste manual, Condição (Novo/Usado/Recondicionado), Garantia (tempo + tipo).
  • Logística: Categoria de Endereço (WMS), Localização padrão.
  • Estoque: Estoque Infinito, Estoque de Segurança, Alerta de Estoque, Controle de Lote, Controle de Rastreabilidade, Validade Obrigatória.
  • Produção: Produção Própria (sim/não), Linha de Produção.
  • Texto livre: Descrição, Comentários, Tags.
  • Comportamento da NF: Tratar como Kit na NF, Compartilhar Imagem entre SKUs.

São ~70 campos no total. Os mais importantes estão explicados em detalhe abaixo.

Aba SKUs — variações​

Mostra a grade de variações do produto-pai. Cada linha é um SKU variante, com:

  • Combinação de variações (ex.: Cor: Azul / Tamanho: M).
  • Código de referência próprio.
  • Código de barras próprio.
  • Status próprio (uma variação pode estar Ativa e outra Inativa).
  • Botões para editar, duplicar, remover.

Aqui você adiciona novas variações (botão Novo SKU), duplica uma variação para criar outra parecida, e gerencia as combinações.

Quando o produto não tem variação, esta aba pode aparecer com 1 linha (o próprio SKU) ou não aparecer.

Aba Fiscal​

Concentra todos os campos fiscais do SKU:

  • Departamento Fiscal (obrigatório) — aponta para o cadastro de Departamento Fiscal que define CFOPs e ICMS.
  • NCM (Nomenclatura Comum do Mercosul) — código de 8 dígitos que classifica o produto fiscalmente.
  • Ex Tipi — código complementar do NCM.
  • CEST — Código Especificador da Substituição Tributária (quando o produto está em ST).
  • CST / Origem Fiscal — Origem do produto (0=Nacional, 1=Importado direto, 2=Importado de terceiro, etc.).
  • Faturador — qual matriz/filial emite a NF (multi-faturador).
  • Regimes especiais — quando aplicável (Substituto Tributário, regime especial estadual).
  • Configuração por faturador — quando você tem multi-CNPJ, pode configurar tributação diferente por faturador (ex.: matriz é Lucro Presumido, filial é Simples).

Pré-requisito: privilégio Visualizar tab Fiscal.

Aba Especificações​

Mostra os campos extras que vieram da Categoria do produto (especificações). Cada categoria pode definir seus próprios campos — exemplo: produtos de Eletrônicos têm "Voltagem", "Garantia", "Cor"; produtos de Vestuário têm "Tecido", "Coleção".

Os campos aparecem aqui para você preencher os valores para este SKU específico. O preenchimento alimenta filtros nas vitrines, especificações dos anúncios e listagens.

A definição de quais campos são especificações de cada categoria é feita em Produtos → Categorias.

Pré-requisito: privilégio Visualizar tab Especificação.

Aba Imagens​

Galeria de imagens do SKU. Permite:

  • Adicionar imagens (upload de arquivo).
  • Ordenar (a primeira é a Principal).
  • Marcar tipo (Principal, Galeria, Variante específica).
  • Compartilhar entre SKUs quando o produto tem variações com imagens em comum.
  • Importar por URL quando a imagem está em um servidor externo (use o botão "Importar imagens por URL" da barra principal).

Formatos aceitos: JPG, PNG, WEBP. Tamanho recomendado: 1000x1000 ou maior.

Pré-requisito: privilégios Visualizar tab Imagem e Adicionar Imagem Sku.

Aba Kit​

Aparece apenas para produtos do tipo Kit. Mostra os componentes do kit:

  • SKU componente.
  • Quantidade necessária.
  • (Opcional) ordem.

Configurações:

  • Atualizar preço automaticamente — quando ligada, o preço do kit é recalculado sozinho quando um componente muda de preço (soma dos preços de cada componente × quantidade).
  • Como tratar na NF — alguns canais e regimes exigem que o kit apareça na NF como múltiplas linhas (uma por componente); o switch Tratar como Kit na NF controla isso.

Pré-requisito: privilégios Visualizar Tab Kit, Adicionar item kit, Editar item kit, Deletar item kit.

Aba Kits Relacionados​

Mostra os kits que usam este SKU como componente. Útil quando você está editando o preço/estoque de um componente e quer ver o impacto: quais kits dependem deste SKU.

A aba é informativa — não permite editar os kits diretamente (cada kit é gerenciado na própria ficha do kit).

Aba Preços​

Mostra os preços ativos do SKU em todas as Políticas Comerciais cadastradas. É o mesmo conteúdo da tela Preços filtrado por este SKU.

Permite criar, editar e remover preços direto daqui sem sair da ficha.

Pré-requisito: privilégios Visualizar tab Preço, Criar preço Sku, Editar preço Sku.

Aba Armazéns​

Mostra o saldo do SKU em cada armazém (multi-CD). Cada linha = 1 armazém, com:

  • Quantidade disponível.
  • Quantidade reservada.
  • Quantidade total.
  • Valor de estoque (quantidade × custo médio).

Aparece apenas para SKUs com controle físico de estoque (tipo Produto/SKU/Matéria-prima/Caixa). Serviços e Kits virtuais não têm essa aba (ou aparecem vazia).

A gestão dos armazéns em si fica em Logística → Armazéns.

Aba Endereços​

Mostra os endereços (WMS) onde o SKU está alocado. Cada linha = 1 endereço com:

  • CD + Armazém + Endereço (rua/módulo/coluna/nível).
  • Quantidade no endereço.
  • Lote (se aplicável).
  • Endereço padrão (sim/não).

Aparece quando a empresa usa WMS estruturado (parametrização do módulo Endereços). Pequenas operações sem WMS não enxergam esta aba.

A gestão dos endereços em si fica em Logística → Endereços.

Aba Lotes / Endereços​

Aparece apenas quando o SKU tem Controle de Lote ligado (sub-aba interna controlada pelo switch "Controle de Lote" da aba Geral). Mostra:

  • Cada lote do produto.
  • Número/identificação do lote.
  • Validade.
  • Data de fabricação.
  • Endereço onde está.
  • Saldo do lote.
  • Status (Ativo / Esgotado).

É a mesma listagem da tela Logística → Lotes e Endereços SKUs filtrada pelo SKU.

Pré-requisito: privilégio Visualizar lote.

Aba Serial / IMEI​

Aparece para SKUs configurados com controle de número de série (eletrônicos, celulares, equipamentos). Lista os números de série individuais com status (Em estoque, Vendido, Devolvido).

A gestão em massa fica em Produtos → Números de série/IMEI.

Pré-requisitos: privilégios Criar Número de Seriel | IMEI, Editar Número de Seriel | IMEI, Deletar Número de Seriel | IMEI.

Aba Anúncios​

Mostra os anúncios ativos do SKU em todos os canais integrados (Mercado Livre, Shopee, Magalu, etc.). Cada linha = 1 anúncio, com:

  • Canal.
  • Código do anúncio (ID externo).
  • Status (Ativo, Pausado, Encerrado).
  • Preço no canal.
  • Estoque no canal.

É consulta — ações sobre anúncios (publicar, atualizar, pausar) ficam na tela específica de cada canal/integração.

Aba Entradas​

Lista o histórico de movimentos de entrada do SKU: compras, devoluções de clientes, ajustes positivos, produção concluída. Cada linha tem data, origem, quantidade, custo, armazém, lote.

Útil para auditoria — "quando esse produto entrou pela última vez?", "qual foi o custo da última compra?".

Aparece apenas para tipos com estoque físico.

Aba Saídas​

Lista o histórico de saídas do SKU: vendas, transferências, ajustes negativos, produção consumida. Mesmas colunas das Entradas, mais detalhes do pedido/cliente quando origem é venda.

A aba também traz uma análise rápida (componente SaleDetails) com indicadores: total vendido no período, ticket médio, principais canais, top clientes.

Aba Fator nota fiscal​

Quando o SKU é estocado em uma unidade e vendido em outra (ex.: estoca em peça, vende em caixa de 12), configure aqui o fator de conversão que vai para a NF — assim a NF sai com quantidade convertida corretamente.

Exemplo: SKU estocado em "Litro", vendido como "Garrafa 1L" → fator 1:1. SKU estocado em "Litro", vendido como "Garrafa 0,5L" → fator 1:2 (cada saída de 1 garrafa baixa 0,5L do estoque).

Aba Faturador​

Quando a empresa tem multi-faturador (matriz + filiais com CNPJs distintos), esta aba permite habilitar o SKU para cada matriz/filial e configurar:

  • Quais faturadores podem vender este SKU.
  • Departamento Fiscal específico por faturador (quando o regime/regras fiscais variam por matriz).
  • Configurações de NF específicas por faturador.

Sem multi-faturador (1 CNPJ só), esta aba não aparece.

Aba Conciliação Fiscal​

Cruza a configuração fiscal cadastrada no SKU com a configuração efetivamente usada nas NFs emitidas. Mostra divergências (NCM cadastrado é X mas a última NF saiu com Y; CFOP esperado é Z mas usou W).

Útil para auditoria e correção retroativa. Não corrige automaticamente — só sinaliza.

Aba Composição Caixa​

Aparece apenas para SKUs do tipo Caixa. Define qual é o produto base e quantas unidades estão dentro da caixa. Exemplo: "Caixa com 12 garrafas do Refrigerante X" → base = Refrigerante X, quantidade = 12.

Quando vende a caixa, o sistema baixa 12 unidades do produto base do estoque.

Aba Promoção PDV​

Lista promoções específicas para o PDV físico que envolvem este SKU. Promoções incluem:

  • Desconto direto (X% off).
  • Leve N pague M.
  • Combo (compra X + Y leva desconto).
  • Brinde (compra X ganha Y).

A criação das promoções fica na tela Promoções PDV.

Pré-requisito: privilégio Visualizar tab Promoção PDV.

Aba Produção Própria​

Aparece quando o switch Produção Própria está ligado na Geral. Define o processo de fabricação:

  • Etapas de produção (ex.: corte → costura → acabamento).
  • Matérias-primas consumidas em cada etapa, com quantidade.
  • Linha de Produção vinculada (config da tela Linhas de Produção).

A produção em si é executada nas telas Produção → Ordens de Produção e Produção → Linha de Produção.

Aba Log​

Auditoria de alterações no SKU. Cada linha = 1 alteração, com:

  • Data/hora.
  • Usuário que alterou.
  • Campo alterado.
  • Valor anterior → valor novo.
  • Origem da alteração (manual via tela, importação por planilha, integração com canal, recálculo automático).

Útil para investigar "quem mudou o preço?", "quando o NCM foi alterado?".

Pré-requisito: privilégio Exportar Log Sku para exportar.

Aba Código de barras adicionais​

Quando o produto tem mais de um código de barras (ex.: GTIN-13 + GTIN-14 da caixa + código interno legado), você cadastra todos aqui. Cada código pode ter um tipo (Principal / Adicional / Por Pacote / Por Embalagem).

Útil quando recebe NF com código de barras diferente do principal — o sistema reconhece via os adicionais.

Nome do Produto e Código de Referência​

  • Nome do Produto (SkuName) — o nome comercial que aparece em todos os lugares (catálogo, NF, etiqueta, canal de venda). Máx. 200 caracteres. Edite com cuidado em produtos publicados — alguns canais (especialmente marketplaces) podem rejeitar mudança brusca de título.
  • Código de Referência — código interno único do SKU dentro da conta. Aparece em etiquetas, em relatórios, na busca rápida, na importação de pedidos. Quando deixado em branco, o sistema gera automaticamente (geralmente um número sequencial). Quando preenchido manualmente, deve ser único na conta.

Veja Por que não consigo editar o código de referência? para entender a proteção.

Tipo do Produto / SKU​

Veja Quais são os tipos de produto?. Resumindo: SKU, Produto com variação, Kit, Caixa, Matéria-prima, Serviço, Uso e consumo, Clube.

Atenção: depois de criado, o tipo não pode ser alterado. Para mudar, é necessário excluir e recriar.

Marca, Categoria e Status​

  • Marca — vem de Produtos → Marcas. Obrigatória (em algumas configurações).
  • Categoria — vem de Produtos → Categorias. Define quais Especificações o produto vai ter. Obrigatória.
  • Status — Ativo, Inativo, Compra suspensa, Venda suspensa, Deletado. Veja Quais são os status do SKU?.

Código de Barras (EAN/GTIN)​

Campo BarCode — código EAN-13 (13 dígitos), GTIN-14 ou outro padrão. Deve ser único na conta. O sistema valida o dígito verificador.

Quando o produto não tem EAN oficial, alguns lojistas usam:

  • Sequência interna gerada pelo botão Gerar EAN (nas ações da ficha).
  • O próprio Código de Referência.
  • EAN da caixa coletiva.

Códigos secundários ficam na aba Código de barras adicionais.

Unidade de medida​

MeasurementUnit — UN, KG, L, M, M², PC, etc. Define a unidade do estoque e da venda. Importante para NF (precisa ser uma unidade aceita pela SEFAZ).

Quando vende em unidade diferente da estocada, configure na aba Fator nota fiscal.

Dimensões e peso (cm e kg)​

  • Altura, Largura, Comprimento (cm) — dimensões do produto embalado (não nu). Usadas para:
    • Cálculo de frete (a transportadora cobra por peso cubado).
    • Cálculo de volumetria de carga.
    • Empacotamento (cabe ou não cabe na caixa X?).
  • Peso (kg) — peso bruto da embalagem com o produto dentro.
  • Ocupação Pacote — campo opcional para multiplicar o pacote (ex.: ocupação 1.5 = ocupa 1,5x o volume calculado).

Produtos sem dimensões/peso preenchidos podem ter problema no cálculo de frete (algumas transportadoras rejeitam) e na separação WMS (operador não sabe em qual caixa cabe). Boa prática: preencher mesmo que aproximado.

Embalagem (Package)​

Package — quantidade de unidades por embalagem padrão (ex.: 1 = unitário; 12 = embalado de 12 em 12). Influencia em separação WMS e na conferência da nota fiscal de entrada.

Curva ABC e ajuste manual​

  • Curva ABC (AbcCurve) — classificação automática baseada em vendas: A (top, 80% das vendas), B (intermediário), C (cauda longa). Calculada em background com base no histórico de vendas.
  • Ajuste Curva ABC (AbcCurveAdjust) — sobrescrita manual. Você força "Curva A" mesmo que o produto venda pouco (porque é estratégico) ou "Curva C" mesmo que venda muito (produto que não quer dar mais foco).

Útil para priorizar atendimento, separação no CD, agrupamento em endereços de picking, alertas de estoque.

Condição (Novo / Usado / Recondicionado)​

Marca a condição comercial do produto:

  • Novo (default).
  • Usado — produto de segunda mão (típico em marketplaces que aceitam usados, ex.: Mercado Livre).
  • Recondicionado — produto restaurado.

A condição é repassada para os canais que diferenciam (Mercado Livre destaca como "Usado"/"Novo" no anúncio).

Garantia​

Dois campos juntos:

  • Tempo de garantia (WarrantyTime) — número inteiro (ex.: 12).
  • Unidade do tempo (WarrantyTimeType) — Dias / Meses / Anos.

Exemplo: 12 + Meses = garantia de 12 meses. Aparece em alguns anúncios de canal.

Categoria de Endereço (WMS)​

Quando a empresa usa WMS, marca o produto como pertencendo a uma categoria de armazenagem (ex.: Refrigerado, Frágil, Pesado, Alto Giro). Influencia em onde o sistema sugere armazenar e em qual endereço de picking ele ocupa.

Cadastrado em Logística → Categoria Armazenagem.

Produção Própria​

OwnProduction (switch Sim/Não). Marca o SKU como fabricado internamente (não comprado pronto). Habilita a aba Produção Própria para cadastrar o processo de fabricação (etapas + matérias-primas).

Útil quando você fabrica parte do que vende — desde montagem de cesta até costura, montagem eletrônica, fabricação industrial.

Estoque Infinito​

InfiniteInventory (switch Sim/Não). Quando ligado, o sistema considera o estoque do produto como infinito — sem controle físico. Útil para:

  • Serviços (já é sem estoque, mas algumas operações usam o switch para forçar).
  • Produtos sob encomenda (compra do fornecedor toda vez que vende).
  • Produtos virtuais (e-books, software, licenças).

Quando ligado, vendas nunca caem em "Sem estoque" e não geram saída física.

Estoque de Segurança e Alerta de Estoque​

  • Estoque de Segurança (SafetyStock) — quantidade mínima que o sistema reserva para evitar ruptura. Saldo apresentado para venda = saldo real − estoque de segurança. Útil para garantir disponibilidade entre o pedido de compra e a chegada da mercadoria.
  • Alerta de Estoque (MinAlertStock) — quando o saldo cai abaixo desse número, o produto vira alerta (cor vermelha em listagens, notificação no painel). Sinal para repor.

A combinação típica: alerta = 10 (avisa quando chega aí), segurança = 5 (não vende se o saldo cair abaixo).

Controle de Lote​

Batch (switch Sim/Não). Quando ligado, o sistema rastreia o saldo por lote — não apenas a quantidade total, mas separada por número de lote / data de fabricação / validade.

Obrigatório para:

  • Produtos perecíveis (alimentos, medicamentos) — para vender pelo lote mais antigo (FIFO).
  • Produtos com rastreabilidade exigida (medicamentos, cosméticos).

Ativa a aba Lotes / Endereços e habilita a tela Logística → Lotes e Endereços SKUs.

Controle de Rastreabilidade​

RastroControl (switch Sim/Não). Quando ligado, força que toda movimentação registre número de lote e data de validade — para gerar a tag rastro na NF (exigida pela SEFAZ em alguns produtos: medicamentos, agrotóxicos, produtos de origem animal).

Quando ligado, o sistema bloqueia faturamento sem informação de rastreabilidade (mensagem: "Bloquear faturamento sem informação de rastreabilidade").

Validade Obrigatória​

BestBeforeRequired (switch Sim/Não). Quando ligado, o sistema exige data de validade ao cadastrar lotes deste SKU. Sem a data, não permite criar/movimentar o lote.

Use em produtos perecíveis. Combine com Controle de Lote para FIFO automático por validade.

Tags​

Tags — texto livre separado por vírgula. Etiquetas operacionais (não fiscais, não comerciais — só para você organizar). Exemplos: "promoção_natal", "vendendo_pouco", "revisar_fiscal".

Útil para filtrar a listagem rapidamente: você bate "promoção_natal" no filtro e vê todos os marcados.

Comentários​

Texto livre para anotações internas que não aparecem em lugar nenhum (NF, anúncio, etiqueta) — só na ficha do SKU. Use para histórico de mudanças, observações de fornecedor, lembretes.

Compartilhar Imagem entre SKUs​

ShareProductImage (switch Sim/Não). Quando ligado, as imagens cadastradas no produto-pai (Product) são automaticamente herdadas por todas as variações (SKUs). Útil quando todas as variações têm a mesma aparência exceto pela cor/tamanho (o foto do produto é a mesma).

Quando desligado, cada SKU pode ter seu próprio conjunto de imagens (cada cor tem sua foto).

Tratar como Kit na NF (NfeInvoiceAsKit)​

NfeInvoiceAsKit (switch Sim/Não). Para SKUs do tipo Kit. Quando ligado:

  • A NF é emitida com uma linha por componente do kit (cada componente sai como item separado, com seu próprio NCM, CST, CFOP).
  • Quando desligado, a NF sai com uma única linha do kit (NCM e CFOP do próprio kit).

A escolha depende do regime fiscal e da exigência do estado/cliente. Alguns regimes proíbem kit em uma linha (precisa abrir os componentes). Confirme com o contador.

Quais filtros a tela tem?​

A tela tem filtros extensos (em Filtros no topo da lista):

  • Conta (multi-empresa).
  • Categoria (com seletor em árvore).
  • Marca.
  • Departamento Fiscal.
  • Status (Ativo, Inativo, Compra suspensa, Venda suspensa).
  • Tipo (SKU, Produto com variação, Kit, Caixa, Matéria-prima, Serviço, Uso e consumo).
  • Curva ABC.
  • Tags (CSV).
  • Fornecedor + Código no Fornecedor.
  • Faturador (em multi-faturador).
  • Integração — produtos com anúncio em uma integração específica.
  • EAN / Código de Barras.
  • Código de Referência.
  • Nome do produto.
  • Faixa de preço (de R$ X a R$ Y).
  • Faixa de custo.
  • Faixa de saldo.
  • Faixa de criação (data).
  • Faixa de alteração (data).
  • Produção Própria (sim/não).
  • Estoque Infinito (sim/não).
  • Controle de Lote (sim/não).
  • Sem imagem / Sem preço / Sem anúncio / Sem lote (ver próxima pergunta).
  • Vários outros — abra o painel para explorar.

Como buscar produtos sem imagem, sem preço ou sem anúncio?​

A tela tem filtros de ausência muito úteis para auditoria:

  • Sem imagem — produtos que não têm nenhuma imagem cadastrada. Use para preencher catálogo antes de publicar.
  • Sem preço — produtos sem nenhum preço ativo. Importante: sem preço, a venda falha.
  • Sem anúncio — produtos sem anúncio em nenhum canal. Use para publicar produtos pendentes.
  • Sem fornecedor — produtos sem fornecedor cadastrado (impossível fazer pedido de compra).
  • Sem lote — quando o produto tem controle de lote, busca os SKUs sem nenhum lote ativo.

Marque as opções desejadas e o filtro retorna apenas os SKUs nesse estado. Depois é só usar as ações em massa para corrigir.

Como mostrar/esconder colunas?​

No canto direito acima da tabela, há um seletor de colunas (ícone de configuração). Clique para ver a lista de todas as colunas disponíveis e marque/desmarque as que quer ver. A escolha fica salva no seu navegador.

Por que não vejo as colunas de custo?​

Porque você não tem o privilégio Mostrar Custo Produto. Sem ele, as colunas R$ Último Custo, R$ Custo Médio, R$ Custo Manual, R$ Saldo Estoque, R$ Custo Total etc. são automaticamente escondidas do grid e dos relatórios.

Para liberar, peça ao administrador para incluir o privilégio no seu perfil de acesso (Configurações → Perfis de Acesso).

Como ver a grade de preços de um produto sem abrir a ficha?​

Na coluna direita de cada linha (modo Listar Produtos), há um ícone de Preços que abre um modal mostrando todos os preços ativos do SKU (por Política Comercial + vigência), sem precisar abrir a ficha completa.

Atalho útil para conferência rápida durante busca/auditoria.

Como ver o saldo por armazém sem abrir a ficha?​

Similar ao Preços: na coluna direita há um ícone de Armazéns que abre um modal com o saldo do SKU em cada armazém. Útil quando você quer confirmar onde tem disponibilidade antes de fechar uma venda.

Como importar produtos por planilha?​

  1. Clique em Mais Ações → Importar Arquivo.
  2. Baixe o modelo (botão "Baixar Modelo" dentro do modal) — uma planilha XLSX com as colunas esperadas.
  3. Preencha:
    • 1 linha por SKU.
    • Colunas: Nome, Código de Referência, EAN, Categoria, Marca, Departamento Fiscal, NCM, Dimensões, Peso, etc.
    • Para criar variação, use o produto-pai na primeira linha e variações nas seguintes (formato detalhado no modelo).
  4. Salve o arquivo.
  5. Volte ao modal, escolha o arquivo e clique em Importar.
  6. O sistema processa, valida e mostra um relatório (criados / atualizados / erros).

Use para cadastrar centenas de produtos de uma vez (lançamento de nova coleção, migração de outro sistema).

Pré-requisito: privilégio Criar Sku.

Como importar imagens por URL em massa?​

  1. Clique em Mais Ações → Importar imagens por URL.
  2. No modal:
    • Cole uma lista (planilha ou texto) de SKU + URL da imagem.
    • Ou faça upload de um arquivo XLSX no formato.
  3. Clique em Processar. O sistema baixa cada imagem da URL e anexa ao SKU correspondente.

Útil quando o catálogo vem com imagens hospedadas em outro lugar (servidor de fornecedor, drive público) e você precisa baixar tudo de uma vez.

Como inativar vários produtos de uma vez?​

  1. Marque as caixas de seleção dos SKUs.
  2. Clique em Mais Ações → Inativar Produtos.
  3. No modal, confirme.
  4. O sistema muda o status de todos para Inativo de uma vez.

Útil para descontinuar uma coleção inteira ou suspender produtos de fim de estação.

A operação não exclui — só inativa. Você pode reativar individualmente.

Como imprimir etiquetas em lote?​

  1. Marque os SKUs.
  2. Clique em Mais Ações → Imprimir Etiquetas.
  3. O sistema gera as etiquetas no formato ZPL com preço, código de barras e identificação.

A configuração do leiaute (com ou sem preço, fonte, tamanho) é feita em Etiquetas.

Como criar anúncio nos canais a partir da seleção?​

  1. Marque os SKUs.
  2. Use os botões Anunciar (clássico) ou Anúncio v2 na barra superior.
  3. Selecione os canais (Mercado Livre, Shopee, etc.) onde quer publicar.
  4. O sistema cria os anúncios em background nos canais escolhidos.

Pré-requisito: privilégio Criar oferta de SKU.

Como remover vários SKUs de uma vez?​

  1. Marque os SKUs.
  2. Clique em Remover Selecionados (botão azul que aparece na barra quando há seleção).
  3. Confirme.

O sistema processa um a um. Falhas (SKUs com movimento, em pedidos, etc.) são reportadas no relatório, mas não interrompem o processamento dos outros.

Pré-requisito: privilégio Deletar Produto/Sku.

O que outras ações em massa fazem?​

O menu Mais Ações → Ações abre um sub-menu com várias operações em lote disponíveis:

  • Exportar para Excel — gera planilha com os dados do grid (respeitando colunas visíveis).
  • Alterar campo em massa — escolhe um campo (categoria, marca, status, etc.) e altera em todos os selecionados.
  • Recalcular curva ABC — força recálculo das curvas dos selecionados.
  • Recalcular custos — refaz o cálculo de custo médio com base no histórico.
  • Outras dependentes de privilégios.

A lista exata varia conforme privilégios e configurações da empresa.

Por que não consigo cadastrar SKU sem Departamento Fiscal?​

Porque a emissão da nota fiscal depende do Departamento Fiscal — é dele que o sistema tira os CFOPs, alíquotas de ICMS, CST de PIS/COFINS/IPI. Sem essa amarração, ao tentar emitir a NF do produto, o sistema falha com erro de "cadastro fiscal não encontrado".

Por isso, o campo Departamento Fiscal é obrigatório no cadastro do SKU (em quase todos os tipos — Serviço tem regra própria, e Uso e Consumo pode ter casos especiais).

Para resolver: cadastre o Departamento Fiscal primeiro em Produtos → Departamento Fiscal, depois volte aqui e selecione no campo.

Por que NCM é obrigatório?​

Porque o NCM (Nomenclatura Comum do Mercosul) é exigido pela legislação brasileira em toda NF de mercadoria. Sem NCM, a SEFAZ rejeita a nota.

Mesmo se você não emite NF agora, é boa prática preencher (consulta com o contador qual NCM se aplica). NCM tem 8 dígitos e depende da natureza do produto (vestuário tem um conjunto, eletrônicos outro, alimentos outro).

Serviços usam Código de Serviço Municipal em vez de NCM (campo separado, configurado no Departamento Fiscal de serviço).

Por que o sistema bloqueia ao salvar dimensões zeradas?​

Algumas configurações da empresa exigem dimensões/peso preenchidos porque:

  • Cálculo de frete — sem dimensões, várias transportadoras rejeitam a cotação.
  • WMS — sem dimensões, o operador não sabe em que caixa empacotar.
  • Volumetria — para análise de carga de caminhão.

A parametrização Bloquear cadastro sem dimensões força preenchimento. Quando desligada, o sistema aceita produto sem dimensões (a sua conta pode ter regra própria).

Para destravar, peça ao administrador para desligar a parametrização ou preencha as dimensões com aproximação.

O que acontece com o estoque ao excluir um SKU?​

A exclusão é bloqueada quando o SKU tem saldo positivo em qualquer armazém — para evitar perda de mercadoria física registrada.

Para excluir um SKU com estoque, é necessário primeiro zerar o saldo (via ajuste de inventário, em Estoque → Inventário) e depois excluir.

Em geral, em vez de excluir, inative o SKU (status = Inativo) — preserva todo o histórico e libera o catálogo de novas vendas/compras.

Por que não consigo excluir um SKU que tem movimento?​

Porque o histórico de entradas e saídas está amarrado ao SKU. Excluí-lo causaria perda de auditoria fiscal e operacional.

A solução é inativar em vez de excluir.

Como o sistema decide se mostra ou esconde uma aba?​

Cada aba tem duas condições:

  1. Privilégio — o usuário precisa ter o privilégio correspondente à aba (Visualizar tab Produto, Visualizar tab Sku, Visualizar tab Preço, Visualizar tab Imagem, Visualizar tab Fiscal, Visualizar Tab Kit, Visualizar tab Promoção PDV, etc.). Sem o privilégio, a aba nem aparece.
  2. Tipo do SKU — algumas abas só fazem sentido para certos tipos. Exemplos:
    • Kit — só para tipo Kit.
    • Composição Caixa — só para tipo Caixa.
    • Produção Própria — só quando o switch Produção Própria está ligado.
    • Lotes / Endereços — só quando o switch Controle de Lote está ligado.
    • Entradas/Saídas/Lotes/Endereços — só para tipos com estoque físico (não aparecem em Serviço/Kit virtual).

Resumo: você pode estar vendo um conjunto diferente de abas de um colega — é normal, depende do produto e do seu perfil.

O que muda em multi-empresa (matriz e filial)?​

Em multi-empresa, cada SKU é cadastrado em uma conta específica. O comportamento muda em:

  • Listagem — você precisa selecionar a conta para ver os SKUs daquela conta.
  • Estoque por filial — saldo é controlado por armazém, e armazéns pertencem a CDs, que pertencem a filiais. Você pode ter o mesmo SKU em vários armazéns/CDs.
  • Faturador — em multi-faturador, a aba Faturador permite habilitar o SKU em cada matriz/filial separadamente.
  • Departamento Fiscal — pode ter Departamentos diferentes por conta (cada conta tem seu cadastro de Departamento Fiscal).

Estoque do kit é controlado separadamente?​

Não. O kit não tem estoque físico próprio. O estoque do kit é virtual, calculado a partir do menor componente disponível, considerando a quantidade de cada um na receita:

Estoque do Kit = MIN(Saldo do componente A ÷ Qtde A no kit, Saldo de B ÷ Qtde B, ...)

Exemplo: Kit "Cesta Café da Manhã" = 1 Pão + 2 Cafés + 1 Leite.

  • Saldo: Pão=10, Café=30, Leite=8.
  • Capacidade: Pão limita a 10, Café limita a 15 (30÷2), Leite limita a 8.
  • Estoque do Kit = 8 (limitado pelo Leite).

Quando você vende o kit, o sistema baixa os componentes proporcionalmente (1 pão, 2 cafés, 1 leite por kit vendido).

Resumo de parametrizações​

As parametrizações ficam em Configurações → Parametrizações nos submenus indicados. As principais que afetam esta tela:

ParametrizaçãoSubmenuO que muda quando ativada
Bloquear preço de venda zeradoProdutoImpede salvar SKU com preço de venda zerado.
Bloquear mais de um preço para mesma pol. comercialProdutoImpede duplicidade na grade de preços.
Checar cadastro fiscal produto para finalizarPedidoAntes de finalizar pedido, valida que todos os SKUs tem cadastro fiscal completo.
Atualizar preço automaticamente canais de vendaAnúncioSincroniza preço com canais ao salvar (não interfere no cadastro, mas no efeito downstream).
Bloquear emissão NF normal para consumidor sem IEFiscal ProdutoBloqueia emissão de NF normal para destinatário pessoa física sem IE.
Bloquear faturamento sem informação de rastreabilidadeFiscal ProdutoQuando o SKU tem Controle de Rastreabilidade ligado, exige info no faturamento.

A lista completa de parametrizações depende dos módulos contratados. Use o filtro no painel de Parametrizações para localizar as relacionadas a "Produto", "SKU" ou "Fiscal".

Privilégios da tela​

Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela.

PrivilégioLibera
Visualizar SkuAcessa a tela Produtos e SKUs e a lista de SKUs. Sem este privilégio, o item de menu nem aparece.
Criar SkuHabilita o botão Novo Produto e o salvamento de novos SKUs.
Editar SkuHabilita o ícone Editar, o salvamento de alterações e o duplo-clique para abrir a ficha.
Deletar Produto/SkuHabilita o ícone Remover e a ação Remover Selecionados.
Exportar SkuHabilita exportação da lista para Excel.
Exportar Log SkuHabilita exportação do histórico de alterações.
Visualizar tab ProdutoMostra a aba Geral na ficha.
Visualizar tab SkuMostra a aba SKUs (variações) na ficha.
Visualizar tab PreçoMostra a aba Preços na ficha.
Visualizar tab EspecificaçãoMostra a aba Especificações na ficha.
Visualizar tab ImagemMostra a aba Imagens na ficha.
Visualizar Tab KitMostra a aba Kit na ficha.
Visualizar tab FiscalMostra a aba Fiscal na ficha.
Visualizar tab Promoção PDVMostra a aba Promoção PDV na ficha.
Adicionar item kitPermite adicionar componentes ao kit.
Editar item kitPermite editar componentes do kit.
Deletar item kitPermite remover componentes do kit.
Adicionar fornecedor SkuPermite cadastrar fornecedor no SKU.
Deletar fornecedor SkuPermite remover fornecedor do SKU.
Adicionar Imagem SkuPermite adicionar imagem ao SKU.
Criar preço SkuPermite criar preço pela aba Preços.
Editar Código Referência SkuPermite editar o Código de Referência depois de criado (operação delicada — ver pergunta sobre o tema).
Adicionar Grupo SkuPermite adicionar SKU a um Grupo SKU.
Editar Grupo SkuPermite editar a associação a Grupos SKU.
Deletar Grupo SkuPermite remover SKU de um Grupo SKU.
Visualizar Grupo SkuPermite ver Grupos SKU.
Criar Número de Seriel | IMEIPermite cadastrar números de série.
Editar Número de Seriel | IMEIPermite editar números de série.
Deletar Número de Seriel | IMEIPermite remover números de série.
Mostrar campo Custo ProdutoPermite ver as colunas de custo (Último Custo, Custo Médio, Custo Manual, Saldo Estoque) na lista e na ficha.
Mostrar campo Cost ManualVariação do anterior — específica para o campo de Custo Manual.
Criar oferta de SKUHabilita os botões Anunciar / Anúncio v2 para criar anúncios nos canais.
Visualizar Listar ProdutosHabilita o modo Listar Produtos (visão agrupada por Produto-pai).
Visualizar cadastro SKUHabilita o item de menu Cadastro SKU (rota alternativa de cadastro).

Existem outros privilégios menores ligados a operações específicas (relatórios, históricos, ações que dependem de módulos contratados). Em caso de dúvida sobre o que cada privilégio libera exatamente, consulte o administrador ou abra um chamado.