Fecha y Franja de Entrega para PrestaShop: documentación del módulo

Este módulo añade al checkout de PrestaShop 8 y 9 una elección obligatoria de fecha y franja de entrega, limitada por la capacidad real de su taller, con zonas de reparto por día de la semana, tarjeta de mensaje, recogida en tienda y suplementos de entrega. Nombre técnico: dfflorist.

Instalación

1. En Módulos > Gestor de módulos, haga clic en Subir un módulo y suelte el archivo ZIP.
2. Al instalarse, el módulo crea sus tablas, dos franjas de demostración (Mañana 09:00-12:00 y Tarde 14:00-18:00), cuatro diseños de tarjeta ilustrados y un producto oculto Suplemento de entrega (referencia DFFLO-SURCHARGE).
3. Aparece una nueva pestaña Pedidos > Entregas floristería. La barra de navegación del módulo da acceso a la planificación, zonas, franjas, cierres, tarjetas, carga del taller y ajustes.

Ajustes generales

Alcance

• Productos afectados: todos los productos o solo los de las categorías marcadas (flores frescas, plantas, productos frescos).
• Transportistas afectados: deje todo sin marcar para aplicar la planificación a todos. Con una selección, los demás transportistas (flores secas por paquete, por ejemplo) no piden fecha.
• Transportistas de recogida en tienda: véase más abajo.
• Entregar solo dentro de las zonas: en cuanto hay una zona activa, un código postal fuera de todas las zonas no puede pedir con un transportista afectado.
• Distintivo en la ficha de producto y color de acento del bloque del checkout.

Fecha de entrega y plazos

• Fecha obligatoria y franja obligatoria (solo si existen franjas para el día elegido).
• Entrega en el mismo día y su hora límite (HH:MM, zona horaria de la tienda).
• Hora límite de pedido (opcional): un pedido realizado después de esta hora cuenta desde el día siguiente. Ejemplo: 16:00 con un plazo mínimo de un día, un pedido del lunes a las 17:00 no puede entregarse el martes.
• Plazo mínimo en días, tiempo de preparación antes de una franja para pedidos del mismo día, ventana de reserva en días.

Capacidad del taller

• Días de entrega del taller y capacidad por día de la semana en unidades (0 = sin límite diario).
• Carga por defecto por producto: unidades que consume cada artículo. Ajuste una carga distinta por producto en Carga del taller.
• Reserva durante el checkout (20 minutos por defecto): los carritos que han elegido una franja la bloquean durante ese tiempo.
• Aviso de últimas plazas y estados de pedido que liberan capacidad (cancelado, error de pago, reembolsado por defecto).

Tarjeta de mensaje y destinatario

Active la tarjeta, haga obligatorio el mensaje si es necesario, fije la longitud máxima y ofrezca la firma y la opción de tarjeta sin firmar. El teléfono del destinatario puede estar oculto, ser opcional u obligatorio.

Zonas de entrega

Una zona agrupa códigos postales y los días en que se reparte. Patrones admitidos, uno por línea o separados por comas:

• código exacto: 28001
• prefijo: 28*
• rango: 28001..28099

El país es opcional. El plazo adicional se suma al plazo mínimo en zonas alejadas y desactiva la entrega en el mismo día en esa zona. Si varias zonas coinciden, gana la primera zona activa de la lista.

Franjas horarias

Cada franja tiene una etiqueta traducible, una hora de inicio y fin, días de la semana, una capacidad en unidades (0 = solo se aplica la capacidad del día), un suplemento con IVA opcional y, si hace falta, una limitación a ciertas zonas. Sin ninguna franja activa, el cliente solo elige una fecha.

Cierres y días punta

• Cerrado: la fecha queda bloqueada (vacaciones, inventario).
• Día punta o apertura excepcional: la capacidad del día se sustituye por la suya (0 = sin límite) y el día abre aunque normalmente esté cerrado. Si no hay franjas para ese día de la semana, se ofrecen todas las franjas activas.

Tarjetas de mensaje

Cada diseño tiene un nombre, un texto sugerido que rellena el mensaje cuando el cliente elige la tarjeta y una imagen JPG, PNG o WebP de 2 MB como máximo, proporción 3:2 recomendada. Los cuatro diseños incluidos (Cumpleaños, Amor, Gracias, Condolencias) son editables.

Carga del taller por producto

Para cada producto, indique las unidades por artículo (0 para un jarrón o bombones sin preparación) y una preparación adicional en días para los artículos por encargo. Si ese producto está en el carrito, el plazo se amplía y la entrega en el mismo día se desactiva.

Lo que ve el cliente en el checkout

En el paso Envío, el bloque aparece bajo la lista de transportistas, encima del botón Continuar. El cliente elige un día en el calendario (el indicador muestra la carga, un «+» señala un suplemento) y luego una franja que muestra las últimas plazas y su suplemento. Después elige un diseño de tarjeta, escribe su mensaje y su firma y ve cómo se actualiza la vista previa. La elección se guarda automáticamente.

El botón Continuar se bloquea mientras falte información obligatoria, y el servidor lo vuelve a comprobar todo al validar el paso.

Recogida en tienda

Marque sus transportistas Click & collect en Transportistas de recogida en tienda. Para ellos, el bloque pasa a Fecha de recogida: sin zona, sin teléfono del destinatario y sin suplemento. Las franjas limitadas a zonas no se ofrecen. Cuando el cliente cambia de transportista, el bloque se recarga y el suplemento se añade o se quita del carrito.

Suplementos de entrega

Se suman tres fuentes, todas con IVA en la moneda por defecto:

• el suplemento de la franja elegida (exprés, hora fija);
• el suplemento del día de la semana (domingo, por ejemplo);
• el suplemento de mismo día.

El total se añade al carrito en una línea Suplemento de entrega, con la regla de impuestos del producto oculto. Aparece en el resumen, el pedido y la factura. Se retira automáticamente si el cliente pasa a la recogida en tienda o si el carrito ya no contiene productos afectados.

Planificación e impresión

La página Planificación muestra una banda de 14 días con su ocupación, la carga del día seleccionado por franja, las unidades retenidas por carritos en curso y la lista de entregas (hora, zona o mención Recogida en tienda, destinatario, dirección, artículos, tarjeta). Tres acciones:

• Imprimir tarjetas: tarjetas A6, cuatro por hoja A4 con líneas de corte, marcadas después como Impresa;
• Hoja de reparto: ruta por franja, recogidas en tienda en una sección aparte;
• Exportar CSV: separador punto y coma, compatible con Excel.

Pedidos, emails y PDF

• La lista de pedidos del back-office incorpora una columna Fecha de entrega ordenable y filtrable por rango de fechas.
• La ficha del pedido muestra un panel con la fecha, la franja, la zona, el suplemento y la tarjeta, y permite modificarlos (sin control de capacidad).
• En los emails nativos, la fecha se añade tras el nombre del transportista, en el idioma del pedido. Variables para sus plantillas: {dfflo_delivery_date}, {dfflo_delivery_slot}, {dfflo_card_message}.
• La factura PDF muestra la fecha y el teléfono del destinatario, el albarán añade el mensaje.

Actualización desde la 1.0.0

Suba el ZIP 1.1.0 sobre la versión existente desde el gestor de módulos. El script de actualización añade las nuevas columnas y ajustes, crea el producto Suplemento de entrega y asigna las imágenes a las tarjetas de demostración. Sus zonas, franjas y pedidos se conservan.

Preguntas frecuentes

El bloque no aparece en el checkout

Compruebe que el módulo está activado en los ajustes, que el carrito contiene un producto afectado y que el transportista elegido está afectado o declarado como recogida en tienda.

No se ofrece ninguna fecha

Revise los días de entrega del taller, los días de reparto de la zona del cliente, el plazo mínimo y la ventana de reserva. Un producto con preparación adicional también retrasa la primera fecha.

¿Qué ocurre al desinstalar?

Se eliminan las zonas, franjas, tarjetas y fechas guardadas en los pedidos, así como el producto Suplemento de entrega. Las líneas de suplemento ya facturadas permanecen en los pedidos.