Cantidad mínima y venta por múltiplos: documentación DataFirefly Minimums

Instalación

Instale el módulo desde Módulos > Gestor de módulos > Subir un módulo con el archivo ZIP, o copie la carpeta dfminimums en el directorio /modules/ de la tienda y haga clic en Instalar.

Al instalarse, el módulo crea dos tablas (reglas de cantidad y mínimos de pedido), registra sus hooks y añade dos pestañas en el menú Catálogo: Mínimos y múltiplos y Pedido mínimo.

Configuración del módulo

La página de configuración del módulo reúne seis ajustes.

Activar las reglas de compra

Interruptor general. Si se desactiva, ninguna regla se muestra ni se aplica en la tienda. Las reglas siguen guardadas.

Ajustar las cantidades automáticamente

Cuando un cliente añade al carrito una cantidad que incumple una regla, el módulo la sustituye por la cantidad permitida más cercana: hacia arriba al añadir, hacia abajo al quitar. Añadir 7 de un producto vendido por 6 da 12, bajar de 12 a 11 da 6. Las líneas personalizadas nunca se modifican. Si se desactiva, la cantidad se queda como está y el carrito se bloquea hasta que el cliente la corrija.

Mostrar las condiciones en la ficha de producto

Muestra un recuadro bajo el botón de añadir al carrito con el mínimo, el múltiplo y el máximo que se aplican al cliente conectado. El recuadro aparece también en la vista rápida.

Mostrar una etiqueta en los listados de productos

Añade una etiqueta corta bajo el precio de las miniaturas, por ejemplo «Venta por 6» o «Mín. 12».

Mostrar las condiciones bajo cada línea del carrito

Recuerda la condición de cada línea y muestra el error en rojo cuando la cantidad no está permitida.

Cliente en varios grupos

Determina qué mínimo de pedido se aplica cuando un cliente pertenece a varios grupos que tienen cada uno un mínimo: el de su grupo por defecto, el más alto o el más bajo.

Crear una regla de cantidad

Abra Catálogo > Mínimos y múltiplos y haga clic en Añadir una regla.

Se aplica a

• Un producto: busque el producto por nombre, referencia, EAN o ID y, si lo desea, elija una combinación. Una regla sobre una combinación tiene prioridad sobre una regla sobre todo el producto.
• Una categoría: elija la categoría e indique si se incluyen las subcategorías. Se incluyen todos los productos asociados a la categoría, sea cual sea su categoría por defecto.
• Todos los productos: la regla afecta a todo el catálogo.

Grupo de clientes

Deje «Todos los grupos de clientes» o elija un grupo. Una regla de grupo se aplica a todo cliente que pertenezca a ese grupo, aunque no sea su grupo por defecto.

Mínimo, múltiplo y máximo

• Cantidad mínima: 0 o 1 significa sin mínimo. Si hay un múltiplo y el mínimo no lo es, se redondea al múltiplo superior: mínimo 10 por 6 da 12.
• Venta en múltiplos de: 1 deja la cantidad libre, 6 solo acepta 6, 12, 18, etc.
• Cantidad máxima: 0 significa sin máximo. El máximo debe ser múltiplo del múltiplo elegido y mayor o igual que el mínimo.

Una regla debe definir al menos un mínimo superior a 1, un múltiplo superior a 1 o un máximo.

Qué regla se aplica

Para cada producto del carrito se aplica una sola regla «por producto». El módulo la elige en este orden:

1. la prioridad más alta;
2. a igual prioridad, la regla más específica: combinación, luego producto, luego categoría (la más profunda primero), luego todos los productos;
3. a igual especificidad, una regla de grupo de clientes antes que una regla para todos los grupos.

Ejemplo: una regla «Vinos, venta por 6» para todos los clientes y una regla «Vinos, venta por 12» para el grupo Profesionales. Un profesional pide por 12, un particular por 6.

El panel del módulo en la pestaña Módulos de la ficha de producto lista las reglas que se dirigen directamente al producto y las de categoría o catálogo que también pueden aplicarse.

Surtido libre por categoría

En una regla de categoría, el campo Forma de contar ofrece dos valores.

• Cada producto por separado: la regla se aplica a cada producto de la categoría, como una regla de producto.
• Todos los productos de la categoría juntos (surtido libre): el mínimo, el múltiplo y el máximo se aplican a la suma de las cantidades de todos los productos de la categoría presentes en el carrito.

Ejemplo: mínimo 12 y múltiplo 6 en surtido libre sobre la categoría Vinos. El cliente puede llevar 4 tintos, 4 blancos y 4 rosados. Con 13 botellas en total, el carrito se bloquea.

Las reglas de surtido libre se comprueban además de la regla propia de cada producto. Un vino vendido por unidades sigue disponible por unidades, siempre que el total de la categoría cumpla la regla de surtido libre.

Mínimos de pedido por grupo

Abra Catálogo > Pedido mínimo y haga clic en Añadir un mínimo de pedido.

• Grupo de clientes: un mínimo por grupo. La entrada «Todos los clientes (por defecto)» se aplica a los clientes cuyos grupos no tienen un mínimo propio.
• Importe mínimo: se indica en la moneda por defecto de la tienda y se convierte automáticamente para los carritos en otra moneda. Los gastos de envío nunca se incluyen.
• Importe con IVA: No compara el importe con el total de productos sin IVA, lo habitual en B2B.
• Descontar los cupones: Sí toma el total después de las reglas del carrito y los cupones.

Lo que ve el cliente

Cuando el carrito incumple una regla, el módulo rellena la clave minimalPurchaseRequired del carrito, la que PrestaShop usa para su propio importe mínimo. El botón de pedido se desactiva y la alerta nativa del carrito muestra «Su carrito aún no cumple las condiciones de compra.» seguido del detalle de cada problema: cantidad no permitida con las cantidades posibles, total de una categoría en surtido libre, importe que falta para alcanzar el mínimo de pedido.

La comprobación se repite al abrir la página de pedido: un cliente que intenta acceder directamente vuelve al carrito.

En el front, los campos de cantidad siguen la regla. En el tema Classic, los botones TouchSpin avanzan de múltiplo en múltiplo. En Hummingbird, los botones +/- saltan directamente a la cantidad permitida siguiente o anterior.

Importación y exportación CSV

La importación está en la parte superior de la lista de reglas. El archivo acepta el separador ; o , y necesita una línea de encabezado con al menos la columna scope. Columnas reconocidas:

• name: nombre interno, generado si está vacío;
• scope: product, category o all;
• product_id o product_reference;
• combination_reference: referencia de combinación;
• category_id e include_subcategories (0 o 1);
• apply_mode: per_product o cumulative (surtido libre);
• group_id: 0 para todos los grupos;
• min_qty, multiple, max_qty, priority, active.

La casilla «Eliminar primero todas las reglas existentes de esta tienda» sustituye el conjunto de reglas. Las líneas con error se listan con su número y no bloquean las demás. El botón Exportar CSV genera el mismo formato, útil para copiar reglas de una tienda a otra. Se puede descargar un archivo de ejemplo desde el bloque de importación.

Buenas prácticas

• Empiece por una regla amplia (categoría o catálogo) y añada después las excepciones por producto: la regla más específica gana sin tocar la prioridad.
• Reserve la prioridad para los casos en que una regla menos específica debe ganar, por ejemplo una regla de categoría que debe imponerse a todos sus productos.
• Pruebe con una cuenta de cliente de cada grupo afectado: las reglas de grupo no son visibles para un visitante no conectado.
• Tras un cambio, vacíe la caché si la tienda usa un módulo de caché de página completa.

Resolución de problemas

El cliente no puede bajar de una cantidad aunque ninguna regla lo exige

Revise la cantidad mínima nativa de la ficha de producto (pestaña Stock o Cantidades según la versión) y vuelva a ponerla en 1.

El carrito se bloquea con el mensaje nativo de importe mínimo

Es el mínimo nativo de Parámetros de la tienda > Configuración de pedidos. Póngalo a 0 si solo deben contar los mínimos por grupo.

Los botones +/- avanzan de 1 en 1

El tema no usa los selectores estándar de Classic o Hummingbird. La regla se sigue aplicando en el servidor: el carrito se corrige o se bloquea. Contáctenos con el nombre del tema para adaptarlo.

Un módulo de pedido en una página deja pasar el pedido

El módulo de terceros ignora minimalPurchaseRequired. Pruébelo en una tienda de preproducción y contáctenos indicando su nombre.

Compatibilidad

• PrestaShop 8.0 a 9.x, el mismo ZIP cubre las dos ramas.
• Temas Classic y Hummingbird.
• Multitienda: las reglas y los mínimos se guardan por tienda.
• Arquitectura ModuleAdminController, sin dependencias Composer, PHP 7.2 o superior.
• Interfaz disponible en inglés, francés, español, alemán, italiano, neerlandés, polaco y portugués.