Importe Produtos em Massa
Se você tem muitos produtos para adicionar (mais que alguns poucos), importar de uma planilha é muito mais rápido que adicioná-los um por um. Você pode adicionar centenas ou até milhares de produtos em apenas alguns cliques!Opções de importação
O Alana suporta várias formas de importar produtos:| Opção | Como | Melhor para |
|---|---|---|
| Planilha (CSV/Excel) | Upload de arquivo | Importação em massa dos seus próprios dados |
| Importação por URL | Cole uma URL de produto | Extrair dados de produto de um site |
| Conector de plataforma | Conecte Shopify/WooCommerce | Sincronizar de uma loja existente |
Formatos de Arquivo Suportados
Suportamos dois formatos comuns de planilha:- CSV (Comma-Separated Values) — Formato de texto simples, funciona com qualquer app de planilha
- Excel — Arquivos
.xlsx(Excel 2007 e mais recente)
Passo 1: Baixe o Template
Para garantir que sua planilha tenha o formato correto, comece baixando nosso template:- Na visualização do seu catálogo, clique em “Importar Produtos”
- Clique em “Baixar Template”
- Um arquivo de planilha será baixado para o seu computador
Passo 2: Preencha os Dados dos Produtos
Adicione seus produtos ao template seguindo estas diretrizes:Colunas Obrigatórias
Estas colunas DEVEM ser preenchidas para cada produto:- Title: Nome do produto (ex: “Camiseta Azul de Algodão”)
- Description: O que é o produto e detalhes chave
- Image URL: Um link para a imagem principal do produto (deve começar com
http://ouhttps://)
Colunas Opcionais
Estas são úteis mas não obrigatórias:- SKU: Seu código interno do produto
- Price: Preço de venda (como número, ex:
29.99) - Additional Images: Mais URLs de imagens, separadas por vírgulas
- Color: Cor do produto
- Size: Tamanho do produto
- Material: Do que é feito
- Weight: Peso do produto
- Dimensions: Largura x Altura x Comprimento
Dicas para sua Planilha
URLs para Imagens:- Certifique-se de que os URLs das imagens estejam corretos e apontem para arquivos reais
- As imagens devem ser acessíveis publicamente (o sistema precisa conseguir baixá-las)
- Formatos comuns: JPG, PNG, WebP
- Se você ainda não tem URLs de imagens, deixe em branco — você pode adicionar imagens depois
- Use o mesmo formato para todos os dados similares (ex: todos os preços como números sem símbolos de moeda)
- Use terminologia consistente (ex: sempre “Médio” não às vezes “Médio” e às vezes “M”)
- Não deixe células completamente vazias se elas contêm informações importantes
Passo 3: Faça Upload do seu Arquivo
Quando sua planilha estiver pronta:- Vá para seu catálogo e clique em “Importar Produtos”
- Clique em “Escolher Arquivo” ou arraste e solte sua planilha
- O sistema começará a analisar seu arquivo
Passo 4: Mapeie suas Colunas
O sistema precisa saber qual coluna contém quais dados. Você verá uma tela mostrando as colunas da sua planilha. Para cada coluna, selecione que dados ela representa:- Clique em um cabeçalho de coluna
- Escolha o campo a que ela corresponde (Title, Description, SKU, Price, Color, etc.)
- Se uma coluna não for necessária, selecione “Pular”
Passo 5: Revise e Valide
O sistema verificará seus dados em busca de erros:- Campos obrigatórios faltando → Erro (você deve corrigir antes de fazer upload)
- URLs de imagem inválidos → Aviso (produto será importado mas sem imagens)
- Problemas de formatação de preço → Aviso (preços podem não ser exibidos corretamente)
- SKUs duplicados → Aviso (pode sobrescrever produtos existentes)
Passo 6: Confirme e Importe
Revise o resumo final:- Número de produtos a serem importados
- Quaisquer avisos ou problemas
- Suas colunas mapeadas
Problemas Comuns e Como Corrigi-los
”Campo obrigatório faltando”
Problema: Um produto está sem dados obrigatórios (Title, Description ou Image URL). Correção:- Adicione os dados faltantes à sua planilha
- Faça upload do arquivo novamente
”URL de imagem inválido”
Problema: O link da imagem não funciona ou não está no formato correto. Correção:- Verifique se o URL está completo e correto
- Certifique-se de que o arquivo de imagem realmente existe naquele local
- Use URLs que comecem com
http://ouhttps:// - Considere fazer upload do arquivo de imagem separadamente e usar esse URL
”SKU duplicado”
Problema: Dois produtos têm o mesmo SKU, o que pode causar confusão. Correção:- Dê a cada produto um SKU único
- Verifique se o produto já existe no seu catálogo (talvez você não precise importá-lo novamente)
“Erro de formato de preço”
Problema: Preços não estão formatados corretamente. Correção:- Use apenas números (ex:
29.99nãoR$ 29,99) - Use ponto (
.) como separador decimal, não vírgula
”Arquivo muito grande”
Problema: Sua planilha tem muitos produtos para importar de uma vez. Correção:- Divida seus dados em arquivos menores
- Importe-os em lotes (5.000 produtos por importação é típico)
Após a Importação — Processamento pelo pipeline
Depois que seus produtos forem importados, o pipeline Bronze executa automaticamente — produtos são armazenados com uma chave de idempotência para prevenir importações duplicadas da mesma fonte. Você pode então executar:- Normalização Silver — mapeia campos de origem para o schema Alana, detecta duplicatas, valida URLs de imagem
- Scoring Gold — calcula uma pontuação de otimização (0–100) e retorna uma lista de gaps
- Eles aparecem no seu catálogo imediatamente
- Você pode editar qualquer produto para adicionar mais detalhes ou imagens
- Produtos estão em status rascunho — eles não serão visíveis para clientes até você publicar seu catálogo
- Você pode adicionar mais produtos importando novamente, ou adicioná-los manualmente
Para Usuários Técnicos
Para informações detalhadas sobre formatos de importação, integração de API e opções avançadas, veja nosso Guia de Importação de Produtos.Precisa de Ajuda?
Se você encontrar problemas:- Verifique a mensagem de erro — ela geralmente diz o que está errado
- Revise os problemas comuns acima
- Certifique-se de que o formato do seu arquivo corresponde ao nosso template
- Tente importar um lote menor para testar