Importando produtos em lote (CSV)

Quando você tem dezenas, centenas ou milhares de produtos pra cadastrar, o caminho é a importação por planilha CSV. Em vez de cadastrar um por um, você sobe um arquivo único.

Como chegar

Em Gestão → Produtos, abra o menu e use a opção Importar. Ou direto pela URL /produtos/importar.

Passo 1: baixe o template

O botão Baixar template completo gera um CSV com todas as colunas suportadas, mais uma linha de exemplo pra você ver o formato. Use ele como base.

Colunas obrigatórias

Só duas:

• nome
• preco_venda

Tudo o mais é opcional.

Colunas suportadas

Identificação: codigo_interno, marca, mpn, codigo_barras, ncm, unidade.

Preços e estoque: preco_custo, margem_lucro, estoque_minimo, estoque_atual, localizacao.

Organização: categoria_nome (a categoria é criada se não existir), linha, posicao.

Específicos de autopeças: garantia_meses, universal (true/sim pra peças universais), aplicacao (texto livre tipo "VW GOL 1.0 2010-2015 | FIAT PALIO 1.4 FLEX 2012-2018").

Equivalências: EQUIVALENTE_1, EQUIVALENTE_2, EQUIVALENTE_3... (códigos de produtos equivalentes).

Códigos originais: OEM_1, OEM_2, OEM_3... (códigos das montadoras).

Dimensões: peso_kg, altura_cm, largura_cm, profundidade_cm.

Imagem: imagem_url_1.

Separador

Aceita ponto e vírgula ou vírgula. O sistema detecta automaticamente.

Passo 2: upload e pré-visualização

Depois de escolher o arquivo, o sistema mostra as primeiras 10 linhas em uma tabela. Linhas com erro aparecem destacadas em vermelho, com a indicação do problema (nome vazio, preço inválido, etc.). Você pode corrigir o arquivo e subir de novo.

Passo 3: importar

Quando estiver tudo certo, clica em Importar. O sistema processa:

• Produtos com código interno que já existe são atualizados (não duplicados).
• Categorias informadas e não cadastradas são criadas automaticamente.
• Códigos OEM e equivalências são cadastrados junto.
• Aplicações veiculares são interpretadas do texto livre.

Passo 4: resultado

Ao final, aparece um relatório:

• Produtos importados e atualizados.
• Equivalências citadas, resolvidas e pendentes (as pendentes resolvem em imports futuros quando o produto-alvo aparecer).
• Aplicações detectadas, universais e não mapeadas.
• OEMs inseridos.
• Indicadores de qualidade: quantos ficaram sem marca, sem MPN, sem aplicação.

Dicas

• Use Excel ou planilha do Google e salve como CSV UTF-8.
• Antes de subir um arquivo grande, teste com 5-10 linhas pra ver se o formato está certo.
• Mantenha o codigo_interno como chave: assim, próximos imports atualizam em vez de duplicar.