Importando produtos em massa com planilha CSV
Como cadastrar centenas de produtos de uma vez sem digitar tudo: baixar o template, preencher, importar e o que fazer se der erro.
A importação CSV é a forma mais rápida de popular o catálogo quando você está migrando de outro sistema ou começando do zero com muitos produtos.
1. Baixar o template
- Vá em Produtos no menu
- Clique em Importar no canto superior direito
- Clique em Baixar template — abre um CSV de exemplo já formatado
💡 Use Google Sheets O Google Sheets mantém UTF-8 automaticamente, evitando "ç" virar "ç". Se preferir Excel, na hora de salvar escolha "CSV UTF-8".
2. Campos obrigatórios
- nome — até 120 caracteres
- preco_venda — número com ponto decimal (29.90, não 29,90)
- unidade — sigla: UN, KG, CX, PC, L, M
- estoque_atual — quantidade em estoque no momento da importação
3. Campos opcionais (recomendados)
- codigo_interno — seu SKU, usado pra encontrar o produto no PDV
- codigo_barras — EAN-13 ou EAN-8
- preco_custo — custo de compra, pra cálculo de margem
- estoque_minimo — pra disparar alerta quando o saldo chegar nesse valor
- ncm — 8 dígitos, obrigatório pra emitir NF-e desse produto
- categoria — se não existir, é criada na hora
- disponivel_loja — S ou N pra publicar na loja online
4. Fazendo a importação
- Salve o arquivo como CSV UTF-8
- Em Produtos → Importar, selecione o arquivo
- Confira a prévia das primeiras 5 linhas — confirme que as colunas estão alinhadas
- Clique em Importar e aguarde — pra 1.000 produtos leva uns 30 segundos
- No fim, o relatório mostra: criados, atualizados e linhas com erro (com motivo)
📌 Nota Se um produto com o mesmo codigo_interno ou codigo_barras já existir, ele é atualizado em vez de duplicado. É assim que você atualiza preços em massa.
5. Erros comuns
- Caracteres estranhos (ã, ç) — salve o CSV como UTF-8
- Coluna não encontrada — não renomeie os cabeçalhos do template
- preco_venda inválido — use ponto decimal (29.90), não vírgula
- NCM inválido — exatamente 8 dígitos numéricos, sem pontos
- unidade inválida — apenas as siglas listadas acima
6. Atualizando preços em massa
Pra reajustar preços, exporte sua lista atual em Produtos → Exportar, ajuste a coluna preco_venda no Excel/Sheets e reimporte. O sistema atualiza apenas os campos que vierem preenchidos — colunas em branco são ignoradas.