# Date et Créneau de Livraison PrestaShop : documentation du module

> Ce module ajoute au checkout de PrestaShop 8 et 9 un choix obligatoire de date et de créneau de livraison, limité par la capacité réelle de votre atelier, avec des…

- Page: <https://www.datafirefly.com/documentation/dfflorist/>
- Langue: fr
- Mis à jour le: 2026-09-24
- Autres langues: [en](https://www.datafirefly.com/en/documentation/dfflorist/index.md), [es](https://www.datafirefly.com/es/documentation/dfflorist/index.md), [de](https://www.datafirefly.com/de/documentation/dfflorist/index.md), [it](https://www.datafirefly.com/it/documentation/dfflorist/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfflorist/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfflorist/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfflorist/index.md)
- Index: <https://www.datafirefly.com/documentation/llms.txt>

Ce module ajoute au checkout de PrestaShop 8 et 9 un choix obligatoire de date et de créneau de livraison, limité par la capacité réelle de votre atelier, avec des zones desservies par jour de la semaine, une carte message, le retrait en boutique et des suppléments de livraison. Nom technique : `dfflorist`.

## Installation

1. Dans **Modules > Gestionnaire de modules**, cliquez sur **Installer un module** et déposez le fichier ZIP.
2. À l'installation, le module crée ses tables, deux créneaux de démonstration (Matin 09:00-12:00 et Après-midi 14:00-18:00), quatre modèles de carte illustrés et un produit caché **Supplément livraison** (référence `DFFLO-SURCHARGE`).
3. Un nouvel onglet **Commandes > Livraisons fleuriste** apparaît. La barre de navigation du module donne accès au planning, aux zones, aux créneaux, aux fermetures, aux cartes, à la charge atelier et aux réglages.

Ne supprimez pas le produit Supplément livraison du catalogue : il porte les suppléments dans le panier. Vous pouvez en modifier le nom, l'image et la règle de taxe.

## Réglages généraux

### Périmètre

- **Produits concernés** : tous les produits, ou seulement ceux des catégories cochées (fleurs fraîches, plantes, produits frais).
- **Transporteurs concernés** : laissez tout décoché pour appliquer le planning à tous les transporteurs. Avec une sélection, les autres transporteurs (envoi en colis de fleurs séchées, par exemple) ne demandent pas de date.
- **Transporteurs de retrait en boutique** : voir plus bas.
- **Livrer uniquement dans les zones** : dès qu'une zone est active, un code postal hors de toutes les zones ne peut pas commander avec un transporteur concerné.
- **Badge sur la fiche produit** et **couleur d'accent** du bloc checkout.

### Date de livraison et délais

- **Date obligatoire** et **créneau obligatoire** (appliqué seulement quand des créneaux existent pour le jour choisi).
- **Livraison le jour même** et son **heure limite** (HH:MM, fuseau de la boutique).
- **Heure limite de commande** (facultative) : une commande passée après cette heure compte à partir du lendemain. Exemple : 16:00 avec un délai minimum d'un jour, une commande à 17:00 le lundi ne peut pas être livrée le mardi.
- **Délai minimum** en jours, **temps de préparation avant un créneau** pour les commandes du jour même, **fenêtre de réservation** en jours.

### Capacité de l'atelier

- **Jours de livraison** de l'atelier et **capacité par jour de semaine** en unités (0 = sans limite journalière).
- **Charge par défaut par produit** : nombre d'unités consommées par article. Réglez une charge différente produit par produit dans **Charge atelier**.
- **Réservation pendant le checkout** (20 minutes par défaut) : les paniers qui ont choisi un créneau le bloquent pendant ce délai.
- **Alerte dernières places** et **statuts de commande qui libèrent la capacité** (annulé, erreur de paiement, remboursé par défaut).

### Carte message et destinataire

Activez la carte, rendez le message obligatoire si besoin, fixez la longueur maximale, proposez la signature et l'option carte non signée. Le téléphone du destinataire peut être masqué, facultatif ou obligatoire.

## Zones de livraison

Une zone regroupe des codes postaux et les jours où elle est livrée. Motifs acceptés, un par ligne ou séparés par des virgules :

- code exact : `06000`
- préfixe : `75*` ou `2A*`
- plage : `06000..06300`

Le pays est facultatif. Le **délai supplémentaire** s'ajoute au délai minimum pour les zones éloignées et désactive la livraison le jour même dans cette zone. Quand plusieurs zones correspondent, la première zone active de la liste l'emporte.

## Créneaux horaires

Chaque créneau a un libellé traduisible, une heure de début et de fin, des jours de la semaine, une capacité en unités (0 = seule la capacité du jour s'applique), un **supplément TTC** facultatif et, si besoin, une limitation à certaines zones. Sans aucun créneau actif, le client choisit seulement une date.

## Fermetures et jours de pointe

- **Fermé** : la date est bloquée (congés, inventaire).
- **Jour de pointe ou ouverture exceptionnelle** : la capacité du jour est remplacée par la vôtre (0 = sans limite), et le jour ouvre même s'il est habituellement fermé. Si aucun créneau n'est prévu ce jour de la semaine, tous les créneaux actifs sont proposés.

## Cartes message

Chaque modèle a un nom, un texte suggéré qui préremplit le message quand le client choisit la carte, et un visuel JPG, PNG ou WebP de 2 Mo maximum, au format 3:2 conseillé. Les quatre modèles fournis (Anniversaire, Amour, Merci, Condoléances) sont modifiables.

## Charge atelier par produit

Pour chaque produit, indiquez les **unités par article** (0 pour un vase ou des chocolats qui ne demandent pas de préparation) et une **préparation supplémentaire** en jours pour les articles sur commande. Quand un tel produit est dans le panier, le délai s'allonge d'autant et la livraison le jour même est désactivée.

## Ce que voit le client au checkout

À l'étape Livraison, le bloc s'affiche sous la liste des transporteurs, au-dessus du bouton Continuer. Le client choisit un jour dans le calendrier (la jauge indique la charge, un « + » signale un supplément), puis un créneau qui affiche les dernières places et son supplément. Il choisit ensuite un modèle de carte, écrit son message et sa signature et voit l'aperçu de la carte se mettre à jour. Le choix est enregistré automatiquement.

Le bouton Continuer est bloqué tant qu'une information obligatoire manque, et le serveur revérifie tout au moment de valider l'étape.

## Retrait en boutique

Cochez vos transporteurs Click & collect dans **Transporteurs de retrait en boutique**. Pour eux, le bloc devient **Date de retrait** : pas de zone, pas de téléphone du destinataire, pas de supplément. Les créneaux limités à des zones ne sont pas proposés. Quand le client change de transporteur, le bloc se recharge et le supplément est ajouté ou retiré du panier.

## Suppléments de livraison

Trois sources s'additionnent, toutes en TTC dans la devise par défaut :

- le supplément du **créneau** choisi (express, heure fixe) ;
- le supplément du **jour de la semaine** (le dimanche, par exemple) ;
- le supplément **jour même**.

Le total est ajouté au panier sur une ligne **Supplément livraison**, avec la règle de taxe du produit caché. Il apparaît dans le récapitulatif, la commande et la facture. Le supplément est retiré automatiquement si le client passe au retrait en boutique ou si le panier ne contient plus de produit concerné.

## Planning et impression

La page **Planning** affiche une bande de 14 jours avec leur remplissage, la charge du jour sélectionné par créneau, les unités réservées par des paniers en cours et la liste des livraisons (horaire, zone ou mention Retrait en boutique, destinataire, adresse, articles, carte). Trois actions :

- **Imprimer les cartes** : cartes A6, quatre par feuille A4 avec traits de coupe, marquées Imprimée ensuite ;
- **Feuille de livraison** : tournée par créneau, retraits en boutique dans une section séparée ;
- **Export CSV** : séparateur point-virgule, compatible Excel.

## Commandes, emails et PDF

- La liste des commandes du back-office gagne une colonne **Date de livraison** triable et filtrable par plage de dates.
- La fiche commande affiche un panneau avec la date, le créneau, la zone, le supplément et la carte, et permet de les modifier (sans contrôle de capacité).
- Dans les emails natifs, la date est ajoutée après le nom du transporteur, dans la langue de la commande. Variables disponibles pour vos modèles : `{dfflo_delivery_date}`, `{dfflo_delivery_slot}`, `{dfflo_card_message}`.
- La facture PDF affiche la date et le téléphone du destinataire, le bon de livraison ajoute le message.

## Mise à jour depuis la 1.0.0

Installez le ZIP 1.1.0 par-dessus la version existante depuis le gestionnaire de modules. Le script de mise à jour ajoute les nouvelles colonnes et réglages, crée le produit Supplément livraison et attache les visuels aux cartes de démonstration. Vos zones, créneaux et commandes sont conservés.

## Questions fréquentes

### Le bloc n'apparaît pas au checkout

Vérifiez que le module est activé dans les réglages, que le panier contient un produit concerné et que le transporteur sélectionné est concerné ou déclaré en retrait en boutique.

### Aucune date n'est proposée

Contrôlez les jours de livraison de l'atelier, les jours desservis de la zone du client, le délai minimum et la fenêtre de réservation. Un produit avec préparation supplémentaire décale aussi la première date.

### Que se passe-t-il à la désinstallation ?

Les zones, créneaux, cartes et dates enregistrées sur les commandes sont supprimés, ainsi que le produit Supplément livraison. Les lignes de supplément déjà facturées restent sur les commandes.
