Pular para o conteúdo principal

Modelos de importação

Visão Geral​

Um modelo de importação define a estrutura do arquivo XLSX que você vai preencher: quais campos de produto e variante incluir, quais eixos de variante seu catálogo tem, quais propriedades personalizadas e quantas colunas de imagem. Uma vez desenhado, você baixa um .xlsx já montado com os cabeçalhos, os menus suspensos e os comentários por coluna —pronto para preencher e subir. Ideal para padronizar cargas recorrentes com o mesmo formato.

Diferentemente da abordagem anterior (subir um CSV e mapear colunas), hoje você desenha o esquema e a Aurora gera o arquivo a partir dele.

Como Acessar​

  • Navegue até Catálogo de Vendas > Configurações > Modelos de importação (/sales/settings).
  • Perfil necessário: Administrador.

Visão Geral da Interface​

A tela de Modelos de importação mostra a lista de modelos com seu nome, sua estrutura (eixos, propriedades, imagens), a data de atualização e ações. A partir daí você pode:

  • Novo modelo — abre o editor.
  • Baixar XLSX — gera o arquivo a partir do modelo.
  • Definir como padrão — o modelo que é pré-selecionado ao importar.
  • Excluir — desativa o modelo (as importações anteriores que o usaram continuam funcionando).

O editor de modelos​

O editor ("Componha o esquema do modelo: escolha os campos, defina os eixos de variante e pré-visualize o arquivo XLSX resultante") está organizado em seções:

  • Dados básicos — Nome e descrição (para que você o usa, o que prioriza).
  • Campos de produto — Marque os campos que aparecerão como coluna. Nome, SKU, Preço e Moeda vão sempre incluídos.
  • Variantes — Ative "Este catálogo tem produtos com variantes" e defina os eixos (Cor, Tamanho…). Cada eixo é uma coluna; máximo 4. Inclui-se uma coluna ProductHandle para agrupar as variantes de um mesmo produto.
  • Campos de variante — Campos específicos de cada variante.
  • Propriedades personalizadas — Se seu catálogo tem propriedades personalizadas, escolha-as para incluí-las como colunas.
  • Imagens — Quantas colunas de URL de imagem por variante. Cada coluna espera uma URL pública (http/https).
  • Linhas de exemplo e Pré-visualização — Mostram as colunas em ordem, tal como sairão no XLSX.

Ao terminar, Salvar e baixar XLSX salva o modelo e baixa o arquivo pronto para preencher.

Funcionalidades e Ações​

Criar um modelo​

O que faz: Define um novo esquema de colunas que você poderá reutilizar.

Passos:

  1. Em Modelos de importação, clique em Novo modelo.
  2. Informe Nome e, opcionalmente, Descrição.
  3. Em Campos de produto, marque as colunas que você quer (lembre-se: Nome, SKU, Preço e Moeda sempre vão).
  4. Se seu catálogo tem variantes, ative-as e defina os eixos (até 4).
  5. Adicione propriedades personalizadas e colunas de imagem se você as precisar.
  6. Revise a pré-visualização e clique em Salvar e baixar XLSX.

Notas importantes: O modelo salva o esquema, não dados. As etiquetas e categorias que apareçam no arquivo são criadas automaticamente ao confirmar a importação.

Editar um modelo​

O que faz: Muda o nome, a descrição ou o esquema.

Passos:

  1. A partir da lista, abra o modelo.
  2. Ajuste os campos, eixos, propriedades ou imagens.
  3. Salve (e baixe o XLSX atualizado se a estrutura mudou).

Definir o padrão​

O que faz: Define qual modelo é pré-selecionado ao importar.

Passos:

  1. Na lista, use Definir como padrão no modelo desejado.
  2. Esse modelo aparecerá já marcado no passo 1 da importação.

Excluir um modelo​

O que faz: Desativa o modelo.

Passos:

  1. A partir da lista, clique em Excluir e confirme.

Notas importantes: Excluir um modelo não afeta as importações que já foram executadas com ele; ele só deixa de estar disponível para novas cargas.

Usar um modelo em uma importação​

O que faz: Baixa o XLSX e você o sobe preenchido.

Passos:

  1. A partir de Produtos, clique em Nova importação e escolha o cartão Modelo.
  2. Selecione o modelo, baixe o XLSX, preencha-o e suba.
  3. A Aurora valida o arquivo e te leva ao editor de staging.

Boas práticas​

Um modelo por estrutura, não por arquivo​

Se você gerencia catálogos com estruturas distintas (um simples, outro com variantes e propriedades), crie um modelo por estrutura. Se tudo vem com o mesmo formato, um só basta.

Nomeie bem seus modelos​

"Catálogo completo Q1 2026" é melhor que "Modelo 1". Sua equipe daqui a seis meses vai te agradecer.

Combine com produtos em Rascunho​

Por padrão, os produtos importados ficam em status Rascunho. Assim você pode importar com confiança: se o arquivo trouxer linhas com erros não detectados, os produtos não se expõem ao agente IA até que sua equipe os revise e os ative.

Perguntas Frequentes​

P: Os modelos suportam propriedades personalizadas? R: Sim. Qualquer propriedade personalizada definida no seu catálogo pode ser incluída como coluna a partir da seção Propriedades personalizadas do editor.

P: Os modelos incluem as URLs de imagem? R: Sim. Na seção Imagens você define quantas colunas de URL de imagem por variante. Cada coluna espera uma URL pública.

P: Posso importar sem desenhar um modelo? R: Você precisa pelo menos do modelo padrão (serve para a maioria dos catálogos). O mapeamento manual de colunas aparece como Em breve.

P: Mudei a estrutura do meu catálogo. O que faço? R: Edite o modelo, baixe o XLSX novamente e use-o para sua próxima carga.

Funcionalidades Relacionadas​