Rechnungsausgang & Online-Zahlung — Einstellungen

Zweck

Diese Seite steuert die öffentliche Bezahlseite: ob Kunden ihre Rechnung online bezahlen können, welche Zahlmethoden erlaubt sind, welcher QR-Code auf den Rechnungsdruck kommt und ob die PayPal-Gebühr an den Kunden weitergegeben wird. Die PayPal-Zugangsdaten selbst werden nicht hier, sondern im Integrations-Manager der Zahlungskonten hinterlegt.

Voraussetzungen

- Berechtigung `view:FE_Settings` + `view:Settings` (Seite öffnen) und `update:Settings` (Werte laden und ändern). - Für **PayPal** als Methode: eine aktive [PayPal-Anbindung](/transaction-accounts) mit `paymentsEnabled`. - Für die Gebühren-Weitergabe: ein **Erlöskonto** für den Aufschlag.

Berechtigungen (CASL)

Action	Subject	Wirkung
view	FE_Settings	Einstellungs-Bereich aufrufbar
view	Settings	Seite im Routing erlaubt
update	Settings	Konfiguration laden und speichern

Sowohl der Lese- als auch der Schreib-Endpunkt der Rechnungsausgang-Konfiguration verlangt `update:Settings`. Wer nur `view:Settings` hat, sieht die Seite, aber die Werte werden nicht geladen. Die Oberfläche ist ohne `update:Settings` zudem schreibgeschützt.

Einstellungen

Die Werte werden über die Rechnungsausgang-Konfiguration gespeichert und je Änderung automatisch gespeichert (Autosave).

Feldname	Pflicht	Datentyp	Beschreibung	Wirkung beim Ausfüllen	Voraussetzung
publicPaymentPageEnabled	ja	Boolean	Öffentliche Bezahlseite aktivieren	schaltet /pay/:ref frei; aus = jeder Link „nicht gefunden"	—
paymentMethodsAllowed	ja	String[]	Erlaubte Zahlmethoden	bestimmt, welche Wege der Kunde sieht (bank, paypal)	Bezahlseite aktiv
invoiceQrMode	ja	bankQr / payLinkQr	QR-Code auf dem Rechnungsdruck	payLinkQr druckt den „Jetzt bezahlen"-QR zur Bezahlseite	—
paypalSurchargeEnabled	nein	Boolean	PayPal-Gebühr an Kunden weitergeben	berechnet bei PayPal-Zahlung einen Aufschlag und bucht ihn als Zusatzrechnung	—
paypalSurchargeAccountId	konditional	UUID (Konto)	Erlöskonto für den Aufschlag	Zielkonto der Gebühren-Rechnung; ohne Konto greift der Aufschlag nicht	paypalSurchargeEnabled = true
paypalSurchargeProductId	nein	UUID (Artikel)	Artikel für die Aufschlagsposition	bessere Auswertung; leer = Freitext „PayPal-Zahlungsgebühr"	paypalSurchargeEnabled = true
paypalSurchargeVatMode	nein	likeMainSupply / none	USt-Behandlung des Aufschlags	„wie Hauptleistung" oder „ohne USt (Auslagenersatz)"	paypalSurchargeEnabled = true
allowGobdUnlockOverride	nein	Boolean	GoBD-Entsperrung ausnahmsweise erlauben	erlaubt das Wieder-Entsperren GoBD-festgeschriebener Belege zur Korrektur	—

Master-Schalter & Zahlmethoden

• Öffentliche Bezahlseite aktivieren — der Hauptschalter. Ist er aus, ist die Bezahlseite für alle Rechnungen „nicht gefunden".
• Erlaubte Zahlmethoden — Checkboxen Banküberweisung (bank) und PayPal (paypal). Weitere Methoden sind als „geplant" sichtbar, aber deaktiviert: SumUp, Stripe (Karten/Apple Pay/Google Pay), SEPA-Lastschrift.

QR-Code auf dem Rechnungsdruck

• Bank-QR (GiroCode) – wie bisher (bankQr): klassischer Überweisungs-QR für die Banking-App.
• „Jetzt bezahlen"-QR (Link zur Bezahlseite) (payLinkQr): führt auf die öffentliche Bezahlseite; dort wird u. a. wieder der Bank-QR angeboten.

PayPal-Gebühr weitergeben

Ist der Schalter aktiv, wird bei einer PayPal-Zahlung ein exakter Aufschlag (Gross-up aus dem in der PayPal-Anbindung hinterlegten Gebührensatz) berechnet und beim Bezahlen als separate Zusatzrechnung gebucht. Konfigurierbar sind das Erlöskonto (Vorschlag: SKR03 8400 „Erlöse 19% USt"), ein optionaler Artikel für die Position und die USt-Behandlung (likeMainSupply oder none).

Die Oberfläche blendet bei aktivierter Weitergabe einen Warnhinweis ein: Ein Entgeltaufschlag für gängige bargeldlose Zahlungsmittel kann im B2C nach **§270a BGB** unzulässig sein. Vor dem Einsatz mit dem Steuerberater abstimmen. Die Doku gibt diesen Hinweis nur wieder und ersetzt keine Rechtsberatung.

<Screenshot status="todo" beschreibung="Rechnungsausgang-Einstellungen: Master-Schalter „Öffentliche Bezahlseite", Checkboxen Banküberweisung/PayPal (+ geplante Methoden), QR-Modus-Auswahl, darunter der Schalter „PayPal-Gebühr weitergeben" mit Erlöskonto, Artikel und USt-Behandlung." />

Verknüpfungen zu anderen Modulen

• Öffentliche Bezahlseite — was die Einstellungen für den Kunden bewirken.
• Zahlungskonten — PayPal-Zugangsdaten und Gebührensatz (Integrations-Manager).
• Verkaufsbelege — Bezahlung per PayPal-Link.

Wiederverwendbare Konzepte

• PayPal-Zahlungsannahme
• Berechtigungen verstehen (CASL)

API/Schnittstellen

Methode	Endpoint	Zweck	CASL
GET	/api/settings/rechnungsausgang	Konfiguration lesen	update Settings
PUT	/api/settings/rechnungsausgang	Konfiguration speichern	update Settings

Häufige Fehler und Lösungen

Fehler	Lösung
Werte werden nicht geladen	fehlendes update:Settings — beide Endpunkte verlangen es
PayPal nicht wählbar auf der Bezahlseite	paypal nicht freigegeben oder keine aktive Anbindung mit paymentsEnabled
Aufschlag wird nicht berechnet	paypalSurchargeEnabled aktiv, aber kein Erlöskonto hinterlegt
Druck zeigt weiterhin Bank-QR	QR-Modus steht auf bankQr statt payLinkQr

Versionshinweise

• 2026-06-22: Initiale Veröffentlichung — Rechnungsausgang-Einstellungen (Bezahlseite, Methoden, QR-Modus, PayPal-Gebühren-Weitergabe). Verifiziert an SettingsRechnungsausgangPage.tsx und settings.router.ts (/settings/rechnungsausgang).