Importando produtos em massa com planilha CSV

A importação via CSV é a forma mais rápida de popular o catálogo ao migrar de outro sistema ou ao lançar um novo negócio com muitos produtos.

1. Baixar o template CSV

1. 1Acesse Produtos no menu lateral
2. 2Clique em "Importar" no canto superior direito
3. 3Clique em "Baixar template" para obter o CSV de exemplo
4. 4Abra no Excel, Google Sheets ou LibreOffice Calc

2. Campos obrigatórios

• nome — nome do produto (máx. 120 caracteres)
• preco_venda — preço em formato numérico sem R$ (ex: 29.90)
• unidade — sigla da unidade: UN, KG, CX, PC, L, M
• estoque_atual — quantidade em estoque no momento da importação

3. Campos opcionais (recomendados)

• codigo_interno — SKU interno da sua empresa
• codigo_barras — EAN-13 ou EAN-8
• preco_custo — custo para cálculo de margem
• estoque_minimo — quantidade antes do alerta
• ncm — obrigatório para NF-e (8 dígitos)
• categoria — criada automaticamente se não existir
• disponivel_loja — S ou N para exibir na loja online

4. Realizando a importação

1. 1Salve o arquivo como CSV UTF-8
2. 2Acesse Produtos → Importar e selecione o arquivo
3. 3Confira a prévia das primeiras 5 linhas
4. 4Clique em "Importar" e aguarde o processamento
5. 5Ao finalizar, confira o relatório com linhas criadas, atualizadas e com erro

5. Erros comuns e soluções

• Caracteres estranhos (ã, ç) — salve o CSV como UTF-8
• "Coluna não encontrada" — não renomeie colunas do template
• "preco_venda inválido" — use ponto como separador decimal (29.90)
• "NCM inválido" — o NCM deve ter exatamente 8 dígitos numéricos