Menú
Feedback
Comienza aquí

Resolución de problemas

Resolución de problemas
No logro indexar un producto del catálogo
Publicado el6/9/2024
Última actualización el14/8/2025
6 min de lectura

El proceso de indexación permite reunir y organizar los datos de un producto, tales como información de catálogo, precio y stock, para mostrarlos a los clientes en la búsqueda y en la estantería de productos de la tienda.

Cualquier cambio de status o modificación de información de un producto inicia un flujo de reindexación. A continuación se mencionan algunos ejemplos que activan la reindexación:

  • Modificación de datos de registro
  • Activación o desactivación del producto
  • Creación o remoción del producto de una colección
  • Modificación del precio o cantidad de stock

Para más información sobre la indexación de un producto en tiendas de CMS - Portal legado, consulta Cómo funciona la indexación (CMS - Portal Legado). Si tu tienda utiliza Intelligent Search, verifica el Historial de indexación (Intelligent Search).

En ciertas situaciones, la indexación es interrumpida y no se muestra la información más actualizada del producto en la tienda. A continuación se mencionan algunos escenarios en los que se produce la interrupción:

  • Registro incorrecto del producto en el catálogo

  • Falta de una política comercial asociada al producto en el binding de la tienda

  • Tiempo límite de indexación (40 segundos) alcanzado cuando el checkout recibe muchos requests de información durante la indexación. La cantidad de requests puede variar dependiendo de los siguientes factores asociados al producto:

    • Cantidad de políticas comerciales
    • Cantidad de SKUs
    • Cantidad de regiones geográficas
    • Cantidad de colecciones
    • Cantidad de sellers

Soluciones

Para corregir los problemas que impiden indexar correctamente un producto en la tienda, considera probar las siguientes acciones:

Verificar los campos de registro del producto

Los errores en el registro de un producto pueden generar inconsistencias al reindexarlo.

  1. En el Admin VTEX, accede a Catálogo > Todos los productos.

    Las tiendas que utilizan la página Produtos y SKUS (Beta) deben verificar los campos de registro de productos accediendo a Catálogo > Produtos y SKUS en el Admin VTEX. Más información en Produtos y SKUS (Beta).

  2. Ubica el producto que deseas y haz clic en Modificar.

  3. Comprueba que la información de todos los campos de cadastro esté correcta. De ser necesario, actualiza la información y haz clic en Guardar.

  4. Accede al informe de indexación en Catálogo > Informes y comprueba que el producto esté en la cola de indexación o que ya haya sido indexado.

Verificar la información de binding de la cuenta

Cuando la cuenta tiene más de una tienda, se debe realizar un proceso de binding para vincular el sitio web y las políticas comerciales aplicables a cada tienda. Si un producto está relacionado a una política comercial que no es parte del binding de la cuenta, pueden producirse errores de indexación.

Para identificar las políticas comerciales asociadas a cada tienda de tu cuenta, consulta Vincular una tienda a una estructura de carpetas en CMS (binding).

Reducir las políticas comerciales asociadas al producto

Cuando un producto tiene varias políticas comerciales asociadas, las iteraciones de verificación de datos pueden producir la exclusión del producto de la cola de indexación por agotar el tiempo límite de espera.

Ejemplo: si un producto tiene 5 SKUs activos en 5 políticas comerciales diferentes, deben realizarse 25 validaciones de disponibilidad de stock, reglas de precios y promociones.

Para evitar este escenario, verifica si existe la posibilidad de utilizar una misma política comercial para distintos marketplaces, según se describe en Configurar política comercial para marketplace.

Si es posible reducir el número de políticas comerciales de tu tienda, vuelve a acceder al registro del producto para cambiar la política comercial y verifica el informe de indexación, según se describe en Verificar los campos de registro del producto.

Modificar la cantidad de SKUs por producto

Al igual que las políticas comerciales, tener muchos SKUs asociados a un producto puede hacer que se agote el tiempo límite de espera de la indexación. Para reducir la probabilidad de que se produzca este error, considera dividir un productos en varios productos con menor cantidad de SKUs.

Ejemplo: si el producto "Camisa" tiene seis SKUs (Amarillo P, Amarillo M, Amarillo G, Azul P, Azul M y Azul G), lo puedes dividir en dos productos con tres SKUs cada uno: "Camisa amarilla" (P, M y G) y "Camisa azul" (P, M y G).

Después de reorganizar la cantidad de SKUs por productos, verifica el informe de indexación, según se describe en la sección Verificar los campos de registro del producto.

Remover SKUs de colecciones

Hay dos maneras de remover un SKU de una colección: a través de CMS - Portal Legado o en el módulo Colecciones (Beta). Esta sección describe cómo remover un SKU de una colección mediante CMS - Portal Legado. Para más información sobre el procedimiento en el módulo Colecciones (beta), consulta Eliminación de productos.

Si alguno de los SKUs del producto forma parte de una colección, también puede agotarse el tiempo límite de espera de la indexación. Para comprobar si el SKU forma parte de una o más colecciones, sigue los pasos a continuación:

  1. En el Admin VTEX, accede a Storefront > Layout.
  2. Haz clic en la carpeta CMS y en Product Cluster (Collections).
  3. Haz clic en la primera colección de la lista.
  4. En la parte inferior de la columna Other options, comprueba si el SKU está disponible en la lista. Si está presente y no hay ningún obstáculo para removerlo de la colección, haz clic en el botón de remover (junto al SKU).
  5. Repite el paso 4 para el mismo SKU en todas las colecciones de Product Cluster (Collections).
  6. Accede al informe de indexación en Catálogo > Informes y comprueba que el producto esté en la cola de indexación o que ya haya sido indexado.

Reindexar la base de productos de la tienda

Se puede realizar una reindexación completa de la base de productos para actualizar la información de todos los productos de la tienda al mismo tiempo.

En las tiendas que tienen menos de 100 mil productos registrados en el catálogo, el usuario titular de la cuenta puede utilizar la función Programar reindexación completa en el Admin VTEX.

Las cuentas que tienen 100 mil productos o más registrados deben ponerse en contacto con el soporte VTEX para realizar esta operación.

Más información en Mantenimiento de base de datos (full cleanup).

{"base64":"  ","img":{"width":1279,"height":112,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":11952,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/es/troubleshooting/operaciones-de-la-tienda/no-logro-indexar-un-producto-del-catalogo_1.png"}}

Contribuidores
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
¿Te ha parecido útil?
No
Sugerir cambios (GitHub)
Contribuidores
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
En esta página
¿Tienes otras preguntas?
Pregunta a la comunidad
Encuentra soluciones y comparte ideas en VTEX Community
Únete a nuestra comunidad
Solicita soporte a VTEX
Recibe asistencia personalizada de nuestros especialistas
Abre un ticket de soporte
GitHubDeveloper PortalComunidadFeedback