Refunds & Notifications · Article 6.6
Die Gutschriften-Seite
Ein eigenständiger Bereich im Freelancer-Dashboard, der jede Gutschrift für alle Ihre Angebote auflistet, mit Status, Rückerstattungsbetrag, verknüpftem Angebot und Aktionsschaltflächen. Verwenden Sie diese Seite, wenn Sie Rückerstattungen verwalten möchten, ohne jedes Angebot einzeln aufrufen zu müssen.
Bis April 2026 waren Gutschriften nur innerhalb einzelner Angebote sichtbar – Angebot finden, Dokumente öffnen, Gutschrift suchen. Das funktionierte, wenn Sie ein oder zwei laufende Rückerstattungen hatten; es versagte, sobald Sie ein Dutzend hatten. Die Gutschriften-Seite zeigt Rückerstattungshistorie und ausstehende Aktionen an einem Ort, sortiert nach Status, damit die Elemente, die Ihre Aufmerksamkeit benötigen, ganz oben erscheinen.
Step by step
Öffnen Sie
/credit-notesaus der Dashboard-Seitenleiste (unter Rückerstattungen / Gutschriften).
Nach Status filtern.
Eine Reihe von Auswahlmöglichkeiten oben: Alle, Ausstehend, Angefordert, Fehlgeschlagen, Erfolgreich, Manuell. „Ausstehend" und „Fehlgeschlagen" werden standardmäßig ganz oben sortiert – das sind die, die Ihre Aktion benötigen.
Eine Zeile prüfen.
Jede zeigt: GUT-NNNN, Rückerstattungsbetrag + Währung, Statuszeichen, Angebotslink, Änderungslink, Ausstellungsdatum, Abschlussdatum der Rückerstattung (falls zutreffend), Aktionsschaltflächen.
Aktion aus der Zeile ausführen.
Gleiche Schaltflächen wie das Pro-Angebot-Rückerstattungsbanner: Status aktualisieren (Artikel 8.7), Wiederholen (Artikel 8.8), Als erstattet markieren (Artikel 8.9), PDF herunterladen.
Bei Bedarf in das Angebot einsteigen.
Klicken Sie auf die Angebotsnummer, um
/proposals/{id}für den vollständigen Kontext zu öffnen (Timeline, Dokumente, zugehörige Änderung).
Why this works this way
Backend: CreditNoteListView (amendment_views.py:849, [D-116]) gibt alle nicht gelöschten Gutschriften für die Angebote des authentifizierten Freelancers zurück, geordnet nach issued_at absteigend. Jede Zeile enthält die Nummer, den Kundennamen und die Änderungsnummer des Angebots neben den eigenen Feldern der Gutschrift – keine zusätzlichen Anfragen zum Rendern der Liste erforderlich.
Die Frontend-Seite liest aus derselben Form wie die Per-Angebot-Methode get_credit_notes-Serializer, sodass die Pro-Zeile-Komponente wiederverwendet wird. Filter sind clientseitig (die Ergebnismenge ist durch die Pro-Konto-Gutschriftenanzahl begrenzt, die in der Regel Dutzende, nicht Tausende beträgt).
Troubleshooting
Keep reading
Refunds & Notifications
Refund stages: issued → requested → succeeded (or manual)
The credit note moves through up to four states from creation to settled. Each state corresponds to a specific point in the refund lifecycle, with predictable UI badges and email triggers.
Refunds & Notifications
Refresh status — pull-based sync when the Stripe webhook didn't land
Webhooks aren't perfect. When a credit note appears stuck in `requested` despite Stripe having processed the refund, click `Refresh status` to pull the current state from Stripe directly. Same transition logic as the webhook; no risk of double-firing side-effects.
Refunds & Notifications
Retry Stripe refund — when transient failures clear
A failed Stripe refund can usually be retried — most failures are transient (rate limits, brief Stripe outages, or deposit-paid webhook arriving after the post-sign pipeline ran). The Retry button calls `_trigger_stripe_refund` afresh on the credit note.
Refunds & Notifications
Mark refunded manually — for SEPA and out-of-band proof
When a refund is issued outside Stripe — SEPA bank transfer, cash, PayPal, mailed cheque — `Mark refunded` is how you record it in Clozo. Reason field is mandatory (typically a bank reference). The credit note moves to `manual` status and the client receives a confirmation email.