Este manual explica todas as formas de cadastro, cada aba do formulário, campos obrigatórios, formatos (simples, kit, variações), estoque, fiscal, fotos, marketplaces e importação em massa.
Onde fica: menu lateral → Cadastros → Produtos (/app/products).
1. Visão geral do módulo Produtos
O catálogo de produtos centraliza tudo que você vende no ERP, no PDV e nos marketplaces conectados. Cada produto pertence a uma loja e, obrigatoriamente, precisa estar vinculado a um depósito para ter estoque e poder ser vendido.
Tipos de produto suportados:
Simples — item único, sem composição nem variações (ex.: uma garrafa de refrigerante)
Kit — conjunto de outros produtos vendidos juntos (ex.: combo promocional)
Variações — mesmo produto em tamanhos, cores etc., cada um com SKU, preço e estoque próprios
1.1 Elementos da listagem
Filtro por loja — exibe produtos de uma loja específica ou de todas
Pesquisar — busca por SKU, GTIN ou descrição; ao focar no campo, aparecem buscas recentes
Mais filtros — filtros avançados (estoque, preço, categoria, NCM, integração com e-commerce etc.)
Colunas (ícone ⚙) — escolha quais colunas aparecem na tabela
Atualizar (ícone ↻) — recarrega a listagem
Abas Todos / Simples / Kits / Variações — filtra por formato estrutural do produto
+ Novo Produto — inicia cadastro (botão principal)
Menu ▼ ao lado de Novo Produto — importação, exportação, produtos inativos e problemas fiscais
1.2 Colunas da tabela (referência)
Imagem — miniatura do produto
Loja — loja proprietária
SKU — código interno único por loja
GTIN — código de barras (EAN)
Descrição — nome do produto
Unidade — UN, KG, CX etc.
Tipo — Simples, Kit ou Variações
Fiscal — indicador de configuração fiscal
Estoque — saldo atual (verde = positivo, vermelho = zero ou negativo)
Custo / Venda — preços
Integrações — vínculo com anúncios em marketplaces
Ações (⋯) — editar, inativar etc.
1.3 Seleção em lote
Marque os checkboxes à esquerda de vários produtos. Um painel inferior aparece com:
Imprimir etiqueta — gera etiquetas em lote
Enviar para canal de venda — cria anúncios em massa no Mercado Livre, Shopee etc.
2. Pré-requisitos antes de cadastrar
Loja cadastrada — Cadastros → Empresas/Lojas
Depósito ativo na loja — Cadastros → Depósitos. Sem depósito o produto não recebe estoque e não pode ser vendido.
Permissão de acesso ao módulo Produtos no seu usuário
NCM do produto (8 dígitos) — obrigatório para NF-e; pode pesquisar ou usar sugestão com IA
Grupo fiscal (recomendado) — Cadastros → Grupo Tributário, para ICMS/PIS/COFINS corretos
Categorias de produto (opcional) — Cadastros → Categorias de Produto, para relatórios de giro
3. Formas de cadastrar um produto
Clique em + Novo Produto. O sistema oferece três caminhos principais:
3.1 Cadastrar manualmente
Indicado para poucos produtos ou quando você quer controle total dos dados.
Clique em Cadastrar individualmente
Abre o Cadastro rápido (fluxo guiado)
Para o formulário com todas as abas, clique em Versão completa
3.2 Trazer produtos de um canal de venda
Importa anúncios já publicados no Mercado Livre, Shopee ou outras plataformas conectadas.
Clique em Conectar canal
Selecione as contas de marketplace vinculadas
Escolha o depósito de destino do estoque
Analise a lista de anúncios importáveis
Selecione os itens e confirme a importação
Requisito: contas de marketplace já configuradas em E-commerce → Contas.
3.3 Cadastrar por planilha
Importação em massa via arquivo .xlsx.
Clique em Upload da planilha ou use menu ▼ → Importar por Planilha
Baixe o modelo Excel fornecido pelo sistema
Preencha SKU, descrição, NCM, preços, GTIN etc.
Faça upload e revise erros linha a linha antes de confirmar
3.4 Outras opções no menu ▼
Importar produtos via XML — a partir de XML de NF-e
Importar Produtos do Backup — restaura arquivo .json exportado pelo Zukey
Exportar CSV / Excel / Backup — exporta o catálogo atual
Produtos Inativos — lista produtos desativados
Problemas Fiscais — produtos com NCM, origem ou grupo fiscal pendente
4. Cadastro rápido (fluxo guiado)
Rota: /app/products/cadastro-rapido. Ideal para cadastrar vários produtos simples com agilidade, inclusive em mais de uma loja ao mesmo tempo.
4.1 Seleção de lojas
No painel direito, marque uma ou mais lojas (ou use Todas). O produto será criado em cada loja selecionada, desde que tenham depósito.
4.2 Abas do cadastro rápido
Dados básicos — Nome*, SKU*, preços (venda, custo, atacado), unidade, formato (simples ou variação), GTIN/EAN, descrição resumida para PDV/etiqueta
Características — peso (kg), comprimento, largura, altura (cm), marca
Imagens — foto principal do produto
Estoque — quantidade inicial por depósito de cada loja selecionada
Tributação — NCM, origem da mercadoria, tipo de produto; sugestão de NCM com IA disponível
Variações — aparece se o formato for com variações; cadastre cada variante
Use Próximo → para avançar e Cancelar para voltar à listagem. O botão Versão completa abre o formulário detalhado a qualquer momento.
4.3 Geração automática de SKU (cadastro rápido e completo)
Clique na seta ▼ ao lado do campo SKU:
SKU por descrição — gera código legível a partir do nome (ex.: CAMISETA-POLO-001)
SKU com dígito verificador — para produtos de balança (ex.: 00017)
SKU aleatório — código único gerado automaticamente
5. Formulário completo — visão das abas
Rota: /app/products/new. Menu lateral (desktop) ou abas horizontais (mobile). Botões no topo: Cancelar e Salvar.
Abas disponíveis:
Dados Básicos
Preços
Características
Configurações
Fiscal
Fornecedor
Kits (composição) — só se formato = Kit
Variações — só se formato = Variações
Estoque por Depósito — oculto para produto pai com variações
Anúncios
Fotos — após primeiro save na criação; disponível na edição
E-commerce
6. Aba Dados Básicos
Campo | Obrigatório | Descrição |
Loja | Sim | Loja proprietária. Imutável após salvar. |
SKU | Sim | Código interno único na loja. Geração automática via ▼. |
EAN/GTIN | Não | Código de barras. Em variações, informe na aba Variações. |
Descrição | Sim | Nome completo (mín. 3 caracteres). |
Descrição Resumida | Não | Nome curto para PDV, cupom e etiquetas. |
Formato | Não | Simples (padrão), Kit ou Variações. Define abas extras. Não alterável depois se já houver kit/variações. |
Categoria | Não | Grupo interno para relatórios. Link "Gerenciar categorias" abre Cadastros → Categorias. |
Informações Fiscais | Não | Atalho visual; detalhes na aba Fiscal. |
Imagem principal | Não | JPG, PNG ou GIF, máx. 1 MB. |
Observações | Não | Texto livre interno. |
6.1 Imagem do produto
Fazer Upload — envia arquivo do computador
Buscar Online — busca por GTIN ou descrição (precisa preencher um dos dois antes)
Editar IA — melhora a imagem com inteligência artificial (requer imagem já carregada)
Passe o mouse sobre a imagem e clique em Remover para excluir
6.2 Alerta: loja sem depósito
Se a loja selecionada não tiver depósito cadastrado, aparece alerta vermelho com botão Cadastrar depósito. Resolva isso antes de salvar — caso contrário o produto ficará sem estoque vinculado.
7. Aba Preços
Campo | Obrigatório | Descrição |
Preço de venda | Sim | Valor de venda ao consumidor. Mínimo R$ 0,01. |
Preço de custo | Não | Custo de aquisição/produção. |
Preço de atacado | Não | Preço para revenda ou clientes atacado. |
Preço promocional | Não | Valor durante promoção. |
Início / Fim da promoção | Não | Período em que o preço promocional vale. |
% Desconto máximo | Não | Limite de desconto no PDV (padrão 99%). |
Estoque atual | — | Somente leitura. Calculado pelo sistema. |
Crossdocking (dias) | Não | Prazo logístico sem armazenagem prévia. |
Estoque máximo | Não | Quantidade máxima recomendada em estoque. |
Para alterar estoque, use a aba Estoque por Depósito, cadastro rápido → Estoque, ou Movimento → Movimentações de Estoque.
8. Aba Características
Peso (kg) — usado em frete e marketplaces
Comprimento, Largura, Altura (cm) — dimensões da embalagem
Marca — ex.: Samsung, Nike
Modelo — ex.: Galaxy S21
9. Aba Configurações
Validade (dias) — dias até vencimento, para produtos perecíveis
Cadastro automático — Sim/Não; indica se o produto veio de integração automática (webhook, importação etc.)
10. Aba Fiscal
Obrigatória para emissão de NF-e e conformidade tributária.
Campo | Obrig. | Descrição |
NCM | Sim | 8 dígitos numéricos. Pesquise com 🔍 ou sugira com ✨ (IA). |
CEST | Não | 7 dígitos — substituição tributária. |
EX TIPI | Não | Exceção da TIPI (2 ou 3 dígitos). |
Origem da mercadoria | Sim | Código 0 a 8. Padrão comum: 0 (nacional). |
Tipo de produto | Não | Padrão: Mercadoria para Revenda. |
Grupo fiscal | Não* | Regras de ICMS, PIS, COFINS, IPI. *Recomendado. |
Código benefício fiscal (cBenef) | Não | Código de benefício da UF. |
Unidade de produção | Sim | UN, KG, CX, LT etc. |
10.1 Origem da mercadoria (códigos)
0 — Nacional, exceto códigos 3, 4, 5 e 8
1 — Estrangeira, importação direta
2 — Estrangeira, adquirida no mercado interno
3 a 8 — Nacional com conteúdo de importação ou conforme legislação específica
10.2 IBPT — De Olho no Imposto
Após salvar e informar NCM, clique em Atualizar IBPT para carregar percentuais aproximados (federal, estadual, municipal). Requer extensão configurada em Extensões → De Olho no Imposto.
11. Aba Fornecedor
Disponível após o produto ser salvo. Vincule um ou mais fornecedores com preço de compra, prazo e contato. Use para gestão de compras e custo.
12. Produtos Kit (aba Kits — composição)
Quando Formato = Kit, após salvar configure na aba Kits (composição):
Adicione produtos componentes e quantidades
O sistema soma o preço dos itens
Permite ajuste por acréscimo ou desconto percentual sobre o total
Modo de estoque: Virtual (estoque calculado pelos componentes) ou Físico (estoque próprio do kit)
13. Produtos com Variações (aba Variações)
Quando Formato = Variações:
O SKU e GTIN do produto pai ficam em branco — cada variante tem os seus
Cadastre variantes com atributos (cor, tamanho etc.)
Cada variante: SKU*, preço, estoque, foto opcional
Estoque por depósito é controlado por variante, não no produto pai
14. Aba Estoque por Depósito
Visualize saldo em cada depósito da loja
Faça ajustes de quantidade por armazém
Estoque total = soma de todos os depósitos
Link para Movimentações por Produto na aba Preços
15. Aba Anúncios
Gerencie vínculos com anúncios publicados em Mercado Livre, Shopee etc. Permite associar o produto ERP ao anúncio do marketplace e acompanhar status de publicação.
16. Aba Fotos (galeria)
Após o primeiro save na criação (ou imediatamente na edição):
Fazer Upload — até 5 MB por imagem na galeria
Buscar na Internet — por GTIN ou descrição
Melhorar com IA — em cada thumbnail
Remover imagens pelo ícone de lixeira ao passar o mouse
Marketplaces exigem múltiplas fotos — use esta aba antes de publicar anúncios.
17. Aba E-commerce
Configurações para publicação em marketplaces:
Geral — condição (novo/usado/recondicionado), descrição para anúncio (com botão Sugerir com IA)
Mercado Livre — categoria ML, tipo de anúncio (clássico/premium), frete grátis
Shopee — categoria Shopee, logística
18. Salvar o produto
Revise Dados Básicos, Preços e Fiscal (campos obrigatórios)
Clique em Salvar (canto superior direito)
Aguarde confirmação — o produto aparece na listagem
Complete fornecedores, fotos, estoque inicial e anúncios nas abas restantes
19. Checklist — campos obrigatórios mínimos
☐ Loja selecionada (com depósito ativo)
☐ SKU único
☐ Descrição (mín. 3 caracteres)
☐ Preço de venda ≥ R$ 0,01
☐ NCM com 8 dígitos
☐ Origem da mercadoria
☐ Unidade de produção
☐ Estoque inicial (se for vender imediatamente)
20. Após cadastrar — próximos passos
Publicar anúncio: aba Anúncios ou listagem → seleção em lote → Enviar para canal de venda
Imprimir etiqueta: seleção em lote → Imprimir etiqueta
Emitir NF-e: o produto já estará disponível em Vendas / Emissão NF-e
Conferir fiscal: menu ▼ → Problemas Fiscais (se houver pendências)
21. Erros comuns ao criar
Problema | Causa provável | Solução |
SKU já existe | Duplicado na mesma loja | Altere o SKU ou gere automaticamente |
GTIN já cadastrado | EAN repetido | Verifique se produto já existe |
Botão Salvar desabilitado | Campo obrigatório vazio ou inválido | Revise abas Básicos, Preços e Fiscal |
Loja sem depósito | Nenhum armazém na loja | Cadastros → Depósitos |
NCM inválido | Diferente de 8 dígitos | Use pesquisa ou IA |
Produto sem estoque | Sem movimentação inicial | Estoque por Depósito ou cadastro rápido |
22. Glossário
SKU — Stock Keeping Unit; código interno do produto na sua loja
GTIN / EAN — código de barras internacional do produto
NCM — Nomenclatura Comum do Mercosul; classificação fiscal (8 dígitos)
CEST — Código Especificador da Substituição Tributária
IBPT — estimativa de carga tributária (Lei 12.741)
Crossdocking — logística sem estoque intermediário
Kit — produto composto por outros produtos do catálogo
23. Perguntas frequentes
Posso mudar a loja depois de salvar?
Não. A loja é definida na criação.
Cadastro rápido ou formulário completo?
Rápido: essenciais e multi-loja. Completo: kits, variações, e-commerce, fornecedor, galeria completa.
Preciso cadastrar estoque na hora?
Sim, se for vender no PDV ou marketplace. Sem estoque o item pode aparecer como indisponível.
Como duplicar um produto?
Na edição, use opções de clonagem se disponível, ou cadastre novo com SKU diferente.
O preço de custo é obrigatório?
Não, mas recomendado para margem e relatórios financeiros.