Digital Product Passport (DPP) — Guide complet

Le module DataFirefly — Digital Product Passport (dfdpp) ajoute à votre boutique PrestaShop 8 ou 9 un système complet de passeport numérique produit conforme au règlement européen ESPR (Ecodesign for Sustainable Products Regulation), applicable progressivement à partir de 2027 pour le textile, les batteries et l’électronique.

Chaque produit reçoit un passeport avec identifiant unique (UUID), une page publique multilingue accessible par QR code, un registre de composants (nomenclature / BOM), un journal des événements de cycle de vie et une gestion des certificats de conformité.

Prérequis

• PrestaShop 8.0.0 à 9.x
• PHP 7.4 minimum (8.1+ recommandé)
• Extension GD activée (génération des QR codes en secours si Endroid n’est pas disponible)
• Compatible multiboutique et multilingue (FR / EN / ES / DE / IT inclus)

Installation

1. Dans le back-office, ouvrez Modules > Gestionnaire de modules.
2. Cliquez sur Installer un module et téléversez dfdpp.zip.
3. Le module crée automatiquement ses tables, son menu Passeports produit sous Catalogue et enregistre ses routes publiques.

Configuration

Ouvrez Modules > dfdpp > Configurer. Trois blocs sont disponibles :

Paramètres généraux

• Activer le module — interrupteur global.
• Création automatique — génère un passeport brouillon à chaque enregistrement de produit.
• Catégorie ESPR par défaut — textile, batterie, électronique, mobilier, chaussure ou général.
• Affichage public — active la page publique /dpp/{uuid}.
• Onglet fiche produit — affiche le passeport dans un onglet de la fiche produit.
• Export JSON public — autorise le téléchargement du passeport au format JSON.

QR code

• Taille (par défaut 220 px) et marge (10 px).
• Niveau de correction d’erreur — M recommandé (équilibre densité / robustesse).

Informations société

Nom, numéro de TVA, adresse et pays de l’opérateur économique responsable — ces informations apparaissent sur la page publique du passeport, comme l’exige l’ESPR.

Créer un passeport

Création automatique

Si l’option est activée, un passeport en statut brouillon est créé à chaque enregistrement de produit, avec la catégorie ESPR par défaut. Il ne devient visible publiquement qu’une fois publié manuellement.

Création manuelle

1. Ouvrez Catalogue > Passeports produit > Passeports.
2. Cliquez sur Ajouter, sélectionnez le produit (et la déclinaison si nécessaire).
3. Renseignez les champs puis enregistrez : un UUID v4 unique est généré automatiquement.

Données du passeport

Le formulaire est organisé en cinq blocs :

• Identification — produit, déclinaison, catégorie ESPR, GTIN, fabricant, pays d’origine, date de production, numéro de lot.
• Durabilité — empreinte carbone (kg CO₂e), score de recyclabilité, pourcentage de contenu recyclé, indice de réparabilité, durée de vie attendue, garantie.
• Contenus multilingues — composition des matériaux, instructions d’entretien, consignes de tri et de fin de vie, informations de réparation, informations de sécurité, certificats de conformité (six champs texte riches, traduisibles dans chaque langue de la boutique).
• Composants, événements et documents — gérés en AJAX directement dans la fiche passeport (voir ci-dessous).
• Champs personnalisés — un objet JSON libre pour toute donnée sectorielle supplémentaire.

Registre des composants (BOM)

Chaque passeport peut recenser sa nomenclature complète : nom du composant, matériau, poids (g), pourcentage du produit, part recyclée, caractère recyclable, dangerosité, numéro CAS, fournisseur et pays. Les composants peuvent être imbriqués (composant parent / sous-composant) pour modéliser des assemblages.

Le menu Catalogue > Passeports produit > Registre offre une vue transversale de tous les composants de la boutique, filtrable par matériau, dangerosité ou fournisseur — pratique pour les audits REACH.

Événements de cycle de vie

Le journal retrace la vie du produit : conception, matière première, fabrication, contrôle qualité, distribution, première vente, revente, réparation, reconditionnement, recyclage, fin de vie. Chaque événement porte une date, un lieu, un acteur (nom + rôle), une description et une URL de preuve facultative.

La vue Catalogue > Passeports produit > Événements centralise tous les événements avec filtre par type.

Documents et certificats

Attachez à chaque passeport les certificats exigés : déclaration CE, REACH, RoHS, DEEE, règlement batteries UE, OEKO-TEX, GOTS, Écolabel, FSC, ISO 14001 / 9001, PEF, EPD ou autre. Chaque document porte un numéro, un émetteur, des dates de validité et une URL de fichier.

Score de conformité ESPR

Le module évalue chaque passeport selon des règles propres à sa catégorie ESPR et affiche un score sur 100 accompagné d’un niveau :

• Conforme — score ≥ 90 sans point bloquant.
• Partiel — score ≥ 60.
• Brouillon — données incomplètes.
• Non conforme — points bloquants présents.

La liste des vérifications et des points bloquants est détaillée dans la fiche passeport ; le bouton Recalculer actualise le score après modification.

Page publique et QR code

Chaque passeport publié est accessible à l’adresse https://votre-boutique.com/dpp/{uuid} et son QR code PNG à /dpp/{uuid}/qr.png (paramètre ?size= accepté de 80 à 800 px, cache navigateur de 24 h).

La page publique présente : visuel et identité du produit, QR code, indicateurs de durabilité, composition, tableau des composants, entretien et réparation, consignes de tri, chronologie du cycle de vie, certificats, informations de sécurité et coordonnées de l’opérateur responsable. Elle embarque un balisage JSON-LD schema.org pour le référencement.

Affichage sur la fiche produit

Si l’option est activée, un onglet Passeport numérique apparaît sur la fiche produit du front-office avec le QR code, les indicateurs clés et le lien vers la page publique. Un bloc de secours peut également s’afficher sous la description.

RGPD et journal d’accès

Les consultations publiques peuvent être journalisées de façon anonymisée : l’adresse IP est hachée en SHA-256 avec un sel quotidien et la clé secrète de la boutique — aucune donnée personnelle exploitable n’est conservée. L’option est désactivable dans la configuration.

Multiboutique et multilingue

Les passeports sont rattachés à une boutique (contexte multishop respecté) et tous les contenus rédactionnels existent dans chaque langue active. Le module est livré traduit en français, anglais, espagnol, allemand et italien (format XLIFF, modifiable via International > Traductions).

Désinstallation et conservation des données

À la désinstallation, la configuration et les onglets d’administration sont supprimés, mais les tables de données sont conservées : le règlement ESPR impose la disponibilité du passeport pendant toute la durée de vie du produit. Pour une suppression définitive, supprimez manuellement les tables ps_dfdpp_*.

Dépannage

La page /dpp/{uuid} renvoie une 404

• Vérifiez que le passeport est bien publié et que l’affichage public est activé.
• Videz le cache PrestaShop (Paramètres avancés > Performances) pour régénérer les routes.
• Vérifiez la réécriture d’URL (URL simplifiées activées).

Le QR code ne s’affiche pas

• Vérifiez que l’extension PHP GD est active si votre installation ne fournit pas Endroid QR Code.

L’onglet n’apparaît pas sur la fiche produit

• Activez l’option Onglet fiche produit dans la configuration et vérifiez que votre thème supporte le hook displayProductExtraContent.

Journal des versions

• 1.0.0 — Version initiale : passeports UUID, page publique multilingue, QR codes, composants imbriqués, événements de cycle de vie, documents, score de conformité ESPR par catégorie, export JSON / JSON-LD, journal d’accès RGPD, multiboutique.