Importar produtos por planilha economiza tempo, mas um arquivo mal preparado cria problemas difíceis de desfazer: preços zerados, categorias perdidas, itens duplicados. A boa notícia é que quase todos esses erros podem ser evitados antes do envio.
As quatro colunas esperadas
A planilha precisa de uma linha de cabeçalho com estes nomes:
- nome (obrigatório): nome do produto. Também é a chave que decide se o item será atualizado ou inserido.
- valor: valor unitário. Se ficar em branco, o padrão é 0. Aceita vírgula ou ponto como separador decimal.
- quantidade: saldo em estoque, em número inteiro. Padrão 0.
- categoria: nome exato de uma categoria que já exista no projeto. Se não for encontrada, a categoria é ignorada.
Passo a passo
- Cadastre as categorias no sistema antes de importar.
- Baixe a planilha-modelo na tela de Produtos e preencha os dados a partir dela.
- Revise nomes, valores e quantidades. Procure linhas em branco no meio da planilha e nomes repetidos.
- Envie o arquivo (.xlsx ou .xls) e confira a prévia das primeiras linhas.
- Confirme e leia o resultado: a contagem de produtos inseridos e atualizados, e as mensagens de erro por linha.
Como o sistema decide entre atualizar e inserir
Se já existe um produto com o mesmo nome dentro do projeto, ele é atualizado com os novos valores. Se o nome é novo, um produto é criado. Isso significa que “Arroz 5kg” e “Arroz 5 kg” são dois produtos diferentes. Padronize os nomes antes.
Linhas com o nome vazio são ignoradas e aparecem como erro no resultado.
Checklist de verificação
- A primeira linha é o cabeçalho e os nomes das colunas estão corretos.
- Não há valores com símbolo de moeda ou texto (como “R$ 10,00 reais”).
- As quantidades são números inteiros, sem texto.
- As categorias estão escritas exatamente como no sistema.
- Você guardou uma cópia do arquivo original antes de importar.
E se algo der errado?
Como a importação atualiza produtos existentes, uma planilha com valores incorretos pode sobrescrever dados bons. Por isso a cópia do arquivo antigo é importante: se precisar reverter, basta reimportar a versão anterior. Na primeira vez, teste com poucas linhas.
Em resumo
Preparar bem a planilha leva dez minutos e evita horas de correção. Padronize nomes, confira categorias e use a prévia: essas três atitudes resolvem a maioria dos problemas de importação.
Aplique isso no TechShared
Conheça o módulo Estoque e Contratos e veja como ele apoia esta prática.
Ver módulo Estoque e Contratos