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 é explicado com base em um arquivo de roupas masculinas.

Limitações de upload

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

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"). Após escolher um modelo, uma dica aparece abaixo dos campos: Ao importar com um modelo, primeiro selecione arquivos adicionais, depois o principal.
5. O que você está carregando? — o que você está carregando:
   • 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 Arraste e solte a pasta com os arquivos necessários aqui ou clique na área e selecione a pasta (o assistente escolhe a pasta, e não um arquivo individual). 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). Esta área aparece apenas após a seleção dos arquivos principais (ou no modo Apenas arquivos adicionais) e não é exibida para o tipo Arquivos e pastas locais.
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; o ícone "×" em um registro o remove do histórico) 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 caixa de seleçã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	As categorias do catálogo são coletadas dos valores da coluna.
Contém preço	A coluna é preço (usada com o tipo Float). A caixa de seleção está disponível para colunas dos tipos String, Integer e Float.
Contém moeda	A coluna é moeda. É exibida junto com a caixa de seleção Contém preço.
Inclui SKU	A coluna é artigo (SKU).
Chave única	O valor é identificador único do produto: em uma nova importação, produtos com valores correspondentes são atualizados, e não duplicados.
É ID de registro?	A coluna é o identificador do registro. Não é exibida para o tipo Arquivos e pastas locais.
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	caixa de seleçã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 indique a coluna pela qual buscar arquivos. No campo de modelo, por padrão, é inserida a expressão regular .*#attr#.*, onde #attr# é o valor da coluna selecionada; você pode substituí-la pela sua. O assistente encontrará imagens entre os arquivos adicionais com base nesse padrão.
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 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 mapeada para os status do produto com base em condições:

1. Marque O 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 caixa de seleçã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 caixa de seleção Coletar categorias… na Etapa 2. Se não houver tal coluna, para Excel está disponível a caixa de seleção Coletar categorias do arquivo — as categorias serão coletadas dos arquivos.

Para escolher a categoria raiz na qual o catálogo importado será colocado, marque a caixa de seleção Escolher categoria — abaixo dela aparecerá a escolha Escolher Pai. Clique em Avançar.

Etapa 4. Iniciar importação

1. Processar registros — número de registros processados; abaixo do campo é mostrado de quantos possíveis (o valor pode ser reduzido).
2. Carregar arquivos — a caixa de seleção apenas mostra se os arquivos (imagens) serão carregados junto com os dados; não pode ser alterada.
3. Salvar como modelo — salvar a configuração atual como um modelo; no campo que aparece Nome do modelo, defina um nome significativo (por exemplo, Importação de Excel do Catálogo Masculino), para reutilizá-lo mais tarde.
4. Clique em Iniciar importação e aguarde a conclusão.

Dependendo dos dados, na etapa aparecem caixas de seleção adicionais:

• Processar todos os conjuntos de dados — apenas para XML: todos os conjuntos de dados são processados, e não apenas o conjunto da tabela mestre. A caixa de seleção mostra o modo e não pode ser editada.
• Limpar nomes de grupos — apenas para XML: remove todos os nomes de grupos nos conjuntos de dados, definidos na Etapa 2. Disponível se os nomes de grupos forem definidos.
• Permitir upload de arquivos adicionais — aparece se Salvar como modelo estiver ativado e se as colunas de arquivos tiverem a busca por padrão de nomes configurada; permite carregar arquivos adicionais ao modelo (modo Apenas arquivos adicionais na Etapa 1).
• Reescrever Dados dos Arquivos — aparece se entre as colunas houver arquivos ou imagens; ao ativar, os valores dos atributos de arquivos são sobrescritos durante a importação.

Salvar modelos não está disponível se os dados estão sendo carregados do sistema de arquivos (Arquivos e pastas locais) ou se os conjuntos de dados foram movidos na Etapa 2 — em vez de caixas de seleção, é exibida a mensagem Salvar modelos está desativado porque você está carregando dados do sistema de arquivos ou moveu conjuntos de dados na etapa #2.

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 posteriormente — 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 defina 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).

Editando o 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 de seleção 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.