Zum Inhalt
Extension Foundry

Installation und erste Schritte

Vom Kauf im JTL Extension Store bis zum ersten veröffentlichten Batteriepass mit QR-Code.

Produktpass hilft Ihnen beim Batteriepass und beim Batterie-QR-Code nach der Verordnung (EU) 2023/1542. Die Texte, Vorlagen und Hinweise des Plugins sind keine Rechtsberatung. Für Ihre Pflichten und für die Richtigkeit Ihrer Angaben bleiben Sie selbst verantwortlich. Für eine verbindliche Auskunft zu Ihrem Fall fragen Sie eine Rechtsanwältin oder einen Rechtsanwalt.

Installation

Produktpass läuft mit JTL-Shop 5.6, 5.7 und 5.8 und PHP 8.2 bis 8.4 (JTL-Shop 5.7 und 5.8 laufen nur mit PHP 8.3 oder neuer), mit MariaDB oder MySQL, und mit dem Template NOVA oder einem Kind-Template von NOVA.

  1. Kaufen oder testen Sie Produktpass im JTL Extension Store.
  2. Öffnen Sie im Backend Ihres Shops „Plug-ins > Meine Käufe“ und verknüpfen Sie den Kauf mit Ihrem Shop.
  3. Klicken Sie dort bei Produktpass auf „Installieren“.
  4. Sie finden Produktpass danach unter „Plug-ins > Installierte Plug-ins > Produktpass“ mit den Seiten „Übersicht“, „Pässe“, „Pass-Editor“, „Import“, „Wawi-Zuordnung“, „QR & Etiketten“, „Einstellungen“ und „Hilfe“.

Richten Sie den Cron von JTL-Shop ein, wenn er noch nicht läuft: Er ordnet Werte aus JTL-Wawi zu, prüft jede Nacht die Pässe und arbeitet große Importe und Seriennummern-Stapel ab. Stündlich genügt. Ohne Cron bieten die Seiten einen Knopf, der den nächsten Schritt sofort ausführt.

Einstellungen und verantwortlicher Wirtschaftsakteur

Unter „Einstellungen“ tragen Sie ein, was auf jeder öffentlichen Passseite steht:

  • Verantwortlicher Wirtschaftsakteur: Name und Postanschrift dessen, der die Batterien in Verkehr bringt. Ohne diese Angaben lässt sich kein Pass veröffentlichen.
  • Kontakt-E-Mail für eingeschränkte Daten: die Adresse, an die sich Personen mit berechtigtem Interesse und Behörden wenden. Auch sie ist zum Veröffentlichen nötig.
  • Ersatzreihenfolge der Sprachen: welche Sprache eine Passseite zeigt, wenn ein Wert in der Sprache des Besuchers fehlt: zuerst die Standardsprache Ihres Shops, dann Englisch, dann Deutsch.
  • Adresse der Pässe (Resolver-Basis): Standard ist https://ihr-shop.de/dpp. Eine eigene Adresse (höchstens 53 Zeichen) muss auf diesen Shop zeigen; das Plugin prüft sie, bevor es sie übernimmt. Frühere Adressen leiten weiter, damit gedruckte Codes funktionieren.
  • Automatisch veröffentlichen: aus (Standard). Eingeschaltet veröffentlicht die Wawi-Zuordnung einen vollständig ausgefüllten Pass ohne Ihre Prüfung.
  • Position des Pass-Hinweises auf der Produktseite: nach den Artikelmerkmalen (Standard), nach dem Preis, nach dem Warenkorb-Button, als eigener Reiter oder aus.
  • Passseiten auch im Wartungsmodus des Shops ausliefern: an (Standard), damit gedruckte Codes auch dann antworten.
  • Ich verzichte auf die Sicherung: siehe Deinstallieren.

Einen Pass anlegen

  1. Öffnen Sie „Pässe“ und suchen Sie die Batterie nach Name, Artikelnummer oder GTIN.
  2. Beantworten Sie die Kategorie der Batterie und, bei einer Industriebatterie, ihre Energie in kWh. Daraus ergibt sich die Vorlage: „T-BAT-PASS“ (Batteriepass) für LMT-Batterien, Industriebatterien mit mehr als 2 kWh und Elektrofahrzeugbatterien, sonst „T-BAT-INFO“ (Batterie-Informationsseite mit QR-Code).
  3. Wählen Sie die Ebene: Modell (ein Pass für alle Batterien des Artikels), Charge oder einzelne Batterie.

Varianten zeigen den Pass ihres Vaterartikels unter ihrer eigenen GTIN; abweichende Werte (etwa ein anderes Gewicht) tragen Sie bei der Variante mit „Eigener Wert“ ein. Viele Pässe auf einmal legen Sie per CSV-Import oder per Wawi-Zuordnung an.

Den Pass ausfüllen und veröffentlichen

  • Jedes Feld hat einen Wert, ist „nicht anwendbar“ (mit Grund) oder noch offen. Neben jedem Feld steht, was es bedeutet und welcher Artikel der Verordnung es verlangt.
  • Dokumente wie die Konformitätserklärung laden Sie als PDF, PNG oder JPEG bis 20 MB hoch.
  • Die sechs Entsorgungshinweise (Art. 74 Abs. 1 Buchst. a bis f) sind als Entwurf vorausgefüllt. Prüfen Sie jeden und bestätigen Sie ihn; vorher lässt sich der Pass nicht veröffentlichen.
  • „Vorschau“ zeigt die öffentliche Seite mit Ihren Arbeitswerten, bevor Sie veröffentlichen.
  • „Veröffentlichen“ speichert eine Version, die sich nicht mehr ändert, mit Prüfsumme. Spätere Änderungen sind unveröffentlicht, bis Sie erneut veröffentlichen. „Zurückziehen“ lässt die Adresse mit einem Hinweis bestehen.

Die öffentliche Seite zeigt nur die öffentlichen Angaben (Anhang XIII Nr. 1). Angaben für Personen mit berechtigtem Interesse und für Behörden erscheinen dort nicht; sie erhalten sie über die Kontakt-E-Mail.

QR-Codes und Etiketten

  • Unter „QR & Etiketten“ laden Sie den Code jedes veröffentlichten Passes als SVG oder als PNG mit 600 dpi.
  • Mindestdruckgröße ist 20 × 20 mm einschließlich des weißen Rands; drucken Sie das PNG mit 100 %.
  • Der Druckbogen setzt bis zu 24 Codes auf eine A4-Seite (3 × 8 Etiketten von 70 × 37 mm).
  • Für einzelne Batterien erstellen Sie einen Seriennummern-Stapel: bis zu 10.000 Seriennummern auf einmal, als ZIP-Datei mit einer SVG-Datei je Seriennummer und einer CSV-Datei mit GTIN, Seriennummer und Adresse.
  • Unter einer Testlizenz tragen Codes und Druckbögen das Wort „TESTLIZENZ“. Drucken Sie Codes für die Ware mit der gekauften Lizenz.

Die Übersicht

Die „Übersicht“ zählt die Tage bis zum 18.02.2027 und zeigt jeden Artikel mit seinem Stand: kein Pass, unvollständig, bereit, veröffentlicht oder zurückgezogen. Ein Klick auf die offenen Punkte öffnet den Pass-Editor am ersten davon. Unter „Kategorien in der Übersicht“ wählen Sie die Kategorien Ihrer Batterien, damit auch die Artikel ohne Pass erscheinen. „Alle bereiten Entwürfe veröffentlichen“ veröffentlicht jeden Entwurf ohne offenen Punkt.

Wenn die Lizenz endet

  • Alle veröffentlichten Passseiten, Dokumente und QR-Adressen bleiben erreichbar.
  • Sie können alles ansehen und exportieren; Bearbeiten, Importieren, die Wawi-Zuordnung und das Veröffentlichen sind gesperrt, bis Sie verlängern.
  • Jede Seite des Plugins zeigt einen roten Hinweis mit einem Link zum JTL Extension Store.

Lassen Sie das Plugin aktiv. Ein Plugin, das Sie mit abgelaufener Lizenz deaktivieren, führt die Plugin-Verwaltung unter „Probleme“, und mit ihm sind die Passseiten offline. Nach der Verlängerung klicken Sie im Reiter „Probleme“ auf „deaktivieren“ und danach im Reiter „Deaktiviert“ auf „Aktivieren“; alle Daten sind wieder da. Endet eine Testlizenz, deaktiviert JTL-Shop das Plugin selbst.

Deinstallieren und die Daten behalten

Gedruckte Codes lassen sich nicht zurückholen. Produktpass löscht seine Tabellen und Dateien deshalb nur, wenn Sie unter „Einstellungen“ „Ich verzichte auf die Sicherung“ angekreuzt oder unter „Import“ nach der letzten Änderung alle Pässe exportiert haben. Sonst bleiben sie erhalten, auch wenn im Dialog „Plugin-Deinstallation“ das Löschen der Tabellen angekreuzt ist; eine erneute Installation findet sie wieder. Ein Verzicht gilt nur, bis sich Pässe danach ändern.

Was der Webserver erlauben und sperren muss

Die Passseiten liegen unter https://ihr-shop.de/dpp/… und werden von JTL-Shop selbst ausgeliefert. Sie setzen keine Cookies und laden nichts von anderen Servern.

  • Seriennummern mit Schrägstrich stehen in der Adresse als %2F. Apache weist solche Adressen ohne die Einstellung AllowEncodedSlashes NoDecode im VirtualHost ab; der Druckbogen und die Seriennummern-Stapel warnen dann. Bitten Sie Ihren Hoster um diese Einstellung, oder vermeiden Sie Schrägstriche in Seriennummern.
  • Gesperrte Ordner: Dokumente, hochgeladene CSV-Dateien und QR-Stapel liegen in mediafiles/ab_produktpass/ mit den Unterordnern imports/ und qr-batches/. Apache sperrt sie mit der .htaccess, die das Plugin dort anlegt.
  • nginx liest keine .htaccess. Sperren Sie den Ordner dort in der Konfiguration Ihres Shops, vor der Regel, die PHP-Dateien weiterreicht (liegt der Shop in einem Unterordner, setzen Sie dessen Pfad davor):
    location ^~ /mediafiles/ab_produktpass/ {
    deny all;
}
    Prüfen Sie danach, dass https://ihr-shop.de/mediafiles/ab_produktpass/imports/ mit 403 oder 404 antwortet.

Support

Schreiben Sie an support@extensionfoundry.com mit den Versionen von JTL-Shop und Produktpass (unter „Hilfe“ im Plugin) und, wenn vorhanden, den Einträgen von Produktpass unter „Fehlerbehebung > Logbuch“. Schicken Sie keine Zugangsdaten.