Estoque

Como importar produtos por planilha sem erros

Equipe TechShared · Atualizado em 18 de novembro de 2026 · 5 min de leitura

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

  1. Cadastre as categorias no sistema antes de importar.
  2. Baixe a planilha-modelo na tela de Produtos e preencha os dados a partir dela.
  3. Revise nomes, valores e quantidades. Procure linhas em branco no meio da planilha e nomes repetidos.
  4. Envie o arquivo (.xlsx ou .xls) e confira a prévia das primeiras linhas.
  5. 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