# 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… - Seite: - Sprache: de - Aktualisiert am: 2026-07-01 - Weitere Sprachen: [fr](https://www.datafirefly.com/documentation/dfdpp/index.md), [en](https://www.datafirefly.com/en/documentation/dfdpp/index.md), [es](https://www.datafirefly.com/es/documentation/dfdpp/index.md), [it](https://www.datafirefly.com/it/documentation/dfdpp/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfdpp/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfdpp/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfdpp/index.md) - Index: 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. Es wird keine externe Bibliothek mitgeliefert: Das Modul nutzt die im PrestaShop-Kern enthaltene Endroid-QR-Code-Bibliothek (v3, v4 oder v5 werden automatisch erkannt) mit einem GD-Fallback-Renderer. ## 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. In der Produktansicht des Back-Office ermöglicht der Tab **Digitaler Pass** das direkte Erstellen oder Öffnen des Passes des gerade bearbeiteten Produkts. ## 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. Ein abgelaufenes Zertifikat wird vom Konformitätsmodul als _Blocker_ markiert und senkt den Pass-Score. ## 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. Drucken Sie den QR-Code auf Etikett, Beipackzettel oder Verpackung: Das ist der von der ESPR vorgesehene Zugangsweg für Endverbraucher, Reparaturbetriebe und Recycler. ## 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.