> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alana.shopping/llms.txt
> Use this file to discover all available pages before exploring further.

# Importando Produtos de uma Planilha

> Faça upload em massa de centenas de produtos de uma vez usando um arquivo CSV ou Excel. Perfeito para catálogos grandes.

## 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           |

Para importação por URL, veja o guia de [Importação por URL](/guides/url-import).

## 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)

Ambos os formatos funcionam igualmente bem. Use o que você se sentir mais confortável!

## Passo 1: Baixe o Template

Para garantir que sua planilha tenha o formato correto, comece baixando nosso template:

1. Na visualização do seu catálogo, clique em **"Importar Produtos"**
2. Clique em **"Baixar Template"**
3. Um arquivo de planilha será baixado para o seu computador

Abra o template no Excel, Google Sheets ou seu app de planilha favorito. O template mostra exatamente quais colunas você precisa e quais dados vão em cada uma.

## 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://` ou `https://`)

### 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

**Dados Consistentes:**

* 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

**Exemplos:**

```
Title: "Fone de Ouvido Bluetooth Sem Fio"
Description: "Fones de ouvido sem fio de alta qualidade com bateria de 20 horas e cancelamento de ruído"
SKU: "FO-BT-001"
Price: "79.99"
Color: "Preto"
```

## Passo 3: Faça Upload do seu Arquivo

Quando sua planilha estiver pronta:

1. Vá para seu catálogo e clique em **"Importar Produtos"**
2. Clique em **"Escolher Arquivo"** ou arraste e solte sua planilha
3. 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"

O sistema tentará adivinhar o mapeamento correto baseado nos nomes das suas colunas, mas sempre verifique se está correto antes de prosseguir.

## 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)

**Corrija quaisquer erros** antes de prosseguir. Avisos são aceitáveis, mas considere corrigi-los para melhores resultados.

## Passo 6: Confirme e Importe

Revise o resumo final:

* Número de produtos a serem importados
* Quaisquer avisos ou problemas
* Suas colunas mapeadas

Clique em **"Confirmar Importação"** e seus produtos serão adicionados ao seu catálogo!

A importação geralmente leva alguns segundos a alguns minutos dependendo de quantos produtos você está fazendo upload. Você verá um indicador de progresso.

## 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://` ou `https://`
* 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.99` não `R$ 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

Execute esses processos no menu **Catálogo → Ações em Lote** ou via [Pipeline API](/api-reference/pipeline/overview). Veja o guia de [Enriquecimento de Dados](/guides/data-enrichment) para um passo a passo.

Depois que seus produtos forem importados:

* 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](/pt/help/catalogs/publishing-a-catalog)
* Você pode adicionar mais produtos importando novamente, ou [adicioná-los manualmente](/pt/help/catalogs/adding-products)

## 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](/pt/guides/product-import)**.

## Precisa de Ajuda?

Se você encontrar problemas:

1. Verifique a mensagem de erro — ela geralmente diz o que está errado
2. Revise os problemas comuns acima
3. Certifique-se de que o formato do seu arquivo corresponde ao nosso template
4. Tente importar um lote menor para testar