Import und Export
Auf der Seite Bereitschaft ordnest du vielen Produkten auf einmal einen Pass zu und exportierst alle Pässe.
Massenimport
- Wähle bei “CSV-Datei” deine Datei aus.
- Klicke auf Änderungen vorab prüfen. Die Vorschau zeigt für jede Zeile, ob ein Pass angelegt oder aktualisiert wird oder ob die Zeile einen Fehler hat. Noch wird nichts gespeichert.
- Klicke auf Import ausführen. Zeilen mit Fehler werden übersprungen.
Das Ergebnis siehst du als Meldung, zum Beispiel “1 angelegt, 1 aktualisiert, 1 übersprungen”.
Aufbau der CSV-Datei
UTF-8, Trennzeichen Semikolon oder Komma, erste Zeile mit den Spaltennamen. Pflicht ist nur product_number. Für Varianten gibst du die Produktnummer der Variante an.
| Spalte | Inhalt |
|---|---|
| product_number | Produktnummer (Pflicht) |
| source_type | external_url (Lieferanten-URL), gs1_digital_link oder internal (Hier gepflegt) |
| source_url | Pass-URL. Pflicht, außer bei internal |
| upi | Eindeutige Produktkennung |
| gtin | GTIN, wird geprüft und mit 14 Stellen gespeichert |
| granularity | model, batch oder item |
| status | draft, active, superseded oder archived |
| product_group | Produktgruppe, zum Beispiel batteries |
| economic_operator | Wirtschaftsakteur |
| valid_from, valid_to | Gültigkeit, zum Beispiel 2026-10-01 |
| title, summary | Titel und Kurzbeschreibung |
Beispiel:
product_number;source_type;source_url;gtin;status;title DPP-AUD-002;external_url;https://pass.klangwerk.example/k2;4260712345011;active;Produktpass Kopfhörer K2 Studio
Hat das Produkt noch keinen eigenen Pass, legt der Import einen neuen Pass an und ordnet ihn zu. Leere Felder erhalten dann diese Werte: Quelle Lieferanten-URL, Ebene Modell, Status Veröffentlicht. Hat das Produkt bereits einen eigenen Pass, aktualisiert der Import diesen Pass.
Massenexport
- Pässe exportieren (CSV) lädt alle Pässe mit ihren Zuordnungen als
product-passports.csvherunter, eine Zeile je Zuordnung. - QR-Codes herunterladen (ZIP) lädt für jeden Pass den QR-Code als SVG-Datei herunter, benannt nach dem Code. Das funktioniert für bis zu 1000 Pässe.