Rechnungen & Quittungen
Wo der Kunde seine Rechnungen findet, wie er PDFs herunterlaedt, und was er bei fehlenden Rechnungen tun kann.
Wo findet der Kunde Rechnungen?
Im Portal unter https://portal.sellx.dev/dashboard/billing. Die Seite listet alle Subscription-Beiträge (monatlich / jaehrlich) und alle einmaligen Kaeufe (z.B. All-Inclusive-Bundle).
Pro Eintrag: Datum, Betrag, Status, PDF-Download-Link.
Wie werden PDFs erzeugt?
Sobald Stripe eine Zahlung erfolgreich verbucht (invoice.payment_succeeded), erzeugt sellx_central asynchron ein PDF. Verwendet wird QuestPDF auf Basis des Sellx-Briefkopfs (Logo, Adresse, Bankverbindung, USt-ID).
Das PDF landet in /var/sellx/invoices/{kunden-id}/{invoice-id}.pdf (Production) bzw. $HOME/sellx/invoices/ (Dev).
Der AuditLog-Eintrag invoice.pdf_rendered wird erst geschrieben, wenn das PDF fertig ist. Kunde sieht bis dahin „PDF wird erzeugt…“.
Haeufige Probleme
Rechnung fehlt im Portal
Stripe hat die Zahlung verbucht, aber der Webhook hat noch nicht getriggert. Normalerweise innerhalb von 30s. Wenn nach 5 Min immer noch nichts: Ops prueft sellx_central-Logs auf invoice.payment_succeeded-Verarbeitung.
PDF-Download bricht ab / Datei ist 0 KB
PDF-Rendering schlug fehl. Ops-AuditLog nach 'invoice.pdf_render_failed' filtern. Haeufigste Ursache: Logo-Datei fehlt, weil sellx_central auf neuem Server deployt wurde ohne /var/sellx/assets/.
Falscher Betrag in der Rechnung
Stripe-Coupon oder -Tax-Rate wurde nach Kauf geaendert. Rechnung basiert auf den zur Kaufzeit gueltigen Stripe-Daten. Korrektur: Stripe-Credit-Memo + manuelle Rechnung durch Ops.
Rechnung ist auf englisch, Kunde will deutsch
Briefkopf ist eine zentrale Konfiguration unter /admin/invoice-template. Aenderungen erfordern Redeploy. Aktuell nicht per Self-Service aenderbar (Phase 3).
FAQ
Wo finde ich meine Rechnungen?
Im Portal unter https://portal.sellx.dev/dashboard/billing. Pro Eintrag gibt es einen PDF-Download-Link.
Was bedeutet „PDF wird erzeugt…“?
Stripe-Zahlung ist verbucht, aber das PDF-Rendering (QuestPDF) laeuft noch asynchron. Normalerweise innerhalb weniger Sekunden fertig — nach 5 Min eskalieren.
Kann ich eine Rechnung mit anderer Adresse bekommen?
Adressaenderung im Stripe-Customer-Portal (ueber sellx-Portal verlinkt). Ops re-rendert die offene Rechnung.
Wie lange werden Rechnungen aufbewahrt?
7 Jahre (HGB §257). Storage in Phase 2 ueber Coolify-Volume, ab Phase 3 S3 mit Lifecycle-Policy.