Polonais 
Anglais Estimated Delivery Date est un module Magento 2 qui affiche au client la date estimée d’expédition et de livraison avant même la validation de la commande. L’information apparaît sur la fiche produit, dans le panier, dans les e-mails ainsi que dans le panneau d’administration au niveau de la commande.
La solution aide à transformer l’incertitude liée à la livraison en une promesse d’achat claire. Le client voit quand la boutique prévoit d’expédier le produit et quand il peut s’attendre à sa livraison, tandis que l’équipe de la boutique dispose d’outils pour maintenir cette information également après l’achat.
Les clients des boutiques en ligne prennent de plus en plus souvent leur décision d’achat non seulement sur la base du prix, mais aussi sur le délai de traitement. L’absence d’une information claire sur la livraison entraîne des abandons de panier, des questions au service client et une tension inutile après l’achat.
Le module répond aux principaux besoins des acheteurs :
Ainsi, le client n’a pas besoin de rechercher lui-même l’information dans les conditions générales, la FAQ ni de contacter le service client pour confirmer le délai de livraison estimatif.
Le module soutient les ventes et la gestion des commandes à plusieurs étapes du parcours d’achat. Sur la fiche produit, il renforce la décision d’achat, dans le panier, il réduit l’incertitude avant la finalisation de la transaction, et après l’achat, il aide à maintenir une communication cohérente avec le client.
Principaux avantages pour la boutique :
Estimated Delivery Date calcule la date estimée sur la base du temps de préparation, du temps de transport, de l’heure de cut-off, des jours fériés, des week-ends, des règles et des paramètres attribués directement au produit. Le module peut afficher une date unique ou une plage de dates, selon la configuration et le résultat du calcul.
L’administrateur peut gérer les messages globalement pour chaque store view et, si nécessaire, les remplacer au niveau du produit. Cela permet de gérer aussi bien les produits disponibles immédiatement que les articles commandés à la demande, les produits nécessitant une préparation plus longue ou les marchandises ayant un délai de transport non standard.
Sur la page produit, le module affiche un message avec la date de livraison estimée. L’information peut être basée sur des paramètres globaux, des règles ou les attributs d’un produit donné. Pour les produits dont la date ne doit pas être affichée, il est possible de désactiver le message directement dans les données du produit.
Dans le panier, le module affiche la date estimée pour la commande. Ainsi, le client voit aussi l’information de livraison à la dernière étape avant de passer à la finalisation de l’achat.
Le module prend en charge un widget qui décompte le temps restant jusqu’à l’heure limite pour une expédition le jour même. Il peut indiquer au client combien de temps il lui reste pour passer commande afin que la boutique puisse encore l’expédier aujourd’hui.
Le widget peut fonctionner comme un élément inline à côté du message de livraison ou comme un élément fixed collé dans un coin sélectionné de l’écran. Après le dépassement de l’heure de cut-off, il peut être masqué ou remplacé par un message après cut-off.
L’algorithme tient compte des jours non travaillés définis dans la configuration ainsi que des jours fériés enregistrés dans le module. Ainsi, la date estimée ne repose pas uniquement sur une simple addition du nombre de jours calendaires.
Sont pris en charge :
L’administrateur peut importer les jours fériés et les jours non travaillés depuis un fichier CSV. Cela facilite la préparation du calendrier des livraisons avant les périodes de fêtes, les longs week-ends ou les interruptions d’entrepôt.
L’import prend en charge les jours isolés, les plages de dates ainsi que les dates récurrentes. Les enregistrements peuvent être limités notamment à un store view, un pays, une région, une méthode de livraison ou une source MSI.
Le module contient un tableau de règles qui peuvent définir le temps de préparation, le temps de transport, le message client, le niveau de confiance ainsi que la priorité. Les règles peuvent être liées au produit, à la catégorie, au store view ou à la méthode de livraison.
Ainsi, la boutique peut différencier les dates pour des groupes de produits ou des méthodes d’expédition sélectionnés sans modifier la configuration globale.
Le module ajoute un groupe d’attributs produit Estimated Delivery Date. Depuis l’édition du produit, l’administrateur peut définir un temps de préparation individuel, un temps de transport, un message personnalisé, un niveau de confiance de la date ou désactiver totalement l’affichage de la date pour ce produit.
Cela est utile pour les produits commandés à la demande, les produits lourds, non standard, personnalisés ou disponibles selon un modèle logistique différent du reste du catalogue.
Après la validation de la commande, le module enregistre la date calculée sous forme de snapshot sur la commande et ses lignes. Cela signifie qu’un changement ultérieur de configuration, de calendrier ou d’attributs produit ne modifie pas l’information historique enregistrée sur la commande.
Le snapshot comprend notamment la date estimée d’expédition, la date estimée de livraison, le message client, le code de la règle utilisée, le niveau de confiance ainsi que l’heure du calcul.
Dans la vue de la commande, l’administrateur voit la section Estimated Delivery Date. Il peut modifier manuellement la date d’expédition, la date de livraison et le message client, indiquer la raison du retard et envoyer au client un message avec des excuses et une nouvelle date.
Le module enregistre l’historique des modifications, ce qui permet à l’équipe de la boutique de vérifier l’ancienne et la nouvelle date, la raison du changement ainsi que l’information indiquant si l’e-mail a été envoyé.
Le module ajoute un bloc avec la livraison estimée aux e-mails de commande, de facture et d’expédition. Il peut également envoyer un e-mail séparé après le paiement de la commande ainsi qu’un message après une modification manuelle de la date de livraison.
La communication après modification de la date peut contenir l’ancienne date, la nouvelle date, un message d’excuses par défaut ainsi que la raison du retard saisie par l’administrateur.
Le module met à disposition des endpoints REST pour récupérer les estimations d’un produit, du panier client, du panier invité ainsi que d’une commande. Cela permet d’utiliser les données de livraison estimée dans des intégrations avec le frontend, des systèmes externes ou des applications mobiles.
La date peut être visible aux endroits suivants :
Le module est particulièrement adapté aux boutiques où le délai de traitement dépend de la disponibilité du produit, du fonctionnement de l’entrepôt, de la méthode de livraison ou du calendrier des jours non travaillés.
Exemples d’utilisation :
Estimated Delivery Date structure la communication sur les délais de livraison dans Magento 2. Il réunit dans un seul module le calcul des dates, l’affichage des messages au client, la configuration produit, la gestion des jours fériés, le snapshot de commande, les e-mails ainsi que l’API.
Pour le client, cela signifie une meilleure transparence avant l’achat. Pour la boutique, cela signifie moins de questions, un meilleur contrôle des attentes et une communication plus professionnelle après la validation de la commande.
Ce document décrit l’installation du module Estimated Delivery Date, la configuration dans le panneau d’administration de Magento 2 ainsi que la gestion des attributs ajoutés au produit. La description des champs est basée sur l’implémentation actuelle du module.
Le package est destiné à une installation via Composer.
Exemple d’installation depuis un dépôt VCS :
WhatsApp
+48608012047composer config repositories.kowal.estimated.delivery.date vcs https://github.com/kowalco/estimated-delivery-datecomposer require kowal/module-estimated-delivery-datebin/magento module:enable Kowal_EstimatedDeliveryDatebin/magento setup:upgradebin/magento cache:flushAprès le déploiement en production, il convient d’exécuter le processus standard de compilation et de déploiement des ressources statiques conforme au projet Magento :
bin/magento setup:di:compilebin/magento setup:static-content:deploybin/magento cache:flushLa configuration du module est disponible dans le panneau d’administration :
Stores > Configuration > Sales > Estimated Delivery DateLes paramètres sont disponibles aux niveaux default, website et store view, conformément au mécanisme de configuration de Magento.
Active ou désactive le module pour le périmètre de configuration concerné. Lorsque le champ est désactivé, les messages sur le frontend ne doivent pas être affichés.
Valeur par défaut : Yes.
Fuseau horaire utilisé pour le calcul des dates et de l’heure de cut-off. Si le champ reste vide, le module utilise le fuseau horaire de la boutique configuré dans Magento.
Exemple de valeur :
Europe/WarsawUtilisation : utile lorsque la boutique fonctionne avec plusieurs store views ou lorsque l’entrepôt qui traite les expéditions travaille dans un fuseau horaire différent de la configuration par défaut de la boutique.
Message de remplacement utilisé comme texte de secours lorsque la boutique souhaite afficher une information générale au lieu d’une date précise.
Valeur par défaut :
Nous confirmerons le délai de livraison après la validation de la commande.Format de date utilisé lors du rendu des messages pour le client. Le champ utilise le modèle ICU pris en charge par le formatage des dates de Magento.
Valeur par défaut :
EEEE, d MMMMExemple de résultat :
lundi 18 maiNombre minimal de jours ouvrés nécessaires pour préparer la commande avant l’expédition.
Valeur par défaut : 1.
Utilisation : détermine la date d’expédition la plus tôt possible.
Nombre maximal de jours ouvrés nécessaires pour préparer la commande.
Valeur par défaut : 1.
Utilisation : permet de créer une plage de dates d’expédition lorsque la préparation peut durer plus longtemps que le temps minimal.
Nombre minimal de jours ouvrés de transport entre l’expédition et la livraison.
Valeur par défaut : 1.
Utilisation : détermine la date de livraison la plus tôt possible après l’expédition.
Nombre maximal de jours ouvrés de transport.
Valeur par défaut : 2.
Utilisation : permet d’afficher une plage de livraison, par exemple lorsque le transporteur livre généralement en 1 à 2 jours ouvrés.
Heure limite pour l’expédition le jour même. La valeur doit être saisie au format HH:MM.
Valeur par défaut :
14:00Si l’heure actuelle est postérieure au cut-off, le module reporte le début du calcul au jour ouvré suivant.
Liste des jours de la semaine considérés comme non travaillés. Les valeurs doivent être saisies sous forme de numéros ISO séparés par des virgules :
1 - lundi,2 - mardi,3 - mercredi,4 - jeudi,5 - vendredi,6 - samedi,7 - dimanche.Valeur par défaut :
6,7Utilisation : ignore par défaut les samedis et dimanches lors du calcul des jours ouvrés.
Tampon de sécurité supplémentaire ajouté au temps de transport.
Valeur par défaut : 0.
Utilisation : utile pendant les périodes de forte hausse des commandes, en cas d’activité instable des transporteurs ou pour les produits nécessitant une promesse de livraison plus prudente.
Active l’affichage de la date estimée sur la fiche produit.
Valeur par défaut : Yes.
Active l’affichage de la date estimée dans le panier.
Valeur par défaut : Yes.
Active la section Estimated Delivery Date dans la vue de la commande du panneau d’administration.
Valeur par défaut : Yes.
Active le widget de compte à rebours jusqu’à l’heure de cut-off sur la fiche produit.
Valeur par défaut : Yes.
Active le widget cut-off dans le panier.
Valeur par défaut : No.
Définit le mode d’affichage du widget cut-off.
Valeurs disponibles :
Inline - le widget est affiché à l’emplacement d’insertion du bloc,Fixed - le widget est fixé dans le coin de l’écran sélectionné,Inline + Fixed - le widget fonctionne à la fois comme élément inline et fixed.Valeur par défaut : Inline.
Définit la position du widget fixed.
Valeurs disponibles :
Bottom Right - coin inférieur droit,Bottom Left - coin inférieur gauche,Top Right - coin supérieur droit,Top Left - coin supérieur gauche.Valeur par défaut : Bottom Right.
Définit les types d’appareils sur lesquels le widget fixed doit être visible.
Valeurs disponibles :
Desktop,Mobile,Desktop + Mobile.Valeur par défaut : Desktop + Mobile.
Définit le comportement du widget après le dépassement de l’heure de cut-off.
Valeurs disponibles :
Hide Widget - le widget sera masqué,Show After Cut-off Message - le widget affichera un message après cut-off.Valeur par défaut : Show After Cut-off Message.
Les messages prennent en charge des variables simples au format {{nazwa_zmiennej}}.
Variables disponibles pour les messages de livraison :
{{ship_date}},{{ship_date_from}},{{ship_date_to}},{{delivery_date}},{{delivery_date_from}},{{delivery_date_to}}.Variables disponibles pour les messages cut-off :
{{cutoff_time}},{{cutoff_countdown}}.Modèle de message utilisé lorsque le calcul renvoie une plage de dates de livraison.
Valeur par défaut :
Livraison estimée : {{delivery_date_from}} - {{delivery_date_to}}Modèle de message utilisé lorsque la date de livraison la plus tôt et la plus tardive sont identiques.
Valeur par défaut :
Livraison estimée : {{delivery_date}}Message affiché avant le dépassement de l’heure de cut-off.
Valeur par défaut :
Commandez dans les {{cutoff_countdown}} à venir et nous expédierons encore aujourd’hui.Message affiché après le dépassement de l’heure de cut-off si le champ After Cut-off Behavior est défini pour afficher un message.
Valeur par défaut :
Les expéditions du jour sont déjà closes. Nous expédierons le prochain jour ouvré.Active l’envoi d’un e-mail séparé après le paiement de la commande.
Valeur par défaut : No.
Utilisation : permet de confirmer au client que le paiement a été reçu et que la commande est entrée en traitement.
Modèle d’e-mail envoyé après le paiement.
Valeur par défaut :
estimated_delivery_date_emails_payment_templateExpéditeur du message après paiement. Le champ utilise les identités e-mail configurées dans Magento.
Valeur par défaut :
salesPermet d’envoyer au client un message après modification manuelle de la date de livraison dans le panneau d’administration.
Valeur par défaut : Yes.
Modèle d’e-mail envoyé après modification de la date de livraison.
Valeur par défaut :
estimated_delivery_date_emails_date_change_templateExpéditeur du message relatif au changement de date de livraison.
Valeur par défaut :
salesTexte d’excuses par défaut utilisé dans le message concernant le changement de date de livraison.
Valeur par défaut :
Nous vous prions de nous excuser, le délai de traitement de votre commande a été modifié.Exige la saisie d’une raison du retard lors d’une modification manuelle de la date dans la vue de la commande.
Valeur par défaut : No.
Utilisation : impose une meilleure discipline opérationnelle et facilite l’explication ultérieure des changements de date.
Envoie automatiquement un message au client après modification manuelle de la date de livraison.
Valeur par défaut : No.
Si le champ est désactivé, l’administrateur peut décider de l’envoi en cochant la case dans la vue de la commande.
Le module ajoute au produit un groupe d’attributs Estimated Delivery Date. Les attributs sont optionnels et ont une portée store view. S’ils ne sont pas renseignés, le module utilise les règles ou la configuration globale.
Les attributs produit ont priorité sur les règles calculées pour le produit. Cela permet de remplacer rapidement la date pour un SKU spécifique sans modifier les paramètres globaux.
Les attributs sont disponibles dans le panneau d’administration Magento :
Catalog > Products > Edit Product > Estimated Delivery DateSi le groupe n’est pas visible dans un attribute set donné, il convient de vérifier la configuration de l’ensemble d’attributs produit dans Magento.
Code attribut :
edd_processing_days_minNombre minimal de jours ouvrés nécessaires pour préparer un produit donné.
Utilisation : un produit disponible immédiatement peut avoir la valeur 0, tandis qu’un produit commandé auprès d’un fournisseur peut avoir par exemple 3.
Code attribut :
edd_processing_days_maxNombre maximal de jours ouvrés de préparation pour un produit donné.
Utilisation : si la préparation est variable, il est possible de définir par exemple un minimum de 2 et un maximum de 5 afin que le message affiche une plage plus prudente.
Code attribut :
edd_transport_days_minNombre minimal de jours ouvrés de transport pour un produit donné.
Utilisation : pour les produits expédiés par un autre transporteur ou depuis un autre entrepôt.
Code attribut :
edd_transport_days_maxNombre maximal de jours ouvrés de transport pour un produit donné.
Utilisation : pour les produits volumineux, sur palette ou nécessitant une logistique spéciale.
Code attribut :
edd_static_textMessage personnalisé pour le client affiché à la place du message issu de la configuration globale.
Exemples :
Produit fabriqué à la commande. Nous confirmerons le délai de livraison après l’achat.Livraison estimée : {{delivery_date_from}} - {{delivery_date_to}}L’attribut peut utiliser les mêmes variables de date que celles disponibles dans les messages globaux de livraison.
Code attribut :
edd_confidenceNiveau de confiance de la date enregistré avec la promesse de livraison.
Valeurs recommandées :
guaranteed - date garantie,likely - date probable,estimated - date indicative,unknown - absence d’estimation fiable.L’implémentation actuelle enregistre cette valeur dans le résultat du calcul et dans les snapshots. Elle peut être utilisée par les modèles, les intégrations ou une personnalisation ultérieure des messages.
Code attribut :
edd_disableDésactive l’affichage de la livraison estimée pour un produit donné sur la fiche produit et désactive également pour lui le widget cut-off.
Utilisation : produits indisponibles, produits nécessitant un devis de livraison individuel, services, produits en prévente ou marchandises pour lesquelles la boutique ne souhaite pas faire de promesse de date.
Pour la plupart des produits, les attributs peuvent être laissés vides et la configuration globale peut être utilisée. Il est utile de les renseigner uniquement lorsqu’un produit donné diffère réellement du processus logistique standard.
Approche type :
Disable Estimated Delivery Date ou définir un message explicatif.Après modification des attributs produit, il convient de rafraîchir le cache Magento si la boutique utilise le cache complet de page ou des mécanismes de cache supplémentaires dans le thème.
L’import est disponible dans le panneau d’administration :
Sales > Estimated Delivery Date > Import HolidaysLe fichier CSV doit contenir les colonnes :
code,name,typeColonnes optionnelles :
date_from,date_to,month,day,country,region,postcode_pattern,shipping_method,source_code,store_id,scope,is_activeTypes pris en charge dans la colonne type :
single - date unique, nécessite date_from,range - plage de dates, nécessite date_from et date_to,recurring - date récurrente, nécessite month et day.Description de certains champs d’import :
code - code unique du jour férié ou du jour non travaillé,name - nom visible dans l’administration,type - type d’entrée : jour unique, plage ou date récurrente,date_from - date de début au format YYYY-MM-DD,date_to - date de fin au format YYYY-MM-DD,month - mois pour une entrée récurrente,day - jour du mois pour une entrée récurrente,country - code pays,region - région,postcode_pattern - motif de code postal,shipping_method - méthode de livraison,source_code - code source MSI,store_id - identifiant du store view,scope - périmètre d’application, par défaut shipping_delivery,is_active - statut d’activation de l’entrée.Exemple :
code,name,type,date_from,date_to,month,day,country,store_id,is_activechristmas_2026,Christmas Break,range,2026-12-24,2026-12-26,,,,,1new_year,New Year,recurring,,,1,1,,,1La section Estimated Delivery Date est disponible dans la vue de la commande si le champ Show in Admin Order est activé.
L’administrateur peut modifier :
Si l’e-mail après modification de la date est activé, l’administrateur peut cocher l’envoi d’un message avec des excuses et la nouvelle date. Le module enregistre l’historique des modifications avec l’ancienne et la nouvelle date, la raison ainsi que l’information sur l’envoi de l’e-mail.
Le module met à disposition les endpoints suivants :
GET /rest/V1/estimated-delivery/product/:skuGET /rest/V1/estimated-delivery/cart/:cartIdGET /rest/V1/estimated-delivery/guest-cart/:cartIdGET /rest/V1/estimated-delivery/order/:orderIdL’API renvoie notamment la date d’expédition, la date de livraison, le message, le niveau de confiance, le code de la règle, la date de calcul et la source des données. Pour une commande, le module renvoie le snapshot enregistré s’il existe.