Packs de productos y bundles: documentación
Crear packs y bundles en PrestaShop 1.7.8, 8 y 9: composición, cuatro modos de precio, página del pack, carrito, pedidos, factura e IVA por tipo.
Novedades de la versión 3.0.0
- Compatible con PrestaShop 1.7.8, 8 y 9. El modo «una sola línea para el pack» requiere PrestaShop 8 o posterior.
- Back office renovado: indicadores, precio, ahorro y estado en la lista de packs; navegación por secciones, controles «listo para vender» y vista previa del cliente en el editor; ajustes agrupados por tema.
- Nueva página del pack: resumen del precio siempre visible, barra de compra en móvil, botones + y −, etiquetas Gratis y Opcional.
- Correcciones: descuento de grupo de clientes aplicado una sola vez, precio fijo proporcional a las cantidades elegidas, IVA por tipo registrado correctamente en modo una sola línea, resumen de los packs exacto en la confirmación y la factura, compatibilidad con PrestaShop 9.
Instalación
El módulo se instala como cualquier módulo de PrestaShop, por el back office o por FTP.
- Desde Módulos y Gestor de módulos, haz clic en Subir un módulo y arrastra el archivo
dfpackpro.zip. - Por FTP, descomprime el archivo en la carpeta
/modules/de tu tienda e instala DataFirefly – Packs & Bundles desde el gestor de módulos. - Vacía la caché en Parámetros avanzados y Rendimiento.
La instalación crea nueve tablas con prefijo ps_dfpackpro, registra los hooks necesarios y añade la pestaña Packs & Bundles (DF) en el menú Catálogo.
El módulo no instala ningún override de clases ni de controladores. La desinstalación elimina las tablas, las claves de configuración y la pestaña.
Ajustes generales
El botón Configurar de la ficha del módulo abre los ajustes que se aplican a todos los packs.
- Posición del bloque en la ficha de producto: bajo el bloque de compra, al pie de la ficha, o ambos. El bloque lista los packs que contienen el producto consultado.
- Bloque de packs activo: corta la visualización cross-sell sin desinstalar. Las páginas de packs siguen accesibles.
- Número máximo de packs mostrados: 3 por defecto.
- Orden de los packs: posición, fecha de creación o aleatorio.
- Mostrar precios unitarios: detalla el precio de cada componente en la página del pack.
- Mostrar el ahorro: badge e importe ahorrado, en el bloque de la ficha y en la página del pack.
- Mostrar la disponibilidad: estado de stock del pack, calculado desde los stocks de los componentes.
- Modo carrito estricto: si el cliente retira un componente, todo el pack y su descuento se retiran. Desactivado, la retirada se acepta y el descuento se conserva sobre el resto.
- Tras añadir al carrito: redirección al carrito o confirmación en el sitio.
- Color de acento: color de los badges, botones y bordes de los bloques del módulo.
- Producto escaparate en el catálogo: activa el producto escaparate generado para cada pack (listados, búsqueda, sitemap).
- Base de precio del escaparate: con impuestos para una tienda B2C, sin impuestos para una tienda que muestra precios sin IVA.
- Resumen de packs en la factura PDF: bloque añadido al final de la factura, el único punto que expone PrestaShop.
- Resumen de packs en la confirmación y el historial de pedidos.
- Selector de combinaciones en la página del pack: como la ficha de producto (un selector por atributo: desplegable, muestras de color o botones, según el tipo de cada grupo de atributos), un desplegable con todas las combinaciones, o miniaturas de imagen clicables. En todos los modos, elegir una combinación cambia la foto del producto a la imagen asociada, y si la variante predeterminada de un componente de elección libre se agota, la página se abre en una combinación con stock.
- Muestras de los atributos de color: para los grupos de atributos de tipo «Color o textura», en el selector como en la ficha de producto. Automático (por defecto) muestra la imagen de una combinación de ese color cuando el color no tiene código de color ni textura. Color o textura mantiene la visualización nativa de PrestaShop. Imagen de la combinación muestra siempre la foto de la combinación, aunque exista un código de color.
- Stock de cada producto del pack: no mostrar, disponibilidad, o disponibilidad y plazo de entrega. Bajo cada producto se muestra el estado de la combinación elegida con las mismas etiquetas que tus fichas de producto: etiqueta de disponibilidad de la combinación, si no la del producto, si no la de los ajustes de productos, «Últimas unidades en stock» por debajo del umbral fijado en los ajustes de productos, y nota de plazo de entrega del producto. El umbral tiene en cuenta la cantidad del producto en el pack. Un punto de color indica el estado: verde en stock, naranja últimas unidades, azul pedible sin stock, rojo no disponible. La visualización sigue cada cambio de combinación.
- Visualización de la página del pack: página de pack dedicada, o ficha de producto de la tienda. Ver la sección «Mostrar el pack como una ficha de producto».
- Pack en el carrito: una línea por producto, o una sola línea para el pack. Ver la sección «Una sola línea para el pack en el carrito».

Crear un pack
Abre Catálogo y Packs & Bundles (DF), y haz clic en Nuevo pack.

Información del pack
- Nombre: campo traducido, mostrado en el bloque de la ficha, la página del pack y el badge del carrito.
- Alias de URL: generado automáticamente desde el nombre si lo dejas vacío. Compone la dirección de la página del pack.
- Resumen y descripción: textos enriquecidos traducidos, mostrados encima y debajo de los productos del pack.
- Badge: texto corto traducido, mostrado en las tarjetas del bloque cross-sell. Déjalo vacío para mostrar el porcentaje de ahorro.
- Modo de precio: los cuatro modos descritos más abajo. El formulario oculta los campos innecesarios según el modo elegido.
- Heredar las promociones existentes: activado, los descuentos de catálogo en curso son el precio de partida del cálculo del pack.
- Fechas de validez: déjalas vacías para un pack permanente. Fuera del periodo, el pack desaparece del front.
- Activo: equivalente al interruptor de activación de la lista.

Componentes
El panel Componentes gestiona el contenido del pack.
- Búsqueda de productos: escribe al menos dos caracteres. La búsqueda cubre nombre, referencia e ID. Haz clic en un resultado para añadirlo.
- Combinación: para un producto con combinaciones, el selector lista las variantes con su precio. La variante elegida se convierte en la predeterminada.
- Elección de la combinación por el cliente: activado, el cliente selecciona su variante en la página del pack y en el bloque de la ficha. Desactivado, la variante está impuesta.
- Cantidad: número de unidades del componente en el pack. Un pack puede contener un solo producto en cantidad, para una venta por lote.
- Cantidad editable: el cliente puede ajustar la cantidad de este componente en la página del pack.
- Opcional: el cliente puede desmarcar este componente, el precio se recalcula.
- Descuento por producto: en porcentaje o importe, visible solo en el modo Descuento por producto. Un descuento del 100 % convierte el componente en regalo.
- Orden: flechas arriba y abajo para ordenar la visualización.
El simulador de precio bajo la tabla recalcula en directo el precio total, el precio del pack y el ahorro con cada cambio.
El botón Duplicar de la lista copia un pack completo con sus componentes, práctico para declinar la misma mecánica en varias gamas.

El editor de pack
El formulario se organiza en nueve secciones (barra de navegación arriba, controles «listo para vender» en el resumen): información (nombre, referencia, etiqueta, visibilidad, URL amigable, periodo de validez), productos, precio, imágenes, descripción, catálogo y SEO. El selector de idioma en la parte superior de los pasos traducidos cambia todos los campos traducidos. A la derecha, el resumen se actualiza con cada cambio: precio de los productos comprados por separado, descuento, precio del pack con y sin IVA, y desglose del IVA por tipo tal como aparecerá en la factura.
Las imágenes se añaden arrastrando y soltando o con un clic. Arrastra las miniaturas para cambiar su orden: la primera pasa a ser la portada. El árbol de categorías del paso 6 decide dónde aparece el pack en el catálogo, y la primera categoría marcada pasa a ser su categoría por defecto.
Imágenes de los productos
Un pack nuevo guardado sin imagen recibe automáticamente la imagen de cada uno de sus productos: la de la combinación por defecto, si no la imagen de portada del producto. En un pack existente, marca «Añadir a la galería las imágenes de los productos del pack al guardar» en el paso 4. Después puedes reordenar estas imágenes, eliminar algunas o añadir una imagen del lote completo.
Resumen y descripción
El paso 5 contiene dos campos traducidos. El resumen del pack se muestra encima de los productos, como el resumen de una ficha de producto, y pasa a ser el resumen del producto escaparate. La descripción se muestra debajo de los productos, para la presentación completa. Cada producto del pack enlaza con su propia ficha, así que no hace falta repetir sus detalles.
Descuento por grupo de clientes
En el paso 3, el bloque «Descuento por grupo de clientes» añade un descuento en porcentaje sobre el precio del pack para los clientes de un grupo. El grupo que se tiene en cuenta es el grupo por defecto del cliente, como en los precios específicos nativos. Deja el campo vacío para no añadir descuento. El descuento se aplica en la página del pack, en el carrito y en el pedido, y cada grupo ve su precio en los listados gracias a un precio específico de grupo creado en el producto escaparate.
Los precios de grupo de los propios productos (precios específicos por grupo, descuento de grupo) ya se aplican cuando «Partir de los precios rebajados» está en Sí: el precio del pack parte entonces del precio del cliente conectado. El descuento de grupo del pack se suma a ellos.
SEO
El paso 7 reúne el meta título, la meta descripción y las palabras clave, por idioma. Si se dejan vacíos, el meta título toma el nombre del pack y la meta descripción el inicio del resumen. Una vista previa muestra cómo se verá el pack en los resultados de búsqueda, con un contador de caracteres: unos 60 para el título, 160 para la descripción. Las palabras clave, separadas por comas, se convierten en las etiquetas del producto escaparate, que usa la búsqueda de la tienda.
Estos campos se copian en el producto escaparate: se aplican tanto si el pack se muestra en su propia página como en una ficha de producto. La URL amigable se configura en el paso 1.
Los cuatro modos de precio
Sin descuento
El pack vende los componentes a su precio actual. Útil para un pack de pura comodidad o para destacar solo la composición.
Descuento global en porcentaje
El porcentaje se aplica al precio de cada componente. Un pack al -15 % descuenta cada línea un 15 %.
Descuento por producto
Cada componente lleva su propio descuento, en porcentaje o importe. Es el modo de las ofertas tipo máquina más consumible de regalo: la máquina al 0 %, el consumible al 100 %.
Precio fijo
Anuncias el precio del pack, con impuestos en la moneda por defecto. La diferencia entre la suma de los precios actuales y el precio anunciado se reparte proporcionalmente en cada línea, sin impuestos. Cada producto conserva su tipo de IVA.
Ejemplo: un pack a 49 € compuesto por un producto A a 40 € y un producto B a 30 €. La suma actual es 70 €, el descuento 21 €. A soporta 12 € de descuento y B 9 €, en proporción a su peso en el total. La factura sigue siendo exacta aunque A esté al 21 % de IVA y B al 10 %.
Desde la versión 3.0.0, el precio fijo corresponde a la composición por defecto del pack: si el cliente aumenta una cantidad modificable o quita un producto opcional, el precio varía en proporción y nunca obtiene más productos por el mismo precio. Las cantidades modificables tienen un máximo de 99.

El bloque en las fichas de producto
Cada producto que pertenece a un pack muestra un bloque « este producto también está disponible en pack ». Cada tarjeta presenta las miniaturas de los componentes, el nombre del pack, el total tachado, el precio del pack, el badge de ahorro y el estado de stock.
- Ver el pack abre la página del pack.
- Añadir añade directamente el pack al carrito en su configuración predeterminada. El botón se convierte en Configurar cuando el pack contiene elecciones: combinación libre, componente opcional o cantidad editable.
La posición del bloque, el número de tarjetas y su orden se ajustan en la configuración del módulo.


La página del pack
Cada pack tiene su página en /pack/12-mi-alias, con el identificador del pack y el alias del idioma en curso. La página lista los componentes con sus selectores de combinación, las casillas de los productos opcionales y los campos de cantidad cuando están abiertos. Cada producto muestra su cantidad en el pack al final de su nombre, por ejemplo « x2 ».
Cada cambio recalcula en Ajax el precio total, el precio del pack, el ahorro y la disponibilidad, sin recargar la página. El botón de añadir envía la selección actual al carrito.
La disponibilidad se calcula desde el stock real: el pack es vendible si cada componente requerido está disponible en la cantidad solicitada, teniendo en cuenta los permisos de pedido sin stock de cada producto.



El carrito
Al añadir un pack, cada componente se convierte en una línea real del carrito, facturada a su precio de pack mediante un precio específico limitado a ese carrito. No se crea ningún producto fantasma.
Badge de pack
Cada línea que pertenece a un pack muestra un badge con el nombre del pack, un enlace a su página y un botón Retirar el pack completo. La retirada elimina todas las líneas del pack y sus descuentos en una acción.
Cantidades adicionales
El precio del pack solo cubre las cantidades del pack. Si el cliente sube la cantidad de una línea, el módulo aplica un precio unitario medio ponderado: cantidad del pack al precio de pack, excedente al precio normal.
Ejemplo: pack de 2 unidades a 8 € con precio normal de 10 €. El cliente pasa la línea a 5 unidades. El precio unitario pasa a (2 x 8 + 3 x 10) / 5 = 9,20 €, un total de 46 €. El descuento queda acotado a las 2 unidades del pack.
Modo estricto
Activado, eliminar un componente retira todo el pack y su descuento. Esto impide conservar el descuento devolviendo parte del lote. Desactivado, la retirada se acepta y el descuento se conserva en las líneas restantes.
Un mismo producto puede pertenecer a varios packs en el mismo carrito. Cada pack se sigue por separado y el precio medio tiene en cuenta el conjunto.

Pedidos y contabilidad
Cada producto del pack llega en su propia línea de pedido, a su precio de pack. Facturas, albaranes, abonos y devoluciones parciales funcionan de forma nativa, artículo por artículo. Tus exportaciones contables y ERP solo ven referencias reales de tu catálogo.
En el modo una línea por producto, la factura muestra en cada línea el precio base sin IVA y el precio unitario de pack, más un bloque Detalle de los packs al final de la factura: total sin pack, descuento en importe y porcentaje, total del pack. El mismo resumen aparece en la página de confirmación y en el historial de pedidos del cliente. El detalle de cada pedido en el back office muestra un resumen de los packs pedidos. La lista de packs muestra un contador de ventas por pack.


El producto escaparate en el catálogo
Cada pack genera un producto escaparate sincronizado automáticamente: un producto real del catálogo, sin regla de impuestos, que lleva la referencia del pack (o DFPACK seguida del identificador del pack cuando la referencia está vacía). Lo encuentras en Catálogo y Productos escribiendo esa referencia. Aparece en los listados de categorías, la búsqueda nativa, los filtros por facetas y el sitemap, con la galería del pack, el total tachado y el badge de promoción nativos. Su stock mostrado sigue la disponibilidad calculada del pack.
Según el ajuste «Visualización de la página del pack», la ficha del escaparate redirige con un 301 a la página del pack, o muestra ella misma el pack como una ficha de producto. Según el ajuste «Pack en el carrito», una línea de carrito que lo referencie se convierte en líneas de productos, cada una con su propio tipo de IVA, o pasa a ser una sola línea de pack con su contenido. Se resincroniza en cada guardado del pack, en cada cambio o movimiento de stock de un producto componente y tras cada pedido.
Transportistas y peso
El peso del producto escaparate se calcula a partir de los productos del pack, combinaciones incluidas, en cada sincronización. Los transportistas, las características y los demás ajustes de envío se configuran en su ficha nativa, pestaña Envío: el enlace «Producto escaparate (características, transporte…)» del resumen del editor lleva directamente a ella, y la sincronización no modifica estos ajustes.
Con «Pack en el carrito» en «Una línea para el pack», se aplican los transportistas y el peso del producto escaparate. Con «Una línea por producto», cada artículo conserva sus propios transportistas y su propio peso.
El nombre, los precios, la referencia, las imágenes, las categorías, el resumen, la descripción y los campos SEO del producto escaparate se gestionan desde el formulario del pack: la próxima sincronización sobrescribiría un cambio hecho directamente en el escaparate.

Importar los packs nativos de PrestaShop
El botón Import PrestaShop packs de la lista de packs convierte tus packs nativos: componentes con combinaciones y cantidades, categorías, imágenes y precio incluidos (modo precio fijo). El producto pack nativo se desactiva tras la importación para no competir con el escaparate; reactívalo en el catálogo si lo necesitas. La referencia PSPACK guarda el origen: relanzar la importación nunca importa dos veces el mismo pack. Los packs anidados dentro de otros packs se ignoran.
Mostrar el pack como una ficha de producto
Con el ajuste «Visualización de la página del pack» en «Ficha de producto de la tienda», el pack se muestra en la ficha de su producto escaparate, construida por tu tema como cualquier otro producto: galería, ruta de navegación, precio, cantidad, botón de añadir al carrito, pestañas, opiniones. El bloque «Este pack contiene» se coloca encima de la cantidad, con los productos, sus selectores de combinaciones, los productos opcionales y el ahorro.
Cuando el cliente cambia una combinación, el precio, el precio tachado y el porcentaje de descuento del tema se actualizan. El botón de añadir al carrito del tema añade el pack con la selección del cliente, y el campo cantidad fija el número de packs. Los enlaces al pack (bloque cross-sell, página /packs, etiqueta del carrito) apuntan a esta ficha, y las antiguas direcciones /pack/ redirigen a ella con un 301.
La vista rápida de los listados sigue siendo una ventana de producto simple: añadir desde ella añade el pack en su configuración por defecto.
Una sola línea para el pack en el carrito
Con el ajuste «Pack en el carrito» en «Una línea para el pack», el pack entra en el carrito como una sola línea, con el nombre del pack y su contenido debajo: «1 x Camiseta (Talla: S, Color: Blanco)». Dos selecciones distintas dan dos líneas, y el mismo pack añadido dos veces con la misma selección aumenta la cantidad de la línea.
El precio de la línea es la suma de los precios de los productos, calculada con el tipo de IVA de cada uno: los totales sin IVA, con IVA y de IVA del carrito y del pedido son exactos. En la factura, la línea del pack muestra su precio base y su descuento. Los importes de IVA del pedido se registran por tipo (exportaciones contables); sin embargo, la tabla de IVA nativa de la factura de PrestaShop muestra un tipo combinado cuando el pack mezcla tipos, por lo que se añade al final de la factura un bloque «IVA de los packs por tipo» con la base y el IVA de cada tipo. El contenido del pack aparece también en el checkout, el detalle del pedido, los emails y la factura, y la tarjeta «Packs de este pedido» del back office indica los productos y combinaciones que hay que preparar.
El stock de cada producto se descuenta al hacer el pedido, se devuelve si el pedido pasa a «Cancelado» o «Error en el pago», y se vuelve a descontar si se reactiva.
Las devoluciones parciales con reposición de stock solo devuelven el producto escaparate. Tus exportaciones contables ven una referencia DFPACK con varios tipos de IVA en la misma línea: si tu contabilidad exige una línea por tipo, mantén el modo «Una línea por producto».
Multitienda y multilingüe
Cada pack se asocia a las tiendas de su contexto de creación y puede gestionarse tienda a tienda. Los campos Nombre, Alias de URL, Resumen, Descripción, Badge, Meta título, Meta descripción y Palabras clave se traducen en los idiomas instalados. El front sigue el idioma del cliente, incluido el alias de la página del pack.
Adaptar la visualización a tu tema
Tres plantillas son sobrescribibles. Cópialas desde /modules/dfpackpro/views/templates/ a /themes/tu-tema/modules/dfpackpro/views/templates/ conservando las subcarpetas.
hook/product_packs.tpl: el bloque cross-sell de las fichas de productofront/pack.tpl: la página del packhook/cart_line_badge.tpl: el badge de pack en el carrito
El CSS está aislado bajo el prefijo dfpackpro y el color de acento lo lleva la variable CSS --dfpackpro-accent. Para un ajuste puntual, apunta a las clases desde la hoja de estilos de tu tema en lugar de modificar views/css/front.css, que se sobrescribiría en la actualización.
Solución de problemas
El bloque no aparece en la ficha de producto
- Verifica que el pack está activo y que la fecha actual está dentro del periodo de validez.
- Verifica que el producto consultado forma parte de los componentes del pack.
- Controla el ajuste Bloque de packs activo y la posición elegida en la configuración.
- Vacía la caché Smarty y la caché de tu servidor.
El pack aparece como no disponible
La disponibilidad es el mínimo de los stocks de los componentes requeridos divididos por su cantidad en el pack. Un solo componente agotado sin permiso de pedido sin stock basta para hacer el pack no disponible. Los componentes opcionales desmarcados no cuentan.
El badge del carrito aparece en el lugar equivocado
El tema renderiza el badge en la columna de acciones y luego JavaScript lo mueve al bloque de información del producto. En un tema muy personalizado sin los contenedores estándar, el badge se queda en su posición original. Sobrescribe cart_line_badge.tpl para integrarlo en tu estructura.
El precio de pack se aplica a demasiadas unidades
Este caso lo cubre el precio medio ponderado: comprueba el precio unitario de la línea, debe situarse entre el precio de pack y el precio normal en cuanto la cantidad supera la del pack. Si no es así, vacía la caché y modifica la cantidad para forzar un recálculo.
La página del pack devuelve un 404
Verifica que el pack está activo y dentro de su periodo de validez. Tras un cambio de alias, la dirección antigua redirige con un 301 a la nueva mientras el identificador del pack sea correcto.
El producto escaparate aparece varias veces
Antes de la versión 2.7.2, un paso de sincronización fallido podía crear un escaparate nuevo en cada guardado del pack. Actualiza el módulo y guarda el pack una vez: el módulo conserva el escaparate vinculado al pack y elimina las copias.
Si aparece el error «Table ps_product_attribute_combination doesn’t exist», la base de datos está incompleta, a menudo tras copiar una base de producción a una de preproducción. Esta tabla nativa de PrestaShop vincula cada combinación con sus atributos. Vuelve a importarla desde la base de origen, no la recrees vacía: se perderían los vínculos entre combinaciones y atributos.
Error «Unknown column» tras una actualización
Los archivos del módulo se sustituyeron sin ejecutar su actualización. Desde la versión 2.7.1, basta con abrir Catálogo y Packs & Bundles (DF) o la configuración del módulo: la base de datos se completa automáticamente. También puedes hacer clic en Actualizar en el gestor de módulos.
Desinstalación
La desinstalación elimina las nueve tablas del módulo, sus claves de configuración y la pestaña del menú Catálogo. Los pedidos pasados conservan sus líneas y precios, tu histórico contable no se altera.