Vinos y licores en PrestaShop: documentación de DataFirefly Wine & Spirits

Instalación

Instale el módulo desde Módulos > Gestor de módulos > Subir un módulo con el archivo ZIP. El módulo crea sus tablas, registra sus hooks y añade el menú Catálogo > Vinos y licores.

En la instalación crea también ocho características nativas: Añada, Variedad de uva, Denominación de origen, Graduación alcohólica, Color, Región, País de origen y Certificación. Configura Francia (edad legal 18 años, casilla de edad en el pago, advertencia sanitaria francesa obligatoria) y los tipos franceses de impuestos especiales de 2026.

Para actualizar desde una versión anterior, instale el nuevo ZIP: los scripts de actualización añaden las columnas, tablas y características que faltan sin tocar sus datos.

Panel

Primera pestaña del menú. Muestra el número de productos gestionados, las unidades vendidas, el alcohol puro y los impuestos especiales del mes en curso, una lista de comprobación de la configuración, la completitud de los datos (graduación, color, añada, variedades, denominación) y los 30 últimos productos por completar con un enlace a su ficha. El color, la añada y las variedades solo se comprueban para los vinos.

Ajustes

Modo de cálculo de los impuestos especiales

• Incluidos en el precio (por defecto): sus precios ya contienen los impuestos. El importe se muestra en la ficha de producto («Impuestos especiales incluidos») y en el carrito, y se registra en el registro.
• Añadidos en el pago: se añade al carrito una línea «Impuestos especiales» con los impuestos del país de entrega. La lleva un producto técnico oculto del catálogo, creado al activar este modo. No elimine este producto.
• Desactivado: no se calcula ningún importe, el registro solo guarda volúmenes y alcohol puro.

Regla de impuestos de la línea de impuestos especiales: en la UE, los impuestos especiales forman parte de la base del IVA. Elija su tipo general.

Visualización

Cada elemento se activa por separado: resumen del vino en la ficha de producto, importe de los impuestos en la ficha, aviso legal en la ficha, aviso y total de impuestos en el carrito, aviso en el pie de página, impuestos y aviso en la factura PDF, pestaña Ficha de cata, distintivos en los listados de productos.

Ventana de verificación de edad

• Verificación: botones Sí / No, o fecha de nacimiento con cálculo de la edad.
• Recordar durante: número de días durante los que no se vuelve a preguntar al visitante. 0 vuelve a preguntar en cada sesión del navegador.
• URL de salida: página que se abre cuando el visitante responde que no o no tiene la edad requerida.
• Color de los botones, título y texto por idioma. En el texto, {age} se sustituye por la edad legal del país del visitante.

La ventana no se muestra a los robots de los buscadores, en las páginas CMS ni a los clientes conectados cuya fecha de nacimiento acredita su edad. El contenido de la página permanece en el HTML.

Caja surtida

Configure el número de botellas necesarias (6 por defecto), el descuento en porcentaje y los productos elegibles: todos los productos alcohólicos gestionados por el módulo, o solo los marcados en su pestaña. En cuanto el carrito alcanza el número necesario, cada botella elegible recibe el descuento. Un producto cuyo propio descuento por caja ya se aplica conserva su descuento.

Países sin regla específica

Valores usados para los países que no ha configurado: entrega de alcohol permitida o no, casilla de edad en el pago, edad legal.

Valores por defecto de los productos

Volumen (75 cl) y tamaño de caja (6) propuestos para un producto nuevo.

Características filtrables

La tabla indica el estado de las ocho características. Volver a crear las características que faltan las recrea si alguna se ha eliminado. Para que sus clientes filtren por ellas, añádalas a su plantilla de filtros en ps_facetedsearch (botón Abrir la navegación por facetas).

Rellenar un producto

Abra la ficha de producto, pestaña Módulos, bloque Wine & Spirits. Marque Este producto es una bebida alcohólica. El bloque se guarda con su propio botón, independientemente del formulario del producto.

Datos de vinos y licores

• Categoría: categoría fiscal usada para los impuestos (vino tranquilo, espumoso, vino generoso, otro producto intermedio, bebidas espirituosas, cerveza, sidra).
• Añada o casilla Sin añada.
• Graduación alcohólica en % vol y volumen por unidad en cl.
• Variedades de uva separadas por comas: cada una se convierte en un valor de filtro. Denominación de origen con sugerencias de los valores existentes para evitar duplicados.

Perfil y cata

Color, región, país de origen, temperatura de servicio (mín. y máx.), potencial de guarda, sellos (ecológico, biodinámico, vino natural, vegano, HVE), premios y puntuaciones (uno por línea). Las notas de cata y el maridaje se introducen por idioma con las pestañas de idioma.

Venta por caja

• Solo por unidad: comportamiento estándar.
• Por unidad o por caja: la ficha de producto ofrece elegir entre botella y caja, con el precio de la caja y el ahorro.
• Solo por caja: la cantidad mínima pasa a ser el tamaño de la caja y las cantidades del carrito se redondean a la caja completa superior (inferior si falta stock).

El descuento por caja, en % o en importe por caja, se crea como descuento por cantidad nativo a partir de una caja completa. La casilla Elegible para la caja surtida aparece cuando la caja surtida está activada.

Volumen por combinación

Para un producto con combinaciones (media botella, botella, mágnum), indique el volumen de cada combinación. Vacía, la combinación usa el volumen del producto. Los impuestos, el alcohol puro del registro y la ficha de cata siguen la combinación.

Países y avisos legales

La pestaña muestra los países activos, con un buscador. Para cada país, Editar permite configurar:

• Se puede entregar alcohol en este país: desmarcada, el cliente con alcohol en el carrito se detiene en el paso de envío con un mensaje, y se muestra un aviso en la ficha de producto.
• Casilla de edad legal al pagar y edad legal: la casilla «Confirmo que tengo al menos N años» se añade a las condiciones que hay que aceptar en el paso de pago.
• Aviso legal por idioma. Un idioma vacío usa el idioma por defecto de la tienda.

El país de entrega se toma de la dirección de entrega del carrito, si no de la primera dirección del cliente conectado, después del país del visitante y después del país por defecto de la tienda.

Tipos de impuestos especiales

Un tipo se define por país, categoría, rango de graduación (límites incluidos, 0 como máximo para sin límite), base de cálculo e importe en la moneda por defecto, sin impuestos. Varios tipos pueden aplicarse al mismo producto y se suman.

• por hectolitro de producto: vinos, espumosos, productos intermedios, sidras.
• por hectolitro de alcohol puro: bebidas espirituosas. Ejemplo: 70 cl al 40 % = 0,0028 hl de alcohol puro.
• por hectolitro y por grado: cervezas.
• por litro de producto y por unidad vendida para otros casos.

Tipos franceses 2026 incluidos: vinos tranquilos 4,19 €/hl, espumosos 10,38 €/hl, sidras 1,46 €/hl, VDN y VDL 52,39 €/hl, otros productos intermedios 209,53 €/hl más 52,39 €/hl de cotización por encima del 18 % vol, alcoholes 1 932,42 €/hl de alcohol puro más 620,47 € de cotización a la seguridad social por encima del 18 % vol, cervezas 4,12 €/hl/grado hasta 2,8 % vol y después 8,24 €. Una botella de 70 cl al 40 % soporta así 7,15 €.

Registro de impuestos especiales

Cada pedido validado registra, para cada producto alcohólico, el país de entrega, la categoría, la combinación, las unidades, el volumen, la graduación, el alcohol puro y el importe de los impuestos al tipo del día. La pestaña Registro filtra por periodo, por país y por pedidos validados, con dos exportaciones CSV: el resumen por país y categoría, y las líneas de pedido. La página de cada pedido muestra además un panel Impuestos especiales.

Importación y exportación CSV

Exportar los productos alcohólicos o Exportar todo el catálogo genera un archivo con el formato de la importación. Complételo en una hoja de cálculo y vuelva a importarlo.

• Separador ; o , detectado automáticamente. Producto encontrado por id_product, si no por reference.
• Una columna ausente o una celda vacía conserva el valor actual. - vacía la añada, las variedades, la denominación y los campos de texto.
• vintage: año o NV. product_type: still_wine, sparkling_wine, vdn_vdl, intermediate, spirits, beer, cider. sale_mode: unit, both, case_only. color: red, white, rose, orange, amber, clear. labels: organic, biodynamic, natural, vegan, hve, separados por comas. origin_country: código ISO (ES, FR…). awards: un premio por valor, separados por |.
• Columnas por idioma: tasting_notes_es, food_pairing_es, tasting_notes_en…

Deje marcada Solo simulación para una primera pasada: el informe indica las líneas leídas, los productos que se actualizarían y los errores con su número de línea, sin guardar nada.

Lo que ve el cliente

• Ficha de producto: resumen del vino, elección de botella o caja, oferta de caja surtida, importe de los impuestos, edad legal y aviso legal, aviso si el país de entrega está bloqueado.
• Pestaña Ficha de cata: tarjetas de características, sellos, notas de cata, maridaje y premios.
• Listados de productos: distintivos de color, añada, sellos, premios y caja surtida.
• Carrito: «2 x caja de 6» bajo las líneas, progreso de la caja surtida, total de impuestos y aviso legal.
• Pago: casilla de edad legal, línea de impuestos en modo añadido.
• Factura PDF: importe de los impuestos, alcohol puro y aviso legal.

Solución de problemas

Los filtros no aparecen

Añada las características a la plantilla de filtros de ps_facetedsearch y asigne la plantilla a las categorías correspondientes. Los valores solo aparecen cuando al menos un producto se ha guardado con sus datos.

La pestaña Ficha de cata o los distintivos no se muestran

Compruebe las opciones de visualización y que el producto está marcado como bebida alcohólica. Los distintivos usan el hook displayProductListReviews y la pestaña displayProductExtraContent: un tema que no los llame no los mostrará.

La línea de impuestos no aparece en el carrito

Compruebe el modo Añadidos en el pago, que el país de entrega tiene tipos para la categoría del producto y que existe el producto técnico de la línea de impuestos (su ID aparece en los ajustes).

La ventana de edad vuelve a aparecer en cada página

El navegador bloquea la cookie dfws_age_ok. Compruebe que ningún gestor de cookies la elimina: es una cookie funcional.

Compatibilidad

• PrestaShop 8.0 a 9.x, el mismo ZIP cubre las dos ramas.
• Filtros mediante características nativas, compatibles con ps_facetedsearch.
• Arquitectura ModuleAdminController, sin dependencias de Composer, PHP 7.2 o superior.
• Interfaz en francés, inglés, español, alemán, italiano, neerlandés, polaco y portugués.