# Como importar produtos em lote?

{% hint style="danger" %}
**Antes de começar: use obrigatoriamente o modelo de planilha da plataforma**

**Este é o erro mais comum.** Muitos administradores tentam importar uma planilha própria,  do Excel, de outro sistema ou de fornecedor,  e a importação falha ou gera dados incorretos.

A plataforma só reconhece um único formato de planilha, com colunas específicas em ordem exata. Qualquer variação faz a importação não funcionar.

* Não renomeie as colunas
* Não reordene as colunas
* Não adicione colunas extras
* Não altere o tipo do arquivos obrigatórios

**👉 Sempre baixe o modelo direto da plataforma** (veja o Passo 3 abaixo) e preencha a partir dele.
{% endhint %}

***

### O que é a importação em lote?

A importação em lote permite que você cadastre ou atualize um grande volume de produtos e conteúdos de uma só vez, via planilha. Em vez de criar cada produto manualmente, com seus títulos, descrições, configurações, você preenche tudo em uma planilha e sobe de uma única vez.

{% hint style="info" icon="lightbulb" %}
**Quando vale usar a importação em lote?**

Lançamentos com 5+ produtos, migrações de plataforma, atualizações em massa, e qualquer situação em que configurar produto por produto levaria mais de 30 minutos.
{% endhint %}

***

### Passo a passo

{% stepper %}
{% step %}

### **Acesse as Configurações**

No menu lateral do painel de administrador, clique em **Configurações**. Em seguida, selecione **Importação**\
Configurações → Importação
{% endstep %}

{% step %}

### Abra o Relatório de Importação em Lote

Você será direcionado à página "Relatório de Importação em lote". Aqui ficam registradas todas as importações já realizadas, com status e logs de cada uma.
{% endstep %}

{% step %}

### Clique em "+ Importar em lote" e baixe o modelo oficial

Na parte superior direita, clique no botão **+ Importar em lote**. Na tela seguinte, **faça o download do modelo de planilha disponibilizado pela plataforma**. <mark style="color:$warning;">Este arquivo é o único formato aceito.</mark>

Configurações → Importação → Importar em Lote → Baixar modelo

**Não pule este passo**

{% hint style="warning" %}
Mesmo que você tenha uma planilha parecida de outro sistema, baixe o modelo agora. Use-o como base. Cole seus dados dentro do modelo, nunca o contrário.
{% endhint %}
{% endstep %}

{% step %}

### Selecione o tipo de importação desejada

Na tela de importação, escolha a opção no campo de seleção. <mark style="color:$warning;">Cada tipo de importação (produtos, conteúdos, membros) tem seu próprio modelo</mark>, certifique-se de usar o modelo correspondente ao que selecionou.
{% endstep %}

{% step %}

### Preencha o modelo com seus dados

Abra o arquivo no modelo escolhido baixado e preencha linha a linha com os dados dos seus produtos. Cada linha representa um produto. <mark style="color:$danger;">Não apague o cabeçalho (primeira linha)</mark>.
{% endstep %}

{% step %}

### Faça o upload e confirme

Volte à plataforma, anexe o arquivo preenchido e clique em **Importar**. A plataforma processará a planilha e exibirá o resultado na aba **Logs de importação**

{% hint style="info" icon="lightbulb" %}
**Dica: teste com 3 a 5 produtos antes de importar tudo**&#x20;

Antes de subir uma planilha com 200 produtos, faça uma importação de teste com apenas algumas linhas. Se os dados aparecerem corretos, aí sim importe o lote completo. Isso evita retrabalho em caso de erro de formatação.
{% endhint %}
{% endstep %}
{% endstepper %}

***

### Passo a Passo com Imagens

<details>

<summary>Confira Aqui</summary>

1. No menu lateral do painel de administrador, clique em **Configurações**. Em seguida, selecione **Importação**

<figure><img src="/files/fht5kXDtKpCtKlyIwIYF" alt=""><figcaption></figcaption></figure>

2. Seremos direcionado à página de "Relatório de Importação em lote", vamos clicar no botão <mark style="color:blue;">**+importar em lote**</mark>, conforme mostra a imagem:

<figure><img src="/files/bLyatb9SZX3aTPzzqpVD" alt=""><figcaption><p>Configurações > Importação > Importar em Lote</p></figcaption></figure>

3. Selecione a importação que você deseja. Neste caso, vamos escolher **'produtos'** e, em seguida clique em continuar. Conforme a imagem:&#x20;

<figure><img src="/files/qvoFeBCxxfVuIuk8l3pZ" alt=""><figcaption></figcaption></figure>

4. Após isso, baixe o arquivo em CSV, XLSX, XLS ou ODS do modelo padrão que disponibilizamos.

<figure><img src="/files/OU9tht4zYFds4e1BEBZu" alt=""><figcaption></figcaption></figure>

Na imagem, há o passo a passo.&#x20;

* 1º  é o link para que você possa fazer o download do modelo de arquivo (de acordo com o tipo de arquivo que você deseja baixar)&#x20;
* 2º  Após ter o arquivo em CSV, XLSX, XLS ou ODS preenchido, conforme o modelo, você irá arrastar/colar para este espaço. Basta clicar em 'navegue'.
* 3º  Depois de carregar o arquivo, você clicará em <mark style="color:blue;">**continuar**</mark>

{% hint style="danger" %}
***O arquivo precisa estar em formato .***&#x43;SV, .XLSX, .XLS ou .ODS
{% endhint %}

<figure><img src="/files/eCtOPLw6jRQ86IJCYVcX" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
**O arquivo de produtos deverá conter TODAS as informações do nosso modelo padrão. Caso você não possua, basta fazer o download.**
{% endhint %}

#### **Modelo** CSV, XLSX, XLS ou ODS **de Produto**

A planilha contém todas as informações necessárias para que desta forma o produto possa ser importado corretamente. A seguir, veja como preencher cada um:

* Nome do conteúdo: Coloque o nome do seu produto exemplo: "Curso Iniciante de Marketing "
* Nome do módulo: defina um nome para este módulo, exemplo: "Estratégia e Gestão de Mídias Sociais"
* Nome da aula: Coloque aqui o nome específico da aula, exemplo: "Como desenvolver um calendário editorial para uma rede social"
* Tipo da aula: Aqui você deve descrever o formato da aula, se é um vídeo, áudio, pdf. Exemplo: Video - YouTube
* Referência: Aqui você deve colocar o link do vídeo. Exemplo: <https://youtu.be/123>
* Descrição da aula: Uma sinopse simples da aula. Exemplo: Aprendendo a estruturar um calendário editorial, de postagens, do zero.&#x20;

<figure><img src="/files/w8Or4wqHkIb2UEwkkgfu" alt=""><figcaption></figcaption></figure>

5. Após preencher a planilha, você deve salvar em ' CSV, XLSX, XLS ou ODS' e colar no espaço, conforme mostra na imagem. Em seguida, você irá **'enviar o arquivo'** e **'continuar'**

<figure><img src="/files/99JNNWUb4arnWr3Ao6q0" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
Se a importação for feita em turmas, a data das configurações da turma prevalecerá.
{% endhint %}

6. A segunda etapa consiste em fornecer informações sobre a importação que está realizando.

Adicione informações de título e descrição da importação e clique em ‘**Continuar**’

<figure><img src="/files/drSO32g7eCEae37Qw9Xp" alt="" width="513"><figcaption></figcaption></figure>

&#x20;

7. Selecione o Tipo do lote, conforme a imagem. Em seguida, selecione uma Categoria e clique em **'continuar'**

<figure><img src="/files/QgOFe5f0BJGC39vbsiI8" alt=""><figcaption></figcaption></figure>

&#x20;

8. Por fim aparecerá todas as linhas do seu arquivo, após ‘**Continuar e Importar**’ o processo começará a ser feito.

<figure><img src="/files/CCretaVaJSuDf6JvYoGX" alt=""><figcaption></figcaption></figure>

&#x20;

9. Prontinho, seus produtos já estão sendo exportados.

<figure><img src="/files/DxVHgvillqEsH5njKzeo" alt="" width="487"><figcaption></figcaption></figure>

</details>

***

### Passo a Passo com Vídeo

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FbngsDeqkldLwY4IEOjYs%2FGravando%202026-04-02%20125100.mp4?alt=media&token=1dbe2603-105f-4168-8deb-9e864fbe16fa>" %}

***

### Erros comuns e como evitar

<details>

<summary>Confira Aqui</summary>

Esses são os erros que mais aparecem nos atendimentos. Identifique o seu e resolva antes de tentar uma nova importação.

> <mark style="color:red;">Erro #1</mark>
> \
> Planilha no formato errado
> \
> A planilha usada não é o modelo oficial da plataforma. Pode parecer igual, mas basta uma coluna fora de ordem para quebrar.
> \ <mark style="color:$success;">✔ Solução: baixe o modelo novamente e use-o como base.</mark>

> <mark style="color:red;">Erro #2</mark>
> \
> Cabeçalho apagado ou alterado
> \
> A primeira linha da planilha (com os nomes das colunas) foi apagada, traduzida ou modificada.
> \ <mark style="color:$success;">✔ Solução: mantenha a primeira linha exatamente como está no modelo.</mark>

> <mark style="color:red;">Erro #3</mark>
> \
> Arquivo salvo em formato diferente
> \
> A planilha foi salva com outro formato que não o recomendado.
> \ <mark style="color:$success;">✔ Solução: salve sempre como .csv, .ods, .xls ou .xlsx. antes de fazer o upload.</mark>

> <mark style="color:red;">Erro #4</mark>
> \
> Campos obrigatórios em branco
> \
> Algumas colunas são obrigatórias. Deixá-las vazias faz a linha ser ignorada ou gerar erro.
> \ <mark style="color:$success;">✔ Solução: verifique os campos marcados como obrigatórios no modelo.</mark>

> <mark style="color:red;">Erro #5</mark>
> \
> Modelo desatualizado
> \
> Um modelo baixado há meses pode estar em versão antiga, incompatível com a plataforma atual.
> \ <mark style="color:$success;">✔ Solução: sempre baixe um modelo novo antes de cada importação importante.</mark>

> <mark style="color:red;">Erro #6</mark>
> \
> Tipo de importação errado
> \
> O modelo de "Conteúdos" foi usado para importar "Produtos", cada tipo tem seu próprio modelo.
> \ <mark style="color:$success;">✔ Solução: confira se o tipo selecionado na tela corresponde ao modelo baixado.</mark>

</details>

***

### Como verificar se a importação funcionou e tempo de processamento

<details>

<summary>Após concluir o upload, você pode acompanhar o resultado de duas formas:</summary>

📋**Aba "Logs de importação":** mostra o histórico detalhado de cada importação, com status (sucesso, erro, parcial) e o número de registros processados.

🔍**Aba "Importação em lote":** lista as importações realizadas. Clique em uma delas para ver detalhes linha a linha.

⚠️**Status "parcial":** significa que algumas linhas foram importadas e outras não. Verifique o log para identificar quais linhas falharam e o motivo.

{% hint style="info" icon="clock-five" %}
**Lotes grandes podem demorar alguns minutos**&#x20;

Planilhas com muitos produtos são processadas em background. Não feche a janela antes de ver o status "concluído". Se a página demorar, atualize após alguns minutos e verifique nos logs.
{% endhint %}

</details>

***

### Perguntas frequentes

<details>

<summary>Posso usar minha própria planilha em vez do modelo?</summary>

Não. A plataforma só aceita o modelo oficial, com as colunas na ordem e formato exatos. Planilhas de outros sistemas, fornecedores ou criadas do zero não serão reconhecidas corretamente.

</details>

<details>

<summary>A importação em lote sobrescreve produtos que já existem?</summary>

Depende da configuração. Em geral, se um produto com o mesmo código já existe, ele será atualizado, não duplicado. Confirme este comportamento nos logs após uma importação de teste.

</details>

<details>

<summary>Há um limite de linhas por planilha?</summary>

Recomenda-se não ultrapassar 500 linhas por importação para garantir desempenho. Para volumes maiores, divida em lotes menores.

</details>

<details>

<summary>Posso desfazer uma importação?</summary>

Não há desfazer automático. Por isso, faça sempre um teste com poucas linhas antes de importar o lote completo. Em caso de erro em massa, entre em contato com o suporte.

</details>

<details>

<summary>Onde encontro o modelo de planilha mais atualizado?</summary>

Sempre dentro da plataforma, no próprio fluxo de importação (Configurações → Importação → Importar em Lote). Não use modelos salvos de importações anteriores sem verificar se ainda são válidos.

</details>

{% hint style="info" %}
Ainda com dúvidas ou importação com erro?

[Falar com o suporte](https://wa.me/5511974418668)
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.curseduca.com/conteudos/produtos/produto-versao-2/como-criar-um-novo-produto/como-importar-produtos-em-lote.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.