O caminho completo, do cadastro à loja
O caminho inteiro de um produto, do cadastro à loja, num só lugar.
- Quem faz
- VisualizadorMembroGestorAdministradorProprietário
- Onde
- Produtos · Ativos · Revisão de mídia · Aprovações · ficha do produto
- Antes de começar
- O Membro percorre quase todo o caminho sozinho. Os passos 4 e 7 pedem uma decisão de quem tem papel de Gestor ou acima.
Do cadastro até a loja da VTEX, um produto passa por oito passos, e cada um tem o seu ponto de bloqueio. Os capítulos 5 a 20 detalham cada passo; volte a eles quando algum travar.
Passo 1 de 8 · Cadastre ou importe
Um produto de cada vez, em Produtos › Novo produto. Ou muitos de uma vez, em Importação, por planilha (capítulo 7).
| A tela diz | O que fazer |
|---|---|
| "Criar um produto exige o papel de Membro. Peça a um Proprietário, Administrador ou Gestor, ou fale com o suporte." | peça o papel de Membro |
| "Já existe um produto com o SKU {código} neste site." | o código já está em uso |
Antes de seguir: confira se o produto aparece na lista.
Passo 2 de 8 · Atribua a família e complete os atributos
Abra a ficha do produto e atribua a família. É ela que define quais campos são obrigatórios (capítulos 6 e 8). Depois preencha os atributos.
A armadilha deste passo é ler uma nota alta como produto pronto. Sem família, nenhum campo é exigido, e a ficha avisa:
Este produto não tem família, então nenhum campo é exigido dele: a nota está vazia, não conquistada. Atribua uma família para a completude significar alguma coisa aqui.
O caso inverso também acontece. Com os atributos completos e sem foto, a ficha diz, com Imagem no lugar dos campos:
Todos os atributos obrigatórios estão preenchidos, mas este produto ainda não pode ser publicado. Falta: {campos}.
Antes de seguir: família atribuída e o quadro Completude do produto sem campo faltando.
Passo 3 de 8 · Envie a imagem e espere as versões por canal
Envie a foto pela ficha do produto (capítulo 18) ou pela biblioteca, em Ativos (capítulo 11). O sistema gera uma versão da foto para cada canal (capítulo 15). O envio aceita JPEG, PNG, WebP ou GIF, até 25 MB.
| A tela diz | O que fazer |
|---|---|
| "Versões por canal ainda sendo geradas" | espere; é normal logo após o envio |
| "O endereço respondeu, mas o conteúdo não é uma imagem. Confira se o link abre a foto, e não uma página." | use o endereço do arquivo da foto |
| "A imagem passa do limite de 25 MB. Envie uma versão menor." | reduza o arquivo |
| "Sem versões por canal, e nada vai gerá-las" | avise o suporte |
Antes de seguir: a foto aparece em Imagens do produto, com as versões por canal geradas.
Passo 4 de 8 · Aprove a imagem
Quando a sua conta exige aprovação de imagens, toda imagem nova entra como Pendente na fila Revisão de mídia, e substituir o arquivo de uma imagem também a devolve para Pendente. Quem tem papel de Gestor ou acima aprova ou rejeita; rejeitar exige um motivo (capítulo 16). Com a trava de publicação por aprovação ligada, imagem Pendente ou Rejeitada não vai para a galeria da VTEX, para os feeds dos canais nem para o endereço público, então nenhuma foto nova chega à loja antes de ser aprovada.
O Membro vê a fila e não decide:
Você vê a fila, mas não pode decidir. Peça a um proprietário ou administrador o papel de Gestor.
Aproveite para registrar a licença, a fonte e a validade da foto no cartão Direitos de uso (capítulo 17).
Antes de seguir: a imagem com o selo Aprovado no detalhe do ativo.
Passo 5 de 8 · Libere o canal
Na ficha do produto, no quadro Canais de distribuição, marque a loja de destino e clique em Salvar canais.
Escolha para quais canais este produto pode ir. Preço e estoque não entram aqui.

Este é o passo mais esquecido do caminho, e o mais barato de corrigir. Sem ele, o produto diz "este produto ainda não foi habilitado neste canal", e o botão de envio à VTEX fica sem loja para publicar.
Antes de seguir: a loja marcada na ficha.
Passo 6 de 8 · Defina a categoria de destino
No mesmo quadro, diga em que ponto da árvore de categorias daquela loja o produto entra. A categoria de destino vem do mapeamento da categoria do produto ou de uma escolha feita só para ele: Definir categoria abre a árvore da loja e grava o destino deste produto, sem mexer nos outros. Leia a frase da tela antes de agir, porque três causas parecidas pedem trabalhos diferentes:
| A tela diz | Onde se resolve | Custo |
|---|---|---|
| "este produto ainda não foi habilitado neste canal" | volte ao passo 5 | segundos |
| "esta categoria não tem destino nesta loja" | Definir categoria para este produto; para todos os produtos da categoria, peça o mapeamento ao suporte | minutos para um produto, horas para a categoria |
| "este produto ainda não tem categoria, então não há o que mapear" | Definir categoria para este produto, ou dê uma categoria a ele na ficha | minutos |
Antes de seguir: a categoria de destino preenchida para aquela loja.
Passo 7 de 8 · Envie para revisão e aprove o produto
Na ficha, clique em Enviar para revisão. Quem tem papel de Gestor ou acima decide na fila Aprovações (capítulo 9). Aprovar não depende da nota de completude; o que a completude trava é a publicação.
O Membro vê a fila e não decide:
Somente leitura
Você vê a fila de revisão, mas não pode decidir. Peça a um proprietário ou administrador o papel de Gestor.
Enquanto o produto não é aprovado, o envio à VTEX fica desligado, e uma linha logo abaixo do botão explica o motivo:
O produto precisa estar aprovado antes de enviar para a VTEX.
Ao lado do motivo, o atalho Ir para a aprovação leva ao quadro de status da ficha. Quando o que falta é um canal liberado, o atalho é Ir para os canais.
Antes de seguir: o status do produto em Aprovado.
Passo 8 de 8 · Publique
Na ficha, clique em Enviar para VTEX. Quando o produto está liberado para mais de uma loja, cada botão traz o nome da sua, como Publicar em {loja}. A tela confirma o pedido:
Publicação enfileirada para a VTEX.

Daqui sai o catálogo: produto, SKU, especificações, EAN e imagens aprovadas. Preço e estoque são definidos na própria VTEX pela equipe da loja, que também ativa o item. O capítulo 22 explica o selo ao lado do botão e por que um produto publicado ainda não está à venda.
| A tela diz | O que fazer |
|---|---|
| "A VTEX não tem id para {tipo} {código} neste canal. O produto está certo; falta mapear a taxonomia antes de publicar." | volte ao passo 6 |
| "O produto não está liberado para este canal de distribuição." | volte ao passo 5 |
| "Não foi possível publicar: {motivo}." | o motivo nomeia o que falta, como "falta a marca" ou "faltam as dimensões de embalagem"; corrija na ficha |
| "Esta publicação está bloqueada: as tentativas automáticas se esgotaram." | use Tentar de novo, ao lado do selo (capítulo 22) |