Bulk-Import
QR-Codes per CSV importieren, Jobs prüfen, wiederholen und exportieren.
Bulk Import ist für Kampagnen gedacht, bei denen viele Codes konsistent erzeugt werden müssen: Filialen, Verpackungen, Mailings, Events oder Agenturkunden.
Status
Bulk-Jobs sind im Dashboard vorhanden. CSV-Upload, Jobliste, Abbruch, Retry,
Export und Download sind im generierten node-qr-Contract abgebildet.
Typischer Ablauf
- CSV vorbereiten.
- Datei im Bulk-Bereich hochladen.
- Vorschau und Validierung prüfen.
- Job starten.
- Fortschritt beobachten.
- Ergebnis herunterladen oder fehlerhafte Zeilen korrigieren.
CSV-Grundstruktur
Die konkrete CSV-Struktur kann sich je nach QR-Art unterscheiden. Bewährt hat sich diese Basis:
title,type,kind,targetUrl,tags
Store Mainz,dynamic,url,https://example.com/mainz,"retail,mainz"
Store Berlin,dynamic,url,https://example.com/berlin,"retail,berlin"Fehlerbehandlung
Bulk-Jobs sollten nie blind in den Druck gehen. Prüfe nach jedem Import:
- fehlerhafte Zeilen,
- Warnungen aus Preflight und URL-Check,
- Domain-Zuweisung,
- gewünschte Kampagne, Tags und Ordner,
- Render-Ausgabe für Druckgröße und Kontrast.
Webhooks
Job-Status-Webhooks sind als Beta-Thema zu behandeln. Für produktive Workflows sollte dein System aktuell zusätzlich die Jobliste im Dashboard oder API-seitig prüfen, bis die Event-Abdeckung als stabil markiert ist.