Wo WooCommerce Gemiddeld

DataFirefly Digital Product Passport: documentatie

Digital Product Passport 2.0 voor WooCommerce installeren en gebruiken: configuratiewizard, sectorsjablonen, paspoorteditor en live voorbeeld, variaties, QR-codes en etiketten, GS1 Digital Link, toegangsniveaus en -sleutels, import/export, REST API, regelgeving en probleemoplossing.

Bijgewerkt Moduleversie 2.0.0

Overzicht

DataFirefly Digital Product Passport geeft elk WooCommerce-product, en elke variatie die dat nodig heeft, een digitaal productpaspoort: identificatiecodes, fabrikant, milieugegevens, duurzaamheid en reparatie, materialen, onderdelen, instructies, zorgwekkende stoffen, documenten en stappen voor traceerbaarheid. Elk paspoort heeft een permanent openbaar adres en een QR-code om af te drukken op het product, de verpakking of de documenten.

Versie 2.0 voegt toe: een overzicht van je hele catalogus, een configuratiewizard met sectorsjablonen, een editor met volledigheidsscore en live voorbeeld, paspoorten voor variaties, een openbare pagina die is ontworpen voor telefoons in 8 talen, QR-codes in afdrukformaten en etiketvellen, GS1 Digital Link, toegangsniveaus met toegangssleutels, een versiegeschiedenis, CSV/JSON-import en -export, blokken en een gedocumenteerde REST API.

DataFirefly Digitaal productpaspoort – Overzicht van de paspoorten: volledigheid, producten zonder paspoort en volgende EU-termijn
Overzicht van de paspoorten: volledigheid, producten zonder paspoort en volgende EU-termijn
In het kort: installeer de plugin, doorloop de configuratie in Paspoorten, vul het tabblad Productpaspoort van een product in, controleer het Live voorbeeld, publiceer en druk daarna de QR-code af.

Wat de EU-regels vereisen

De Verordening (EU) 2024/1781 betreffende ecologisch ontwerp voor duurzame producten (ESPR) maakt een paspoort op zichzelf niet verplicht: elke productgroep heeft een gedelegeerde handeling nodig, die ten minste 18 maanden na de inwerkingtreding ervan van toepassing wordt. In november 2026 was nog geen gedelegeerde handeling op grond van de ESPR vastgesteld die een paspoort verplicht stelt. De Commissie plant eerst ijzer en staal, daarna textiel, banden en aluminium (2027), meubelen (2028) en matrassen (2029). Het batterijpaspoort van Verordening (EU) 2023/1542 geldt vanaf 18 februari 2027 voor LMT-batterijen, industriële batterijen van meer dan 2 kWh en batterijen voor elektrische voertuigen.

De plugin helpt je de gegevens te structureren en te publiceren. Hij maakt je producten niet zelf conform: hij is niet gekoppeld aan het EU-register voor productpaspoorten, levert niet de door de ESPR vereiste reservekopie bij een onafhankelijke aanbieder van paspoortdiensten en is niet beoordeeld aan de hand van de geharmoniseerde normen voor paspoorten. Het scherm Paspoorten > Regelgeving toont elke eis met de status (Gedekt, Gedeeltelijk gedekt, Niet gedekt, Jouw verantwoordelijkheid) en de officiële bron.

DataFirefly Digitaal productpaspoort – Regelgeving en dekking: ESPR en batterijpaspoort, wat de plugin dekt
Regelgeving en dekking: ESPR en batterijpaspoort, wat de plugin dekt
De informatie in een paspoort wordt verstrekt onder de verantwoordelijkheid van de marktdeelnemer die het product in de handel brengt. Laat de regels die voor je producten gelden controleren door een juridisch adviseur.

Installatie en update

  1. Kies in Plugins > Plugin toevoegen > Plugin uploaden het bestand dfdpp-2.0.0.zip en activeer daarna DataFirefly Digital Product Passport.
  2. Open Paspoorten in het beheermenu.

Vereisten: WordPress 6.4 of hoger, WooCommerce 8.2 of hoger, PHP 7.4 tot en met 8.5. Openbare adressen werken zonder dat je de permalinks opnieuw hoeft op te slaan.

Bijwerken vanaf versie 1.0

Upload de nieuwe zip en kies Huidige vervangen door de geüploade. Paspoorten, hun identificatiecodes, hun openbare adressen en je instellingen blijven bewaard; QR-codes die al zijn afgedrukt blijven werken. Landcodes worden genormaliseerd, de volledigheid van elk paspoort wordt berekend en van elk gepubliceerd paspoort wordt een eerste versie vastgelegd. De weergavekeuzes van versie 1.0 worden toegangsniveaus (verborgen gegevens worden “Alleen intern”). Een melding stelt de nieuwe functies voor.

Configuratiewizard

Bij een nieuwe installatie biedt het overzicht een configuratie in drie stappen:

  1. Je bedrijf: naam, adres en land van de fabrikant, identificatiecode van de marktdeelnemer (bijvoorbeeld je EORI-nummer of GS1-GLN) en een contactpersoon voor productinformatie. Deze gegevens worden vooraf ingevuld in elk nieuw paspoort.
  2. Sector en weergave: een sectorsjabloon (textiel, batterijen, elektronica, meubelen of andere producten), de merkkleur van de openbare pagina en wat er op productpagina’s verschijnt.
  3. Eerste paspoorten: maak conceptpaspoorten aan voor alle producten zonder paspoort, of voor bepaalde categorieën. Er wordt niets gepubliceerd.
DataFirefly Digitaal productpaspoort – Configuratiewizard met sectorsjablonen: textiel, batterijen, elektronica, meubels
Configuratiewizard met sectorsjablonen: textiel, batterijen, elektronica, meubels

Overzicht van je paspoorten

Paspoorten > Overzicht toont het aantal paspoorten, de gemiddelde volledigheid, de producten zonder paspoort en de volgende EU-termijn. De tabel kan worden gefilterd op status, sector en onvolledige paspoorten, en je kunt zoeken op product, GTIN, model of artikelnummer. Voor elk paspoort zie je de volledigheid, de eerste ontbrekende onderdelen, de status, de versie en de laatste update.

Bulkacties gelden voor de geselecteerde paspoorten: publiceren, terug naar concept, archiveren, etiketten afdrukken, exporteren als CSV of JSON. Onder de tabel maak je conceptpaspoorten aan voor producten die er nog geen hebben, met het sectorsjabloon van je keuze.

Een gepubliceerd paspoort waarvan het product nog niet is gepubliceerd, blijft verborgen voor het publiek: het overzicht markeert het als “Verborgen: product niet openbaar”.

Een paspoort bewerken

Open een product: het tabblad Productpaspoort van het vak Productgegevens bevat de editor. Vink voor een product zonder paspoort Een paspoort voor dit product aanmaken wanneer ik het opsla aan (dit wordt automatisch aangevinkt zodra je iets in een veld typt).

DataFirefly Digitaal productpaspoort – Paspoorteditor in het productscherm, met volledigheid en controles
Paspoorteditor in het productscherm, met volledigheid en controles

De kop toont de volledigheidsring, de status (Concept, Gepubliceerd, Gearchiveerd), de knop Live voorbeeld en de link naar de openbare pagina. De secties staan links, met het aantal ontbrekende onderdelen; gebruik de pijltjestoetsen om ertussen te wisselen.

  • Identificatie: productsector (die bepaalt de verwachte onderdelen), GTIN met controle van het controlecijfer, model, waarop het paspoort betrekking heeft (een model, een batch of één exemplaar), batch, serienummer, land van productie.
  • Fabrikant en marktdeelnemer: fabrikant, identificatiecode van de marktdeelnemer, verantwoordelijke marktdeelnemer in de EU (importeur of gemachtigde), contactpersoon, productiedatum, productielocatie en identificatiecode van de installatie.
  • Milieu: koolstofvoetafdruk met eenheid en berekeningsmethode, gerecycleerde inhoud, recyclebaar aandeel, verwachte levensduur, gewicht.
  • Duurzaamheid en reparatie: repareerbaarheidsscore, repareerbaarheidsklasse, commerciële garantie, reserveonderdelen en software-updates.
  • Sectorgegevens: velden die voor de sector worden voorgesteld, bijvoorbeeld de landen van spinnen, weven, veredelen en confectioneren voor textiel, of categorie, chemie, capaciteit, spanning, energie, levensduur in cycli en aandelen gerecycled kobalt, lithium, nikkel en lood voor batterijen.
  • Materialen, Onderdelen, Instructies (gebruik, onderhoud, reparatie, veiligheid, recycling, einde levensduur), Conformiteit en documenten en Traceerbaarheid.

Velden die voor de sector worden verwacht, hebben een stip. Waarden worden tijdens het typen gecontroleerd (GTIN, waardebereiken, datums, webadressen); ongeldige waarden die toch worden verzonden, worden bij het opslaan geweigerd, in een melding opgesomd en bij het veld gemarkeerd, en het paspoort wordt pas gepubliceerd als ze zijn gecorrigeerd.

Materialen en onderdelen

Voeg per materiaal een rij toe: code (kunststoffen, textielvezels, metalen, batterijchemieën…) of vrije naam, aandeel in het product, gewicht, gerecycled aandeel, hernieuwbaar of biogebaseerd, herkomst, CAS-nummer en, indien nodig, het onderdeel waartoe het behoort. Het totaal van de aandelen wordt weergegeven en mag niet hoger zijn dan 100%.

DataFirefly Digitaal productpaspoort – Materiaalsamenstelling met controle van de aandelen en koppeling aan onderdelen
Materiaalsamenstelling met controle van de aandelen en koppeling aan onderdelen

Onderdelen hebben een naam, type, gewicht, herkomst, leverancier en land van de leverancier, en de kenmerken “Vervangbaar”, “Recyclebaar” en “Bevat kritieke grondstoffen”. Documenten (conformiteitsverklaring, handleidingen, certificaten…) kun je kiezen uit de mediabibliotheek.

Live voorbeeld

Live voorbeeld toont de openbare pagina met je niet-opgeslagen wijzigingen, op een telefoon of een computer. Het wordt bijgewerkt terwijl je typt.

DataFirefly Digitaal productpaspoort – Live voorbeeld van de openbare paspoortpagina op een telefoon
Live voorbeeld van de openbare paspoortpagina op een telefoon

Variaties

Vink in het tabblad Variaties de optie Eigen productpaspoort voor deze variatie aan: de variatie krijgt een eigen GTIN, model, batch, serienummer, koolstofvoetafdruk, gewicht en QR-code. De overige gegevens worden overgenomen van het productpaspoort. Het productpaspoort toont de paspoorten van de variaties.

QR-codes en etiketten

De sectie QR-code en etiketten van de editor toont het gecodeerde adres, de QR-versie en de foutcorrectie, en biedt:

  • SVG (vector, voor drukwerk), PNG 1024 px en PNG 20, 30 of 50 mm, 300 dpi;
  • een afdrukbaar etiket met de QR-code, de productnaam, de GTIN, de batch of het serienummer en het adres;
  • de identificatiecode van het paspoort, de openbare pagina, het GS1 Digital Link-adres en de JSON-gegevens.
DataFirefly Digitaal productpaspoort – QR-code voor drukwerk (SVG, PNG 20, 30, 50 mm), etiketten en GS1 Digital Link
QR-code voor drukwerk (SVG, PNG 20, 30, 50 mm), etiketten en GS1 Digital Link

Om meerdere etiketten af te drukken, selecteer je paspoorten in het overzicht en kies je Etiketten afdrukken. Druk af op 100% en laat de witte marge rond de code vrij.

DataFirefly Digitaal productpaspoort – Afdrukbaar etiketvel met de QR-codes van meerdere paspoorten
Afdrukbaar etiketvel met de QR-codes van meerdere paspoorten
Het adres dat in de QR-code is gecodeerd, verandert nooit, ook niet als je later het URL-voorvoegsel wijzigt: het vorige voorvoegsel verwijst door naar het nieuwe.

De openbare paspoortpagina

Het openbare adres ziet eruit als yourdomain.com/dpp/{identifier}/. De pagina is ontworpen voor telefoons en volgt de taal van de telefoon van de bezoeker (8 talen, met een taalmenu). Ze toont het product, de sector en de identificatiecodes, de kerncijfers, de materiaalsamenstelling, de onderdelen, de sectorgegevens, de instructies, de conformiteitsinformatie en -documenten, de tijdlijn voor traceerbaarheid, de fabrikant, de QR-code (downloaden, delen, afdrukken) en de paspoortgegevens (identificatiecode, datums, versie en SHA-256-vingerafdruk).

DataFirefly Digitaal productpaspoort – Openbare paspoortpagina: kerncijfers, materialen, onderdelen, instructies, documenten
Openbare paspoortpagina: kerncijfers, materialen, onderdelen, instructies, documenten
DataFirefly Digitaal productpaspoort – Batterijpaspoort op een telefoon, zoals na het scannen van de QR-code
Batterijpaspoort op een telefoon, zoals na het scannen van de QR-code

De pagina is toegankelijk met toetsenbord en schermlezer, past zich aan de donkere modus aan en laat zich netjes afdrukken. Ze biedt haar gegevens ook in JSON aan (/dpp/{identifier}.json) en bevat schema.org JSON-LD. Op productpagina’s linkt een tabblad Productpaspoort (of een kaart onder de samenvatting) naar het paspoort.

DataFirefly Digitaal productpaspoort – Tabblad „Productpaspoort” op de WooCommerce-productpagina
Tabblad „Productpaspoort” op de WooCommerce-productpagina

Instellingen

In Paspoorten > Instellingen (beheerders en winkelmanagers):

  • Openbare pagina: URL-voorvoegsel (direct van kracht), losse pagina of binnen het thema, talen, indexering door zoekmachines, weergave op productpagina’s, overerving door variaties, automatische publicatie, paspoorten van producten die niet meer worden verkocht (standaard online gehouden).
  • Standaardgegevens van het bedrijf: vooraf ingevulde waarden van nieuwe paspoorten en de standaardsector.
  • Gegevenstoegang en API: het toegangsniveau van elk soort gegevens, toegangssleutels en de REST API.
  • QR-codes en etiketten: paspoortadres of GS1 Digital Link, foutcorrectie, kleur (alleen donkere kleuren), downloadformaat, etiketformaat.
  • Weergave: merkkleur (de tekstkleur daarop wordt gekozen voor leesbaarheid) en logo.
  • Gegevens en verwijderen: alles verwijderen wanneer de plugin wordt verwijderd (standaard uitgevinkt).

Toegangsniveaus en -sleutels

Kies voor elk soort gegevens — fabrikant, productielocatie, milieu, koolstofvoetafdruk, duurzaamheid, instructies, conformiteit, documenten, onderdelen, namen van leveranciers, materialen, traceerbaarheid, wie elke stap heeft uitgevoerd, sectorgegevens — Openbaar, Gemachtigde partijen (toegangssleutel) of Alleen intern. Namen van leveranciers zijn standaard intern. Identificatiecodes, de productnaam en het land van productie zijn altijd openbaar.

DataFirefly Digitaal productpaspoort – Toegangsniveaus voor gegevens, toegangssleutels voor gemachtigde partijen en REST API
Toegangsniveaus voor gegevens, toegangssleutels voor gemachtigde partijen en REST API

Maak een toegangssleutel aan voor een autoriteit, een reparateur, een recycler of een partner: de sleutel wordt één keer getoond en daarna als hash opgeslagen. De ontvanger stuurt hem mee in de header X-DPP-Access-Key bij het opvragen van het JSON-adres of de API. Je kunt een sleutel op elk moment intrekken.

Wanneer een paspoort een geldige GTIN heeft, krijgt het een GS1 Digital Link-adres op je domein, zoals yourdomain.com/01/09506000134352/10/LOT42 (met de batch of het serienummer, afhankelijk van waarop het paspoort betrekking heeft). De plugin beantwoordt deze adressen en verwijst door naar het paspoort; ?linkType=linkset geeft de lijst met links terug. In de QR-instellingen kun je ervoor kiezen dit adres in de QR-codes te coderen.

Import en export

Paspoorten > Importeren / exporteren:

  • Exporteren: alle paspoorten, of die met één status, als CSV of JSON. JSON behoudt alle lijsten (materialen, onderdelen, stappen, documenten). Bewaar het als reservekopie.
  • Importeren: een CSV-bestand (komma, puntkomma of tab) of een JSON-bestand. Rijen worden gekoppeld op uuid, daarna op product_id en daarna op sku. De plugin toont eerst wat er wordt aangemaakt, bijgewerkt of overgeslagen, met waarschuwingen; er wordt niets weggeschreven voordat je bevestigt. Lege CSV-cellen wissen geen bestaande gegevens. Begin met het CSV-sjabloon.

Blokken, shortcodes en ontwikkelaars

  • Blokken Productpaspoort (kaart met QR-code, alleen QR-code of link) en QR-code van het paspoort.
  • Shortcodes [dfdpp_passport product="123" layout="card|qr|link" qr="no" size="112"] en [dfdpp_qr product="123" size="160"]; zonder product wordt het huidige product gebruikt.
  • 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. Schrijfaanroepen vereisen een gebruiker die het product mag bewerken (applicatiewachtwoorden werken). Beschrijving: /wp-json/dfdpp/v1/openapi.
  • WP-CLI: wp dfdpp status, list, publish, unpublish, qr, export.
  • Sjabloon: kopieer templates/passport.php naar your-theme/dfdpp/passport.php. Filter dfdpp_passport_payload; actions dfdpp_passport_created, dfdpp_passport_saved, dfdpp_public_head.

Probleemoplossing

De openbare pagina geeft een 404-fout

Het paspoort is een concept of gearchiveerd, of het product is nooit gepubliceerd. Het overzicht toont de reden. Paspoorten van producten die niet meer worden verkocht blijven online, tenzij je hebt gekozen om ze te verbergen.

Een waarde wordt niet opgeslagen

Na het opslaan somt een melding de geweigerde waarden op en worden de velden in de editor gemarkeerd. Corrigeer ze en sla opnieuw op.

Mijn paginacache toont beperkte gegevens

Beperkte gegevens worden alleen verzonden naar verzoeken met een toegangssleutel of van je eigen team. Als je een paginacache gebruikt, laat die dan variëren op de header X-DPP-Access-Key en op inlogcookies (de plugin stuurt de bijbehorende Vary-header mee).

Verwijderen

Bij het deactiveren van de plugin blijven alle gegevens bewaard. Ook bij het verwijderen blijven de paspoorten bewaard, zodat een herinstallatie ze met hun adressen terugbrengt. Om alles te verwijderen (tabellen, instellingen, toegangssleutels), vink je Alle paspoorten en instellingen verwijderen aan in Instellingen > Gegevens en verwijderen voordat je de plugin verwijdert.

Door de gegevens te verwijderen, verdwijnen de pagina’s achter je afgedrukte QR-codes. Exporteer eerst je paspoorten.

Ondersteuning

Ondersteuning wordt per e-mail gegeven in het Frans en het Engels via support@datafirefly.com. Vermeld de versies van de plugin, WordPress en WooCommerce.

Was deze pagina nuttig?

Loopt u nog vast? Neem contact op met support