Passo a Passo: Como Importar Produtos via Planilha (CSV)

Neste artigo, você aprenderá como importar ou atualizar a sua lista de produtos no sistema utilizando um arquivo de planilha (no formato CSV). Essa funcionalidade é ideal para cadastrar novos itens em massa ou realizar alterações rápidas em lote (como reajustes de preços), economizando tempo e evitando a digitação manual de item por item.

Para realizar a importação com sucesso, siga os passos abaixo:

1. Prepare o seu arquivo de forma correta. A sua planilha deve ser salva obrigatoriamente no formato .CSV (separado por ponto e vírgula). Além disso, a primeira linha da planilha deve conter os cabeçalhos com os nomes exatos das colunas (Ex: CODIGO, DESCRICAO, UNIDADE, ATIVO, CODCFOP).

☁️ Atenção para usuários em Nuvem: Se a sua empresa utiliza o nosso sistema em Nuvem, lembre-se de que o arquivo .CSV salvo no seu computador físico precisa ser transferido para o ambiente da nuvem para que o sistema consiga "enxergá-lo" na hora de importar. Caso você não saiba como realizar essa transferência, não se preocupe: basta acessar o nosso Passo a Passo: Como Transferir Arquivos entre a Nuvem e o Computador (Modo HTML5)

2. Acesse o menu Cadastro > Produtos > Produtos para abrir a tela principal de Cadastro de Produtos. Na tela de pesquisa, vá até o menu superior em utilitários e selecione a opção 3. Importar. Uma nova janela chamada "Cadastro de Produtos - Importação" será aberta.

3. Na tela de Importação, localize o campo com o ícone de uma pasta. Clique nele para procurar, encontre o arquivo .CSV salvo no seu computador (ou no seu ambiente nuvem, caso utilize) e selecione-o.

4. Clique no botão Importar. Neste momento, o sistema iniciará uma varredura linha por linha da sua planilha para validar e processar as informações.

5. Acompanhe o progresso através do painel na tela ("Progresso da importação... XX%"). Ao final do processamento, o sistema exibirá uma mensagem de conclusão indicando o total de registros que tiveram sucesso e quantos falharam.

Pronto! Os produtos válidos da sua planilha foram integrados com sucesso ao banco de dados do sistema.

💡 Como o sistema se comporta por trás da tela? Para garantir a total segurança e integridade do seu banco de dados, o motor de importação trabalha seguindo regras rígidas de negócio:

• A Regra de Ouro da Coluna CÓDIGO (Inclusão x Alteração): O sistema mapeia os dados pelo nome do cabeçalho da coluna. Ao ler a coluna CODIGO, ele aplica a seguinte inteligência:

  • Alteração: Se o código informado na linha já existir no sistema, ele atualiza o cadastro atual substituindo-o pelas novas informações da planilha (útil para reajuste de preços).

  • Inclusão: Se a coluna CODIGO vier vazia ou preenchida com o valor 0, o sistema entende que é um item totalmente novo. Ele criará o cadastro e gerará uma nova numeração automática sequencial.

• Travas de Validação (O que faz uma linha falhar?): Se houver qualquer falha, o sistema exibirá o motivo exato na grade inferior de resultados para você corrigir. Uma linha será rejeitada se:

  • Os campos DESCRICAO ou UNIDADE estiverem totalmente vazios.

  • O código de barras (CODBARRA) informado já estiver cadastrado em outro produto ativo.

  • O NCM não contiver exatamente 8 dígitos ou o CEST não contiver exatamente 7 dígitos numéricos.

  • Campos de valores, preços ou margem de lucro contiverem números negativos.