# 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="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FySDWp7iCukM9fvP940Ed%2Fimage.png?alt=media&#x26;token=63cb4667-aa50-4a4a-99e7-e58218cb2a73" 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="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FHs01wgQgUjB6Xci9zDqA%2Fimage.png?alt=media&#x26;token=cfcf8893-ad49-4136-99b0-cc5ba3633c7c" 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="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FrX04bBvsE0xq5YukjlQ0%2Fimage.png?alt=media&#x26;token=8e0be8ef-3b0c-4a71-b7a4-2704fbf32ac4" 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="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FPdpA77CFVZLbQrBeGmf3%2Fimage.png?alt=media&#x26;token=1994caae-3521-4b76-adcd-f578347f3d55" 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="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FCgUVR4fYwMbpaSTFbMLl%2Fimage.png?alt=media&#x26;token=98ad6c39-7d86-412a-a891-11dd19ad85d0" 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="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2F1RqOdpdjYQ2IDVVhLNhN%2Fimage.png?alt=media&#x26;token=71147e55-ac7c-4117-a08c-1c5f6846085b" 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="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FAZkUvn8z2OStRABwgANq%2Fimage.png?alt=media&#x26;token=c355f620-8af6-44a2-bf42-a731c051d69b" 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="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FoVw9tnpD5j8HIR8lP025%2Fimage.png?alt=media&#x26;token=480df1d9-6a1e-4d0a-ad24-2eccfc3c38d6" 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="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FoIuCrPVWxksxgCd6fzM0%2Fimage.png?alt=media&#x26;token=c33f4a58-8224-44d1-ae5f-708832f0dc38" 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="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2F5vD3DttjzYJtOjZPg6dX%2Fimage.png?alt=media&#x26;token=b6e4e2f4-87a2-45ea-b2da-43eb07b8cae2" alt=""><figcaption></figcaption></figure>

&#x20;

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

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FVXgyT4b1RMBnd9e8OM0x%2Fimage.png?alt=media&#x26;token=d08c0d93-3b5d-4763-b958-4e9cee9dd60b" 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 %}