# 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… - Pagina: - Lingua: it - Aggiornato il: 2026-07-01 - Altre lingue: [fr](https://www.datafirefly.com/documentation/dfdpp/index.md), [en](https://www.datafirefly.com/en/documentation/dfdpp/index.md), [es](https://www.datafirefly.com/es/documentation/dfdpp/index.md), [de](https://www.datafirefly.com/de/documentation/dfdpp/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfdpp/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfdpp/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfdpp/index.md) - Indice: 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. Nessuna libreria esterna è inclusa: il modulo utilizza Endroid QR Code fornito con il core di PrestaShop (v3, v4 o v5 rilevata automaticamente), con un renderer GD di riserva. ## 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. Dalla scheda prodotto del back-office, la scheda **Passaporto digitale** permette di creare o aprire direttamente il passaporto del prodotto in modifica. ## 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. Un certificato scaduto viene segnalato come _bloccante_ dal motore di conformità e riduce il punteggio del passaporto. ## 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. Stampate il codice QR sull'etichetta, il libretto o l'imballaggio del prodotto: è la modalità di accesso prevista dall'ESPR per il consumatore finale, i riparatori e i riciclatori. ## 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.