Propina / Tip en el Checkout — Guía completa
Instalar, configurar y usar la propina opcional (porcentaje, importe fijo o libre) en el carrito y el checkout para PrestaShop 8 y 9.
Descripción general
El módulo Propina / Tip en el Checkout (dftip) añade en la página del carrito de tu tienda un bloque «Añadir una propina» que permite al cliente dejar una propina opcional: un porcentaje, un importe fijo o un importe libre. La propina se integra después de forma nativa en el pedido, sin sobrescritura del núcleo de PrestaShop. Ideal para artesanos, creadores y restauración.
La propina la transporta una línea de pedido dedicada cuyo precio se fija para el carrito actual mediante un specific_price limitado al carrito. Por tanto fluye limpiamente hacia el total pagado, el IVA, la factura y los posibles abonos — exactamente el mecanismo que usa PrestaShop para los precios personalizados al editar un pedido.
Compatibilidad
- PrestaShop 8.0 a 9.x
- PHP 7.4 a 8.3
- Tienda única y multitienda
- 5 idiomas: FR, EN, ES, DE, IT
- Tema Classic y temas personalizados
- Sin dependencias (ni Composer ni framework)
Instalación
- En el back-office, abre Módulos > Gestor de módulos.
- Haz clic en Subir un módulo y selecciona el archivo
dftip.zip. - Una vez instalado, haz clic en Configurar.
Al instalarse, el módulo registra sus hooks, crea un producto virtual oculto «Propina» (fuera del catálogo y de la búsqueda, sin envío) destinado a transportar el importe de la propina, y aplica sus ajustes por defecto: propina en porcentaje 5, 10, 15 %, importe libre permitido, sin IVA.
Configuración
Todos los ajustes están en la página de configuración del módulo.
- Activar el módulo: muestra u oculta el bloque de propina.
- Título y subtítulo: textos del bloque, personalizables y traducibles en cada idioma.
- Tipo de propina: Porcentaje, Importe fijo o Ambos.
- Porcentajes propuestos: lista separada por comas, por ejemplo
5,10,15. - Importes fijos propuestos: lista separada por comas en la moneda por defecto, por ejemplo
1,2,5. - Base de cálculo del porcentaje: total de productos con IVA o sin IVA.
- Permitir un importe libre: añade un campo de entrada libre.
- Importe libre mínimo / máximo: límites aplicados al importe libre.
- Impuesto aplicado a la propina: Sin impuesto por defecto; puedes seleccionar un grupo de impuestos si tu caso lo requiere.
- Mostrar el bloque en la página del carrito: activa el selector en la página del carrito.
El título y el subtítulo son campos multilingües: elige cada idioma en el selector del campo para adaptar el texto. Se proporcionan valores por defecto en los cinco idiomas al instalar.
Funcionamiento
Cómo se añade la propina
Cuando el cliente elige una propina, el módulo memoriza su elección (tipo y valor) para el carrito actual, añade la línea «Propina» al carrito y fija su precio exacto mediante un specific_price limitado a ese carrito. La operación se realiza por Ajax, sin recargar, y el total se actualiza de inmediato.
Porcentaje recalculado automáticamente
Para una propina en porcentaje, el importe sigue el contenido del carrito: si el cliente añade o quita un producto, el módulo recalcula el importe y resincroniza la línea antes del pago. La base (total de productos con o sin IVA) se define en la configuración y siempre excluye la propia línea de propina y los gastos de envío.
Integración nativa en el pedido
Como la propina es una línea de carrito real, se incluye en el importe realmente pagado y se captura en el pedido al validarlo. Aparece limpiamente en la factura, la contabilidad y los posibles abonos, sin sobrescritura del núcleo.
IVA de la propina
Como una propina voluntaria suele estar fuera del ámbito del IVA, la línea se entrega sin impuesto por defecto. Si asocias un grupo de impuestos a la propina, el importe introducido o calculado se trata como una base sin impuesto.
El producto «Propina» creado por el módulo no debe eliminarse ni hacerse visible en el catálogo: solo sirve para transportar el importe de la propina. Está oculto de la búsqueda y de los listados y se mantiene sin envío.
Quitar la propina
El cliente puede quitar su propina en cualquier momento con la opción «Sin propina». Si elimina manualmente la línea «Propina» del carrito, el módulo también borra la elección memorizada para no volver a añadirla.
FAQ y resolución de problemas
El bloque de propina no aparece en la página del carrito
Comprueba que el módulo está activado y que la opción «Mostrar el bloque en la página del carrito» está marcada. Luego vacía la caché de PrestaShop (Parámetros avanzados > Rendimiento) y, durante las pruebas, desactiva la combinación/compresión (CCC). El bloque aparece cuando el carrito contiene al menos un artículo.
La propina en porcentaje no se actualiza cuando cambio el carrito
El recálculo se produce al guardar el carrito y al cargar la página del carrito o del checkout. Si modificas el carrito mediante una acción Ajax del tema, recarga la página: el importe se resincronizará antes del pago.
¿La propina aparece en la factura?
Sí. La propina es una línea de pedido completa: aparece en el detalle del pedido y en la factura, y se tiene en cuenta en los abonos.
¿Puedo aplicar IVA a la propina?
Sí, seleccionando un grupo de impuestos en la configuración. Por defecto la propina es sin impuesto, en línea con la naturaleza de una propina voluntaria.
¿Es compatible con PrestaShop 9 y multitienda?
Sí. El módulo es compatible con PrestaShop 8 y 9, en tienda única y multitienda, y multilingüe, sin dependencia de Composer ni framework.