Cantidad mínima y venta por múltiplos: documentación DataFirefly Minimums
Instalación, reglas de cantidad (mínimo, múltiplo, máximo), prioridades y simulador, pedidos mínimos por grupo, comprobaciones en el servidor, importación CSV y resolución de problemas.
Qué hace el módulo
DataFirefly Minimums fija un mínimo, un múltiplo obligatorio (se vende por 6, por 12) y un máximo por producto, combinación, categoría, marca o para todo el catálogo, opcionalmente para un solo grupo de clientes y un periodo. También fija un importe mínimo de pedido por grupo de clientes. Cada regla se vuelve a comprobar en el servidor, desde el añadido al carrito hasta la creación del pedido: una petición directa no permite eludirla.

Instalación
Instale el ZIP desde Módulos > Gestor de módulos > Subir un módulo. El módulo crea sus tablas, registra sus hooks y añade dos pestañas en Catálogo: Mínimos y múltiplos y Pedido mínimo. La versión 2.0.0 funciona en PrestaShop 1.7.8, 8 y 9 con el mismo ZIP.
Actualización desde la 1.0.0: suba el ZIP 2.0.0 sobre el anterior. Sus reglas y pedidos mínimos se conservan, las nuevas columnas y los nuevos parámetros se añaden automáticamente.
Resumen
La página de configuración se abre con un resumen: número de reglas activas por objetivo, pedidos mínimos, lista de las comprobaciones realizadas en el servidor, eventos contados en los últimos 30 días (cantidades ajustadas, cambios rechazados, páginas de pedido bloqueadas, pedidos rechazados) y comprobaciones de coherencia. El módulo solo cuenta eventos reales: no estima ningún efecto en las ventas.

Las comprobaciones de coherencia señalan las reglas dirigidas a un producto, categoría, marca o grupo eliminado, las reglas finalizadas, los mínimos redondeados, los máximos ignorados, las reglas ambiguas (mismo objetivo, grupo y prioridad), los productos cuyo stock es inferior al mínimo y la cantidad mínima nativa de las fichas de producto.
Parámetros

- Activar las reglas de compra: interruptor general. Desactivado, no se muestra ni se aplica nada; las reglas se conservan.
- Cantidad no permitida al añadir al carrito: ajustarla a la cantidad permitida más cercana e informar al cliente (hacia arriba al añadir, hacia abajo al retirar), o rechazar el cambio indicando las cantidades permitidas.
- Selector de cantidad por múltiplos: los botones + y – de la ficha de producto, la vista rápida, los listados (Hummingbird) y el carrito pasan de una cantidad permitida a la siguiente.
- Condiciones en la ficha, insignia en los listados, condiciones bajo las líneas del carrito, barra de progreso: cada visualización se puede desactivar.
- Cliente en varios grupos: pedido mínimo del grupo por defecto, el más alto o el más bajo.
- Importe mínimo de compra nativo: se aplican ambos, o el mínimo del módulo sustituye al nativo para los clientes que tienen uno.
- Pedidos por webservice y back office: los pedidos por webservice se comprueban por defecto y se rechazan con un error explícito; los del back office no se comprueban por defecto, para pedidos telefónicos y excepciones.
- Medir ajustes y bloqueos: solo se guarda el ID del carrito, los registros se eliminan a los 90 días.
- Conservar las reglas al desinstalar.
Reglas de cantidad
Abra Catálogo > Mínimos y múltiplos. La lista muestra el objetivo, el grupo de clientes, las condiciones, el periodo y la prioridad de cada regla. Las reglas se pueden duplicar y activar o desactivar en bloque.

Crear una regla
- Se aplica a: un producto (búsqueda por nombre, referencia, EAN o ID y, opcionalmente, una combinación), una categoría (con o sin subcategorías), una marca o todos los productos.
- Modo de recuento: cada producto y cada combinación por separado; cada producto con sus combinaciones sumadas (tallas y colores combinados); o todos los productos seleccionados juntos (combinación libre).
- Grupo de clientes: todos los grupos o uno. Los visitantes sin sesión pertenecen al grupo Visitante, los pedidos sin cuenta al grupo Invitado.
- Mínimo, múltiplo, máximo: el mínimo se redondea al múltiplo (5 por 6 da 6). El máximo debe ser múltiplo y al menos igual a la menor cantidad permitida: si no, el formulario lo rechaza y propone dos valores.
- Nombre del envase, por idioma: «caja» da «Se vende por caja de 6».
- Prioridad y periodo opcional (desde / hasta).
El bloque Lo que verán los clientes muestra los mensajes y la insignia mientras escribe, con las advertencias.

Qué regla se aplica
Para cada línea de producto del carrito se aplica una sola regla. Se elige en este orden:
- la prioridad más alta;
- el objetivo más preciso: combinación, producto, categoría (la más profunda primero), marca, todo el catálogo;
- una regla para un grupo del cliente antes que una regla para todos los grupos;
- la regla más reciente.
Las reglas de combinación libre se comprueban además: suman todos los productos de una categoría, de una marca o de todo el pedido. Se conserva la cantidad mínima nativa de la ficha de producto: cuando es mayor, eleva el mínimo de la regla, redondeado al múltiplo.
El Simulador responde a la pregunta para un producto, una combinación, un grupo de clientes o un cliente (correo) y una cantidad: lista cada regla candidata, la aplicada, por qué las demás no lo están, las condiciones efectivas, el veredicto para la cantidad, el stock y el pedido mínimo.

La pestaña Módulos de la ficha de producto muestra las condiciones efectivas por grupo de clientes, las reglas del producto y las heredadas.

Pedidos mínimos por grupo
Abra Catálogo > Pedido mínimo. Un mínimo por grupo, más un mínimo por defecto opcional para todos los clientes sin mínimo propio. Cada mínimo elige su base: con o sin impuestos, antes o después de vales, con o sin los gastos de envío estimados en el carrito. Los importes se introducen en la moneda por defecto y se convierten al tipo de cambio actual.

Lo que ve el cliente
La ficha de producto muestra las condiciones de compra, las cantidades permitidas y el número de envases. El selector de cantidad empieza en una cantidad permitida y avanza por múltiplos.

Cuando el stock es inferior al mínimo y no se aceptan pedidos sin stock, el cliente ve el motivo y el botón de añadir al carrito se desactiva.

Los listados de productos muestran una insignia («Se vende por 6», «Mín. 4»). Con Hummingbird, el selector de cantidad de las miniaturas también sigue la regla.

En el carrito, cada línea recuerda su condición. Una cantidad no permitida se explica, con botones para pasar a las cantidades permitidas más cercanas, y el botón de pedido se desactiva con el motivo.

Una barra de progreso indica el importe que falta para alcanzar el pedido mínimo del cliente, en ordenador y en móvil.


Cuando una cantidad se ajusta automáticamente, se informa al cliente una vez en el resumen del carrito.

Comprobaciones en el servidor
- Añadir al carrito y cambios de cantidad, por AJAX o URL directa: ajustados o rechazados según el parámetro.
- Página de pedido: un carrito que incumple una regla se devuelve al carrito con los motivos.
- Acceso directo a un módulo de pago (por ejemplo la página de validación de la transferencia): redirección al carrito, no se crea ningún pedido.
- Creación del pedido: última comprobación antes de guardarlo, sea cual sea el punto de entrada. Las notificaciones de un proveedor de pago sin la sesión del cliente nunca se bloquean, porque el cliente quizá ya ha pagado: se registran.
- Webservice y back office: según los parámetros.
El importe mínimo de compra nativo de PrestaShop también se impone al crear el pedido, mientras que PrestaShop solo lo comprueba en la página de pedido.
Importación y exportación CSV
Abra Importar / exportar. El tipo de archivo se reconoce por su cabecera: reglas de cantidad (columna scope) o pedidos mínimos (columna amount). Solo comprobar está marcado por defecto: el informe indica cada línea como OK o con error y no se guarda nada. La sustitución de las reglas existentes solo se realiza si todas las líneas son válidas, en una sola transacción. Las exportaciones neutralizan las fórmulas de hoja de cálculo y se pueden volver a importar tal cual.

Columnas de las reglas de cantidad: name, scope (product, category, manufacturer, all), product_id o product_reference, combination_reference, category_id, include_subcategories, manufacturer_id, apply_mode (per_product, product_total, cumulative), group_id, min_qty, multiple, max_qty, priority, active, date_from, date_to, pack_label_xx. Columnas de los pedidos mínimos: group_id, amount, tax_incl, after_discounts, include_shipping, active. Se aceptan los archivos de la versión 1.0.0.
Resolución de problemas
El mínimo es superior al de la regla
La cantidad mínima nativa de la ficha de producto es mayor: prevalece, redondeada al múltiplo. El simulador y las comprobaciones de coherencia lo indican.
El cliente no puede alcanzar el mínimo
El stock es inferior al mínimo y no se aceptan pedidos sin stock. Reponga, permita los pedidos sin stock o baje el mínimo.
El carrito está bloqueado por el mensaje del mínimo nativo
Es el importe mínimo de Parámetros de la tienda > Configuración de pedidos. Póngalo a 0 o elija «sustituir» en los parámetros.
Los botones +/- avanzan de 1 en 1
El tema no usa los selectores estándar. La regla se sigue aplicando en el servidor: la cantidad se ajusta o se rechaza y el pedido se bloquea.
Compatibilidad
- PrestaShop 1.7.8, 8.x y 9.x, el mismo ZIP (probado con PHP 7.4, 8.1 y 8.5).
- Temas Classic y Hummingbird.
- Multitienda: reglas y mínimos guardados por tienda.
- Multimoneda: importes convertidos al tipo de cambio actual.
- Interfaz en inglés, francés, español, alemán, italiano, neerlandés, polaco y portugués.