O processo de indexação permite que dados de um produto, tais como informações de catálogo, preço e estoque, sejam reunidos e organizados para serem exibidos aos clientes na busca e na prateleira da loja.

Sempre que um produto tem mudança de status ou alteração de informações, é iniciado um fluxo de reindexação. Confira a seguir alguns exemplos onde a reindexação ocorre:

• Modificação de dados de cadastro
• Ativação ou desativação de produto
• Criação ou remoção de coleção
• Mudança de preço ou na quantidade de estoque

Para mais detalhes sobre a indexação de um produto em lojas legado, acesse Como funciona a indexação - CMS Portal Legado. Se a sua loja utiliza o Intelligent Search, verifique o Histórico da indexação - Intelligent Search.

Em determinadas situações, a indexação é interrompida durante o processo e as informações mais atualizadas do produto não são exibidas no site da loja. Veja abaixo alguns cenários em que esta interrupção pode acontecer:

• Cadastro incorreto do produto no Catálogo

• Ausência da política comercial associada ao produto no binding da loja

• Tempo limite de indexação (40 segundos) é excedido quando ocorrem um grande - número de requisições de informações ao checkout durante a indexação. O número de requisições pode variar conforme os seguintes fatores associados ao produto:

  • Quantidade de políticas comerciais
  • Quantidade de SKUS
  • Quantidade de regiões geográficas
  • Quantidade de coleções
  • Quantidade de sellers

Para corrigir problemas que estejam impedindo um produto de ser corretamente indexado na loja, considere realizar as seguintes ações:

• Verificar campos de cadastro do produto
• Verificar informações de binding da conta
• Reduzir políticas comerciais associadas ao produto
• Modificar quantidade de SKUs por produto
• Remover SKU de coleções
• Reindexar a base de produtos da loja

Erros no cadastro de um produto podem gerar inconsistências no momento de realizar a indexação de um produto.

1. No Admin VTEX, acesse Catálogo > Todos os produtos.

   Lojas que utilizam a página Produtos e SKUS (Beta) devem verificar os campos de cadastro do produto acessando Catálogo > Produtos e SKUS no Admin VTEX. Saiba mais em Produtos e SKUS (Beta).

2. Localize o produto desejado e clique em EDITAR.

3. Verifique se as informações de todos os campos de cadastro estão corretas. Se necessário, atualize as informações e clique em Salvar.

4. Acesse o relatório de indexação em Catálogo > Relatórios e verifique se o produto está na fila de indexação ou já foi indexado.

Quando a conta possui mais de uma loja, é necessário realizar o processo de binding, que consiste em vincular o website e as políticas comerciais aplicáveis a cada uma das lojas. Se um produto estiver relacionado a uma política comercial que não está presente no binding da conta, podem ocorrer erros de indexação.

Para identificar as políticas comerciais associadas a cada uma das lojas de sua conta, acesse Vincular uma loja a uma estrutura de pastas do CMS (binding).

Quando um produto possui diversas políticas associadas a ele, as diversas iterações de verificação de dados podem ocasionar a saída da fila de indexação por atingir o tempo limite de espera.

Exemplo: se um produto possui 5 SKUs ativos em 5 políticas comerciais diferentes, serão necessárias 25 validações de disponibilidade de estoque, regras de preço e promoções.

Para evitar este cenário, verifique a possibilidade de utilizar uma mesma política comercial para marketplaces diferentes, como descrito em Configurar política comercial para marketplace.

Caso seja possível reduzir o número de políticas comerciais em sua loja, acesse novamente o cadastro do produto para modificar a política comercial e verificar o relatório de indexação, como descrito na seção Verificação dos campos de cadastro do produto.

Da mesma forma que as políticas comerciais, ter muitos SKUs associados a um produto pode levar a exceder o tempo limite de espera para indexação. Para reduzir a probabilidade de ocorrência deste erro, considere a possibilidade de dividir um produto em outros produtos com menor quantidade de SKUs.

Exemplo: se o produto “Camisa” possui seis SKUs (Amarela P, Amarela M, Amarela G, Azul P, Azul M e Azul G), ele pode ser dividido em dois produtos com três SKUs cada: “Camisa Amarela” (P, M e G) e “Camisa Azul” (P, M e G).

Após reorganizar a quantidade de SKUs por produto, verifique o relatório de indexação, como descrito na seção Verificação dos campos de cadastro do produto.

Existem duas formas de remover o SKU de uma coleção: por meio do Portal CMS Legado ou utilizando o módulo Coleções (Beta). Esta seção demonstra como remover o SKU de uma coleção no Portal CMS Legado. Para mais informações sobre o procedimento no módulo Coleções (Beta), acesse Remoção de produtos.

Caso algum dos SKUs do produto faça parte de uma coleção, também é possível que ocorra o tempo limite de espera para indexação. Para verificar se o SKU faz parte de uma ou mais coleções, siga os passos abaixo:

1. No Admin VTEX, acesse Storefront > Layout.
2. Clique na pasta CMS e em Product Cluster (Collections).
3. Clique na primeira coleção da lista.
4. Na parte inferior da coluna Other options, verifique se o SKU está disponível na lista. Caso esteja presente e não exista nenhum impedimento de removê-lo da coleção, clique sobre o botão de remoção localizado na frente do SKU.
5. Repita o passo 4 para o mesmo SKU em todas as coleções dentro de Product Cluster (Collections).
6. Acesse o relatório de indexação em Catálogo > Relatórios e verifique se o produto está na fila de indexação ou já foi indexado.

A reindexação completa da base de produtos pode ser realizada para atualizar as informações de todos os produtos na loja ao mesmo tempo.

Para lojas com menos de 100 mil produtos cadastrados no catálogo, o usuário titular da conta pode utilizar a função Agendar reindexação completa no Admin VTEX.

Contas com 100 mil produtos ou mais cadastrados devem entrar em contato com o Suporte da VTEX para realizar este tipo de operação.

Saiba mais em Manutenção de base (full cleanup).