CSV-Import und -Export

Viele Pässe auf einmal anlegen oder ändern, und alle Pässe als Datei sichern.

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.

Die Vorlage

Eine Datei gilt für eine Vorlage: „T-BAT-INFO“ (Batterie-Informationsseite) oder „T-BAT-PASS“ (Batteriepass). Unter „Import“ laden Sie für jede die Vorlage als CSV-Datei herunter; ihre Kopfzeile nennt alle Spalten. Füllen Sie eine Zeile je Artikel und, bei Pässen für einzelne Batterien, eine Zeile je Batterie mit ihrer Seriennummer.

Die Spalten

artnr oder gtin: über sie findet der Import den Artikel Ihres Shops. Hat eine GTIN mehrere Artikel, geben Sie die Artikelnummer an.
level: model (Modell), batch (Charge) oder item (einzelne Batterie).
serial, batch, manufacture_date, item_status: die Angaben einer einzelnen Batterie (nur bei der Ebene item); item_status ist original, repurposed, reused, remanufactured oder waste.
Je Feld der Vorlage eine Spalte mit dem Schlüssel des Felds, zum Beispiel capacity_ah; Texte haben eine Spalte je Sprache, .de und .en, zum Beispiel waste_prevention.de. Nach den Wertspalten eines Felds folgt seine Zustandsspalte, zum Beispiel capacity_ah.state.
Ein Dokument geben Sie mit der ID an, die der Export nennt; neue Dokumente laden Sie im Pass-Editor hoch.
Die Spalten identifier, url, status und published_version stehen nur im Export; der Import übergeht sie.

Eine Spalte, die es in der Vorlage nicht gibt, eine doppelte Spalte oder ein Wert in einer Spalte ohne Namen wird abgewiesen, mit der Spalte und der Zeile.

Werte, Zustände und leere Zellen

Zahlen schreiben Sie mit Dezimalkomma oder Dezimalpunkt, ohne Tausendertrennzeichen: 3,4 oder 3.4.
Monate schreiben Sie als 2026-07 oder 07/2026.
Eine Auswahl schreiben Sie mit ihrem Wert, ihrer Bezeichnung oder ihrer Kurzform, wie die Vorlage sie nennt.
Zustand: provided (angegeben), pending (offen) oder not_applicable (nicht anwendbar) mit dem Grund nach einem Doppelpunkt, zum Beispiel not_applicable:category_not_covered. Bleibt die Zustandsspalte leer, macht ein Wert das Feld „angegeben“.
Eine leere Zelle lässt den gespeicherten Wert, wie er ist; #LEER löscht ihn.

Mit Excel arbeiten

Öffnen Sie die CSV-Datei nie per Doppelklick: Excel macht dann aus langen Zahlen wie GTINs „9,52E+12“ und aus Monaten Datumsangaben. Importieren Sie sie stattdessen über „Daten > Aus Text/CSV“, geben Sie jeder Spalte den Typ „Text“ und speichern Sie sie als „CSV UTF-8 (durch Trennzeichen getrennt)“. Der Import erkennt UTF-8 mit oder ohne Byte-Order-Mark und Windows-1252, Semikolon, Komma oder Tabulator als Trennzeichen, und er weist Zellen zurück, die Excel verändert hat. Eine Excel-Arbeitsmappe (.xlsx) nimmt er nicht an.

Probelauf und Import

Laden Sie die Datei unter „Import“ hoch und starten Sie den Probelauf. Er ändert nichts.
Der Bericht zeigt jede Zeile mit ihrem Ergebnis: neu anzulegen, zu ändern, unverändert oder mit Fehlern, jeder Fehler mit Zeile und Spalte. Sie können ihn als CSV-Datei herunterladen.
Der Knopf „Import“ übernimmt genau die geprüfte Datei. Der Import legt Entwürfe an oder ändert Arbeitswerte; er veröffentlicht nichts. Veröffentlichen Sie die Pässe danach im Pass-Editor oder in der Übersicht.

Probeläufe und Importe bleiben mit ihren Berichten 90 Tage erhalten; die Datei eines nicht importierten Probelaufs wird nach einem Tag gelöscht. Hochgeladene Dateien liegen bis dahin in mediafiles/ab_produktpass/imports/ (auf nginx sperren Sie diesen Ordner selbst, siehe Webserver).

Große Dateien

Eine Datei darf bis zu 20 MB und 50.000 Zeilen haben. Bis 500 Zeilen läuft sie sofort; größere Dateien arbeitet der Cron des Shops in Teilen ab, und die Seite zeigt den Fortschritt. Läuft der Cron nicht, führt „Nächsten Schritt jetzt ausführen“ den nächsten Teil aus. Bricht ein Teil mehrmals ab, verkleinert der Import ihn; gelingt er auch dann nicht, endet der Auftrag mit den Zeilen, die nicht gelangen.

Export und Sicherung

„Alle exportieren (CSV)“ schreibt je Vorlage alle Pässe mit ihren Batterien in die Spalten der Vorlage; die Datei lässt sich wieder importieren.
„Veröffentlichte Versionen (JSON)“ schreibt die neueste veröffentlichte Version jedes Passes mit ihrer Prüfsumme.
Exporte funktionieren auch, wenn die Lizenz abgelaufen ist.
Ein vollständiger Export jeder Vorlage nach der letzten Änderung gilt als die Sicherung, die eine Deinstallation mit Löschen der Daten verlangt (siehe Deinstallieren).
Ist ein Export größer als 20 MB oder 50.000 Zeilen, teilen Sie ihn vor einem erneuten Import nach Zeilen auf.