Wo WooCommerce Intermedio

DataFirefly Digital Product Passport — Documentazione

Installa e usa Digital Product Passport 2.0 per WooCommerce: procedura guidata di configurazione, modelli di settore, editor del passaporto e anteprima dal vivo, variazioni, codici QR ed etichette, GS1 Digital Link, livelli e chiavi di accesso, importazione/esportazione, API REST, normative e risoluzione dei problemi.

Aggiornato Versione del modulo 2.0.0

Panoramica

DataFirefly Digital Product Passport dà a ogni prodotto WooCommerce, e a ogni variazione che ne ha bisogno, un passaporto digitale del prodotto: identificativi, fabbricante, dati ambientali, durabilità e riparazione, materiali, componenti, istruzioni, sostanze che destano preoccupazione, documenti e fasi di tracciabilità. Ogni passaporto ha un indirizzo pubblico permanente e un codice QR da stampare sul prodotto, sul suo imballaggio o sui suoi documenti.

La versione 2.0 aggiunge una panoramica di tutto il tuo catalogo, una procedura guidata di configurazione con modelli di settore, un editor con punteggio di completezza e anteprima dal vivo, passaporti per le variazioni, una pagina pubblica progettata per smartphone in 8 lingue, codici QR in formati di stampa e fogli di etichette, GS1 Digital Link, livelli di accesso con chiavi di accesso, una cronologia delle versioni, importazione ed esportazione CSV/JSON, blocchi e un’API REST documentata.

DataFirefly Passaporto digitale del prodotto – Panoramica dei passaporti: completezza, prodotti senza passaporto e prossima scadenza UE
Panoramica dei passaporti: completezza, prodotti senza passaporto e prossima scadenza UE
In breve: installa il plugin, segui la configurazione in Passaporti, completa la scheda Passaporto del prodotto di un prodotto, controlla l’Anteprima dal vivo, pubblica e poi stampa il codice QR.

Che cosa richiedono le regole dell’UE

Il regolamento (UE) 2024/1781 sulla progettazione ecocompatibile dei prodotti sostenibili (ESPR) da solo non rende obbligatorio un passaporto: ogni gruppo di prodotti richiede un atto delegato, che si applica almeno 18 mesi dopo la sua entrata in vigore. A novembre 2026 non era ancora stato adottato alcun atto delegato dell’ESPR che imponga un passaporto. La Commissione prevede prima il ferro e l’acciaio, poi i tessili, gli pneumatici e l’alluminio (2027), i mobili (2028) e i materassi (2029). Il passaporto delle batterie del regolamento (UE) 2023/1542 si applica dal 18 febbraio 2027 alle batterie LMT, alle batterie industriali di capacità superiore a 2 kWh e alle batterie per veicoli elettrici.

Il plugin ti aiuta a strutturare e pubblicare i dati. Da solo non rende conformi i tuoi prodotti: non è collegato al registro dei passaporti dell’UE, non fornisce la copia di backup presso un fornitore indipendente di servizi per i passaporti richiesta dall’ESPR e non è stato valutato rispetto alle norme armonizzate per i passaporti. La schermata Passaporti > Normative elenca ogni requisito con il suo stato (Coperto, Parzialmente coperto, Non coperto, A tuo carico) e la sua fonte ufficiale.

DataFirefly Passaporto digitale del prodotto – Normativa e copertura: ESPR e passaporto della batteria, cosa copre il plugin
Normativa e copertura: ESPR e passaporto della batteria, cosa copre il plugin
Le informazioni contenute in un passaporto sono fornite sotto la responsabilità dell’operatore economico che immette il prodotto sul mercato. Verifica con un consulente legale le regole che si applicano ai tuoi prodotti.

Installazione e aggiornamento

  1. In Plugin > Aggiungi plugin > Carica plugin, scegli dfdpp-2.0.0.zip, poi attiva DataFirefly Digital Product Passport.
  2. Apri Passaporti nel menu di amministrazione.

Requisiti: WordPress 6.4 o successivo, WooCommerce 8.2 o successivo, PHP da 7.4 a 8.5. Gli indirizzi pubblici funzionano senza dover salvare di nuovo i permalink.

Aggiornamento dalla versione 1.0

Carica il nuovo zip e scegli Sostituisci l’attuale con quello caricato. I passaporti, i loro identificativi, i loro indirizzi pubblici e le tue impostazioni vengono conservati; i codici QR già stampati continuano a funzionare. I codici paese vengono normalizzati, la completezza di ogni passaporto viene calcolata e viene registrata una prima versione di ogni passaporto pubblicato. Le scelte di visualizzazione della versione 1.0 diventano livelli di accesso (i dati nascosti diventano “Solo interno”). Un avviso presenta le novità.

Procedura guidata di configurazione

In una nuova installazione, la panoramica propone una configurazione in tre passaggi:

  1. La tua azienda: nome, indirizzo e paese del fabbricante, identificativo dell’operatore (ad esempio il tuo numero EORI o il GLN GS1) e un contatto per le informazioni sul prodotto. Questi dati precompilano ogni nuovo passaporto.
  2. Settore e visualizzazione: un modello di settore (tessili, batterie, elettronica, mobili o altri prodotti), il colore del marchio della pagina pubblica e ciò che compare nelle pagine dei prodotti.
  3. Primi passaporti: crea passaporti in bozza per tutti i prodotti che non ne hanno uno, oppure per alcune categorie. Non viene pubblicato nulla.
DataFirefly Passaporto digitale del prodotto – Procedura di configurazione con modelli per settore: tessile, batterie, elettronica, mobili
Procedura di configurazione con modelli per settore: tessile, batterie, elettronica, mobili

Panoramica dei tuoi passaporti

Passaporti > Panoramica mostra il numero di passaporti, la completezza media, i prodotti senza passaporto e la prossima scadenza UE. La tabella può essere filtrata per stato, per settore e per passaporti incompleti, e puoi cercare per prodotto, GTIN, modello o SKU. Per ogni passaporto vedi la completezza, i primi elementi mancanti, lo stato, la versione e l’ultimo aggiornamento.

Le azioni di gruppo si applicano ai passaporti selezionati: pubblica, riporta in bozza, archivia, stampa etichette, esporta in CSV o JSON. Sotto la tabella, crea passaporti in bozza per i prodotti che non ne hanno, con il modello di settore che preferisci.

Un passaporto pubblicato il cui prodotto non è ancora pubblicato resta nascosto al pubblico: la panoramica lo segnala come “Nascosto: prodotto non pubblico”.

Modificare un passaporto

Apri un prodotto: la scheda Passaporto del prodotto del riquadro dati del prodotto contiene l’editor. Per un prodotto senza passaporto, seleziona Crea un passaporto per questo prodotto quando lo salvo (l’opzione viene selezionata automaticamente non appena scrivi in un campo).

DataFirefly Passaporto digitale del prodotto – Editor del passaporto nella scheda prodotto, con completezza e controlli
Editor del passaporto nella scheda prodotto, con completezza e controlli

L’intestazione mostra l’anello di completezza, lo stato (Bozza, Pubblicato, Archiviato), il pulsante Anteprima dal vivo e il link alla pagina pubblica. Le sezioni sono elencate a sinistra con il numero di elementi mancanti; usa i tasti freccia per spostarti tra di esse.

  • Identificazione: settore del prodotto (determina gli elementi attesi), GTIN con verifica della cifra di controllo, modello, che cosa copre il passaporto (un modello, un lotto o un singolo articolo), lotto, numero di serie, paese di fabbricazione.
  • Fabbricante e operatore: fabbricante, identificativo dell’operatore, operatore economico responsabile nell’UE (importatore o mandatario), contatto, data di fabbricazione, sito e identificativo dello stabilimento.
  • Ambiente: impronta di carbonio con la sua unità e il metodo di calcolo, contenuto riciclato, quota riciclabile, durata prevista, peso.
  • Durabilità e riparazione: punteggio di riparabilità, classe di riparabilità, garanzia commerciale, pezzi di ricambio e aggiornamenti software.
  • Dati di settore: campi suggeriti per il settore, ad esempio i paesi di filatura, tessitura, finissaggio e confezione per i tessili, oppure categoria, chimica, capacità, tensione, energia, durata in cicli e quote di cobalto, litio, nichel e piombo riciclati per le batterie.
  • Materiali, Componenti, Istruzioni (uso, manutenzione, riparazione, sicurezza, riciclo, fine vita), Conformità e documenti e Tracciabilità.

I campi attesi per il settore sono contrassegnati da un punto. I valori vengono controllati mentre scrivi (GTIN, intervalli numerici, date, indirizzi web); i valori non validi inviati comunque vengono rifiutati al salvataggio, elencati in un avviso e segnalati sul campo, e il passaporto non viene pubblicato finché non sono corretti.

Materiali e componenti

Aggiungi una riga per ogni materiale: codice (plastiche, fibre tessili, metalli, chimiche delle batterie…) o nome libero, quota nel prodotto, peso, quota riciclata, rinnovabile o a base biologica, origine, numero CAS e, se necessario, il componente a cui appartiene. Il totale delle quote viene mostrato e non deve superare il 100 %.

DataFirefly Passaporto digitale del prodotto – Composizione dei materiali con controllo delle percentuali e collegamento ai componenti
Composizione dei materiali con controllo delle percentuali e collegamento ai componenti

I componenti hanno nome, tipo, peso, origine, fornitore e paese del fornitore, oltre agli indicatori “Sostituibile”, “Riciclabile” e “Contiene materie prime critiche”. I documenti (dichiarazione di conformità, manuali, certificati…) possono essere scelti dalla libreria media.

Anteprima dal vivo

Anteprima dal vivo mostra la pagina pubblica con le modifiche non salvate, su uno smartphone o un computer. Si aggiorna mentre scrivi.

DataFirefly Passaporto digitale del prodotto – Anteprima dal vivo della pagina pubblica del passaporto su smartphone
Anteprima dal vivo della pagina pubblica del passaporto su smartphone

Variazioni

Nella scheda Variazioni, seleziona Passaporto del prodotto specifico per questa variazione: la variazione riceve GTIN, modello, lotto, numero di serie, impronta di carbonio, peso e codice QR propri. Gli altri dati vengono ereditati dal passaporto del prodotto. Il passaporto del prodotto elenca i passaporti delle variazioni.

Codici QR ed etichette

La sezione Codice QR ed etichette dell’editor mostra l’indirizzo codificato, la versione QR e la sua correzione degli errori, e offre:

  • SVG (vettoriale, per la stampa), PNG 1024 px e PNG 20, 30 o 50 mm, 300 dpi;
  • un’etichetta stampabile con il codice QR, il nome del prodotto, il GTIN, il lotto o il numero di serie e l’indirizzo;
  • l’identificativo del passaporto, la pagina pubblica, l’indirizzo GS1 Digital Link e i dati JSON.
DataFirefly Passaporto digitale del prodotto – Codice QR per la stampa (SVG, PNG 20, 30, 50 mm), etichette e GS1 Digital Link
Codice QR per la stampa (SVG, PNG 20, 30, 50 mm), etichette e GS1 Digital Link

Per stampare più etichette, seleziona i passaporti nella panoramica e scegli Stampa etichette. Stampa al 100 % e mantieni il margine bianco intorno al codice.

DataFirefly Passaporto digitale del prodotto – Foglio di etichette stampabile con i codici QR di più passaporti
Foglio di etichette stampabile con i codici QR di più passaporti
L’indirizzo codificato nel codice QR non cambia mai, anche se in seguito modifichi il prefisso dell’URL: il prefisso precedente reindirizza a quello nuovo.

La pagina pubblica del passaporto

L’indirizzo pubblico ha la forma yourdomain.com/dpp/{identifier}/. La pagina è progettata per smartphone e segue la lingua del dispositivo del visitatore (8 lingue, con un menu delle lingue). Mostra il prodotto, il suo settore e i suoi identificativi, i dati chiave, la composizione dei materiali, i componenti, i dati di settore, le istruzioni, le informazioni e i documenti di conformità, la cronologia della tracciabilità, il fabbricante, il codice QR (scarica, condividi, stampa) e i dettagli del passaporto (identificativo, date, versione e impronta SHA-256).

DataFirefly Passaporto digitale del prodotto – Pagina pubblica del passaporto: dati chiave, materiali, componenti, istruzioni, documenti
Pagina pubblica del passaporto: dati chiave, materiali, componenti, istruzioni, documenti
DataFirefly Passaporto digitale del prodotto – Passaporto della batteria su smartphone, come appare dopo la scansione del codice QR
Passaporto della batteria su smartphone, come appare dopo la scansione del codice QR

La pagina è accessibile da tastiera e con lettori di schermo, si adatta alla modalità scura e si stampa in modo pulito. Offre anche i suoi dati in JSON (/dpp/{identifier}.json) e include JSON-LD schema.org. Nelle pagine dei prodotti, una scheda Passaporto del prodotto (o un riquadro sotto il riepilogo) rimanda al passaporto.

DataFirefly Passaporto digitale del prodotto – Scheda «Passaporto del prodotto» nella pagina prodotto WooCommerce
Scheda «Passaporto del prodotto» nella pagina prodotto WooCommerce

Impostazioni

In Passaporti > Impostazioni (amministratori e gestori del negozio):

  • Pagina pubblica: prefisso dell’URL (effetto immediato), pagina autonoma o all’interno del tema, lingue, indicizzazione nei motori di ricerca, visualizzazione nelle pagine dei prodotti, ereditarietà delle variazioni, pubblicazione automatica, passaporti dei prodotti non più in vendita (mantenuti online per impostazione predefinita).
  • Dati predefiniti dell’azienda: valori precompilati dei nuovi passaporti e settore predefinito.
  • Accesso ai dati e API: il livello di accesso di ogni tipo di dato, le chiavi di accesso e l’API REST.
  • Codici QR ed etichette: indirizzo del passaporto o GS1 Digital Link, correzione degli errori, colore (solo colori scuri), formato di download, dimensione delle etichette.
  • Aspetto: colore del marchio (il colore del testo sovrapposto viene scelto per la leggibilità) e logo.
  • Dati e disinstallazione: elimina tutto quando il plugin viene eliminato (non selezionato per impostazione predefinita).

Livelli e chiavi di accesso

Per ogni tipo di dato — fabbricante, sito di fabbricazione, ambiente, impronta di carbonio, durabilità, istruzioni, conformità, documenti, componenti, nomi dei fornitori, materiali, tracciabilità, chi ha svolto ogni fase, dati di settore — scegli Pubblico, Soggetti autorizzati (chiave di accesso) o Solo interno. I nomi dei fornitori sono interni per impostazione predefinita. Gli identificativi, il nome del prodotto e il paese di fabbricazione sono sempre pubblici.

DataFirefly Passaporto digitale del prodotto – Livelli di accesso ai dati, chiavi di accesso per soggetti autorizzati e API REST
Livelli di accesso ai dati, chiavi di accesso per soggetti autorizzati e API REST

Crea una chiave di accesso per un’autorità, un riparatore, un riciclatore o un partner: viene mostrata una sola volta, poi memorizzata come hash. Il destinatario la invia nell’intestazione X-DPP-Access-Key quando legge l’indirizzo JSON o l’API. Puoi revocare una chiave in qualsiasi momento.

Quando un passaporto ha un GTIN valido, riceve un indirizzo GS1 Digital Link sul tuo dominio, ad esempio yourdomain.com/01/09506000134352/10/LOT42 (con il lotto o il numero di serie a seconda di ciò che copre il passaporto). Il plugin risponde a questi indirizzi e reindirizza al passaporto; ?linkType=linkset restituisce l’elenco dei link. Nelle impostazioni QR puoi scegliere di codificare questo indirizzo nei codici QR.

Importazione ed esportazione

Passaporti > Importa / esporta:

  • Esporta tutti i passaporti, o quelli di un solo stato, in CSV o JSON. Il JSON conserva tutti gli elenchi (materiali, componenti, fasi, documenti). Conservalo come backup.
  • Importa un file CSV (virgola, punto e virgola o tabulazione) o JSON. Le righe vengono abbinate per uuid, poi per product_id, poi per sku. Il plugin mostra prima ciò che verrà creato, aggiornato o ignorato, con eventuali avvisi; nulla viene scritto prima della tua conferma. Le celle CSV vuote non cancellano i dati esistenti. Parti dal modello CSV.

Blocchi, shortcode e sviluppatori

  • Blocchi Passaporto del prodotto (riquadro con codice QR, solo QR o link) e Codice QR del passaporto.
  • Shortcode [dfdpp_passport product="123" layout="card|qr|link" qr="no" size="112"] e [dfdpp_qr product="123" size="160"]; senza product viene usato il prodotto corrente.
  • API REST 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. Le chiamate in scrittura richiedono un utente autorizzato a modificare il prodotto (le password per le applicazioni funzionano). Descrizione: /wp-json/dfdpp/v1/openapi.
  • WP-CLI: wp dfdpp status, list, publish, unpublish, qr, export.
  • Template: copia templates/passport.php in your-theme/dfdpp/passport.php. Filtro dfdpp_passport_payload; azioni dfdpp_passport_created, dfdpp_passport_saved, dfdpp_public_head.

Risoluzione dei problemi

La pagina pubblica restituisce un errore 404

Il passaporto è in bozza o archiviato, oppure il suo prodotto non è mai stato pubblicato. La panoramica mostra il motivo. I passaporti dei prodotti non più in vendita restano online, a meno che tu non abbia scelto di nasconderli.

Un valore non viene salvato

Dopo il salvataggio, un avviso elenca i valori rifiutati e i campi vengono segnalati nell’editor. Correggili e salva di nuovo.

La mia cache delle pagine mostra dati riservati

I dati riservati vengono inviati solo alle richieste con una chiave di accesso o provenienti dal tuo team. Se usi una cache delle pagine, falla variare in base all’intestazione X-DPP-Access-Key e ai cookie di accesso (il plugin invia l’intestazione Vary corrispondente).

Disinstallazione

Disattivare il plugin conserva tutti i dati. Anche eliminarlo conserva i passaporti, così una reinstallazione li ripristina con i loro indirizzi. Per eliminare tutto (tabelle, impostazioni, chiavi di accesso), seleziona Elimina tutti i passaporti e le impostazioni in Impostazioni > Dati e disinstallazione prima di eliminare il plugin.

Eliminare i dati fa scomparire le pagine a cui rimandano i tuoi codici QR stampati. Esporta prima i tuoi passaporti.

Assistenza

L’assistenza è fornita via e-mail in francese e in inglese all’indirizzo support@datafirefly.com. Indica le versioni del plugin, di WordPress e di WooCommerce.

Questa pagina ti è stata utile?

Ancora bloccato? Contatta l'assistenza