Criar produtos e importar planilhas
Criar um produto pelo formulário ou muitos de uma vez por planilha.
- Quem faz
- VisualizadorMembroGestorAdministradorProprietário
- Onde
- Produtos → Novo produto e Catálogo → Importação
- Antes de começar
- Tenha à mão o SKU de cada produto. Para a importação, comece baixando a planilha da própria tela.
Um produto entra no catálogo por dois caminhos: um de cada vez, pelo formulário, ou muitos de uma vez, por planilha. Os dados que chegam da Visto têm regra própria na importação, descrita no passo 1.
Criar um produto
Passo 1 de 2 · Abra o formulário
Na lista de produtos, clique em Novo produto. O formulário cria o produto e a variante padrão:
Cria o produto e a variante padrão. O resto do cadastro é na ficha, logo depois.
Quem tem papel de Visualizador encontra uma recusa no lugar do formulário:
Sem permissão para criar produtos
Criar um produto exige o papel de Membro. Peça a um Proprietário, Administrador ou Gestor, ou fale com o suporte.
Passo 2 de 2 · Preencha e crie
Preencha SKU e Nome. Escolha o SKU com cuidado, porque ele não muda depois:
Identificador imutável. É por ele que a importação por planilha reconhece o produto depois.
A Família (opcional) pode ficar para depois, mas é melhor escolhê-la agora. É ela que decide o que conta como completo:
A família define quais atributos são obrigatórios. Sem ela, nada é exigido e a completude não tem contra o que medir.
Clique em Criar produto. A tela confirma com "Produto criado." e abre a ficha do novo produto, onde você continua o cadastro (capítulo 5). Se algo der errado, a tela diz:
| A tela diz | O que fazer |
|---|---|
| Já existe um produto com o SKU {SKU} neste site. | o SKU está em uso; procure o produto na lista |
| Não foi possível criar o produto. | tente de novo |
Importar uma planilha
Passo 1 de 3 · Baixe a planilha
Abra Importação no menu. No alto da tela Importação em massa, clique em Baixar planilha. Ela vem com uma coluna por atributo e com os dados que já estão no catálogo, e a tela explica o que entra nela:
A planilha traz uma coluna por atributo deste site, exceto preço e estoque, que vêm da VTEX. Colunas marcadas com "(leitura)" são só para consulta e não voltam na importação. Reenviar esta planilha com a marca intacta é a única forma de corrigir um valor que a Visto fornece.
Logo abaixo, a tela avisa o que uma planilha comum não consegue fazer:
Valores fornecidos pela Visto não são sobrescritos pela planilha. Um upload comum grava como "importação por arquivo", que perde para a Visto no mesmo atributo. Para corrigir um valor que a Visto fornece, use a planilha exportada acima e reenvie-a com a marca de origem intacta.
Para corrigir um dado da Visto, use a planilha baixada desta tela. Uma planilha montada do zero é gravada e contada como importada, mas a ficha continua mostrando o valor da Visto naquele atributo. Edite a planilha baixada e reenvie sem apagar a marca de origem.
Passo 2 de 3 · Edite e envie
Edite os valores na planilha e salve em CSV. O arquivo aceita até 200 MB e 500.000 linhas; a coluna "sku" identifica o produto, e cada outra coluna vai para o atributo de mesmo nome. Em Arquivo do catálogo, escolha o arquivo e clique em Enfileirar importação.
A tela confirma quantas linhas entraram na fila:
Importação enfileirada: {número} linha(s). Acompanhe o status abaixo.
Se uma coluna não corresponder a nenhum atributo, a importação segue sem ela e a tela avisa quais colunas ficaram de fora.
Quem tem papel de Visualizador vê o envio desligado, com esta frase:
Você precisa da permissão Catálogo · Editar para importar produtos.
Passo 3 de 3 · Acompanhe a execução
A importação é feita em segundo plano. A tabela Execuções recentes mostra cada envio com o status, as contagens (Importados, Atualizados, Linhas com falha, Total) e o horário de início, e se atualiza sozinha enquanto alguma execução está em andamento. As leituras pedidas pelo botão Trazer da Visto agora (capítulo 5) aparecem na mesma tabela.
| Status | O que significa |
|---|---|
| Na fila | aguardando a vez |
| Executando | em processamento |
| Concluída sem erro | terminou, e nenhuma linha ou célula ficou com erro |
| Concluída com erro | terminou, mas alguma linha falhou ou alguma célula não foi gravada |
| Falhou | a execução parou com falha; se ela chegou a gravar linhas antes disso, a tela diz quantas, como "{n} antes da falha" |
| Cancelada | foi interrompida |
Quando uma execução para antes do fim do arquivo, a coluna Total mostra também quantas linhas não foram processadas.
Clique em Ver erros para abrir o relatório da execução. Ele lista cada erro com linha, coluna, código, mensagem e valor.
O total de erros e a coluna Linhas com falha contam coisas diferentes, e a tela explica por quê:
Nem todo erro registrado reprova uma linha: a lista abaixo inclui avisos de célula e registros que não pertencem a nenhuma linha da planilha (o encerramento automático de uma execução travada, ou a causa de uma importação parcial, por exemplo). Por isso esta contagem pode não bater com a coluna “Linhas com falha”, que conta só as linhas que o importador não conseguiu gravar.
Erros que não pertencem a nenhuma linha da planilha aparecem marcados como sem linha. Corrija as linhas indicadas na planilha e reenvie só elas, ou a planilha inteira.