Repository navigation
Description
Anlass
Bei Zahlungsdienstleistern (Stripe, PayPal, Shopify Payments, Etsy, eBay …) behält der Anbieter bei jeder Kundenzahlung eine Gebühr ein. Haben legt daraus heute zwei getrennte Umsätze an, die in der Bankliste weit auseinander stehen können. Beim Zuordnen sieht man nur die eine Hälfte; die Gebühr muss separat gebucht werden, obwohl beide aus derselben Bewegung stammen.
Beispiel aus einem Stripe-Konto (Export „Balance history“), eine Bewegung txn_…:
| Umsatz | Betrag | Status |
|---|---|---|
Zahlung (charge), Gegenpartei leer |
+56,00 € | Offen |
| Gebühr, Gegenpartei „Stripe“ | −1,09 € | Beleg fehlt |
Screenshot 1: so steht es heute in Haben (zwei Zeilen, Gegenpartei der Zahlung leer).
Buchhaltungsbutler zeigt dieselbe Bewegung als eine Zeile mit dem Bruttobetrag, darunter eingerückt die Gebühr als zweite Teilzeile (Erlöskonto 4400 mit Steuerschlüssel, Gebühr 6855 „Nebenkosten des Geldverkehrs“ ohne USt/VSt). Rechnung zuweisen, Konten und Steuer stehen in derselben Zeile; Zahlung und Gebühr werden zusammen bestätigt.
Screenshot 2: Vorbild Buchhaltungsbutler (Zahlung 15,00 €, Gebühr −0,35 €, Saldo 14,65 €).
Stand in Haben
Geprüft auf main @ a0a135e.
- Import trennt bewusst (
packages/import/src/psp.ts, Kopfkommentar undparseStripe): aus einer Zeile mit Brutto, Gebühr und Netto entstehen zwei Umsätze. Die Gebühr hat die Referenz<txn_…>-gebuehr, die Zahlung<txn_…>. Die Zusammengehörigkeit steht also in den Daten, wird aber in der Oberfläche nicht genutzt. Der Importvertrag aus Gemeinsame Importschnittstelle für Bank- und Zahlungsdienstleister-Connectoren #306 kennt sie ausdrücklich:import_movementshat die Komponentenmainundfeezur selbensourceEventId. - Die Bausteine für den Rest gibt es schon: In
bank.tsxgibt es „Voll zuordnen, Rest als Gebühr“ (nur wenn der Umsatz kleiner ist als der offene Betrag, also bei Auszahlungen ohne getrennte Gebühr), die Aufteilung eines Umsatzes in Teile mit Vorzeichen, und die Sammelrechnung der Gebühren (Gebühren eines Monats einem Beleg zuordnen). Eine Zahlung mit der zugehörigen Gebühr in einem Schritt zuzuordnen geht nur über Umwege: zuerst die Zahlung der Rechnung, dann die Gebühr separat. - Die Gebühr wird erst gebucht, wenn man sie gesondert behandelt; bis dahin steht sie als „Beleg fehlt“ in der Liste.
Name und Verwendungszweck fehlen bei Stripe
Im Screenshot 1 hat die Zahlung keine Gegenpartei, der Verwendungszweck ist nur charge · txn_…. Das ist keine Fehlzuordnung, sondern kommt aus dem Stripe-Export:
- CSV „Balance history“ (
parseStripe): Der Name kommt aus der Spalte Kunde (customer_namebzw.customer_email), sonst ausdescription. Beide Spalten sind im Export nur gefüllt, wenn man sie beim Erstellen des Berichts auswählt, unddescriptionist leer, wenn die Zahlung ohne Beschreibung angelegt wurde (typisch bei Checkout und Payment Links). Dann bleibt der Name leer und der Zweck besteht nur aus Art undtxn_-Kennung. Die Doku (docs/bank-zahlungsdienstleister.md) nennt nur „Stripe: Saldenverlauf“, nicht welche Spalten Haben für Name und Zweck braucht. - API-Adapter aus Gemeinsame Importschnittstelle für Bank- und Zahlungsdienstleister-Connectoren #306 / Bank: Stripe-Umsätze über die API abrufen (Balance Transactions) #1280 (Entwurf Bank: Stripe-Balance-Transactions nach dem Importvertrag abbilden (#306, #1280) #1237,
stripe/batch.ts): Hier ist es konsequent schlechter: Für Zahlungen wird gar keine Gegenpartei gesetzt (nur bei Auszahlung und Gebühr „Stripe“), der Zweck istdescriptionoder diereporting_category. Name, E-Mail und Rechnungsnummer des Kunden stehen in der Balance Transaction nicht, sondern am zugehörigen Charge (billing_details.name,receipt_email,description,metadata,invoice). Die Abfrage nutzt dafür bisher nurexpand[]=data.source.chargefür Erstattungen und Streit.
Behoben im Entwurf Bank: Stripe-Balance-Transactions nach dem Importvertrag abbilden (#306, #1280) #1237 (Commit 428f023): Der Abruf klapptsourceauf und übernimmt Name (sonst E-Mail), Beschreibung und Rechnungsnummer aus dem Charge, bei Erstattung und Streit aus der ursprünglichen Zahlung. Noch offen bleibt die CSV-Seite. - Buchungstext: Haben bildet den Buchungstext der Journalbuchung aus Gegenpartei und Art, etwa
Zahlung RE-0026 · <Gegenpartei>oder<Gegenpartei> · <Label>. Bei leerer Gegenpartei steht dort „Bankumsatz“. Wer Name und Verwendungszweck nicht mitliefert, bekommt also auch einen nichtssagenden Buchungstext, und die Vorschläge zur Zuordnung („lernt aus früheren Zuordnungen nach Name“) finden nichts.
Das gilt ebenso für Fremdsysteme mit Gebühren: PayPal, Shopify, eBay und Etsy liefern Name bzw. Betreff, aber nicht immer Rechnungsnummer; die Anzeige der Gebühr sollte überall dieselbe sein.
Ich habe das aus dem Code abgeleitet und mit den Spalten der Stripe-Dokumentation verglichen, nicht gegen einen echten Export des betroffenen Kontos nachvollzogen. Welche Spalten die Datei im konkreten Fall hatte, sollte vor der Umsetzung geprüft werden.
Vorschlag
1. Zahlung und Gebühr als eine Zeile anzeigen und zusammen zuordnen
- Umsätze, die zur selben Bewegung gehören (CSV: gleiche Kennung mit Anhang
-gebuehr; Importvertrag: gleichesourceEventId, Komponentenmainundfee), erscheinen in der Liste als eine Zeile: Bruttobetrag, darunter eingerückt die Gebühr, daneben der Nettobetrag. Beide Beträge einzeln sichtbar, die Summe ergibt den Zufluss auf dem Verrechnungskonto. - Eine Zuordnung gilt für die Zeile: Rechnung (voller Brutto-Erlös), Gebühr als Aufwand (Konto für Nebenkosten des Geldverkehrs, bei Gebühren aus dem Ausland optional mit Gebührenbeleg bzw. § 13b wie in der Sammelrechnung). Bestätigen bucht beide Teile.
- Die Teile bleiben getrennte Umsätze mit eigener Kennung (Dubletten-Erkennung, Importvertrag und Archiv bleiben unverändert); nur Anzeige und Zuordnung fassen sie zusammen. Wer die Gebühr gesondert behandeln will (Sammelrechnung), kann die Gruppe auflösen.
- Erstattungen, Streitfälle und Gutschriften einer Gebühr werden wie bisher als eigene Zeilen geführt, mit Bezug auf die Zahlung, wenn die Quelle ihn liefert (
relatedEventId).
2. Name und Verwendungszweck übernehmen
- CSV: Beim Import eines Stripe-Exports prüfen, ob Name/E-Mail/Beschreibung-Spalten vorhanden sind; wenn nicht, am Import-Dialog ein Hinweis, welche Spalten man beim Erstellen des Berichts hinzufügt (
customer_name,customer_email,description,invoice_id/order_id). Zusätzliche Spalten (Rechnungsnummer, Bestellnummer, Payment Intent) in den Verwendungszweck. - API (Bank: Stripe-Umsätze über die API abrufen (Balance Transactions) #1280/Bank: Stripe-Balance-Transactions nach dem Importvertrag abbilden (#306, #1280) #1237): (im Entwurf Bank: Stripe-Balance-Transactions nach dem Importvertrag abbilden (#306, #1280) #1237 umgesetzt) Charge mit expandieren (
data.source, bzw.data.source.chargeunddata.source.charge.billing_details), Gegenpartei ausbilling_details.name, sonstreceipt_email; Verwendungszweck ausdescriptionundinvoice/metadata(z. B. Rechnungsnummer), sonstreporting_category. Damit kann der Betrag + Rechnungsnummer-Abgleich Zahlungen automatisch vorschlagen. - Buchungstext: bei leerer Gegenpartei nicht „Bankumsatz“, sondern den Zweck verwenden.
3. Für alle Zahlungsdienstleister
Die Gruppierung hängt nicht an Stripe: Jeder Adapter, der Brutto und Gebühr liefert (PayPal, Shopify, eBay, Etsy, Stripe, Importvertrag aller Quellen), setzt dieselbe Gruppenkennung. Auszahlungen bleiben einzelne Zeilen (Geldtransit).
Planung und Machbarkeit
Aufwand grob: Stufe 1 klein bis mittel, Stufe 2 klein (CSV) bzw. mittel (API, abhängig von #1237), Stufe 3 klein.
- Gruppenbildung (klein): In der Abfrage des Bankabgleichs eine Gruppenkennung ableiten. Für CSV aus
bankReference(Suffix-gebuehr), für den Importvertrag aussourceEventId. Keine Migration nötig, wenn man bei den bestehenden Kennungen bleibt; für Altbestand liefert das Suffix die Zuordnung. Ob eine eigene Spalte (z. B.group_ref) sauberer ist, sollte der Maintainer entscheiden. - Anzeige (mittel): Zeile mit eingerückter Gebühr in
bank.tsx; Zähler und Filter („Offen“, „Beleg fehlt“) rechnen eine Gruppe als einen Eintrag. - Zuordnung in einem Zug (mittel): Serverseitig bestehende Bausteine nutzen (Teile mit Vorzeichen, Gebühr als „ohne Rechnung buchen“ / Sammelrechnung), neu ist die Klammer, die beide Zuordnungen in einer Transaktion schreibt und die Summe prüft. Testfälle: Gebühr 0 €, Gebühr größer als Zahlung, Teilzahlung der Rechnung, Auflösen der Gruppe, Storno einer der beiden Buchungen.
- Name und Zweck (CSV klein, API mittel): siehe oben.
- Doku:
docs/bank-zahlungsdienstleister.mdunddocs/bank.md.
Risiken / offene Fragen
- Soll die Gebühr immer zusammen mit der Zahlung bestätigt werden, oder darf man sie getrennt lassen? Vorschlag: Standard zusammen, Auflösen möglich.
- Umsatzsteuer der Gebühr: Stripe-Gebühren kommen je nach Konto mit Umsatzsteuer oder als § 13b (Rechnungssteller im Ausland); das ist bei der Gebührenbuchung heute schon Thema (Sammelrechnung). Die Zeile sollte den Steuerschlüssel je Gebühr wählbar machen (wie Screenshot 2 „ohne USt/VSt“) und den Gebührenbeleg verknüpfen können.
- Zählung „offene Umsätze“ in Übersicht und Archiv: bleibt je Umsatz oder je Gruppe? Vorschlag: je Gruppe in der Liste, je Umsatz in Auswertungen und Export.
Akzeptanzkriterien
- Zahlung und Gebühr derselben Bewegung erscheinen im Bankabgleich als eine Zeile mit Brutto, Gebühr und Netto.
- Einer Zahlung lässt sich in der Zeile direkt eine Rechnung zuordnen; die Gebühr wird im selben Schritt als Aufwand gebucht (oder einem Beleg zugeordnet). Danach sind beide Umsätze erledigt.
- Die Gruppe lässt sich auflösen; die Gebühr bleibt dann ein eigener Umsatz (Sammelrechnung wie bisher).
- Gilt für Stripe, PayPal, Shopify, eBay und Etsy; Importvertrag und CSV-Import erzeugen dieselbe Gruppierung.
- Name und Verwendungszweck stehen bei Stripe-Zahlungen, wenn die Quelle sie liefert; fehlen Spalten, weist der Import darauf hin. Buchungstext enthält Gegenpartei bzw. Zweck, nie nur „Bankumsatz“.
- Dubletten-Erkennung, Importvertrag (Gemeinsame Importschnittstelle für Bank- und Zahlungsdienstleister-Connectoren #306), Archiv, Ist-/Soll-Versteuerung und DATEV-Export bleiben unverändert; Tests für Gruppierung, gemeinsame Zuordnung und Storno.
Bezug
#108 (Gebühren und Geldtransit bei Zahlungsdienstleistern), #306 (Importvertrag) und #1280 (Stripe über die API, Entwurf #1237). Ich würde das gern selbst umsetzen; zunächst reicht mir eine Rückmeldung, ob die Gruppierung in der Anzeige (Stufe 1) so gewünscht ist und ob Stufe 2 mit #1237 zusammen oder getrennt laufen soll.
Generated with Claude Code
Metadata
Metadata
Assignees
Labels
Projects
- StatusShow more project fieldsIn Arbeit


Activity
JB1985 commentedon Nov 18, 2026
/übernehmen
Ich würde das gern umsetzen, in drei getrennten Pull Requests (je
Refs #1417, der letzteUmgesetzt):<txn>und<txn>-gebuehrbzw.sourceEventIdmitmainundfee), ohne Migration und ohne die Umsätze zu verändern.Fragen vorab:
-gebuehr), oder soll sie eine eigene Spalte bekommen?github-actions commentedon Nov 18, 2026
@JB1985 das Issue ist noch nicht im Board eingeordnet. Ein Maintainer schaut es sich an und meldet sich hier.
Dudeplayz commentedon Nov 18, 2026
@JB1985 danke, das gehört dir. Die Karte steht im Board unter „In Arbeit“, Bereich Bank und Kasse, direkt unter #1280.
Umfang: Zahlung und Gebühr eines Zahlungsdienstleisters als eine Zeile anzeigen und in einem Schritt zuordnen, dazu Name und Verwendungszweck bei Stripe. Die Skizze mit drei Pull Requests passt so.
Zu deinen Fragen:
Refs #1417.<txn>und<txn>-gebuehrbzw.sourceEventIdmitmainundfee), keine eigene Spalte. So braucht es keine Migration, und der Altbestand gruppiert sich ohne Änderung. Eine Spalte erst, wenn ein Adapter keine solche Kennung liefert.Für Schritt 3: Die Steuer der Gebühr muss je Gebühr wählbar bleiben. Stripe-Gebühren aus Irland sind meist § 13b UStG, nicht „ohne USt/VSt“ wie im Screenshot von Buchhaltungsbutler. Weil der Schritt Buchung und Steuer berührt, kommt er vor dem Merge noch einmal zu mir.
Bank: Stripe-Export mit Kunde, Hinweis bei fehlenden Spalten (firsttr…
Bank: Zahlung und Gebühr eines Zahlungsdienstleisters in einer Zeile …
Bank: Zahlung eines Zahlungsdienstleisters mit ihrer Gebühr in einem …
Bank: Zahlung und Gebühr eines Zahlungsdienstleisters in einer Zeile …
Bank: Zahlung eines Zahlungsdienstleisters mit ihrer Gebühr in einem …
JB1985 commentedon Nov 18, 2026
@Dudeplayz danke für die Antworten. Die drei Pull Requests stehen als Entwürfe:
customer_name/customer_emailund Hinweis bei fehlenden Spalten (Refs). Der Verwendungszweck bleibt unverändert, weil er in den Dedup-Hash eingeht; der API-Teil bleibt in Bank: Stripe-Balance-Transactions nach dem Importvertrag abbilden (#306, #1280) #1237.Refs). Gruppiert wird nur, solange beide ganz offen sind, sonst bleiben beide einzeln erreichbar.Umgesetzt). Die Steuer der Gebühr bleibt wählbar: ohne Beleg ohne Steuer, oder der gebuchte Beleg der Gebühr, dann laufen Vorsteuer bzw. § 13b über ihn. Der Pull Request enthält den Commit von Bank: Zahlung und Gebühr eines Zahlungsdienstleisters in einer Zeile anzeigen (#1417) #1431, bis dieser gemergt ist, und geht vor dem Merge an dich zurück, wie besprochen.Als Nächstes folgen die Selbstprüfung und das unabhängige Review je Pull Request, dann „Ready for review“.
Bank: Stripe-Export mit Kunde, Hinweis bei fehlenden Spalten (firsttr…
Bank: Zahlung und Gebühr eines Zahlungsdienstleisters in einer Zeile …
Bank: Zahlung eines Zahlungsdienstleisters mit ihrer Gebühr in einem …
Bank: Stripe-Export mit Kunde, Hinweis bei fehlenden Spalten (firsttr…
Bank: Zahlung und Gebühr eines Zahlungsdienstleisters in einer Zeile …
Bank: Zahlung eines Zahlungsdienstleisters mit ihrer Gebühr in einem …
Bank: Stripe-Export mit Kunde, Hinweis bei fehlenden Spalten (firsttr…
Bank: Zahlung und Gebühr eines Zahlungsdienstleisters in einer Zeile …
Bank: Zahlung eines Zahlungsdienstleisters mit ihrer Gebühr in einem …
Bank: Stripe-Export mit Kunde, Hinweis bei fehlenden Spalten (#1417) (#…