Importação de catálogo do Excel

A seção Importar dados permite carregar um catálogo de um arquivo Excel (ou de uma pasta com o arquivo e imagens): o assistente analisa as colunas, coleta categorias e cria produtos com dados, atributos e imagens. A configuração pode ser salva em um modelo e reutilizada em importações futuras.

O assistente consiste em quatro etapas: Escolher Arquivos → Escolher Dados → Configurações → Importar. Abaixo, cada parâmetro é detalhado com um exemplo de arquivo de roupas masculinas.

Limitações de upload

• Arquivos principais — até 20, adicionais — até 1000.
• Arquivo individual — até 10 MB, todos os arquivos somados — de acordo com o limite do stand.
• O número máximo de registros por importação é limitado (o valor é mostrado no bloco Atenção!).
• Colunas sem dados durante a importação são ignoradas.

Etapa 1. Arquivos e tipo de processamento

1. Abra a seção Importar dados no menu à esquerda.
2. Tipo de processamento — formato dos dados de origem:
   • Arquivos Excel — arquivos .xlsx;
   • Arquivos CSV — arquivos .csv;
   • Arquivos XML — arquivos .xml;
   • Arquivos e pastas locais — importação de arquivos e pastas locais.
3. Tipo de armazenamento de dados — para onde os dados irão. Para o catálogo, escolha Catálogo.
4. Modelos — lista suspensa de modelos salvos. A escolha de um modelo preenche automaticamente o tipo de processamento, tipo de armazenamento e toda a configuração das colunas da Etapa 2 (veja a seção "Edição de modelo").
5. O que você está carregando? — o que você está importando:
   • Arquivos principais (com a opção de adicionais) — arquivos principais (mais a possibilidade de adicionais). Modo padrão.
   • Apenas arquivos adicionais — apenas arquivos adicionais. Disponível apenas para modelos que permitem o carregamento de arquivos adicionais.
6. Carregando Arquivos Principais — arraste a pasta com o arquivo Excel para a área de upload ou clique em Escolher Arquivo. Você também pode carregar um arquivo compactado — o assistente irá descompactá-lo automaticamente. Para conjuntos grandes, use uma pasta compacta — assim o upload será mais rápido.
7. Carregando Arquivos Adicionais — se necessário, adicione uma pasta com imagens (quando as imagens estão em arquivos separados, e não dentro do Excel).
8. Clique em Upload de arquivo, aguarde o processamento e clique em Avançar.

À direita, são exibidos Histórico de Importação (registro de importações anteriores) e Modelos (lista de modelos salvos; o ícone "×" remove o modelo).

Etapa 2. Seleção e configuração de colunas

É exibida uma tabela mestre com todas as colunas do arquivo. Marque as colunas necessárias com uma marcação no cabeçalho — para cada uma aparecerá um cartão de configuração abaixo da tabela.

Parâmetros gerais da coluna

No cartão, são definidos nome do atributo (o marcador é gerado automaticamente), tipo de dados e função da coluna:

Parâmetro	Destino
Tipo	Tipo de atributo: String, Text, Integer, Float, Image, Group of Images, List e outros.
Nome	A coluna contém nome do produto.
Coletar categorias dos valores desta coluna	Os valores da coluna coletam categorias do catálogo.
Contém preço	A coluna é preço (usado com o tipo Float).
Contém moeda	A coluna é moeda.
Inclui SKU	A coluna é artigo (SKU).
Chave única	O valor é identificador único do produto: em uma nova importação, produtos com valor correspondente são atualizados, e não duplicados.
É ID de registro	A coluna é o identificador do registro.
Multi-seleção	Permitir múltiplos elementos de lista no valor (para o tipo List).
Divisor para multi-seleção	Símbolo divisor de valores em multi-seleção (no exemplo — vírgula ,).

Exemplo de configuração de colunas

No exemplo do catálogo masculino, as colunas estão configuradas da seguinte forma:

Coluna	Tipo e parâmetros
Categoria	Coletar categorias dos valores desta coluna
Nome do Produto	marcação Nome
Estilo, Detalhes	List + Multi-seleção + divisor ,
Descrição do Produto	Text
Marca, Gênero, Tamanho, País, Rótulo	List
Cor, Material, Forro, Isolamento, Instruções de Cuidado, Estação	List + Multi-seleção + divisor ,
Unidades, Quantidade em Estoque	Integer
Preço	Float + Contém preço
SKU	String + Inclui SKU + Chave única
Imagens	Image (veja abaixo)
Status	vinculação condicional aos status do produto (veja abaixo)

Coluna com imagens

1. Tipo — Image.
2. Selecione o modo Padrão de busca para nomes de arquivos e no campo de modelo indique *#attr#* — o assistente encontrará as imagens entre os arquivos adicionais pelo valor da coluna.
3. Otimizar imagens carregadas — otimização das imagens carregadas (ativada por padrão).
4. Marque Usar como pré-visualização na lista de produtos — um seletor de Modelos de pré-visualização será aberto; escolha um modelo de pré-visualização.

Vinculação condicional aos status do produto (coluna Status)

A coluna de status pode não ser importada "como está", mas mapear seus valores aos status do produto com base em condições:

1. Marque Atributo contém valores de status, em seguida Converter valor e Usar valores especiais — exatamente nesta ordem (o seletor de tipo de valores especiais aparece apenas após a terceira marcação).
2. Tipo de valor especial — escolha Status de Produtos.
3. Defina as condições de mapeamento. Para cada condição:
   • coluna de comparação (por padrão — a própria coluna Status);
   • operador — por exemplo, igual a (igual). Também estão disponíveis contém, não contém, diferente de, maior, menor, comparação com padrão, com outro atributo, com a data/hora atual, entre outros;
   • valor para comparação (por exemplo, Em Estoque);
   • status alvo do produto da lista de Status de Produtos.
4. Com o botão Adicionar condição, adicione a próxima condição (por exemplo, Fora de Estoque → outro status).

No exemplo: o valor Em Estoque e o valor Fora de Estoque são mapeados para o status do produto demo_status_update.

Se várias tabelas estiverem relacionadas, indique a chave comum (geralmente SKU) através dos campos de mapeamento de colunas. Após concluir a configuração, clique em Avançar.

Etapa 3. Categorias para importação

As categorias são coletadas dos valores da coluna marcada com a marcação Coletar categorias… na Etapa 2. Se necessário, ative a seleção da categoria raiz (Escolher Pai), na qual o catálogo importado será colocado. Clique em Avançar.

Etapa 4. Iniciar importação

1. Processar registros — número de registros a serem processados (pode ser reduzido em relação ao encontrado).
2. Carregar arquivos — carregar arquivos (imagens) junto com os dados.
3. Seleção de idioma — localidade para a qual os valores estão sendo importados.
4. Salvar como modelo — salvar a configuração atual como um modelo; no campo que aparece Nome do modelo, forneça um nome significativo (por exemplo, Importação de Excel do Catálogo Masculino), para reutilizá-lo mais tarde.
5. Clique em Iniciar importação e aguarde a conclusão.

Após a importação, categorias e subcategorias aparecerão no catálogo, e os produtos serão criados com dados, atributos, status e imagens.

Modelos: salvamento e edição

A configuração de importação pode ser salva em um modelo e reutilizada mais tarde — e, se necessário, complementada com uma nova coluna e reimportar o catálogo, atualizando os produtos já criados. O vídeo abaixo mostra todo o ciclo: primeiro uma importação simples com salvamento do modelo, depois sua edição.

Salvando o modelo

1. Realize a importação (no exemplo, duas colunas estão marcadas: Categoria — Coletar categorias… e Nome do Produto — Nome).
2. Na Etapa 4, marque Salvar como modelo, no campo Nome do modelo forneça um nome (no exemplo — Roupas masculinas) e clique em Iniciar importação.

O modelo aparecerá na lista Modelos à direita (o ícone "×" ao lado remove o modelo).

Edição do modelo

1. Na Etapa 1, na lista Modelos, selecione o modelo salvo — o tipo de processamento, armazenamento e configuração das colunas serão preenchidos automaticamente.
2. Marque a caixa Editar modelo — isso ativa o modo de edição (caso contrário, o modelo é aplicado sem alterações).
3. Carregue o arquivo. No modo de edição, o assistente abre imediatamente a Etapa 2 com as colunas do modelo já marcadas.
4. Marque a nova coluna (no exemplo — Estilo) e defina seu tipo (List).
5. Vá para a Etapa 4. Aqui estão disponíveis dois botões:
   • Salvar modelo apenas — salvar alterações no modelo sem importar;
   • Salvar modelo e importar dados — salvar alterações e reimportar o catálogo com os dados atualizados.
6. Clique em Salvar modelo e importar dados.

Após a reimportação, abra qualquer produto da categoria e na aba Atributos verifique se o novo atributo (Estilo) foi adicionado.