Compra en Grupo y Precio Escalonado Colectivo — Guía completa
Instalar, configurar y explotar la compra en grupo: precio escalonado colectivo, modos de recuento, reembolso retroactivo, precio por cantidad y widget en tiempo real para PrestaShop 8 y 9.
Presentación y requisitos
Compra en Grupo introduce un precio escalonado colectivo: cuantos más compradores tiene un producto, más baja el precio unitario para todos. Usted define escalones (un umbral de compradores desbloquea un precio) y el módulo aplica automáticamente el precio del escalón alcanzado mediante los precios específicos nativos de PrestaShop. La tarifa vigente se muestra así en todas partes sin ninguna modificación de su tema: ficha de producto, listados, carrito y correos.
- Compatible con PrestaShop 8.0 a 9.x, tema Classic y temas derivados.
- PHP 7.4 a 8.3.
- Multitienda y multilingüe (FR/EN/ES/DE/IT).
- Ninguna tarea CRON requerida: el recálculo se basa en los eventos de pedido.
- Arquitectura conforme a PrestaShop (ModuleAdminController, ObjectModel), sin dependencia de Composer.
El precio vigente se inscribe en un precio específico ligado a las fechas de la campaña. Por lo tanto se aplica de forma nativa en toda la visualización, sin sobrecarga de plantilla.
Instalación
Instale el módulo como cualquier módulo de PrestaShop:
- Descargue el archivo
dfgroupbuy-1.0.2.zipdesde su cuenta de cliente. - En el back-office, vaya a Módulos > Gestor de módulos.
- Haga clic en Subir un módulo y suelte el archivo.
- Una vez instalado, haga clic en Configurar.
Al instalarse, el módulo crea sus tablas (campañas, escalones, participantes), registra sus hooks y añade la pestaña Compra en Grupo en Catálogo. Puede crear su primera campaña de inmediato.
Ajustes generales del módulo
La página de configuración reúne los ajustes globales, comunes a todas las campañas:
- Color principal y color de acento: aplicados al widget de la ficha de producto (barra de progreso, insignias, precio vigente).
- Enviar un correo al producirse un reembolso retroactivo: notifica al comprador cuando se le concede un vale.
- Periodo de validez de los vales: número de días de validez de los vales retroactivos (30 por defecto).
- Intervalo de actualización: frecuencia de actualización en directo del widget, en segundos (30 por defecto).
Crear una campaña de compra en grupo
Desde la pestaña Catálogo > Compra en Grupo, haga clic en Añadir una campaña. Una campaña asocia un producto a una rejilla de escalones, sobre una ventana de fechas.
- Referencia: identificador interno de la campaña (texto libre).
- Producto: busque y seleccione el producto en cuestión. Puede dirigirse a una combinación concreta o dejar «todas las combinaciones».
- Nombre y descripción: textos traducibles, mostrados en el widget.
- Modo de recuento: véase la sección dedicada más abajo.
- Solo pedidos válidos: cuenta únicamente los pedidos confirmados (recomendado).
- Precio de referencia: el precio inicial (tachado) antes de cualquier escalón.
- Fecha de inicio / fin: la ventana de actividad de la campaña.
- Reembolso retroactivo: véase la sección dedicada.
- Activa: activa o suspende la campaña.
Definir los escalones
Cada escalón asocia un umbral (número de compradores, unidades o clientes según el modo) a un precio unitario sin IVA. Añada tantos escalones como necesite, por ejemplo:
10 compradores → 18,00 € sin IVA
50 compradores → 15,00 € sin IVA
100 compradores → 12,00 € sin IVAEn cada guardado, el módulo recalcula el escalón vigente y actualiza el precio específico. Los precios deben ser decrecientes a medida que aumenta el umbral.
El precio de referencia y los precios de escalón se introducen sin impuestos. La conversión a con impuestos para la visualización sigue las reglas fiscales del producto.
Los modos de recuento
El modo de recuento determina qué hace avanzar el contador colectivo:
- Pedidos: número de pedidos distintos que contienen el producto.
- Unidades vendidas: cantidad total de unidades del producto vendidas.
- Clientes distintos: número de clientes diferentes que han comprado el producto.
La opción Solo pedidos válidos restringe el recuento a los pedidos considerados válidos por PrestaShop (pago aceptado, etc.), lo que evita contar pedidos cancelados o pendientes.
El precio colectivo en tiempo real
En cuanto un pedido se valida o cambia de estado, el módulo recuenta la campaña, determina el escalón alcanzado y actualiza el precio específico aplicado a todos los compradores. El nuevo precio se muestra de inmediato en todas partes, sin intervención. No se requiere ningún CRON: todo se basa en los eventos de pedido.
Si un pedido pasa a un estado cancelado o reembolsado y usted cuenta solo los pedidos válidos, el contador se recalcula a la baja y el precio puede volver a subir si ya no se alcanza el escalón.
Precio por escalón de cantidad (compra al por mayor)
En modo Unidades vendidas, un cliente que pide una gran cantidad de una vez supera un escalón por sí solo: obtiene entonces de inmediato el precio de ese escalón en su propio pedido, sin esperar a que el colectivo lo alcance. Por ejemplo, con un escalón a 10 unidades, un cliente que añade 10 a su carrito paga de inmediato el precio del escalón 10.
Esta lógica sigue siendo «mejor precio para todos»: si el precio colectivo vigente ya es más bajo que el precio del escalón de cantidad, se aplica el precio colectivo. Todo pasa por los precios específicos nativos (por escalones de cantidad), por lo que la tarifa correcta se muestra desde el carrito.
Este mecanismo solo se activa en modo Unidades vendidas, donde los umbrales representan unidades. En modo Pedidos o Clientes, una compra al por mayor sigue siendo un solo pedido o un solo cliente.
Reembolso retroactivo
Cuando la opción está activada, se aplica el principio «todos al mejor precio»: en cuanto se desbloquea un escalón inferior, los compradores anteriores reciben automáticamente un vale de descuento igual a la diferencia entre el precio que pagaron y el nuevo precio, multiplicada por la cantidad comprada. Se envía un correo de notificación si la opción de envío está activa.
- El vale es un código de descuento (CartRule) nominativo, válido durante el número de días configurado.
- Solo los compradores que pagaron más que el nuevo precio reciben un vale.
- El precio efectivo de cada participante se actualiza para evitar cualquier doble reembolso en las bajadas posteriores.
El reembolso retroactivo crea vales de descuento reales. Verifique su rejilla de escalones antes de activar una campaña de gran volumen para controlar el importe total de los reembolsos.
El widget en la ficha de producto
En la ficha de producto, el módulo muestra un widget que escenifica la dinámica colectiva:
- Una insignia y el precio de referencia tachado frente al precio vigente.
- El contador colectivo y una barra de progreso hacia el siguiente escalón.
- La escala completa de escalones, con el escalón vigente destacado.
- Una cuenta atrás hasta el fin de la campaña.
- Una nota sobre el reembolso retroactivo cuando la opción está activa.
Todo se actualiza en directo por AJAX, en el intervalo definido en los ajustes, sin recargar la página.
FAQ y resolución de problemas
El widget no se muestra en el producto
Compruebe que una campaña activa se dirige a este producto, que la fecha de hoy está comprendida entre la fecha de inicio y la de fin, y que la campaña pertenece a la tienda actual. Si se dirige a una combinación concreta, el widget solo aparece para esa combinación.
El precio no baja aunque se alcanza el umbral
El recálculo se activa con la validación de pedidos y los cambios de estado. Si cuenta solo los pedidos válidos, asegúrese de que los pedidos correspondientes están en un estado válido. Una simple edición y guardado de la campaña también fuerza un recálculo.
Un comprador al por mayor no obtiene el precio de su cantidad
El precio por escalón de cantidad solo funciona en modo Unidades vendidas, y para umbrales mayores o iguales a 2. En modo Pedidos o Clientes, la cantidad de un pedido no supera un escalón por sí sola.
¿Funciona con las combinaciones?
Sí. Una campaña puede dirigirse a una combinación concreta o a todas las combinaciones de un producto. Una campaña dirigida a una combinación concreta prevalece sobre una de «todas las combinaciones».
¿Qué ocurre al desinstalar?
La desinstalación retira los precios específicos creados por el módulo, elimina sus hooks y su pestaña, y limpia sus tablas. Los vales de descuento ya emitidos siguen siendo válidos del lado de los clientes.