# Conformità GPSR (sicurezza del prodotto) — Guida completa

> Presentazione Il modulo Conformità GPSR (datafireflygpsr) attrezza il suo negozio per il regolamento (UE) 2023/988 sulla sicurezza generale dei prodotti, applicabile dal 13 dicembre 2024. Mostra su ogni pagina prodotto…

- Pagina: <https://www.datafirefly.com/it/documentation/datafireflygpsr/>
- Lingua: it
- Aggiornato il: 2026-06-27
- Altre lingue: [fr](https://www.datafirefly.com/documentation/datafireflygpsr/index.md), [en](https://www.datafirefly.com/en/documentation/datafireflygpsr/index.md), [es](https://www.datafirefly.com/es/documentation/datafireflygpsr/index.md), [de](https://www.datafirefly.com/de/documentation/datafireflygpsr/index.md), [pl](https://www.datafirefly.com/pl/documentation/datafireflygpsr/index.md), [nl](https://www.datafirefly.com/nl/documentation/datafireflygpsr/index.md), [pt](https://www.datafirefly.com/pt/documentation/datafireflygpsr/index.md)
- Indice: <https://www.datafirefly.com/it/documentation/llms.txt>

## Presentazione

Il modulo **Conformità GPSR** (`datafireflygpsr`) attrezza il suo negozio per il **regolamento (UE) 2023/988** sulla sicurezza generale dei prodotti, applicabile dal 13 dicembre 2024. Mostra su ogni pagina prodotto il **fabbricante**, il **responsabile stabilito nell'Unione europea**, le **avvertenze di sicurezza** e i **pittogrammi regolamentari**, nella lingua del cliente.

Il modulo fornisce gli strumenti tecnici per raccogliere e mostrare le informazioni richieste. La conformità normativa dipende anche dall'esattezza delle informazioni che inserisce e dall'analisi del rischio propria di ciascun prodotto. Non sostituisce la consulenza legale.

## Compatibilità

- PrestaShop 8.0 a 9.x
- PHP 7.4 a 8.3
- MySQL 5.7+ o MariaDB 10.3+
- Mononegozio e multinegozio
- Tema Classic, Hummingbird e temi personalizzati
- Interfaccia e dati forniti in francese, inglese, spagnolo, tedesco e italiano
- Nessuna dipendenza (né Composer né framework), nessun CDN

## Installazione

1. Nel back office, apra **Moduli > Gestore dei moduli**.
2. Clicchi su **Carica un modulo** e selezioni il file `datafireflygpsr.zip`.
3. Una volta installato, clicchi su **Configura**.

All'installazione, il modulo crea le sue tabelle, registra i suoi hook (risorse back office e front, scheda della pagina prodotto, blocco di visualizzazione nel negozio), aggiunge il menu **Catalogo > GPSR** e precarica dati di esempio: quattro pittogrammi (avvertenza, età 0-3 anni, marcatura CE, infiammabile) e due avvertenze di esempio (rischio di soffocamento, sorveglianza di un adulto), tradotti nelle cinque lingue.

## Avvio rapido

1. Crei i suoi **operatori economici** (almeno un fabbricante e, se necessario, un responsabile UE) in **Catalogo > GPSR > Operatori**.
2. Verifichi o completi la libreria di **pittogrammi** e **avvertenze**.
3. Nella configurazione del modulo, definisca eventualmente un fabbricante e un responsabile UE **predefiniti**.
4. Apra una pagina prodotto, vada alla scheda **GPSR**, compili le informazioni e clicchi su **Salva GPSR**.
5. Verifichi la visualizzazione nel negozio sulla pagina prodotto.

## Configurazione del modulo

- **Attivare la visualizzazione GPSR**: attiva o disattiva la visualizzazione delle informazioni nel negozio.
- **Modalità di visualizzazione**: _Scheda dedicata_ (una scheda «Sicurezza del prodotto» sulla pagina) o _Blocco in linea_ (sotto le informazioni del prodotto).
- **Mostrare i pittogrammi**: mostra o nasconde la griglia di pittogrammi nel negozio.
- **Mostrare le avvertenze**: mostra o nasconde l'elenco delle avvertenze nel negozio.
- **Nascondere se vuoto**: non mostra alcuna cornice quando un prodotto non ha dati GPSR compilati.
- **Fabbricante predefinito** e **Responsabile UE predefinito**: operatori applicati automaticamente ai prodotti senza valore specifico (vedi «Valori predefiniti»).

## Gestire gli operatori economici

Gli operatori economici si gestiscono una sola volta e si riutilizzano in tutto il catalogo, da **Catalogo > GPSR > Operatori**. Sono disponibili quattro **tipi**:

- **Fabbricante**: il soggetto che produce il bene o lo fa produrre con il proprio nome.
- **Importatore**: il soggetto che immette sul mercato dell'Unione un prodotto proveniente da un paese terzo.
- **Mandatario**: la persona incaricata dal fabbricante di agire in suo nome nell'UE.
- **Responsabile UE**: la persona responsabile stabilita nell'Unione, richiesta quando il fabbricante è fuori dall'UE.

Ogni operatore porta la sua ragione sociale, il suo indirizzo completo, il suo paese, la sua email, il suo telefono, il suo sito e la sua partita IVA.

Corregga un indirizzo una sola volta sull'operatore: la modifica si propaga all'istante a tutti i prodotti che lo utilizzano, senza reinserimento prodotto per prodotto.

## Gestire i pittogrammi

Da **Catalogo > GPSR > Pittogrammi**, crei, modifichi o elimini i pittogrammi di sicurezza. Ogni pittogramma ha un codice, un'immagine (SVG o PNG, caricata nel modulo), una posizione di visualizzazione e, per ogni lingua, un nome e una didascalia.

- Quattro pittogrammi sono forniti di serie: avvertenza generale, fascia di età 0-3 anni, marcatura CE, prodotto infiammabile.
- Può crearne quanti ne servono e caricare i propri visual.

Resta sua responsabilità scegliere i pittogrammi adatti a ciascun prodotto secondo la normativa applicabile.

## Gestire le avvertenze

Da **Catalogo > GPSR > Avvertenze**, gestisca la libreria di avvertenze di sicurezza. Ogni avvertenza ha un codice, una posizione e, per ogni lingua, il suo testo.

- Due avvertenze di esempio sono fornite di serie: rischio di soffocamento (piccole parti) e uso sotto la sorveglianza di un adulto.
- I testi sono tradotti nelle cinque lingue e personalizzabili.

## Compilare i dati GPSR di un prodotto

Apra una pagina prodotto nel back office: viene aggiunta una scheda **GPSR**. Vi trova:

- la selezione del **fabbricante** e del **responsabile UE** tra i suoi operatori;
- i campi **GTIN** e **numero di lotto**;
- le **avvertenze** applicabili (caselle);
- la griglia di **pittogrammi** selezionabili;
- un'area di **informazione di sicurezza complementare** in testo libero, multilingue.

Clicchi su **Salva GPSR** per salvare.

Il salvataggio dei dati GPSR passa per un **controller AJAX dedicato**, indipendente dal modulo prodotto Symfony. È una scelta architetturale deliberata: garantisce un comportamento identico e affidabile su PrestaShop 8 e 9, le cui pagine prodotto differiscono profondamente. Il pulsante «Salva GPSR» è quindi distinto dal pulsante «Salva» della pagina prodotto.

## Valori predefiniti e ripiego automatico

Se la maggior parte dei suoi prodotti condivide lo stesso fabbricante o lo stesso responsabile UE, li definisca una volta nella configurazione del modulo come **valori predefiniti**. Ogni prodotto senza fabbricante o responsabile specifico erediterà automaticamente questi valori nel negozio. Compila manualmente solo le eccezioni.

## Visualizzazione nel negozio

A seconda della modalità scelta, le informazioni GPSR vengono mostrate:

- in una **scheda dedicata** della pagina prodotto, tramite l'hook `displayProductExtraContent`;
- oppure in un **blocco in linea** sotto le informazioni del prodotto, tramite l'hook `displayProductAdditionalInfo`.

Il blocco presenta il fabbricante, il responsabile UE, le avvertenze, i pittogrammi (con le loro didascalie), l'informazione complementare e, se del caso, il GTIN e il numero di lotto. L'opzione **Nascondere se vuoto** evita qualsiasi cornice vuota sui prodotti senza dati.

## Cruscotto di copertura

Il menu **Catalogo > GPSR** apre un cruscotto che indica la quota del catalogo con i dati GPSR compilati: numero di prodotti coperti, numero di operatori, di pittogrammi e di avvertenze. La aiuta a individuare i prodotti ancora da completare.

## Multilingue

Le avvertenze, le didascalie dei pittogrammi e l'informazione complementare possono essere tradotte in francese, inglese, spagnolo, tedesco e italiano. La visualizzazione segue automaticamente la lingua attiva del cliente — ciò che il regolamento richiede, imponendo informazioni di sicurezza nella lingua del paese di commercializzazione. Le etichette dell'interfaccia si traducono tramite **Parametri avanzati > Traduzioni > Traduzioni dei moduli installati**, scegliendo `datafireflygpsr`.

## Compatibilità con PrestaShop 9

Il modulo è progettato e testato da PrestaShop 8.0 a 9.x:

- i controller di back office usano `ModuleAdminController`, compatibile con 8 e 9;
- il salvataggio dei dati di prodotto passa per un controller AJAX dedicato anziché per il modulo prodotto Symfony;
- il controller AJAX restituisce direttamente JSON, senza override di firma incompatibile.

## FAQ e risoluzione dei problemi

### La scheda GPSR non mostra i miei operatori

Verifichi di aver creato almeno un operatore in **Catalogo > GPSR > Operatori** e che sia attivo. I menu a tendina della pagina prodotto mostrano solo gli operatori attivi.

### Le informazioni non si mostrano nel negozio

Si assicuri che la visualizzazione GPSR sia attivata nella configurazione, che il prodotto abbia dati compilati (o che sia definito un fabbricante/responsabile predefinito), poi svuoti la cache di PrestaShop. Se l'opzione **Nascondere se vuoto** è attiva, un prodotto senza dati non mostra nulla di proposito.

### Il clic su «Salva GPSR» non salva

Il pulsante «Salva GPSR» è distinto dal pulsante «Salva» della pagina prodotto e attiva una richiesta AJAX dedicata. Svuoti la cache, ricarichi la pagina prodotto e verifichi nella console del browser che nessuna estensione blocchi la richiesta.

### Come aggiungo il mio pittogramma?

In **Catalogo > GPSR > Pittogrammi**, crei un pittogramma, carichi la sua immagine (SVG o PNG) e compili nome e didascalia per ogni lingua.

### È compatibile con PrestaShop 9?

Sì. Il modulo è progettato e testato da PrestaShop 8.0 a 9.x, sia in mononegozio sia in multinegozio.

## Disinstallazione

La disinstallazione rimuove le tabelle del modulo e le sue schede di amministrazione e deregistra gli hook. Operatori, pittogrammi, avvertenze e associazioni di prodotto vengono cancellati. Se prevede di reinstallare, conservi prima un backup del suo database.
