Massennachweise

Mit Massennachweisen kannst du Auszeichnungen per CSV-Upload gleichzeitig an Hunderte oder Tausende Empfänger ausstellen. Der Vorgang besteht aus vier Schritten mit integrierter Fortschrittsanzeige, Pausieren/Fortsetzen und Fehlerbehandlung.

Überblick

Der Ablauf für Massennachweise umfasst vier Schritte:

1. Konfigurieren — Auszeichnung und Optionen auswählen
2. Hochladen — deine CSV-Datei vorbereiten und hochladen
3. Verarbeiten — den Fortschritt beim Erstellen der Nachweise verfolgen
4. Ergebnisse — Ergebnisse prüfen und Berichte herunterladen

Schritt 1: Konfigurieren

1. Öffne die Seite Massennachweise in der Seitenleiste (sie hat eine eigene Route, getrennt von der Seite „Nachweise").
2. Wähle mit der Auszeichnungsauswahl die Auszeichnung aus, die du ausstellen möchtest.
3. Optional kannst du Folgendes festlegen:
   • Ausgestellt am — das Datum für alle Nachweise (Standard ist heute)
   • Läuft ab — optionales Ablaufdatum für alle Nachweise
   • E-Mail senden — ob jeder Empfänger nach der Erstellung seines Nachweises automatisch eine E-Mail erhält
4. Klicke auf Weiter.

Schritt 2: CSV hochladen

CSV-Format

Die CSV-Datei muss eine Spalte name und eine Spalte email sowie eine Kopfzeile enthalten. Die Namen der Kopfzeile sind nicht von der Groß-/Kleinschreibung abhängig, und recipient_name / recipient_email werden als Aliase für name / email akzeptiert.

name,email
Jane Smith,jane@example.com
John Doe,john@example.com
Maria Garcia,maria@example.com

Vorlage herunterladen

Klicke auf Vorlage herunterladen, um eine leere CSV-Datei mit den richtigen Kopfzeilen zu erhalten. Trage deine Empfänger ein und lade sie hoch.

Upload

1. Klicke auf CSV hochladen oder ziehe deine Datei per Drag & Drop hinein.
2. Die Datei wird vor Beginn der Verarbeitung validiert.

Validierungsregeln

Jede Zeile wird validiert, sobald die Datei eingelesen wurde:

• Der Name muss mindestens 5 Zeichen lang sein
• Die E-Mail muss eine gültige E-Mail-Adresse sein
• Leere Zeilen werden übersprungen

Die Vorschautabelle listet jede Zeile mit einem grünen Häkchen oder einem roten Grund auf. Ungültige Zeilen sind kein Hindernis — sie werden einfach übersprungen, und der Zähler zeigt, wie viele gültige Empfänger verarbeitet werden (z. B. „18 gültige Empfänger, 2 ungültig (werden übersprungen)"). Du kannst fortfahren, solange mindestens eine Zeile gültig ist; du musst nicht erst korrigieren und erneut hochladen.

3. Klicke auf Weiter, um die Verarbeitung zu starten.

Schritt 3: Verarbeitung

Sobald die Verarbeitung beginnt, siehst du einen Fortschrittsbalken und Live-Zähler:

• Fortschrittsbalken — der Prozentsatz der verarbeiteten Zeilen
• Erstellt — wie viele Nachweise erstellt wurden
• Fehlgeschlagen — wie viele Zeilen fehlgeschlagen sind
• Verbleibend — wie viele Zeilen noch in der Warteschlange sind

Live-Tabellen für Erstellt, Fehlgeschlagen und Ausstehend füllen sich unter dem Balken, während der Stapel läuft.

Pausieren und Fortsetzen

• Klicke auf Pausieren, um die Verarbeitung vorübergehend anzuhalten. Während der Pause werden keine neuen Nachweise erstellt.
• Klicke auf Fortsetzen, um dort weiterzumachen, wo du aufgehört hast.

Abbrechen

• Klicke auf Abbrechen, um die Verarbeitung vollständig zu beenden. Bereits erstellte Nachweise bleiben erhalten.

Fehlerbehandlung

Wenn eine Zeile aus einem zeilenspezifischen Grund fehlschlägt (z. B. ein ungültiger Wert, den das Backend ablehnt):

• Der Fehler wird zu dieser Zeile vermerkt
• Die Verarbeitung fährt automatisch mit der nächsten Zeile fort
• Fehlgeschlagene Zeilen werden für den Ergebnisschritt gesammelt, ihr Fehlertext wird in der Fehlertabelle auf dem Bildschirm angezeigt

Von Ratenbegrenzung betroffene Zeilen werden automatisch mit kurzer Wartezeit erneut versucht. Ein Guthaben- oder Kontingentfehler ist anders — statt weiterzuspringen, wird der Stapel pausiert, damit du nicht den Rest der Datei verbrauchst. Es erscheint ein roter Hinweis „Unzureichendes Guthaben"; lade Guthaben auf oder wechsle den Tarif und klicke dann auf Fortsetzen, um dort weiterzumachen, wo es angehalten wurde.

Wiederherstellung nach Seitenaktualisierung

Wenn du während der Verarbeitung versehentlich den Browser schließt oder die Seite aktualisierst, wird die Massennachweis-Sitzung beim Zurückkehren wiederhergestellt. Der Fortschritt wird dort fortgesetzt, wo er angehalten wurde.

Schritt 4: Ergebnisse

Nach Abschluss der Verarbeitung (oder nach einem Abbruch) zeigt der Ergebnisbildschirm vier Übersichtskarten:

• Gesamt — Anzahl der Empfänger im Stapel
• Erstellt — Anzahl der erstellten Nachweise
• Fehlgeschlagen — Anzahl der fehlgeschlagenen Zeilen
• Übersprungen — nicht verarbeitete Empfänger (z. B. verbleibende Zeilen nach einem Abbruch)

Unter den Karten listet eine Tabelle Erstellt jeden neuen Nachweis mit einem Link zur Ansicht auf, und eine Tabelle Fehlgeschlagen listet die Fehler mit ihrem Fehlertext auf.

Berichte herunterladen

• Ergebnis-CSV herunterladen — jede Zeile des Stapels mit den Spalten row, name, email, status, award_url (die Nachweis-URL ist bei erstellten Zeilen ausgefüllt).
• Fehler-CSV herunterladen — nur die fehlgeschlagenen Zeilen mit den Spalten name, email, error.

Fehlgeschlagene erneut versuchen

Wenn einige Zeilen fehlgeschlagen sind, klicke auf Fehlgeschlagene erneut versuchen. Dadurch startet ein neuer Durchlauf nur für die fehlgeschlagenen Empfänger — du musst keine CSV erneut hochladen. Das ist praktisch, nachdem du ein vorübergehendes Problem behoben hast, etwa Guthaben aufgeladen hast, nachdem ein Stapel pausiert wurde.