# GPSR-Konformität (Produktsicherheit) — Komplettanleitung

> Überblick Das Modul GPSR-Konformität (datafireflygpsr) rüstet Ihren Shop für die Verordnung (EU) 2023/988 über die allgemeine Produktsicherheit, anwendbar seit dem 13. Dezember 2024. Es zeigt auf jeder Produktseite den Hersteller,…

- Seite: <https://www.datafirefly.com/de/documentation/datafireflygpsr/>
- Sprache: de
- Aktualisiert am: 2026-06-27
- Weitere Sprachen: [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), [it](https://www.datafirefly.com/it/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)
- Index: <https://www.datafirefly.com/de/documentation/llms.txt>

## Überblick

Das Modul **GPSR-Konformität** (`datafireflygpsr`) rüstet Ihren Shop für die **Verordnung (EU) 2023/988** über die allgemeine Produktsicherheit, anwendbar seit dem 13. Dezember 2024. Es zeigt auf jeder Produktseite den **Hersteller**, den **in der Europäischen Union ansässigen Verantwortlichen**, die **Sicherheitshinweise** und die **vorgeschriebenen Piktogramme** an, in der Sprache des Kunden.

Das Modul liefert das technische Werkzeug, um die geforderten Informationen zu erfassen und anzuzeigen. Die regulatorische Konformität hängt zudem von der Richtigkeit der von Ihnen eingegebenen Informationen und der produktspezifischen Risikobewertung ab. Es ersetzt keine Rechtsberatung.

## Kompatibilität

- PrestaShop 8.0 bis 9.x
- PHP 7.4 bis 8.3
- MySQL 5.7+ oder MariaDB 10.3+
- Einzelshop und Multishop
- Classic-Theme, Hummingbird und individuelle Themes
- Oberfläche und Daten in Französisch, Englisch, Spanisch, Deutsch und Italienisch geliefert
- Keine Abhängigkeit (weder Composer noch Framework), kein CDN

## Installation

1. Öffnen Sie im Back-Office **Module > Modul-Manager**.
2. Klicken Sie auf **Modul hochladen** und wählen Sie die Datei `datafireflygpsr.zip`.
3. Klicken Sie nach der Installation auf **Konfigurieren**.

Bei der Installation erstellt das Modul seine Tabellen, registriert seine Hooks (Back-Office- und Front-Ressourcen, Tab der Produktseite, Anzeigeblock im Shop), fügt das Menü **Katalog > GPSR** hinzu und befüllt Beispieldaten vor: vier Piktogramme (Warnung, Alter 0-3 Jahre, CE-Kennzeichnung, entflammbar) und zwei Beispielhinweise (Erstickungsgefahr, Aufsicht durch Erwachsene), in alle fünf Sprachen übersetzt.

## Schnellstart

1. Legen Sie Ihre **Wirtschaftsakteure** an (mindestens einen Hersteller und bei Bedarf einen EU-Verantwortlichen) unter **Katalog > GPSR > Akteure**.
2. Prüfen oder ergänzen Sie die Bibliothek der **Piktogramme** und **Hinweise**.
3. Legen Sie in der Modulkonfiguration optional einen **Standard**-Hersteller und -EU-Verantwortlichen fest.
4. Öffnen Sie eine Produktseite, gehen Sie zum Tab **GPSR**, füllen Sie die Informationen aus und klicken Sie auf **GPSR speichern**.
5. Prüfen Sie die Anzeige im Shop auf der Produktseite.

## Modulkonfiguration

- **GPSR-Anzeige aktivieren**: schaltet die Anzeige der Informationen im Shop ein oder aus.
- **Anzeigemodus**: _Eigener Tab_ (ein Tab „Produktsicherheit" auf der Seite) oder _Inline-Block_ (unter den Produktinformationen).
- **Piktogramme anzeigen**: zeigt oder verbirgt das Piktogramm-Raster im Shop.
- **Hinweise anzeigen**: zeigt oder verbirgt die Liste der Hinweise im Shop.
- **Ausblenden wenn leer**: zeigt keinen Rahmen, wenn ein Produkt keine GPSR-Daten enthält.
- **Standard-Hersteller** und **Standard-EU-Verantwortlicher**: Akteure, die automatisch auf Produkte ohne spezifischen Wert angewendet werden (siehe „Standardwerte").

## Wirtschaftsakteure verwalten

Wirtschaftsakteure werden einmal verwaltet und im gesamten Katalog wiederverwendet, über **Katalog > GPSR > Akteure**. Vier **Typen** stehen zur Verfügung:

- **Hersteller**: die Einheit, die das Produkt herstellt oder unter ihrem Namen herstellen lässt.
- **Importeur**: die Einheit, die ein Produkt aus einem Drittland auf dem Unionsmarkt in Verkehr bringt.
- **Bevollmächtigter**: die vom Hersteller beauftragte Person, in seinem Namen in der EU zu handeln.
- **EU-Verantwortlicher**: die in der Union ansässige verantwortliche Person, erforderlich, wenn der Hersteller außerhalb der EU ist.

Jeder Akteur trägt seinen Firmennamen, seine vollständige Adresse, sein Land, seine E-Mail, sein Telefon, seine Website und seine USt-IdNr.

Korrigieren Sie eine Adresse einmal am Akteur: Die Änderung wirkt sich sofort auf alle Produkte aus, die ihn verwenden, ohne erneute Eingabe Produkt für Produkt.

## Piktogramme verwalten

Über **Katalog > GPSR > Piktogramme** erstellen, bearbeiten oder löschen Sie die Sicherheitspiktogramme. Jedes Piktogramm hat einen Code, ein Bild (SVG oder PNG, in das Modul hochgeladen), eine Anzeigeposition und für jede Sprache einen Namen und eine Beschriftung.

- Vier Piktogramme werden ab Werk geliefert: allgemeine Warnung, Altersgruppe 0-3 Jahre, CE-Kennzeichnung, entflammbares Produkt.
- Sie können beliebig viele anlegen und eigene Bilder hochladen.

Die Auswahl der für das jeweilige Produkt nach geltendem Recht passenden Piktogramme bleibt in Ihrer Verantwortung.

## Hinweise verwalten

Über **Katalog > GPSR > Hinweise** verwalten Sie die Bibliothek der Sicherheitshinweise. Jeder Hinweis hat einen Code, eine Position und für jede Sprache seinen Text.

- Zwei Beispielhinweise werden ab Werk geliefert: Erstickungsgefahr (Kleinteile) und Verwendung unter Aufsicht eines Erwachsenen.
- Die Texte sind in alle fünf Sprachen übersetzt und anpassbar.

## GPSR-Daten eines Produkts ausfüllen

Öffnen Sie eine Produktseite im Back-Office: Ein Tab **GPSR** wird hinzugefügt. Dort finden Sie:

- die Auswahl des **Herstellers** und des **EU-Verantwortlichen** aus Ihren Akteuren;
- die Felder **GTIN** und **Chargennummer**;
- die zutreffenden **Hinweise** (Kontrollkästchen);
- das Raster auswählbarer **Piktogramme**;
- einen Bereich für **ergänzende Sicherheitsinformation** als Freitext, mehrsprachig.

Klicken Sie auf **GPSR speichern**, um zu speichern.

Die Speicherung der GPSR-Daten erfolgt über einen **dedizierten AJAX-Controller**, unabhängig vom Symfony-Produktformular. Dies ist eine bewusste Architekturentscheidung: Sie gewährleistet ein identisches, zuverlässiges Verhalten unter PrestaShop 8 und 9, deren Produktseiten sich grundlegend unterscheiden. Die Schaltfläche „GPSR speichern" ist daher von der Schaltfläche „Speichern" der Produktseite getrennt.

## Standardwerte und automatischer Rückgriff

Teilen sich die meisten Ihrer Produkte denselben Hersteller oder denselben EU-Verantwortlichen, legen Sie diese einmal in der Modulkonfiguration als **Standardwerte** fest. Jedes Produkt ohne spezifischen Hersteller oder Verantwortlichen erbt diese Werte automatisch im Shop. Sie pflegen nur die Ausnahmen manuell.

## Anzeige im Shop

Je nach gewähltem Modus werden die GPSR-Informationen angezeigt:

- in einem **eigenen Tab** der Produktseite, über den Hook `displayProductExtraContent`;
- oder in einem **Inline-Block** unter den Produktinformationen, über den Hook `displayProductAdditionalInfo`.

Der Block zeigt den Hersteller, den EU-Verantwortlichen, die Hinweise, die Piktogramme (mit ihren Beschriftungen), die ergänzende Information und gegebenenfalls die GTIN und die Chargennummer. Die Option **Ausblenden wenn leer** vermeidet jeden leeren Rahmen bei Produkten ohne Daten.

## Abdeckungs-Dashboard

Das Menü **Katalog > GPSR** öffnet ein Dashboard, das den Anteil des Katalogs mit ausgefüllten GPSR-Daten anzeigt: Anzahl der abgedeckten Produkte, Anzahl der Akteure, Piktogramme und Hinweise. Es hilft Ihnen, die noch zu vervollständigenden Produkte zu erkennen.

## Mehrsprachig

Hinweise, Piktogramm-Beschriftungen und ergänzende Information lassen sich ins Französische, Englische, Spanische, Deutsche und Italienische übersetzen. Die Anzeige folgt automatisch der aktiven Sprache des Kunden — was die Verordnung verlangt, die Sicherheitsinformationen in der Sprache des Vermarktungslandes vorschreibt. Oberflächentexte werden über **Erweiterte Parameter > Übersetzungen > Übersetzungen der installierten Module** übersetzt, indem Sie `datafireflygpsr` auswählen.

## PrestaShop-9-Kompatibilität

Das Modul ist von PrestaShop 8.0 bis 9.x konzipiert und getestet:

- die Back-Office-Controller verwenden `ModuleAdminController`, kompatibel mit 8 und 9;
- die Speicherung der Produktdaten erfolgt über einen dedizierten AJAX-Controller statt über das Symfony-Produktformular;
- der AJAX-Controller gibt direkt JSON zurück, ohne inkompatibles Signatur-Override.

## FAQ und Fehlerbehebung

### Der GPSR-Tab zeigt meine Akteure nicht an

Prüfen Sie, ob Sie mindestens einen Akteur unter **Katalog > GPSR > Akteure** angelegt haben und ob er aktiv ist. Die Dropdown-Listen der Produktseite zeigen nur aktive Akteure.

### Die Informationen werden im Shop nicht angezeigt

Stellen Sie sicher, dass die GPSR-Anzeige in der Konfiguration aktiviert ist, dass das Produkt Daten enthält (oder ein Standard-Hersteller/-Verantwortlicher festgelegt ist), und leeren Sie dann den PrestaShop-Cache. Ist die Option **Ausblenden wenn leer** aktiv, zeigt ein Produkt ohne Daten absichtlich nichts an.

### Der Klick auf „GPSR speichern" speichert nicht

Die Schaltfläche „GPSR speichern" ist von der Schaltfläche „Speichern" der Produktseite getrennt und löst eine dedizierte AJAX-Anfrage aus. Leeren Sie den Cache, laden Sie die Produktseite neu und prüfen Sie in der Browser-Konsole, dass keine Erweiterung die Anfrage blockiert.

### Wie füge ich mein eigenes Piktogramm hinzu?

Erstellen Sie unter **Katalog > GPSR > Piktogramme** ein Piktogramm, laden Sie Ihr Bild (SVG oder PNG) hoch und füllen Sie Name und Beschriftung für jede Sprache aus.

### Ist es mit PrestaShop 9 kompatibel?

Ja. Das Modul ist von PrestaShop 8.0 bis 9.x konzipiert und getestet, im Einzelshop wie im Multishop.

## Deinstallation

Die Deinstallation entfernt die Tabellen des Moduls und seine Admin-Tabs und meldet die Hooks ab. Akteure, Piktogramme, Hinweise und Produktverknüpfungen werden gelöscht. Wenn Sie eine Neuinstallation planen, bewahren Sie zuvor ein Backup Ihrer Datenbank auf.
