Wo WooCommerce Mittel

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.

Aktualisiert Modulversion 2.0.0

Ü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.

DataFirefly Digitaler Produktpass – Übersicht der Produktpässe: Vollständigkeit, Produkte ohne Pass und nächste EU-Frist
Übersicht der Produktpässe: Vollständigkeit, Produkte ohne Pass und nächste EU-Frist
Kurz gesagt: Installieren Sie das Plugin, folgen Sie der Einrichtung unter Produktpässe, füllen Sie den Tab Produktpass eines Produkts aus, prüfen Sie die Live-Vorschau, veröffentlichen Sie und drucken Sie dann den QR-Code.

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.

DataFirefly Digitaler Produktpass – Vorschriften und Abdeckung: ESPR und Batteriepass, was das Plugin abdeckt
Vorschriften und Abdeckung: ESPR und Batteriepass, was das Plugin abdeckt
Die Angaben in einem Produktpass werden unter der Verantwortung des Wirtschaftsakteurs bereitgestellt, der das Produkt in Verkehr bringt. Lassen Sie die für Ihre Produkte geltenden Vorschriften von einem Rechtsberater prüfen.

Installation und Aktualisierung

  1. Wählen Sie unter Plugins > Plugin hinzufügen > Plugin hochladen die Datei dfdpp-2.0.0.zip aus und aktivieren Sie dann DataFirefly Digital Product Passport.
  2. Ö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:

  1. 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.
  2. Branche und Darstellung: eine Branchenvorlage (Textilien, Batterien, Elektronik, Möbel oder sonstige Produkte), die Markenfarbe der öffentlichen Seite und das, was auf Produktseiten erscheint.
  3. 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.
DataFirefly Digitaler Produktpass – Einrichtungsassistent mit Branchenvorlagen: Textilien, Batterien, Elektronik, Möbel
Einrichtungsassistent mit Branchenvorlagen: Textilien, Batterien, Elektronik, Möbel

Ü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.

Ein veröffentlichter Produktpass, dessen Produkt noch nicht veröffentlicht ist, bleibt für die Öffentlichkeit verborgen: Die Übersicht kennzeichnet ihn mit „Verborgen: Produkt nicht öffentlich“.

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).

DataFirefly Digitaler Produktpass – Produktpass-Editor in der Produktbearbeitung mit Vollständigkeit und Prüfungen
Produktpass-Editor in der Produktbearbeitung mit Vollständigkeit und Prüfungen

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.

DataFirefly Digitaler Produktpass – Materialzusammensetzung mit Anteilsprüfung und Verknüpfung mit Komponenten
Materialzusammensetzung mit Anteilsprüfung und Verknüpfung mit Komponenten

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.

DataFirefly Digitaler Produktpass – Live-Vorschau der öffentlichen Produktpass-Seite auf dem Smartphone
Live-Vorschau der öffentlichen Produktpass-Seite auf dem Smartphone

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.
DataFirefly Digitaler Produktpass – QR-Code für den Druck (SVG, PNG 20, 30, 50 mm), Etiketten und GS1 Digital Link
QR-Code für den Druck (SVG, PNG 20, 30, 50 mm), Etiketten und GS1 Digital Link

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.

DataFirefly Digitaler Produktpass – Druckbarer Etikettenbogen mit den QR-Codes mehrerer Produktpässe
Druckbarer Etikettenbogen mit den QR-Codes mehrerer Produktpässe
Die im QR-Code codierte Adresse ändert sich nie, auch wenn Sie später das URL-Präfix ändern: Das bisherige Präfix leitet auf das neue weiter.

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).

DataFirefly Digitaler Produktpass – Öffentliche Produktpass-Seite: Kennzahlen, Materialien, Komponenten, Anleitungen, Dokumente
Öffentliche Produktpass-Seite: Kennzahlen, Materialien, Komponenten, Anleitungen, Dokumente
DataFirefly Digitaler Produktpass – Batteriepass auf dem Smartphone, wie nach dem Scannen des QR-Codes
Batteriepass auf dem Smartphone, wie nach dem Scannen des QR-Codes

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.

DataFirefly Digitaler Produktpass – Reiter „Produktpass“ auf der WooCommerce-Produktseite
Reiter „Produktpass“ auf der WooCommerce-Produktseite

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.

DataFirefly Digitaler Produktpass – Zugriffsstufen für Daten, Zugriffsschlüssel für berechtigte Stellen und REST-API
Zugriffsstufen für Daten, Zugriffsschlüssel für berechtigte Stellen und REST-API

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.

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, dann product_id, dann sku zugeordnet. 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"]; ohne product wird 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.php nach your-theme/dfdpp/passport.php. Filter dfdpp_passport_payload; Actions dfdpp_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.

Wenn Sie die Daten löschen, verschwinden die Seiten hinter Ihren gedruckten QR-Codes. Exportieren Sie Ihre Produktpässe vorher.

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.

War diese Seite hilfreich?

Immer noch nicht weiter? Support kontaktieren