Makro „EPREL-Datenübernahme"

Das Makro „EPREL-Datenübernahme“ liest zu den Produkten eines Katalogs Daten aus der EU-Energielabel-Datenbank EPREL und legt sie am Produkt ab: das Energielabel, das Produktdatenblatt und Produktmerkmale. Die manuelle Recherche und das Eintragen von Hand entfallen.

Voraussetzungen

Das Makro erkennt ein Produkt auf zwei Wegen, und zwar in dieser Reihenfolge:

Über die GTIN: Ist am Produkt eine „Internationale ID“ gepflegt, sucht das Makro damit in EPREL. Eine Eprel Kategorie ist für diesen Weg nicht erforderlich.
Über Eprel Kategorie und Herstellerartikelnummer: Liefert der erste Weg kein Ergebnis, sucht das Makro über die Eprel Kategorie. Dafür müssen die Eprel Kategorie und die Herstellerartikelnummer gepflegt sein – fehlt einer der beiden Werte, entfällt dieser Weg.

Der zweite Weg greift nicht nur bei fehlender GTIN, sondern immer dann, wenn über die GTIN kein Treffer gefunden wird. Eine gepflegte Eprel Kategorie ist damit die Absicherung für alle Produkte, deren GTIN in EPREL nicht hinterlegt ist.

Beide Identifikationsmerkmale finden Sie am Produkt im Reiter „Produkt“: die GTIN im Feld „Internationale ID“ und die Herstellerartikelnummer im gleichnamigen Feld.

Reiter „Produkt“: „Internationale ID“ und „Herstellerartikelnummer“ sind die beiden Identifikationsmerkmale des Makros

Die Eprel Kategorie pflegen Sie im Reiter „Recht“. Alle Pflegewege – am Produkt, per Massendatenänderung, über eine Vorlage und per Excel-Import – beschreibt der Beitrag EPREL-Kategorie am Produkt pflegen.

Ob das Makro in Ihrer Umgebung Daten abrufen kann, hängt zusätzlich von einem serverseitig konfigurierten EPREL-Zugangsschlüssel ab. Fehlt dieser, endet der Job mit der Meldung „Eprel API Key nicht gefunden. Daten können nicht importiert werden.“ Wenden Sie sich in diesem Fall an den nextPIM-Support.

Makro starten

Öffnen Sie den Katalog und klicken Sie in der Funktionsleiste auf „Makros“.

Funktionsleiste des Katalogs mit der Schaltfläche „Makros“

Geben Sie im Suchfeld des Dialogs „Makros“ einen Wortteil ein, zum Beispiel eprel, oder öffnen Sie die Gruppe „Produkt“. Klicken Sie den Eintrag „EPREL Datenübernahme“ an – rechts erscheint die Beschreibung des Makros.

Mit „Starte Makro“ starten Sie den Lauf.

Makro „EPREL Datenübernahme“ in der Gruppe „Produkt“ mit der Schaltfläche „Starte Makro“

Wichtig: Das Makro läuft immer über alle Produkte des Katalogs. Eine Einschränkung auf eine Kategorie oder eine Produktauswahl ist nicht vorgesehen.

Was das Makro schreibt

Das Energielabel und das Produktdatenblatt als Medien am Produkt.
Produktmerkmale in der Merkmalsgruppe „EPREL_Allgemeine Informationen“.
Den „Eprel Link“ auf den EPREL-Eintrag des Produkts.
Die Energieeffizienzklasse, sofern EPREL einen Wert liefert.
Die „Eprel Kategorie“: Liefert EPREL eine Produktgruppe, wird der von Ihnen ausgewählte Wert durch den Wert aus EPREL ersetzt.

Ein bereits vorhandenes Medium wird nicht ersetzt: Existiert am Produkt schon ein Medium mit derselben Bezeichnung und demselben Verwendungszweck, lässt das Makro es unverändert stehen.

Ergebnis prüfen

Das Makro läuft als Hintergrundjob. Den Fortschritt und das Ergebnis sehen Sie über „Jobs“ im Kopfbereich der Anwendung. Der Lauf erscheint dort mit dem Typ „Makro“.

Dialog „Hintergrund Jobs“: In der Spalte „Typ“ erkennen Sie die Art des Laufs, in der Spalte „Ergebnis“ liegt die Ergebnisdatei

Nach dem Lauf meldet das Makro, wie viele Produkte mit EPREL-Daten aktualisiert wurden und wie viele ohne EPREL-Daten geblieben sind. Zu den nicht gefundenen Produkten legt nextPIM eine Excel-Datei als Ergebnisdatei des Jobs ab – Sie laden sie in der Spalte „Ergebnis“ herunter. Die Datei enthält Produktnummer, Internationale ID und Produktbeschreibung und ist die Arbeitsliste für die Nachpflege.

Anschließend startet nextPIM automatisch einen weiteren Job, der die gefundenen Medien herunterlädt. Warten Sie auch diesen Job ab.

Aktualisieren Sie danach die Ansicht mit F5. Am Produkt finden Sie die übernommenen Daten im Reiter „Merkmale“ (Merkmalsgruppe „EPREL_Allgemeine Informationen“) und im Reiter „Medien“ (Energielabel und Produktdatenblatt).

Hinweise zur Verarbeitung

Produktmerkmale werden nur für einen Teil der EPREL-Produktgruppen geschrieben. Für Kategorien ohne hinterlegte Merkmalszuordnung – etwa „Wäschetrockner (2023)“ oder „Smartphones und Tablets“ – legt das Makro Energielabel und Produktdatenblatt an, jedoch keine Merkmale.

Ein Produkt wird nur dann gespeichert, wenn mindestens ein neues Medium oder ein neues Merkmal hinzugekommen ist. Bei einem zweiten Lauf über dieselben Produkte werden Änderungen, die ausschließlich Eprel Link, Eprel Kategorie oder Energieeffizienzklasse betreffen, deshalb nicht übernommen.

Antwortet EPREL für eine GTIN mit einem Fehler, vermerkt das Makro dies im Job-Protokoll und versucht anschließend dennoch den zweiten Weg über Eprel Kategorie und Herstellerartikelnummer.

Häufige Fehler und Lösungen

Fehler	Mögliche Ursache	Lösung
Der Job endet sofort mit einer Fehlermeldung zum API Key.	In der Umgebung ist kein EPREL-Zugangsschlüssel konfiguriert.	An den nextPIM-Support wenden. Ohne Schlüssel kann das Makro keine Daten abrufen.
Für ein Produkt werden keine Daten übernommen.	Keine verwendbare GTIN, und für den zweiten Weg fehlt die Eprel Kategorie oder die Herstellerartikelnummer. Oder die Kategorie enthält keinen gültigen EPREL-Schlüssel, es wurde die falsche Verordnungsfassung gewählt, oder das Produkt ist in EPREL nicht registriert.	Ergebnisdatei des Jobs herunterladen. An den dort aufgeführten Produkten Eprel Kategorie und Herstellerartikelnummer ergänzen, den Eintrag in EPREL gegenlesen und das Makro erneut starten.
Es wurden Medien angelegt, aber keine Merkmale.	Für die betreffende EPREL-Produktgruppe ist keine Merkmalszuordnung hinterlegt.	Das ist erwartetes Verhalten. Die Merkmale müssen in diesem Fall auf einem anderen Weg gepflegt werden.
Ein zweiter Lauf ändert nichts mehr.	Es sind keine neuen Medien und keine neuen Merkmale hinzugekommen; reine Aktualisierungen von Eprel Link, Eprel Kategorie oder Energieeffizienzklasse werden dann nicht gespeichert.	Die betreffenden Felder bei Bedarf direkt am Produkt oder über die Massendatenänderung setzen.
Nach dem Lauf sind am Produkt keine neuen Daten sichtbar.	Die Ansicht ist noch nicht aktualisiert, oder der Folgejob zum Download der Medien läuft noch.	Den Job-Status prüfen, den Folgejob abwarten und die Ansicht mit F5 aktualisieren.
Die manuell gewählte Eprel Kategorie hat sich geändert.	Das Makro hat die Produktgruppe aus EPREL übernommen und den vorhandenen Wert ersetzt.	Das ist erwartetes Verhalten. Der Wert aus EPREL ist der maßgebliche.

TIPPS FÜR DIE PRAXIS

Legen Sie vor dem Makrolauf eine Sicherung des Katalogs an. Das Makro verändert Produktdaten in großer Zahl.
Pflegen Sie zuerst die Identifikationsmerkmale: GTIN und, als Absicherung, Eprel Kategorie zusammen mit der Herstellerartikelnummer.
Starten Sie das Makro einmal und arbeiten Sie danach die Ergebnisdatei ab, statt den Lauf mehrfach zu wiederholen.
Prüfen Sie nach dem Lauf stichprobenartig die Reiter „Medien“ und „Merkmale“, bevor der Katalog weitergegeben wird.
Bei sehr großen Katalogen: Der Lauf benötigt Zeit, weil EPREL nur eine begrenzte Zahl paralleler Abfragen zulässt. Starten Sie ihn nicht mehrfach parallel.