DataFirefly Digital Product Passport — Dokumentation
Digital Product Passport 2.0 für WooCommerce installieren und verwenden: Einrichtungsassistent, Branchenvorlagen, Produktpass-Editor und Live-Vorschau, Varianten, QR-Codes und Etiketten, GS1 Digital Link, Zugriffsstufen und -schlüssel, Import/Export, REST-API, Vorschriften und Fehlerbehebung.
Überblick
DataFirefly Digital Product Passport gibt jedem WooCommerce-Produkt und jeder Variante, die ihn benötigt, einen digitalen Produktpass: Kennungen, Hersteller, Umweltdaten, Haltbarkeit und Reparatur, Materialien, Komponenten, Anleitungen, besorgniserregende Stoffe, Dokumente und Schritte der Rückverfolgbarkeit. Jeder Produktpass hat eine dauerhafte öffentliche Adresse und einen QR-Code, den Sie auf das Produkt, seine Verpackung oder seine Dokumente drucken.
Version 2.0 ergänzt eine Übersicht über Ihren gesamten Katalog, einen Einrichtungsassistenten mit Branchenvorlagen, einen Editor mit Vollständigkeitswert und Live-Vorschau, Produktpässe für Varianten, eine für Smartphones gestaltete öffentliche Seite in 8 Sprachen, QR-Codes in Druckgrößen und Etikettenbögen, GS1 Digital Link, Zugriffsstufen mit Zugriffsschlüsseln, einen Versionsverlauf, CSV/JSON-Import und -Export, Blöcke und eine dokumentierte REST-API.

Was die EU-Vorschriften verlangen
Die Ökodesign-Verordnung für nachhaltige Produkte, Verordnung (EU) 2024/1781 (ESPR), macht einen Produktpass nicht allein verpflichtend: Für jede Produktgruppe ist ein delegierter Rechtsakt erforderlich, der frühestens 18 Monate nach seinem Inkrafttreten gilt. Im November 2026 war noch kein delegierter Rechtsakt nach der ESPR angenommen, der einen Produktpass vorschreibt. Die Kommission plant zuerst Eisen und Stahl, dann Textilien, Reifen und Aluminium (2027), Möbel (2028) und Matratzen (2029). Der Batteriepass nach der Verordnung (EU) 2023/1542 gilt ab dem 18. Februar 2027 für LMT-Batterien, Industriebatterien mit mehr als 2 kWh und Batterien für Elektrofahrzeuge.
Das Plugin hilft Ihnen, die Daten zu strukturieren und zu veröffentlichen. Es macht Ihre Produkte nicht von sich aus konform: Es ist nicht mit dem EU-Register für Produktpässe verbunden, stellt nicht die von der ESPR verlangte Sicherungskopie bei einem unabhängigen Anbieter von Produktpass-Diensten bereit und wurde nicht anhand der harmonisierten Normen für Produktpässe bewertet. Der Bildschirm Produktpässe > Vorschriften listet jede Anforderung mit ihrem Status (Abgedeckt, Teilweise abgedeckt, Nicht abgedeckt, Ihre Verantwortung) und ihrer offiziellen Quelle auf.

Installation und Aktualisierung
- Wählen Sie unter Plugins > Plugin hinzufügen > Plugin hochladen die Datei
dfdpp-2.0.0.zipaus und aktivieren Sie dann DataFirefly Digital Product Passport. - Öffnen Sie Produktpässe im Admin-Menü.
Voraussetzungen: WordPress 6.4 oder höher, WooCommerce 8.2 oder höher, PHP 7.4 bis 8.5. Die öffentlichen Adressen funktionieren, ohne dass Sie die Permalinks erneut speichern müssen.
Aktualisierung von Version 1.0
Laden Sie die neue ZIP-Datei hoch und wählen Sie Installiertes durch Hochgeladenes ersetzen. Produktpässe, ihre Kennungen, ihre öffentlichen Adressen und Ihre Einstellungen bleiben erhalten; bereits gedruckte QR-Codes funktionieren weiter. Ländercodes werden vereinheitlicht, die Vollständigkeit jedes Produktpasses wird berechnet und für jeden veröffentlichten Produktpass wird eine erste Version gespeichert. Die Anzeigeoptionen von Version 1.0 werden zu Zugriffsstufen (verborgene Daten werden zu „Nur intern“). Ein Hinweis stellt die Neuerungen vor.
Einrichtungsassistent
Bei einer Neuinstallation bietet die Übersicht eine Einrichtung in drei Schritten:
- Ihr Unternehmen: Name, Adresse und Land des Herstellers, Kennung des Wirtschaftsakteurs (zum Beispiel Ihre EORI-Nummer oder GS1-GLN) und ein Kontakt für Produktinformationen. Diese Angaben füllen jeden neuen Produktpass vor.
- Branche und Darstellung: eine Branchenvorlage (Textilien, Batterien, Elektronik, Möbel oder sonstige Produkte), die Markenfarbe der öffentlichen Seite und das, was auf Produktseiten erscheint.
- Erste Produktpässe: Erstellen Sie Produktpässe als Entwurf für alle Produkte ohne Produktpass oder für einzelne Kategorien. Es wird nichts veröffentlicht.

Übersicht über Ihre Produktpässe
Produktpässe > Übersicht zeigt die Anzahl der Produktpässe, die durchschnittliche Vollständigkeit, die Produkte ohne Produktpass und die nächste EU-Frist. Die Tabelle lässt sich nach Status, Branche und unvollständigen Produktpässen filtern und nach Produkt, GTIN, Modell oder Artikelnummer durchsuchen. Für jeden Produktpass sehen Sie seine Vollständigkeit, die ersten fehlenden Angaben, seinen Status, seine Version und seine letzte Aktualisierung.
Massenaktionen gelten für die ausgewählten Produktpässe: veröffentlichen, zurück zum Entwurf, archivieren, Etiketten drucken, als CSV oder JSON exportieren. Unter der Tabelle erstellen Sie Produktpässe als Entwurf für Produkte, die noch keinen haben, mit der Branchenvorlage Ihrer Wahl.
Einen Produktpass bearbeiten
Öffnen Sie ein Produkt: Der Tab Produktpass der Produktdaten-Box enthält den Editor. Aktivieren Sie bei einem Produkt ohne Produktpass Beim Speichern einen Produktpass für dieses Produkt erstellen (die Option wird automatisch aktiviert, sobald Sie etwas in ein Feld eingeben).

Die Kopfzeile zeigt den Vollständigkeitsring, den Status (Entwurf, Veröffentlicht, Archiviert), die Schaltfläche Live-Vorschau und den Link zur öffentlichen Seite. Die Abschnitte stehen links mit der Anzahl der fehlenden Angaben; mit den Pfeiltasten wechseln Sie zwischen ihnen.
- Identifikation: Produktbranche (sie bestimmt die erwarteten Angaben), GTIN mit Prüfung der Prüfziffer, Modell, was der Produktpass abdeckt (ein Modell, eine Charge oder ein einzelnes Exemplar), Charge, Seriennummer, Herstellungsland.
- Hersteller und Wirtschaftsakteur: Hersteller, Kennung des Wirtschaftsakteurs, verantwortlicher Wirtschaftsakteur in der EU (Einführer oder Bevollmächtigter), Kontakt, Herstellungsdatum, Standort und Kennung der Produktionsstätte.
- Umwelt: CO2-Fußabdruck mit Einheit und Berechnungsmethode, Recyclinganteil, recycelbarer Anteil, erwartete Lebensdauer, Gewicht.
- Haltbarkeit und Reparatur: Reparierbarkeitswert, Reparierbarkeitsklasse, gewerbliche Garantie, Ersatzteile und Software-Updates.
- Branchendaten: für die Branche vorgeschlagene Felder, zum Beispiel die Länder für Spinnen, Weben, Veredelung und Konfektion bei Textilien oder Kategorie, Chemie, Kapazität, Spannung, Energie, Lebensdauer in Zyklen sowie Anteile an recyceltem Kobalt, Lithium, Nickel und Blei bei Batterien.
- Materialien, Komponenten, Anleitungen (Gebrauch, Pflege, Reparatur, Sicherheit, Recycling, Lebensende), Konformität und Dokumente und Rückverfolgbarkeit.
Für die Branche erwartete Felder sind mit einem Punkt markiert. Die Werte werden bei der Eingabe geprüft (GTIN, Wertebereiche, Datumsangaben, Webadressen); dennoch gesendete ungültige Werte werden beim Speichern abgelehnt, in einem Hinweis aufgelistet und am Feld markiert, und der Produktpass wird erst veröffentlicht, wenn sie korrigiert sind.
Materialien und Komponenten
Fügen Sie pro Material eine Zeile hinzu: Code (Kunststoffe, Textilfasern, Metalle, Batteriechemien …) oder freier Name, Anteil am Produkt, Gewicht, Recyclinganteil, erneuerbar oder biobasiert, Herkunft, CAS-Nummer und bei Bedarf die Komponente, zu der es gehört. Die Summe der Anteile wird angezeigt und darf 100 % nicht überschreiten.

Komponenten haben einen Namen, einen Typ, ein Gewicht, eine Herkunft, einen Lieferanten und ein Lieferantenland sowie die Kennzeichnungen „Austauschbar“, „Recycelbar“ und „Enthält kritische Rohstoffe“. Dokumente (Konformitätserklärung, Handbücher, Zertifikate …) können aus der Mediathek ausgewählt werden.
Live-Vorschau
Live-Vorschau zeigt die öffentliche Seite mit Ihren ungespeicherten Änderungen, auf einem Smartphone oder einem Computer. Sie wird während der Eingabe aktualisiert.

Varianten
Aktivieren Sie im Tab Varianten die Option Eigener Produktpass für diese Variante: Die Variante erhält eine eigene GTIN, ein eigenes Modell, eine eigene Charge, Seriennummer, einen eigenen CO2-Fußabdruck, ein eigenes Gewicht und einen eigenen QR-Code. Die übrigen Daten werden aus dem Produktpass des Produkts übernommen. Der Produktpass des Produkts listet die Produktpässe der Varianten auf.
QR-Codes und Etiketten
Der Abschnitt QR-Code und Etiketten des Editors zeigt die codierte Adresse, die QR-Version und ihre Fehlerkorrektur und bietet:
- SVG (Vektor, für den Druck), PNG 1024 px und PNG 20, 30 oder 50 mm, 300 dpi;
- ein druckbares Etikett mit QR-Code, Produktname, GTIN, Charge oder Seriennummer und Adresse;
- die Kennung des Produktpasses, die öffentliche Seite, die GS1-Digital-Link-Adresse und die JSON-Daten.

Um mehrere Etiketten zu drucken, wählen Sie in der Übersicht Produktpässe aus und wählen Sie Etiketten drucken. Drucken Sie mit 100 % und lassen Sie den weißen Rand um den Code frei.

Die öffentliche Produktpass-Seite
Die öffentliche Adresse hat die Form yourdomain.com/dpp/{identifier}/. Die Seite ist für Smartphones gestaltet und folgt der Sprache des Smartphones des Besuchers (8 Sprachen, mit Sprachmenü). Sie zeigt das Produkt, seine Branche und Kennungen, die Kennzahlen, die Materialzusammensetzung, die Komponenten, die Branchendaten, die Anleitungen, die Konformitätsangaben und -dokumente, die Zeitleiste der Rückverfolgbarkeit, den Hersteller, den QR-Code (herunterladen, teilen, drucken) und die Details des Produktpasses (Kennung, Daten, Version und SHA-256-Fingerabdruck).


Die Seite ist mit Tastatur und Screenreader bedienbar, passt sich dem Dunkelmodus an und lässt sich sauber drucken. Sie stellt ihre Daten außerdem als JSON bereit (/dpp/{identifier}.json) und enthält schema.org JSON-LD. Auf Produktseiten verweist ein Tab Produktpass (oder eine Karte unter der Zusammenfassung) auf den Produktpass.

Einstellungen
Unter Produktpässe > Einstellungen (Administratoren und Shop-Manager):
- Öffentliche Seite: URL-Präfix (wirkt sofort), eigenständige Seite oder im Theme, Sprachen, Indexierung durch Suchmaschinen, Anzeige auf Produktseiten, Vererbung an Varianten, automatische Veröffentlichung, Produktpässe von Produkten, die nicht mehr verkauft werden (standardmäßig online).
- Standardwerte des Unternehmens: vorausgefüllte Werte neuer Produktpässe und die Standardbranche.
- Datenzugriff und API: die Zugriffsstufe jeder Datenart, Zugriffsschlüssel und die REST-API.
- QR-Codes und Etiketten: Adresse des Produktpasses oder GS1 Digital Link, Fehlerkorrektur, Farbe (nur dunkle Farben), Download-Format, Etikettengröße.
- Darstellung: Markenfarbe (die Textfarbe darauf wird für gute Lesbarkeit gewählt) und Logo.
- Daten und Deinstallation: beim Löschen des Plugins alles löschen (standardmäßig deaktiviert).
Zugriffsstufen und -schlüssel
Wählen Sie für jede Datenart – Hersteller, Herstellungsstandort, Umwelt, CO2-Fußabdruck, Haltbarkeit, Anleitungen, Konformität, Dokumente, Komponenten, Lieferantennamen, Materialien, Rückverfolgbarkeit, wer jeden Schritt durchgeführt hat, Branchendaten – Öffentlich, Berechtigte Stellen (Zugriffsschlüssel) oder Nur intern. Lieferantennamen sind standardmäßig intern. Kennungen, Produktname und Herstellungsland sind immer öffentlich.

Erstellen Sie einen Zugriffsschlüssel für eine Behörde, einen Reparaturbetrieb, einen Recycler oder einen Partner: Er wird einmal angezeigt und dann als Hash gespeichert. Der Empfänger sendet ihn im Header X-DPP-Access-Key, wenn er die JSON-Adresse oder die API abruft. Sie können einen Schlüssel jederzeit widerrufen.
GS1 Digital Link
Hat ein Produktpass eine gültige GTIN, erhält er eine GS1-Digital-Link-Adresse auf Ihrer Domain, zum Beispiel yourdomain.com/01/09506000134352/10/LOT42 (mit Charge oder Seriennummer, je nachdem, was der Produktpass abdeckt). Das Plugin beantwortet diese Adressen und leitet auf den Produktpass weiter; ?linkType=linkset gibt die Liste der Links zurück. In den QR-Einstellungen können Sie festlegen, dass diese Adresse in den QR-Codes codiert wird.
Import und Export
Produktpässe > Import/Export:
- Export aller Produktpässe oder eines Status als CSV oder JSON. JSON behält alle Listen (Materialien, Komponenten, Schritte, Dokumente). Bewahren Sie ihn als Sicherung auf.
- Importieren Sie eine CSV-Datei (Komma, Semikolon oder Tabulator) oder eine JSON-Datei. Zeilen werden über
uuid, dannproduct_id, dannskuzugeordnet. Das Plugin zeigt zuerst, was erstellt, aktualisiert oder übersprungen wird, mit Warnungen; nichts wird geschrieben, bevor Sie bestätigen. Leere CSV-Zellen löschen keine vorhandenen Daten. Beginnen Sie mit der CSV-Vorlage.
Blöcke, Shortcodes und Entwickler
- Blöcke Produktpass (Karte mit QR-Code, nur QR-Code oder Link) und QR-Code des Produktpasses.
- Shortcodes
[dfdpp_passport product="123" layout="card|qr|link" qr="no" size="112"]und[dfdpp_qr product="123" size="160"]; ohneproductwird das aktuelle Produkt verwendet. - REST-API
dfdpp/v1:GET /passport/{uuid},/qr,/revisions,/by-product/{id},/by-gtin/{gtin};GET|POST /passports;POST|DELETE /passport/{id};POST /passport/{id}/publish|unpublish|archive. Schreibende Aufrufe erfordern einen Benutzer, der das Produkt bearbeiten darf (Anwendungspasswörter funktionieren). Beschreibung:/wp-json/dfdpp/v1/openapi. - WP-CLI:
wp dfdpp status,list,publish,unpublish,qr,export. - Vorlage: Kopieren Sie
templates/passport.phpnachyour-theme/dfdpp/passport.php. Filterdfdpp_passport_payload; Actionsdfdpp_passport_created,dfdpp_passport_saved,dfdpp_public_head.
Fehlerbehebung
Die öffentliche Seite liefert einen 404-Fehler
Der Produktpass ist ein Entwurf oder archiviert, oder sein Produkt wurde nie veröffentlicht. Die Übersicht zeigt den Grund an. Produktpässe von Produkten, die nicht mehr verkauft werden, bleiben online, sofern Sie nicht festgelegt haben, sie zu verbergen.
Ein Wert wird nicht gespeichert
Ein Hinweis listet nach dem Speichern die abgelehnten Werte auf, und die Felder sind im Editor markiert. Korrigieren Sie sie und speichern Sie erneut.
Mein Seiten-Cache zeigt eingeschränkte Daten an
Eingeschränkte Daten werden nur an Anfragen mit Zugriffsschlüssel oder aus Ihrem Team gesendet. Wenn Sie einen Seiten-Cache verwenden, lassen Sie ihn nach dem Header X-DPP-Access-Key und nach Anmelde-Cookies variieren (das Plugin sendet den passenden Vary-Header).
Deinstallation
Beim Deaktivieren des Plugins bleiben alle Daten erhalten. Auch beim Löschen bleiben die Produktpässe erhalten, sodass sie bei einer Neuinstallation mit ihren Adressen wieder verfügbar sind. Um alles zu löschen (Tabellen, Einstellungen, Zugriffsschlüssel), aktivieren Sie Alle Produktpässe und Einstellungen löschen unter Einstellungen > Daten und Deinstallation, bevor Sie das Plugin löschen.
Support
Der Support erfolgt per E-Mail auf Französisch und Englisch unter support@datafirefly.com. Bitte geben Sie die Versionen des Plugins, von WordPress und von WooCommerce an.