Buskara
Centro de ayuda

Cómo se indexa el catálogo

Los motores por tienda, idioma y moneda, lo que entra en cada documento, y las tres vías por las que el índice se mantiene al día.

4 min Actualizado el 9 agosto 2026

La búsqueda no corre sobre la base de datos de la tienda. Corre sobre un índice nuestro, que es una copia del catálogo preparada para responder en milisegundos. Esta guía va sobre cómo se hace esa copia y cómo se mantiene fiel.

Un motor por tienda, idioma y moneda

En el handshake, el módulo nos dice qué tiendas tiene, en qué idiomas y con qué monedas. Para cada combinación nace un motor de búsqueda, y eso es lo que ve en Búsqueda → Motores de búsqueda: la tienda a la que pertenece, lo que indexa, el idioma y la moneda, cuántos documentos tiene y cuándo fue la última indexación.

La separación no es un detalle de orden. El nombre de un producto en francés y en español son textos distintos, y una búsqueda por "chaussures" no debe encontrar resultados por el texto español. Los precios siguen la misma lógica: cada motor guarda los de su moneda.

Una tienda multiidioma tiene, por tanto, más de un motor, y casi todo lo que se configura por motor (pesos, sinónimos, filtros) se configura una vez por cada uno.

Lo que entra en un documento

De cada producto guardamos lo que sirve para encontrarlo y para mostrarlo: referencia, EAN y MPN, nombre, marca, categorías, características y atributos, descripciones, precio, imagen, estado de stock y la URL en la tienda.

Tres opciones del módulo cambian lo que llega ahí:

  • Precios con IVA: decide si el precio indexado es con o sin impuesto. Tiene que ser igual al que muestra la tienda, o los resultados dicen un número y la ficha dice otro.
  • Tamaño de imagen: cuál de las imágenes de PrestaShop viaja al índice. La de las tarjetas de la búsqueda, no la de detalle.
  • Productos sin stock: indexarlos igualmente, bajarlos en los resultados, u ocultarlos.

Y tres señales opcionales, que la tienda comparte si quiere, y que no sirven para buscar sino para ordenar y medir: el volumen de ventas (alimenta la ordenación "más vendidos" y la detección de best-sellers invisibles), el precio de coste (da márgenes en la analítica) y los pedidos (conectan la búsqueda con los ingresos).

Atención Activar o desactivar el compartir de ventas o de coste pide una reindexación completa para que el índice refleje el cambio. El módulo avisa cuando eso ocurre.

Las tres vías por las que se mantiene al día

Después de la primera indexación completa, el día a día se resuelve solo:

  1. Tiempo real. Guardar, eliminar o cambiar el stock de un producto empuja el cambio al momento. Por aquí pasa la abrumadora mayoría de las actualizaciones, y es lo que hace que el precio y el stock en la búsqueda sean los mismos que en la tienda.
  2. Sincronización periódica. En ciclos regulares, la plataforma le pide a la tienda que revise el catálogo, y esto es lo que recoge lo que el tiempo real no vio (una importación por CSV, un cambio hecho directo en la base de datos). Para que funcione, la dirección https://tu-tienda/module/buskara/sync tiene que estar accesible desde fuera.
  3. Manual. El botón Reindexar todo del módulo, o el comando de línea. Ver reindexar el catálogo.

Cuándo desconfiar de la vía 2 Los cortafuegos, la autenticación básica en entornos de preproducción y las reglas de "solo mi IP" bloquean la sincronización periódica sin dar un error visible en el back-office. El síntoma es que el índice se pasa días sin moverse mientras el tiempo real va funcionando.

Lo que cuesta la indexación

Nada al plan. Indexar cuenta de forma simbólica (10 peticiones por cada 10.000 ítems indexados) y nunca se cobra: no roza el límite ni genera excedente. Mantener el catálogo al día no debe ser una decisión de presupuesto.

Lo que aparece en el gráfico de uso es esa cuenta simbólica, y está ahí por transparencia, para que se vea lo que ha estado haciendo el índice. Ver qué cuenta como petición.

Un segundo motor, para el contenido

El blog y las páginas de la tienda se pueden indexar aparte, en un motor propio, y aparecer en los resultados sin robarle el sitio a los productos. Es opcional y se activa en el módulo; está explicado en artículos y contenido de la tienda.

¿Le ha resultado útil esta guía?

No, sigo con dudas