O cadastro de produtos na VTEX se organiza em quatro peças: o produto, ligado a uma categoria e a uma marca; os SKUs, que são as variações vendáveis; as especificações, definidas por categoria; e as imagens de cada SKU. Publicar sem retrabalho depende de deixar essas quatro peças prontas antes de o produto entrar na loja.
Na VTEX, o catálogo é o centro da loja: dele saem a vitrine, a busca, os filtros e os catálogos que vão para os marketplaces conectados. Quando o cadastro chega incompleto, o problema se espalha. O filtro de voltagem não funciona, a ficha técnica aparece pela metade, e o mesmo produto precisa ser arrumado de novo em cada canal que lê a loja.
Muitas equipes cadastram direto no painel administrativo, um produto por vez. Funciona enquanto o catálogo é pequeno. Com centenas de lançamentos por temporada, o painel vira gargalo, e a pressa produz exatamente o cadastro incompleto que depois custa caro.
Como a VTEX organiza o cadastro de produtos?
Vale ter clara a estrutura antes de preparar os dados:
- Produto. A ficha geral: nome, descrição, marca, categoria.
- SKU. Cada variação vendável do produto, com código, dimensões, peso, código de barras e imagens próprias.
- Especificações. Os atributos do produto e do SKU, definidos por categoria, que alimentam a ficha técnica e os filtros.
- Categoria. A árvore da loja, que decide quais especificações cada produto pode ter.
O detalhe da estrutura e dos campos está na documentação oficial da VTEX, na central de ajuda e no portal de desenvolvedores. O guia do catálogo da VTEX diz que todo produto se liga a uma categoria e a uma marca e tem pelo menos um SKU, e que todas as especificações precisam estar preenchidas para o item ficar ativo. A lógica geral é estável: quem prepara bem o SKU e as especificações antes da publicação evita a maior parte do retrabalho.
O que preparar antes
- A árvore de categorias decidida. Mudar a categoria de muitos produtos depois mexe em especificações e filtros. Vale fechar a árvore antes do lançamento.
- Especificações por categoria. Liste quais atributos cada categoria tem, com os valores aceitos. É daí que vêm os filtros que o cliente usa.
- SKU completo. Código, código de barras, dimensões e peso da embalagem. Peso e medida errados aparecem depois no cálculo de frete.
- Imagens por SKU. Cada cor ou variação com as próprias fotos, na ordem certa.
- Texto revisado. Nome e descrição no padrão da loja, sem o texto do fornecedor copiado.
O guia de SKUs da VTEX pede pelo menos uma imagem associada ao SKU e aceita o EAN como identificador alternativo. Para o código de barras, veja o post sobre GTIN e EAN no e-commerce; para as fotos, o de fotos de produto por canal.
Publicar sem atropelar o que já está na loja
Quem publica por integração precisa de um cuidado a mais: a loja não é uma folha em branco. Produtos já existem, alguém ajustou um campo pelo painel, um SKU foi desativado de propósito. Vale combinar antes qual sistema manda em cada campo, para que a integração e a equipe não gravem uma por cima da outra.
Outra prática que ajuda é ler o SKU na loja antes de gravar e conferir depois se a gravação ficou como deveria. Parece lento, mas evita o tipo de erro que só aparece quando o cliente reclama.
Como o AdCore Turbo publica na VTEX
O AdCore Turbo publica o cadastro no catálogo da loja VTEX. Antes de gravar, ele lê o SKU na loja, e depois relê o que gravou para conferir. O cadastro em si fica no PIM, com atributos por família, aprovação com registro de quem aprovou e histórico de versões, e as fotos ficam ligadas ao SKU no DAM.
Para quem já tem o catálogo na VTEX, a entrada desse catálogo no AdCore Turbo é montada junto com a nossa equipe, por webhook de SKU, CSV, Google Sheets ou API, conforme o caso. Os detalhes da integração estão na página da VTEX. O que se busca é parar de cadastrar produto à mão no painel e chegar à loja com o cadastro já completo. Antes de publicar, vale ler também sobre atributos de produto.