Importar produtos

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

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

Selecione Importar, depois Modelo.
Abra o CSV baixado em um editor de planilha que preserve a formatação CSV.
Mantenha os cabeçalhos do modelo. Conclua handle e title para produtos, mais o sku mostrado e valores de opção para variantes.
Revise identificadores de produto, títulos, preços, variantes e quaisquer linhas repetidas antes de exportar como CSV.
Retorne ao diálogo e escolha ou arraste o CSV para a área de upload.
Aguarde até que o arquivo mostre Pronto para importar.
Selecione Iniciar Importação uma vez.
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.