Importar produtos (planilha) ES07¶
Atualização em lote de produtos já cadastrados a partir de uma planilha Excel ou CSV. Permite mapear colunas, filtrar o universo de produtos e pré-visualizar antes de gravar.
Pré-requisitos¶
- Estar logado como usuário Master ou Admin
- Ter os produtos que serão atualizados já cadastrados no sistema
- Ter uma planilha com pelo menos uma coluna que identifique o produto (SKU, EAN ou código)
Atualizar é diferente de cadastrar
Esta tela só atualiza produtos existentes. Para criar produtos novos em massa, use Cadastrar produtos (planilha).
Formatos suportados¶
| Item | Limite |
|---|---|
| Formatos | .xlsx · .xls · .csv |
| Tamanho máximo do arquivo | 10 MB |
| Linhas por planilha | 5.000 |
Passo a passo¶
A tela segue 4 etapas em sequência, com um indicador no topo da página.
Etapa 1 — Upload¶
- Arraste a planilha para a área tracejada ou clique para selecionar
- O sistema lê as colunas e o total de linhas
- Na pré-visualização, é possível aplicar transformações clicando no cabeçalho de uma coluna (ex.: remover espaços, converter para maiúsculas, trocar vírgula por ponto em valores numéricos)
Transformações antes do JOIN
Se a coluna de SKU veio com prefixos ou espaços, aplique a transformação adequada antes de avançar — assim o pareamento na etapa de JOIN funciona corretamente.
Etapa 2 — JOIN¶
Define como cada linha da planilha se conecta aos produtos do banco.
Bloco "Defina a chave de JOIN":
- Coluna da planilha — a coluna que identifica o produto (ex.:
SKU,Código,EAN) - Campo do produto — o campo correspondente no cadastro (SKU, EAN, Código tributário, etc.)
Bloco "Filtrar universo de produtos":
Limita os produtos do banco que podem ser pareados. Use múltiplos valores em cada filtro:
| Filtro | Para que serve |
|---|---|
| Grupo | Restringe a um ou mais grupos. |
| Subgrupo | Restringe a um ou mais subgrupos. |
| Departamento | Restringe a um ou mais departamentos. |
| Fornecedor principal | Apenas produtos do(s) fornecedor(es) selecionado(s). |
| Fabricante | Apenas do(s) fabricante(s). |
| Status | Ativos / Inativos / Todos. |
Bloco "Resultado do JOIN":
Cinco indicadores mostram o resultado do pareamento:
- Casados — linhas da planilha que encontraram produto correspondente (verde)
- Sem match — linhas que não bateram com nenhum produto (vermelho)
- Duplicadas — chave repetida na planilha
- Fora do universo — bateram com produto, mas o produto está fora do filtro
- Total — quantidade total de linhas da planilha
Clique nos números para ver a lista das linhas em cada categoria.
Etapa 3 — Mapear¶
Define qual coluna da planilha atualiza qual campo do produto.
| Lado | Conteúdo |
|---|---|
| Coluna da planilha | Coluna lida do arquivo. |
| Campo do produto | Campo de destino (descrição, custo médio, peso, NCM, tabela de preço X, etc.). |
Use + Adicionar mapeamento para criar mais linhas e × para remover.
Tabelas de preço
Cada tabela de preço aparece como um campo separado (ex.: "Preço (Atacado)", "Preço (Varejo)") e pode receber uma coluna específica.
Etapa 4 — Preview e aplicação¶
Mostra antes × depois de cada produto que será atualizado:
- Valor atual no banco (riscado, cinza)
- Novo valor (em destaque, preto)
- Linhas com erro ficam em vermelho
Confirme em Aplicar para gravar. O resumo final indica quantos produtos foram atualizados, quantos foram ignorados e quantos tiveram erro.
Erros comuns¶
Arquivo maior que 10 MB
Divida a planilha em arquivos menores ou remova colunas não usadas.
Muitas linhas sem match
Verifique:
- Se a coluna escolhida no JOIN corresponde realmente ao SKU/EAN cadastrado
- Se há espaços em branco no início/fim (aplique transformação na etapa 1)
- Se os produtos não estão filtrados fora pelo bloco "Filtrar universo"
Chaves duplicadas
Se o mesmo SKU aparece em duas linhas da planilha, ambas ficam marcadas como duplicadas e nenhuma é aplicada. Resolva a duplicidade no arquivo antes de tentar de novo.
Aplicação é definitiva
Não há "desfazer" depois de clicar em Aplicar. Confira o preview com atenção antes de confirmar — especialmente em alterações de preço e custo.