Pular para conteúdo

Cadastrar produtos (planilha) ES08

Módulo Estoque Tela Cadastros → Produtos → Cadastrar por planilha Estoque › Cadastros › Produtos › Cadastrar por planilha

Cadastro em lote de produtos novos a partir de uma planilha Excel ou CSV. Resolve pendências (grupos/subgrupos faltantes) antes de gravar e dá pré-visualização do que será criado.

Tela Cadastrar Produtos via Planilha

Pré-requisitos

  • Estar logado como usuário Master ou Admin
  • Ter pelo menos uma unidade de medida cadastrada (UN, CX, KG, etc.)
  • Conhecer a estrutura mínima de produto da sua empresa (descrição, grupo, unidade)

Cadastrar é diferente de atualizar

Esta tela só cria produtos novos. Para atualizar produtos já existentes, use Importar produtos (planilha).

Formatos suportados

Item Limite
Formatos .xlsx · .xls · .csv
Tamanho máximo do arquivo 10 MB
Linhas por planilha 10.000

Planilha modelo

Na etapa de upload, clique em Baixar modelo para receber uma planilha com os cabeçalhos prontos. O modelo já contém:

  • Campos fixos do cadastro (Descrição, SKU, EAN, Grupo, Subgrupo, Departamento, Fornecedor, Unidade, NCM, Peso, etc.)
  • Uma coluna "Preço (Tabela)" para cada tabela de preço ativa

Modelo é só sugestão

Você pode subir uma planilha fora do padrão — o mapeamento manual da etapa 2 cobre qualquer combinação de colunas.

Passo a passo

A tela segue 5 etapas em sequência, com um indicador no topo.

Etapa 1 — Upload

  1. Baixe o modelo (opcional) ou prepare sua própria planilha
  2. Arraste o arquivo para a área tracejada ou clique para selecionar
  3. O sistema lê as colunas e exibe o total de linhas

Etapa 2 — Mapeamento

Define qual coluna da planilha corresponde a qual campo do cadastro.

Lado Conteúdo
Coluna da planilha Lida do arquivo (somente leitura).
Campo do produto Seletor com todos os campos disponíveis (fixos + tabelas de preço).

O sistema tenta sugerir automaticamente o campo quando a coluna tem o mesmo nome (ex.: coluna "Descrição" mapeia direto para o campo Descrição).

Campos obrigatórios

Pelo menos a descrição, o grupo e a unidade precisam estar mapeados. Sem isso, a etapa de Pendências bloqueia o avanço.

Etapa 3 — Pendências

O sistema verifica se há cadastros auxiliares faltando ou duplicidades na planilha:

Tipo de pendência O que significa
Grupos A planilha menciona um grupo que não existe no cadastro.
Subgrupos Subgrupo inexistente.
Departamentos Departamento inexistente.
Fornecedores Fornecedor inexistente.

Para cada pendência, escolha:

  • Criar novo — cria o registro auxiliar automaticamente com o nome encontrado
  • Vincular a existente — escolhe um registro existente da lista para receber esses produtos
  • Ignorar — produtos dessa linha ficam sem essa classificação

Sem pendências

Se a planilha estiver completa e todos os cadastros auxiliares existirem, esta etapa exibe "Tudo certo!" e libera direto o avanço.

Etapa 4 — Preview

Lista cada produto que será cadastrado, com os valores que ficarão gravados. Linhas com erro (ex.: descrição duplicada, NCM inválido) aparecem em vermelho.

Coluna Descrição
# Linha da planilha.
Descrição / SKU / EAN Valores a gravar.
Grupo / Departamento / Unidade Após a resolução das pendências.
Status OK ou Erro (com motivo).

Confira com calma antes de avançar.

Etapa 5 — Resultado

Após confirmar, a tela exibe:

  • Quantidade de produtos cadastrados com sucesso
  • Quantidade que deu erro (com motivo individual)
  • Botão para baixar o relatório completo da importação

Erros comuns

SKU duplicado

Se a planilha tem duas linhas com o mesmo SKU, ou o SKU já existe no banco, o produto é rejeitado. Cheque na coluna SKU antes de subir.

Grupo / unidade obrigatórios faltando

O motor de cadastro exige no mínimo descrição + grupo + unidade. Mapeie esses campos na etapa 2 ou inclua-os na planilha.

NCM inválido

NCM precisa ter exatamente 8 dígitos. Linhas com NCM incompleto entram como erro na etapa de preview.

Cadastros novos são definitivos

Não há rollback automático. Se cadastrou produtos errados em massa, será necessário inativá-los individualmente ou fazer correção via Importar planilha (ES07).

Veja também