Digital Product Passport (DPP) — Vollständige Anleitung

Das Modul DataFirefly — Digital Product Passport (dfdpp) erweitert Ihren PrestaShop-8- oder 9-Shop um ein vollständiges digitales Produktpass-System gemäß der EU-Verordnung ESPR (Ecodesign for Sustainable Products Regulation), die ab 2027 schrittweise für Textilien, Batterien und Elektronik gilt.

Jedes Produkt erhält einen Pass mit eindeutiger Kennung (UUID), eine mehrsprachige öffentliche Seite mit QR-Code-Zugang, ein Komponentenregister (Stückliste / BOM), ein Lebenszyklus-Ereignisprotokoll und eine Verwaltung der Konformitätszertifikate.

Voraussetzungen

• PrestaShop 8.0.0 bis 9.x
• PHP mindestens 7.4 (8.1+ empfohlen)
• GD-Erweiterung aktiviert (QR-Code-Fallback, falls Endroid nicht verfügbar ist)
• Multishop- und mehrsprachenfähig (FR / EN / ES / DE / IT enthalten)

Installation

1. Öffnen Sie im Back-Office Module > Modul-Manager.
2. Klicken Sie auf Modul hochladen und laden Sie dfdpp.zip hoch.
3. Das Modul erstellt automatisch seine Tabellen, sein Menü Produktpässe unter Katalog und registriert seine öffentlichen Routen.

Konfiguration

Öffnen Sie Module > dfdpp > Konfigurieren. Drei Bereiche stehen zur Verfügung:

Allgemeine Einstellungen

• Modul aktivieren — globaler Schalter.
• Automatische Erstellung — erzeugt bei jedem Speichern eines Produkts einen Pass-Entwurf.
• Standard-ESPR-Kategorie — Textil, Batterie, Elektronik, Möbel, Schuhe oder Allgemein.
• Öffentliche Anzeige — aktiviert die öffentliche Seite /dpp/{uuid}.
• Produktseiten-Tab — zeigt den Pass in einem Tab der Produktseite an.
• Öffentlicher JSON-Export — erlaubt den Download des Passes im JSON-Format.

QR-Code

• Größe (Standard 220 px) und Rand (10 px).
• Fehlerkorrektur-Level — M empfohlen (Balance zwischen Dichte und Robustheit).

Firmendaten

Name, USt-IdNr., Adresse und Land des verantwortlichen Wirtschaftsakteurs — diese Angaben erscheinen auf der öffentlichen Passseite, wie von der ESPR gefordert.

Einen Pass erstellen

Automatische Erstellung

Bei aktivierter Option wird bei jedem Speichern eines Produkts ein Pass im Status Entwurf mit der Standard-ESPR-Kategorie erstellt. Er wird erst öffentlich sichtbar, wenn er manuell veröffentlicht wird.

Manuelle Erstellung

1. Öffnen Sie Katalog > Produktpässe > Pässe.
2. Klicken Sie auf Hinzufügen und wählen Sie das Produkt (und ggf. die Variante).
3. Füllen Sie die Felder aus und speichern Sie: Eine eindeutige UUID v4 wird automatisch generiert.

Passdaten

Das Formular ist in fünf Bereiche gegliedert:

• Identifikation — Produkt, Variante, ESPR-Kategorie, GTIN, Hersteller, Ursprungsland, Produktionsdatum, Chargennummer.
• Nachhaltigkeit — CO₂-Fußabdruck (kg CO₂e), Recyclingfähigkeits-Score, Anteil recycelter Materialien, Reparatur-Index, erwartete Lebensdauer, Garantie.
• Mehrsprachige Inhalte — Materialzusammensetzung, Pflegehinweise, Entsorgungs- und End-of-Life-Hinweise, Reparaturinformationen, Sicherheitsinformationen, Konformitätszertifikate (sechs Rich-Text-Felder, in jede Shop-Sprache übersetzbar).
• Komponenten, Ereignisse und Dokumente — per AJAX direkt in der Passansicht verwaltet (siehe unten).
• Benutzerdefinierte Felder — ein freies JSON-Objekt für zusätzliche branchenspezifische Daten.

Komponentenregister (Stückliste)

Jeder Pass kann seine vollständige Stückliste erfassen: Komponentenname, Material, Gewicht (g), Produktanteil, Recyclinganteil, Recyclingfähigkeit, Gefährlichkeit, CAS-Nummer, Lieferant und Land. Komponenten können verschachtelt werden (übergeordnete Komponente / Unterkomponente), um Baugruppen abzubilden.

Das Menü Katalog > Produktpässe > Register bietet eine übergreifende Ansicht aller Komponenten des Shops, filterbar nach Material, Gefährlichkeit oder Lieferant — praktisch für REACH-Audits.

Lebenszyklus-Ereignisse

Das Protokoll dokumentiert das Produktleben: Design, Rohmaterial, Fertigung, Qualitätskontrolle, Distribution, Erstverkauf, Wiederverkauf, Reparatur, Aufarbeitung, Recycling, Lebensende. Jedes Ereignis trägt ein Datum, einen Ort, einen Akteur (Name + Rolle), eine Beschreibung und optional eine Nachweis-URL.

Die Ansicht Katalog > Produktpässe > Ereignisse zentralisiert alle Ereignisse mit Typfilter.

Dokumente und Zertifikate

Hängen Sie jedem Pass die erforderlichen Zertifikate an: CE-Erklärung, REACH, RoHS, WEEE, EU-Batterieverordnung, OEKO-TEX, GOTS, Ecolabel, FSC, ISO 14001 / 9001, PEF, EPD oder andere. Jedes Dokument trägt eine Nummer, einen Aussteller, Gültigkeitsdaten und eine Datei-URL.

ESPR-Konformitäts-Score

Das Modul bewertet jeden Pass nach den Regeln seiner ESPR-Kategorie und zeigt einen Score von 100 mit einer Stufe an:

• Konform — Score ≥ 90 ohne Blocker.
• Teilweise — Score ≥ 60.
• Entwurf — unvollständige Daten.
• Nicht konform — Blocker vorhanden.

Die Liste der Prüfungen und Blocker ist in der Passansicht detailliert aufgeführt; der Button Neu berechnen aktualisiert den Score nach Änderungen.

Öffentliche Seite und QR-Code

Jeder veröffentlichte Pass ist unter https://ihr-shop.com/dpp/{uuid} erreichbar, sein PNG-QR-Code unter /dpp/{uuid}/qr.png (Parameter ?size= von 80 bis 800 px, 24-Stunden-Browser-Cache).

Die öffentliche Seite zeigt: Produktbild und -identität, QR-Code, Nachhaltigkeits-KPIs, Zusammensetzung, Komponententabelle, Pflege und Reparatur, Entsorgungshinweise, Lebenszyklus-Zeitleiste, Zertifikate, Sicherheitsinformationen und die Angaben des verantwortlichen Akteurs. Sie enthält JSON-LD-schema.org-Markup für SEO.

Anzeige auf der Produktseite

Bei aktivierter Option erscheint ein Tab Digitaler Pass auf der Front-Office-Produktseite mit QR-Code, Kennzahlen und Link zur öffentlichen Seite. Ein Fallback-Block kann zusätzlich unter der Beschreibung angezeigt werden.

DSGVO und Zugriffsprotokoll

Öffentliche Aufrufe können anonymisiert protokolliert werden: Die IP-Adresse wird mit SHA-256, einem täglichen Salt und dem geheimen Shop-Schlüssel gehasht — es werden keine verwertbaren personenbezogenen Daten gespeichert. Die Option lässt sich in der Konfiguration deaktivieren.

Multishop und Mehrsprachigkeit

Pässe sind einem Shop zugeordnet (Multishop-Kontext wird berücksichtigt) und alle redaktionellen Inhalte existieren in jeder aktiven Sprache. Das Modul wird übersetzt in Französisch, Englisch, Spanisch, Deutsch und Italienisch ausgeliefert (XLIFF-Format, editierbar unter International > Übersetzungen).

Deinstallation und Datenaufbewahrung

Bei der Deinstallation werden Konfiguration und Admin-Tabs entfernt, aber die Datentabellen bleiben erhalten: Die ESPR-Verordnung verlangt die Verfügbarkeit des Passes während der gesamten Produktlebensdauer. Für eine endgültige Löschung entfernen Sie die Tabellen ps_dfdpp_* manuell.

Fehlerbehebung

Die Seite /dpp/{uuid} liefert einen 404-Fehler

• Prüfen Sie, ob der Pass veröffentlicht und die öffentliche Anzeige aktiviert ist.
• Leeren Sie den PrestaShop-Cache (Erweiterte Einstellungen > Leistung), um die Routen neu zu generieren.
• Prüfen Sie das URL-Rewriting (sprechende URLs aktiviert).

Der QR-Code wird nicht angezeigt

• Prüfen Sie, ob die PHP-GD-Erweiterung aktiv ist, falls Ihre Installation Endroid QR Code nicht mitliefert.

Der Tab erscheint nicht auf der Produktseite

• Aktivieren Sie die Option Produktseiten-Tab in der Konfiguration und prüfen Sie, ob Ihr Theme den Hook displayProductExtraContent unterstützt.

Versionshistorie

• 1.0.0 — Erstveröffentlichung: UUID-Pässe, mehrsprachige öffentliche Seite, QR-Codes, verschachtelte Komponenten, Lebenszyklus-Ereignisse, Dokumente, ESPR-Konformitäts-Score pro Kategorie, JSON- / JSON-LD-Export, DSGVO-Zugriffsprotokoll, Multishop.