Como importar produtos por planilha

Para que serve

Migrar de uma planilha antiga ou receber uma lista de produtos de um fornecedor não deve significar digitar tudo de novo, um por um. A importação lê um arquivo Excel (.xlsx) ou CSV e cadastra (ou atualiza) produtos em lote, com uma etapa de revisão antes de qualquer gravação.

Passo a passo

1. 1No menu Ferramentas da tela de Estoque, clique em Importar.
2. 2Baixe o modelo de planilha (Excel ou CSV) para garantir que as colunas estejam no formato esperado pelo sistema.
3. 3Preencha o modelo com os produtos (ou adapte sua planilha existente para as mesmas colunas) e faça o upload do arquivo.
4. 4O sistema mostra uma tela de revisão: quantos produtos serão criados, quais categorias novas serão cadastradas e quais linhas têm erro (com o motivo de cada erro).
5. 5Se algum código (SKU) da planilha já existir no seu estoque, escolha se quer manter o produto existente ou substituir os campos pelos valores da planilha.
6. 6Confirme a importação. O sistema atribui SKU automático às linhas sem código, cria as categorias necessárias e grava tudo numa única operação.
7. 7Se houver erros, baixe o relatório de erros para corrigir a planilha e reimportar só as linhas que falharam.

Boas práticas

• Sempre baixe o modelo mais recente antes de montar a planilha: colunas novas (como descrição pública, disponível em contas com Loja Online) só existem no modelo atualizado.
• Revise a tela de prévia com atenção antes de confirmar: é o único momento em que dá para cancelar sem afetar o estoque.
• Para grandes lotes, prefira o Excel (.xlsx) ao CSV: o parser é mais tolerante a acentos e formatação de números.

Perguntas frequentes

A importação pode duplicar produtos que já existem?

Não, se o SKU da planilha coincidir com um produto existente, você escolhe explicitamente entre manter ou substituir. Nunca cria um duplicado automaticamente.

Categorias que não existem ainda travam a importação?

Não. Categorias novas mencionadas na planilha são criadas automaticamente durante a importação.

O que acontece com uma linha com erro?

Ela não é importada. As demais linhas válidas são gravadas normalmente, e um relatório aponta exatamente qual linha e qual campo tem problema.