Importação de catálogo
Visão Geral
A importação permite que você carregue produtos, variantes, categorias e propriedades em massa, sem criá-los um por um. O fluxo é com modelo de Excel (XLSX): você escolhe um modelo, baixa um arquivo .xlsx já montado com suas colunas, preenche, sobe e passa por um editor de staging —uma visualização intermediária onde você revisa o conteúdo, corrige erros e exclui linhas antes de comprometer as mudanças ao catálogo. A confirmação final roda em segundo plano com um modal de progresso que você pode fechar e seguir trabalhando.
Hoje o formato disponível é o modelo XLSX. Outros dois métodos —Excel/CSV com mapeamento manual e PDF, Word ou imagem com IA— aparecem na tela marcados como Em breve.
Como Acessar
- Navegue até Catálogo de Vendas > Produtos e clique em Nova importação (
/sales/imports/new). - Perfil necessário: Administrador.
Visão Geral da Interface
A importação tem três etapas visíveis:
- Escolher o método — Três cartões: Modelo (disponível), Excel / CSV e PDF, Word ou imagem (ambas Em breve).
- Configurar, baixar e subir — Um assistente de três passos: você escolhe o modelo, baixa o XLSX, preenche e sobe.
- Editor de staging (
/sales/imports/:id) — Uma tabela com cada linha do arquivo, seus erros destacados, e ações para editar valores, excluir linhas ou aceitar como estão.
Quando você confirma, aparece um modal de progresso com duas fases (produtos e mídias). Você pode fechá-lo e voltar à lista; o chip de progresso superior mantém o status visível. Ao terminar, você verá um resumo com quantos produtos foram criados, quantos foram atualizados e quantas linhas falharam.
O fluxo com modelo XLSX
Passo 1 — Escolha um modelo
Um modelo define quais colunas seu arquivo traz (campos de produto e variante, propriedades personalizadas, imagens). O padrão funciona para a maioria dos catálogos; crie um personalizado se você precisar de mais colunas. Consulte Modelos de importação para desenhá-los.
Passo 2 — Baixe o modelo XLSX
O botão Baixar modelo XLSX gera um arquivo com cabeçalhos no seu idioma, as colunas obrigatórias marcadas, menus suspensos e comentários por coluna com o formato esperado. Preencha-o no Excel ou Google Sheets.
Passo 3 — Suba seu arquivo
Suba o .xlsx preenchido. A Aurora valida cada célula e te leva ao editor de staging. Só se aceitam arquivos .xlsx; outros formatos são rejeitados.
O editor de staging
Após subir o arquivo, a Aurora te leva ao editor de staging. Aqui:
- Cada linha do arquivo se transforma em uma linha editável da tabela.
- As linhas com erros são destacadas: SKU duplicado, preço inválido, categoria inexistente, coluna obrigatória vazia. Você pode editar o valor diretamente na célula.
- Você pode excluir linhas que não queira importar.
- O contador superior mostra quantas linhas são válidas, quantas têm erros e quantas estão excluídas.
- Se uma linha era um produto já existente (mesmo SKU), a importação a trata como atualização em vez de criação.
Uma vez que o arquivo está limpo (ou você decide aceitar os erros como linhas falhas), você clica em Confirmar importação e o processo passa para o modal de progresso.
Colunas e formato
Cada linha precisa de pelo menos Nome, SKU, Preço e Moeda; as demais colunas são opcionais. Alguns formatos úteis:
- Preço aceita
$100.00,100,00ou1,234.56. - Moeda é um código ISO 4217 (MXN, USD, EUR).
- Para variantes (tamanho, cor), use o mesmo Identificador do produto (ProductHandle) em todas as linhas de um mesmo produto; deixe-o em branco se o produto tiver uma única variante.
Importação de imagens
Quando seu modelo inclui colunas de URL de imagem, a Aurora baixa as imagens dessas URLs durante a importação e as salva na sua conta. As imagens idênticas (mesmo conteúdo) são deduplicadas automaticamente —não duplica o armazenamento se a mesma imagem aparece em vários produtos ou variantes.
Notas importantes:
- As URLs devem ser públicas e acessíveis (a importação não pode se autenticar).
- Se uma URL falha (404, tempo esgotado), o produto é criado mesmo assim, mas sem essa imagem. O erro é registrado no relatório de falhas por linha.
- Para importações grandes (vários milhares de imagens), valide as URLs antes e divida o arquivo em lotes (ver "Importações grandes").
Funcionalidades e Ações
Iniciar uma importação
O que faz: Abre o assistente para escolher modelo e subir o arquivo.
Passos:
- Na lista de produtos, clique em Nova importação.
- Escolha o cartão Modelo.
- Selecione o modelo, baixe o XLSX, preencha-o e suba.
Editar linhas no staging
O que faz: Corrige erros ou ajusta valores antes de comprometer.
Passos:
- No editor de staging, clique em uma célula com erro (ou qualquer célula editável).
- Modifique o valor; os erros de validação são atualizados automaticamente.
Excluir linhas
O que faz: Marca linhas para que não sejam importadas.
Passos:
- Marque as linhas que você quer excluir.
- Elas ficam visíveis mas atenuadas e não são contadas no total a importar.
Confirmar a importação
O que faz: Comprometer as mudanças ao catálogo em segundo plano.
Passos:
- Uma vez revisadas as linhas, clique em Confirmar importação.
- Aparece o modal de progresso com duas fases: Produtos (cria e atualiza) e Mídias (baixa imagens).
- Você pode fechar o modal e seguir trabalhando; o chip de progresso superior te avisa quando termina.
Cancelar uma importação em andamento
O que faz: Detém a importação. O que já foi processado se mantém (é seguro retomar depois).
Passos:
- No modal de progresso, clique em Cancelar e confirme.
- A importação é marcada como cancelada no histórico.
Revisar erros por linha
O que faz: Veja quais linhas falharam e por quê.
Passos:
- Ao terminar, abra o painel de resultados do modal de progresso.
- A lista mostra cada linha falha com o motivo (URL de imagem inacessível, SKU duplicado, dados inválidos, etc.).
- Você também acessa o histórico em Catálogo de Vendas > Configurações > Histórico de importações.
Importações grandes (milhares de produtos e imagens)
- Divida o arquivo em lotes de cerca de 5.000 produtos. Cada lote é uma importação independente.
- Valide as URLs de imagem antes de importar. As URLs caídas fazem falhar imagens individuais —cada falha é registrada mas o produto é criado igual sem imagem.
- Aguarde o ciclo de busca semântica. Para que o agente IA busque de forma semântica em produtos recém-importados, a Aurora processa cada produto em segundo plano. Em uma importação grande, a busca semântica completa pode demorar algumas horas para se estabilizar —enquanto isso a busca por palavras e os filtros estruturados já funcionam a 100%.
Referência de Campos (resumo)
| Campo | Descrição | Obrigatório | Observações |
|---|---|---|---|
| Nome | Nome do produto | Sim | Obrigatório em cada linha |
| SKU | Identificador único de variante | Sim | Único na sua conta; se já existe = atualização |
| Preço | Preço por unidade da variante | Sim | Aceita $100.00, 100,00 ou 1,234.56 |
| Moeda | Código ISO 4217 | Sim | MXN, USD, EUR, etc. |
| Identificador do produto | Agrupa variantes do mesmo produto | Não | Mesmo valor em todas as linhas de um produto multivariante |
| Categoria | Categoria do produto | Não | Resolvida por nome; criada se não existe |
| Marca | Marca do produto | Não | Texto livre |
| Status | Rascunho / Ativo / Descontinuado / Arquivado | Não | Padrão: Rascunho |
| URLs de imagens | Uma ou várias colunas com URLs públicas | Não | Públicas e acessíveis |
| Propriedades personalizadas | Uma coluna por propriedade definida | Não | O valor respeita o tipo da propriedade |
Notas Importantes
- Apenas arquivos
.xlsx. O formato CSV já não se sobe diretamente; baixe o modelo XLSX e preencha-o. - Máximo de 10.000 linhas por arquivo. Para volumes maiores, divida em vários arquivos.
- A importação é retomável: se o processo for interrompido (você fecha o navegador, a conexão cai), o trabalho continua em segundo plano —você não precisa recarregar o arquivo.
- Os produtos criados ficam em status Rascunho salvo se a importação especifique outro status, para que sua equipe os revise antes de expô-los ao agente IA.
- O histórico completo é mantido em Configurações > Histórico de importações —incluindo os arquivos de erro por linha.
Perguntas Frequentes
P: Quais formatos posso subir?
R: Por enquanto, .xlsx gerado a partir de um modelo. O mapeamento manual de Excel/CSV e a extração com IA a partir de PDF/Word/imagem aparecem como Em breve.
P: O que acontece se uma linha tem um SKU que já existe? R: É tratado como uma atualização do produto/variante existente, não como uma duplicação.
P: Por que algumas imagens não apareceram depois de importar? R: Provavelmente as URLs responderam com erro ou demoraram demais. Revise o relatório de falhas por linha e corrija as URLs ou faça upload manualmente para o produto.
P: Posso desfazer uma importação? R: Não há um botão de "desfazer" automático. Para minimizar o risco, os produtos novos ficam em Rascunho por padrão; se você precisa reverter, arquive-os ou faça uma segunda importação de correção.
P: A importação roda mesmo se eu fechar o navegador? R: Sim. Uma vez confirmada, roda em segundo plano. Volte à Aurora e verá o chip de progresso ou o resumo final.