Para que um produto fique visível e disponível para a venda em uma loja VTEX, ele precisa cumprir uma série de requisitos obrigatórios, considerados mínimos para que um pedido possa ser feito. O objetivo deste tópico é compartilhar algumas informações que podem ser validadas e passos que podem ser tomados para garantir que o seu produto fique disponível como desejado.
Além do tutorial abaixo, temos um equivalente em formato de vídeo disponibilizado aqui na Community e que pode ser encontrado aqui.
1- Configurações de Produto
O primeiro passo para que um produto fique disponível é que ele esteja Ativo e que todos os campos obrigatórios estejam preenchidos, tanto a nível de produto quanto a nível de SKU. Portanto, o primeiro passo é validar todos os campos do produto e SKU conforme nosso tutorial de Cadastro de produto. Além disso, especial atenção deve ser dada às Especificações, já que muitas vezes uma especificação é configurada como obrigatória e, portanto, precisa ser preenchida para que o produto fique ativo.
Também é importante validar que a categoria e a marca do produto em questão estejam ativas, já que esta é outra informação obrigatória para o funcionamento do produto/SKU.
2- Estoque
Se o produto em questão (e seus SKUs) estão ativos e cadastrados apropriadamente, o próximo passo é validar que o produto tem inventário cadastrado dentro do módulo de logística. Isso pode ser feito abrindo a sessão de Gerenciamento de inventário no Admin ou, dentro do próprio catálogo, verificando as informações de indexação conforme abaixo:
Neste exemplo, podemos ver o alerta de que o produto está indisponível (UNAVAILABLE) e especificamente sem estoque (withoutStock):
Então, se adicionarmos estoque a ele na sessão de Inventário…
O log de indexação demonstrará tal mudança:
É importante destacar que não basta que um produto tenha estoque, ele precisa ser entregável. Isto é, ele precisa estar disponível em um inventário que esteja propriamente associado a uma Doca e uma Estratégia de Envio, conforme nosso tutorial de Logística. Para verificar que um produto seja entregável, recomendamos o uso do Simulador de Envio disponível no Admin.
3- Preço
Estando configurados os dados de produto/SKU e seu estoque, o próximo passo é validar que o produto em questão tem um preço definido na Tabela de Preços da loja, conforme nosso tutorial.
Além disso, para produtos que sejam vendidos por sellers, é importante que o preço esteja configurado no seller ou que a configurações de preço estejam definidas de forma válida. As configurações de preço podem ser encontradas dentro da sessão de Configurações de Loja no Admin:
A configuração Herdar preços da conta pai é disponível apenas para sellers, e faz com que o preço definido na conta marketplace seja o que será exibido no front. Enquanto isso a configuração sobrescrever preços dos sellers tem o mesmo efeito, mas é feita pelo próprio marketplace.
4- Customizações
Se, mesmo com todos os passos acima, o produto ainda não estiver visível, é possível que o problema seja causado por uma customização que está causando problemas na renderização da página de produto. Neste caso, podemos validar o comportamento do produto de duas formas:
- Bloqueio de customizações (Lojas CMS Legado)
Para lojas que utilizam CMS Legado, uma forma de contornar customizações é com o uso de Bloqueios de solicitação de rede, uma funcionalidade que permite que os elementos de front-end sejam bloqueados pelo próprio navegador. Se o produto fica visível enquanto as customizações estiverem bloqueadas, a recomendação é engajar sua agência para que validem o template da página de produto.
- Abrir a página com uma interface legado (VTEX IO)
Para lojas que utilizam VTEX IO, é possível abrir a página de produto dentro da interface de CMS Legado, seguindo a estrutura desta URL: https://{{accountname}}.vtexcommercestable.com.br/{{productUrl}}/p
Isso permitirá ver os elementos básicos da página de produto com a UI padrão da VTEX. Se ele ficar visível conforme abaixo, o problema pode ser com o tema de sua loja e também recomendamos engajar sua agência.
- Testar produto no Checkout via Cartman
Outra forma de testar o funcionamento de um produto num cenário sem customizações é pela ferramenta Cartman, disponível no checkout de toda loja VTEX dentro do ambiente myvtex (https://{{accountname}}.myvtex.com/checkout) e que pode ser utilizada no Checkout clicando no botão azul no canto inferior direito:
Dentro dele, podemos utilizar a função “Adicionar SKU pelo ID” para forçar a inclusão do produto desejado ao carrinho:
Se o produto for adicionado com sucesso e estiver disponível para compra, conforme abaixo, recomendamos validar a página de produto com sua agência:
5- Cache e Indexação
Se todos os passos anteriores foram verificados e mesmo assim o produto não está visível (e está indisponível quando adicionado ao carrinho via Cartman) uma última possibilidade é que ele ainda esteja sendo indexado ou que a página em seu navegador esteja carregando com cache.
A indexação é um processo normal de diversos módulos VTEX, no qual novas informações são enviadas e salvas em diferentes módulos e bases de dados para o pleno funcionamento da loja. Como este processo envolve múltiplos passos e consultas, é normal que alterações levem alguns minutos para refletirem no front-end e, portanto, recomendamos uma espera após a criação e/ou atualização de qualquer produto. Veja aqui nosso tutorial de Como funciona a indexação.
O cache, por outro lado, é uma ferramenta fundamental para ganho de performance não apenas na VTEX, mas em grande parte das ferramentas, plataformas e destinos dentro da internet. O cache é, em resumo, uma versão anterior de uma página e/ou dado que fica salva dentro do navegador e que permite que uma página carregue mais rápido após a primeira visita. Porém, por sua própria natureza como uma versão anterior, o cache pode fazer com que atualizações demorem um pouco mais ficarem visíveis. Para garantir que o cache não esteja afetando sua navegação, recomendamos o tutorial oficial do Google sobre limpeza de cache. Veja aqui nosso tutorial de Como funciona o cache.
Se mesmo após todas as validações (e apenas após elas) o produto ainda não esteja visível, finalmente recomendamos a abertura de um ticket conosco, para que possamos validar possíveis problemas na criação e exibição de produtos.
Eduardo Luciano
Field Software Engineer | VTEX