---
title: Importar produtos
description: Use o modelo CSV do Runner para iniciar uma importação de catálogo e acompanhe seu histórico de processamento.
---

Importe produtos de um CSV preparado quando inserir as mesmas informações de catálogo estruturado um produto por vez seria ineficiente.

## Por que e quando usar importação

Use Importar quando você já tem dados de produto em uma planilha ou outro sistema e pode mapeá-los para o modelo CSV do Runner. Use o formulário [Produtos](./products) manual para um catálogo pequeno ou quando você precisa aprender os campos primeiro.

## Disponibilidade e pré-requisitos

- Abra **Operações da Loja → Produtos** em uma loja pronta.
- Conclua a configuração de publicação/prontidão da loja que cria seu canal de catálogo de vitrine ao vivo; a tarefa de importação não pode continuar sem esse canal.
- A lista de produtos do desktop preenchida mostra **Importar**. Em um catálogo vazio, primeiro use **Adicionar Primeiro Produto**; a visualização móvel enfatiza a criação manual.
- Importar aceita apenas arquivos CSV.
- Use o Modelo atual do Runner. As colunas obrigatórias são `handle` e `title`; linhas de variante devem incluir o `sku` obrigatório e valores de opção mostrados pelo modelo.
- Iniciar uma importação altera o catálogo da loja. Revise o arquivo antes de enviá-lo.

## Abrir Importar Produtos

**Caminho de entrada:** **Espaço de trabalho → escolha uma loja → Operações da Loja → Produtos → Importar**

![Diálogo Importar Produtos](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgObeFKMJCcW62zHrU8smjSnqvixd1twlAf4uK)

## Controles principais

| Controle | Por que você o usa | O que acontece quando selecionado |
| --- | --- | --- |
| **Importar** | Abra o fluxo de trabalho de importação em massa | Abre o diálogo Importar Produtos sem iniciar uma tarefa. |
| **Modelo** | Comece com as colunas esperadas do Runner | Baixa o arquivo `product-import-template.csv` atual. |
| **Histórico** | Verifique tarefas de importação anteriores | Muda para uma lista de arquivos de importação e seus estados mais recentes. |
| Área de upload | Escolha o CSV preparado | Lê o arquivo localmente e o mostra como pronto quando o conteúdo está disponível. |
| Controle remover arquivo | Corrija uma seleção errada | Limpa o arquivo selecionado para que você possa escolher outro. |
| **Iniciar Importação** | Envie o CSV selecionado | Inicia uma tarefa de importação, depois move para Histórico quando o Runner a aceita. |
| **Cancelar** | Saia sem enviar | Fecha o diálogo e limpa o arquivo selecionado. |
| **Atualizar** em Histórico | Solicite o estado da tarefa mais recente | Recarrega o histórico de importação visível. |
| **Voltar para Importar** | Prepare outro arquivo | Retorna do Histórico para a visualização de upload. |
| **Fechar** | Saia do Histórico | Fecha o diálogo sem alterar a tarefa já enviada. |

## Preparar e enviar um CSV

1. Selecione **Importar**, depois **Modelo**.
2. Abra o CSV baixado em um editor de planilha que preserve a formatação CSV.
3. Mantenha os cabeçalhos do modelo. Conclua `handle` e `title` para produtos, mais o `sku` mostrado e valores de opção para variantes.
4. Revise identificadores de produto, títulos, preços, variantes e quaisquer linhas repetidas antes de exportar como CSV.
5. Retorne ao diálogo e escolha ou arraste o CSV para a área de upload.
6. Aguarde até que o arquivo mostre **Pronto para importar**.
7. Selecione **Iniciar Importação** uma vez.
8. Em **Histórico**, acompanhe o arquivo enviado até atingir um estado terminal, depois atualize a lista Produtos e inspecione as linhas resultantes.

## Entender estados do Histórico

| Estado | Significado | O que fazer |
| --- | --- | --- |
| **Pendente** | A tarefa está aguardando para começar | Deixe-a no lugar e verifique novamente mais tarde; não envie imediatamente uma duplicata. |
| **Processando** | O Runner está trabalhando no arquivo | Mantenha o diálogo aberto ou retorne ao Histórico mais tarde. |
| **Concluído** | O Runner terminou de entregar o arquivo ao importador de catálogo | O processamento de produto pode continuar após este estado. Atualize Produtos e inspecione nomes, variantes, preços, status e inventário. |
| **Falhou** | O Runner não conseguiu concluir a tarefa de importação | O cartão Histórico atual registra o estado falho, mas não uma causa detalhada. Verifique os pré-requisitos e CSV de origem antes de enviar um novo arquivo. |
| **Cancelado** | A tarefa não continuou | Confirme se algum produto foi criado antes de decidir o que enviar a seguir. |

O Histórico também pode mostrar o tamanho do arquivo, total de linhas e um ID de transação quando o Runner tiver esses valores. Esses detalhes identificam a tarefa; eles não substituem a verificação dos registros de produto.

## Limites e solução de problemas

- **Iniciar Importação está desabilitado:** Selecione um arquivo `.csv` e aguarde o Runner terminar de ler conteúdo não vazio.
- **Tipo de Arquivo Inválido:** Exporte a planilha como CSV; renomear outro formato de arquivo não o converte.
- **Erro de Leitura de Arquivo:** Re-exporte o CSV, confirme que ele abre normalmente em seu dispositivo e escolha-o novamente.
- **Importação Falhou:** Confirme que a configuração de publicação/prontidão da loja criou o canal de catálogo de vitrine ao vivo, depois use o modelo fornecido, restaure colunas obrigatórias e verifique `sku` de variante e valores de opção.
- **A tarefa parece travada:** Abra Histórico e selecione **Atualizar**. Pendente e Processando não são prova de conclusão.
- **Linhas de produto inesperadas aparecem:** Não repita a mesma importação cegamente. Compare os identificadores de CSV com a lista Produtos e corrija registros deliberadamente.

## Guias relacionadas

- [Produtos](./products)
- [Inventário e variantes](./inventory-and-variants)
- [Integração e configurações gerais](./onboarding-and-general-settings)
- [Visão geral de Operações da Loja](./)