Digital Product Passport (DPP) — Guida completa

Il modulo DataFirefly — Digital Product Passport (dfdpp) aggiunge al vostro negozio PrestaShop 8 o 9 un sistema completo di passaporto digitale di prodotto conforme al regolamento europeo ESPR (Ecodesign for Sustainable Products Regulation), applicabile progressivamente dal 2027 per il tessile, le batterie e l’elettronica.

Ogni prodotto riceve un passaporto con identificativo unico (UUID), una pagina pubblica multilingue accessibile tramite codice QR, un registro dei componenti (distinta base / BOM), un registro degli eventi del ciclo di vita e una gestione dei certificati di conformità.

Requisiti

• PrestaShop da 8.0.0 a 9.x
• PHP 7.4 minimo (8.1+ consigliato)
• Estensione GD attiva (rendering QR di riserva se Endroid non è disponibile)
• Compatibile multinegozio e multilingue (FR / EN / ES / DE / IT inclusi)

Installazione

1. Nel back-office, aprite Moduli > Gestione moduli.
2. Fate clic su Carica un modulo e caricate dfdpp.zip.
3. Il modulo crea automaticamente le sue tabelle, il suo menu Passaporti prodotto sotto Catalogo e registra le sue rotte pubbliche.

Configurazione

Aprite Moduli > dfdpp > Configura. Sono disponibili tre blocchi:

Impostazioni generali

• Attiva il modulo — interruttore globale.
• Creazione automatica — genera un passaporto bozza a ogni salvataggio di prodotto.
• Categoria ESPR predefinita — tessile, batteria, elettronica, arredamento, calzature o generale.
• Visualizzazione pubblica — attiva la pagina pubblica /dpp/{uuid}.
• Scheda pagina prodotto — mostra il passaporto in una scheda della pagina prodotto.
• Esportazione JSON pubblica — consente di scaricare il passaporto in formato JSON.

Codice QR

• Dimensione (predefinita 220 px) e margine (10 px).
• Livello di correzione degli errori — M consigliato (equilibrio densità / robustezza).

Informazioni aziendali

Nome, partita IVA, indirizzo e paese dell’operatore economico responsabile — queste informazioni appaiono sulla pagina pubblica del passaporto, come richiesto dall’ESPR.

Creare un passaporto

Creazione automatica

Se l’opzione è attiva, un passaporto in stato bozza viene creato a ogni salvataggio di prodotto, con la categoria ESPR predefinita. Diventa visibile pubblicamente solo dopo essere stato pubblicato manualmente.

Creazione manuale

1. Aprite Catalogo > Passaporti prodotto > Passaporti.
2. Fate clic su Aggiungi, selezionate il prodotto (e la combinazione se necessario).
3. Compilate i campi e salvate: un UUID v4 unico viene generato automaticamente.

Dati del passaporto

Il modulo è organizzato in cinque blocchi:

• Identificazione — prodotto, combinazione, categoria ESPR, GTIN, produttore, paese di origine, data di produzione, numero di lotto.
• Sostenibilità — impronta di carbonio (kg CO₂e), punteggio di riciclabilità, percentuale di contenuto riciclato, indice di riparabilità, durata di vita prevista, garanzia.
• Contenuti multilingue — composizione dei materiali, istruzioni di cura, istruzioni di smaltimento e fine vita, informazioni di riparazione, informazioni di sicurezza, certificati di conformità (sei campi di testo ricco, traducibili in ogni lingua del negozio).
• Componenti, eventi e documenti — gestiti via AJAX direttamente nella scheda del passaporto (vedi sotto).
• Campi personalizzati — un oggetto JSON libero per qualsiasi dato settoriale aggiuntivo.

Registro dei componenti (BOM)

Ogni passaporto può registrare la sua distinta base completa: nome del componente, materiale, peso (g), percentuale del prodotto, quota riciclata, riciclabilità, pericolosità, numero CAS, fornitore e paese. I componenti possono essere annidati (componente padre / sottocomponente) per modellare gli assemblaggi.

Il menu Catalogo > Passaporti prodotto > Registro offre una vista trasversale di tutti i componenti del negozio, filtrabile per materiale, pericolosità o fornitore — pratico per gli audit REACH.

Eventi del ciclo di vita

Il registro traccia la vita del prodotto: progettazione, materia prima, fabbricazione, controllo qualità, distribuzione, prima vendita, rivendita, riparazione, ricondizionamento, riciclo, fine vita. Ogni evento porta una data, un luogo, un attore (nome + ruolo), una descrizione e un URL di prova opzionale.

La vista Catalogo > Passaporti prodotto > Eventi centralizza tutti gli eventi con filtro per tipo.

Documenti e certificati

Allegate a ogni passaporto i certificati richiesti: dichiarazione CE, REACH, RoHS, RAEE, regolamento batterie UE, OEKO-TEX, GOTS, Ecolabel, FSC, ISO 14001 / 9001, PEF, EPD o altri. Ogni documento porta un numero, un emittente, date di validità e un URL di file.

Punteggio di conformità ESPR

Il modulo valuta ogni passaporto secondo regole specifiche della sua categoria ESPR e mostra un punteggio su 100 accompagnato da un livello:

• Conforme — punteggio ≥ 90 senza punti bloccanti.
• Parziale — punteggio ≥ 60.
• Bozza — dati incompleti.
• Non conforme — punti bloccanti presenti.

L’elenco delle verifiche e dei punti bloccanti è dettagliato nella scheda del passaporto; il pulsante Ricalcola aggiorna il punteggio dopo le modifiche.

Pagina pubblica e codice QR

Ogni passaporto pubblicato è accessibile all’indirizzo https://vostro-negozio.com/dpp/{uuid} e il suo codice QR PNG a /dpp/{uuid}/qr.png (parametro ?size= accettato da 80 a 800 px, cache del browser di 24 ore).

La pagina pubblica presenta: immagine e identità del prodotto, codice QR, indicatori di sostenibilità, composizione, tabella dei componenti, cura e riparazione, istruzioni di smaltimento, cronologia del ciclo di vita, certificati, informazioni di sicurezza e dati dell’operatore responsabile. Include markup JSON-LD schema.org per la SEO.

Visualizzazione sulla pagina prodotto

Se l’opzione è attiva, una scheda Passaporto digitale appare sulla pagina prodotto del front-office con il codice QR, gli indicatori chiave e il link alla pagina pubblica. Un blocco di riserva può inoltre essere mostrato sotto la descrizione.

GDPR e registro degli accessi

Le consultazioni pubbliche possono essere registrate in forma anonimizzata: l’indirizzo IP viene sottoposto a hash con SHA-256, un sale giornaliero e la chiave segreta del negozio — nessun dato personale sfruttabile viene conservato. L’opzione può essere disattivata nella configurazione.

Multinegozio e multilingue

I passaporti sono collegati a un negozio (contesto multinegozio rispettato) e tutti i contenuti editoriali esistono in ogni lingua attiva. Il modulo è fornito tradotto in francese, inglese, spagnolo, tedesco e italiano (formato XLIFF, modificabile in Internazionale > Traduzioni).

Disinstallazione e conservazione dei dati

Alla disinstallazione, la configurazione e le schede di amministrazione vengono rimosse, ma le tabelle dati vengono conservate: il regolamento ESPR richiede la disponibilità del passaporto per tutta la durata di vita del prodotto. Per un’eliminazione definitiva, eliminate manualmente le tabelle ps_dfdpp_*.

Risoluzione dei problemi

La pagina /dpp/{uuid} restituisce un 404

• Verificate che il passaporto sia pubblicato e che la visualizzazione pubblica sia attiva.
• Svuotate la cache di PrestaShop (Parametri avanzati > Prestazioni) per rigenerare le rotte.
• Verificate la riscrittura degli URL (URL semplificati attivi).

Il codice QR non viene visualizzato

• Verificate che l’estensione PHP GD sia attiva se la vostra installazione non include Endroid QR Code.

La scheda non appare sulla pagina prodotto

• Attivate l’opzione Scheda pagina prodotto nella configurazione e verificate che il vostro tema supporti l’hook displayProductExtraContent.

Cronologia delle versioni

• 1.0.0 — Versione iniziale: passaporti UUID, pagina pubblica multilingue, codici QR, componenti annidati, eventi del ciclo di vita, documenti, punteggio di conformità ESPR per categoria, esportazione JSON / JSON-LD, registro accessi GDPR, multinegozio.