Skip to content

Bank: Zahlung und Gebühr eines Zahlungsdienstleisters zusammen anzeigen und zuordnen; Name und Verwendungszweck bei Stripe übernehmen #1417

Open

Description

@JB1985

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

Haben: Zahlung und Gebühr als zwei getrennte Umsätze

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.

Buchhaltungsbutler: Zahlung mit Gebühr in einer Zeile

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 und parseStripe): 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_movements hat die Komponenten main und fee zur selben sourceEventId.
  • Die Bausteine für den Rest gibt es schon: In bank.tsx gibt 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:

  1. CSV „Balance history“ (parseStripe): Der Name kommt aus der Spalte Kunde (customer_name bzw. customer_email), sonst aus description. Beide Spalten sind im Export nur gefüllt, wenn man sie beim Erstellen des Berichts auswählt, und description ist 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 und txn_-Kennung. Die Doku (docs/bank-zahlungsdienstleister.md) nennt nur „Stripe: Saldenverlauf“, nicht welche Spalten Haben für Name und Zweck braucht.
  2. 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 ist description oder die reporting_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 nur expand[]=data.source.charge für Erstattungen und Streit.
    Behoben im Entwurf Bank: Stripe-Balance-Transactions nach dem Importvertrag abbilden (#306, #1280) #1237 (Commit 428f023): Der Abruf klappt source auf 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.
  3. 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: gleiche sourceEventId, Komponenten main und fee), 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

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.

  1. Gruppenbildung (klein): In der Abfrage des Bankabgleichs eine Gruppenkennung ableiten. Für CSV aus bankReference (Suffix -gebuehr), für den Importvertrag aus sourceEventId. 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.
  2. Anzeige (mittel): Zeile mit eingerückter Gebühr in bank.tsx; Zähler und Filter („Offen“, „Beleg fehlt“) rechnen eine Gruppe als einen Eintrag.
  3. 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.
  4. Name und Zweck (CSV klein, API mittel): siehe oben.
  5. Doku: docs/bank-zahlungsdienstleister.md und docs/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

Activity

  1. JB1985 commented on Nov 18, 2026

    @JB1985
    ContributorAuthor

    /übernehmen

    Ich würde das gern umsetzen, in drei getrennten Pull Requests (je Refs #1417, der letzte Umgesetzt):

    1. Name und Verwendungszweck bei Stripe: Der API-Teil steht schon im Entwurf Bank: Stripe-Balance-Transactions nach dem Importvertrag abbilden (#306, #1280) #1237 (Commit 428f023). Dazu im CSV-Import ein Hinweis, wenn dem Export die Spalten für Kunde, Beschreibung und Rechnung fehlen, und diese Spalten im Verwendungszweck.
    2. Zahlung und Gebühr als eine Zeile im Bankabgleich (Gruppe aus <txn> und <txn>-gebuehr bzw. sourceEventId mit main und fee), ohne Migration und ohne die Umsätze zu verändern.
    3. Gemeinsame Zuordnung in einer Transaktion: Rechnung für den Bruttobetrag, Gebühr als Aufwand oder Beleg, Gruppe auflösbar, Tests für SKR03/SKR04 und Ist/Soll.

    Fragen vorab:

  2. github-actions commented on Nov 18, 2026

    @github-actions
    Contributor

    @JB1985 das Issue ist noch nicht im Board eingeordnet. Ein Maintainer schaut es sich an und meldet sich hier.

  3. moved this to In Arbeit in Roadmapon Nov 18, 2026
  4. added
    wunschNeue Funktion oder Verbesserung
    schnittstelleREST-API, MCP, Connectoren, laufende Importe
    on Nov 18, 2026
  5. Dudeplayz commented on Nov 18, 2026

    @Dudeplayz
    Collaborator

    @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:

    1. Reihenfolge: 1 → 2 → 3 passt. Der API-Teil von Schritt 1 bleibt in Bank: Stripe-Balance-Transactions nach dem Importvertrag abbilden (#306, #1280) #1237, wo er schon steht; der Hinweis zu fehlenden Spalten im CSV-Import kommt als eigener Pull Request mit Refs #1417.
    2. Gruppe: aus den vorhandenen Kennungen ableiten (<txn> und <txn>-gebuehr bzw. sourceEventId mit main und fee), 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.

  6. JB1985 commented on Nov 18, 2026

    @JB1985
    ContributorAuthor

    @Dudeplayz danke für die Antworten. Die drei Pull Requests stehen als Entwürfe:

    1. Bank: Stripe-Export mit Kunde, Hinweis bei fehlenden Spalten (#1417) #1430: Stripe-CSV mit Kunde aus customer_name/customer_email und 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.
    2. Bank: Zahlung und Gebühr eines Zahlungsdienstleisters in einer Zeile anzeigen (#1417) #1431: Zahlung und Gebühr in einer Zeile, aus den vorhandenen Kennungen abgeleitet, keine Migration (Refs). Gruppiert wird nur, solange beide ganz offen sind, sonst bleiben beide einzeln erreichbar.
    3. Bank: Zahlung eines Zahlungsdienstleisters mit ihrer Gebühr in einem Schritt zuordnen (#1417) #1432: „Zuordnen und Gebühr buchen“ in einer Transaktion (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“.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

schnittstelleREST-API, MCP, Connectoren, laufende ImportewunschNeue Funktion oder Verbesserung

Projects

  • Status
    In Arbeit

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions