dfomnibus — Conformité Directive Omnibus PrestaShop

Le module dfomnibus met votre boutique PrestaShop en conformité avec la directive européenne 2019/2161 dite Omnibus, en vigueur dans toute l’Union européenne depuis le 28 mai 2022. Il construit automatiquement l’historique de prix de chaque produit et affiche, dès qu’une promotion est active, le prix le plus bas constaté pendant les 30 jours précédents.

Installation

L’installation prend moins de cinq minutes.

1. Téléchargez le fichier dfomnibus_v1.0.1.zip depuis votre espace client DataFirefly.
2. Dans le back-office PrestaShop, allez dans Modules → Gestionnaire de modules → Installer un module.
3. Uploadez le ZIP. PrestaShop crée les tables, génère un jeton cron et enregistre les hooks nécessaires.
4. Cliquez sur Configurer pour ouvrir l’écran de paramétrage.

Programmation du cron quotidien

Le cron amorce l’historique de votre catalogue et garantit la continuité des snapshots quotidiens, même pour les produits dont le prix ne change jamais. Sans cron actif, le module fonctionne mais son historique reste limité aux produits modifiés manuellement.

Récupération du jeton

Ouvrez la page de configuration du module. Le jeton cron affiché est unique à votre installation. Vous obtenez une URL de la forme :

https://votre-boutique.com/modules/dfomnibus/cron.php?token=VOTRE_JETON

Programmation via cron Unix

Ajoutez la ligne suivante à votre crontab, ajustez l’heure selon votre trafic (idéalement en heures creuses) :

15 3 * * * curl -s "https://votre-boutique.com/modules/dfomnibus/cron.php?token=VOTRE_JETON" > /dev/null

Programmation via CLI

Si vous préférez éviter toute exposition HTTP, exécutez le cron directement en ligne de commande :

php /chemin/vers/votre-boutique/modules/dfomnibus/cron.php token=VOTRE_JETON

Configuration des options

Activation de l’affichage

La bascule Activer l’affichage contrôle l’insertion du message de conformité sous le prix produit. Vous pouvez la désactiver temporairement pour maintenir la collecte de l’historique sans afficher la mention en frontend (utile lors d’une bascule ou pendant les tests).

Mode de calcul

Deux modes sont disponibles :

• Strict : le prix de référence est le minimum constaté pendant les 30 jours qui précèdent le début effectif de la promotion en cours. Correspond à la lettre de la directive.
• Conservateur (recommandé par défaut) : le prix de référence est le minimum sur les 30 derniers jours glissants. Interprétation plus défavorable au commerçant mais plus défensive en cas de contrôle.

Période de référence

La période est fixée à 30 jours par défaut, conformément à la directive. Vous pouvez l’augmenter (60, 90 jours) pour être encore plus prudent, mais la valeur minimale reste à 30 jours.

Exclusion des produits récents

L’option Exclure les produits de moins de X jours masque l’affichage sur les produits trop récents. Valeur par défaut : 30 jours. C’est cohérent avec l’esprit de la directive, qui ne s’applique qu’aux produits dont l’historique de prix est significatif.

Restriction UE

Si vous vendez dans et hors UE, cochez Restreindre l’affichage à l’Union européenne. Le module détecte le pays du client dans cet ordre :

1. Adresse de livraison du client connecté
2. Adresse du panier en cours
3. Pays par défaut de la boutique

Si aucune de ces informations n’est disponible, l’affichage est actif par défaut pour éviter tout risque de non-conformité involontaire.

Masquer lorsque prix égal

L’option Masquer si prix identique supprime le message lorsque le prix actuel correspond exactement au prix le plus bas des 30 derniers jours. Utile pour éviter d’afficher une information sans valeur ajoutée pour le consommateur.

Remise réelle

Activez Afficher la remise réelle pour compléter le message par le pourcentage calculé sur la base du prix Omnibus, et non du prix barré. Exemple : un produit à 89 €, en promo à 59 €, avec un prix Omnibus de 65 € affichera -9,2 % de remise réelle au lieu du -33 % calculé sur le prix barré. C’est plus honnête, mais chaque commerçant est libre de choisir.

Graphique

Le graphique 30 jours peut s’afficher dans un onglet dédié de la fiche produit ou en ligne sous le prix. Il est lazy-loaded via IntersectionObserver et ne se déclenche qu’à l’entrée dans le viewport, ce qui garantit un impact nul sur le Core Web Vitals de vos fiches produit.

Suivi par déclinaison

Cochez Suivre les déclinaisons si vos produits ont des prix différents par combinaison (par exemple des tailles XL avec supplément). L’historique est alors segmenté par id_product_attribute et la mention Omnibus s’adapte au prix de la déclinaison sélectionnée.

Rétention

La durée de conservation par défaut est de 365 jours. Au-delà, l’historique est purgé automatiquement lors de l’exécution du cron. La valeur minimale est de 60 jours pour garantir une marge de sécurité par rapport à la fenêtre légale de 30 jours.

Tableau de bord de conformité

Accessible via Modules → Tableau de bord DataFirefly Omnibus, le tableau de bord regroupe :

• Le nombre de produits suivis
• Le total de snapshots enregistrés
• La date et l’heure du dernier passage du cron
• La liste des produits avec, pour chacun, la date de première capture, la date de dernière capture, le prix le plus bas des 30 derniers jours et un indicateur de promotion active

Pour chaque produit, trois actions sont disponibles :

• Voir l’historique : affiche jusqu’à 1000 snapshots horodatés
• Snapshot manuel : force la capture immédiate
• Supprimer l’historique : réinitialise le suivi pour ce produit (à utiliser avec prudence)

Export CSV

Depuis la vue d’historique d’un produit, le bouton Exporter en CSV génère un fichier avec toutes les colonnes horodatées (date, prix HT, prix TTC, devise, boutique, déclinaison, indicateur promo, source de la capture). Format prêt à archiver ou à transmettre à un contrôleur DGCCRF.

Comportement en frontend

Sur la fiche produit, dès qu’une promotion est active, la mention suivante s’affiche automatiquement sous le prix :

Prix le plus bas des 30 derniers jours : 65,00 €

Le message est traduit selon la langue de la boutique (français, anglais, espagnol, allemand). L’affichage utilise le hook standard displayProductPriceBlock et fonctionne avec tous les thèmes respectant les standards PrestaShop (Classic, Hummingbird, Warehouse, Transformer, Panda).

Multi-boutique et multi-devise

L’historique est stocké par combinaison unique (id_product, id_product_attribute, id_shop, id_currency). Chaque boutique de votre installation conserve donc son historique propre, et chaque devise active a sa propre courbe de prix. Aucune conversion à la volée : les montants affichés correspondent exactement à ce qui a été enregistré au moment de la capture.

Dépannage

La mention n’apparaît pas sur la fiche produit

Vérifiez dans l’ordre :

1. L’option Activer l’affichage est-elle bien cochée dans la configuration ?
2. Un cron a-t-il été exécuté au moins une fois ? Sinon, aucun historique n’existe.
3. La restriction UE est-elle activée alors que vous testez depuis un pays hors UE ?
4. L’option Masquer si prix identique est-elle activée et le prix actuel correspond-il au prix minimum ?
5. Le produit a-t-il moins de 30 jours (avec l’option d’exclusion des nouveautés active) ?

Le graphique ne se charge pas

Ouvrez la console navigateur. Le module attend un point d’entrée AJAX exposé par le contrôleur front pricehistory. Vérifiez qu’aucun système de cache ou pare-feu n’intercepte cette route. Si vous utilisez un CDN, autorisez explicitement les URL /module/dfomnibus/pricehistory.

Le cron retourne une erreur 403 ou 401

Le jeton dans l’URL ne correspond pas à celui enregistré. Retournez dans la configuration du module et copiez le jeton actuel. Si vous suspectez une fuite, cliquez sur Régénérer le jeton et mettez à jour votre cron Unix.

Erreur SQL au moment du snapshot

Si vous êtes sur la version 1.0.0, mettez à jour vers la 1.0.1. La version initiale contenait un défaut sur trois requêtes Db::getRow() qui ajoutaient un LIMIT 1 manuel alors que PrestaShop en ajoute déjà un automatiquement, ce qui produisait un LIMIT 1 LIMIT 1 invalide en SQL. Voir le changelog.

FAQ

Le module est-il obligatoire pour ma boutique ?

Oui, si vous vendez à des consommateurs établis dans l’Union européenne et que vous affichez des prix réduits, des promotions, des codes promo, des soldes ou toute mention de réduction. La directive Omnibus s’applique sans seuil de chiffre d’affaires.

Quelle différence avec les CartRule ?

Le module suit uniquement les prix issus des SpecificPrice de PrestaShop (remises produit, remises quantité, remises groupe client). Les règles de panier (CartRule) s’appliquent au checkout et ne modifient pas le prix unitaire affiché en fiche produit : elles sortent donc du périmètre de la directive.

Comment fonctionne le mode strict précisément ?

Le module cherche dans l’historique le dernier snapshot non-promo, puis le premier snapshot promo qui suit. Cette date est le début de la promotion en cours. La fenêtre de référence est alors les 30 jours qui précèdent cette date. Si aucune bascule non-promo vers promo n’est détectable, le module bascule automatiquement sur le mode conservateur.

Puis-je masquer le message sur certains produits ?

Le module s’applique globalement, mais l’option d’exclusion des produits récents et l’option de masquage si prix égal couvrent la majorité des cas où l’affichage n’apporte pas d’information utile.

Compatible avec les prix HT/TTC ?

Oui. Le module enregistre les deux montants (price_tax_excl et price_tax_incl) à chaque snapshot et affiche celui utilisé par la boutique. Si vous basculez d’un mode à l’autre, l’historique reste exploitable.

Changelog

1.0.1 — 14 mai 2026

• Correction : suppression du LIMIT 1 manuel dans trois requêtes Db::getRow() qui produisaient un LIMIT 1 LIMIT 1 invalide en SQL. Affectait la garde d’idempotence de l’enregistrement et la détection du début de promo en mode strict.

1.0.0 — 14 mai 2026

• Sortie initiale
• Capture automatique de l’historique de prix via hooks et cron quotidien
• Affichage du prix le plus bas sur 30 jours sur la fiche produit
• Graphique 30 jours en canvas vanilla, lazy-load, environ 3 Ko
• Tableau de bord de conformité avec statistiques et export CSV
• Modes de calcul strict et conservateur
• Support multi-boutique, multi-devise, multi-déclinaison
• Restriction UE configurable, exclusion des produits récents, option de masquage si prix identique
• Traductions FR, EN, ES, DE