Skip to content

Bank: Zahlung eines Zahlungsdienstleisters mit ihrer Gebühr in einem Schritt zuordnen (#1417) - #1432

Open
JB1985 wants to merge 2 commits into
firsttris:mainfrom
JB1985:zahlung-gebuehr-zuordnen-1417
Open

JB1985 wants to merge 2 commits into
firsttris:mainfrom
JB1985:zahlung-gebuehr-zuordnen-1417

Conversation

@JB1985

@JB1985 JB1985 commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

Refs #1417

Baut auf dem Pull Request „Zahlung und Gebühr … in einer Zeile anzeigen“ (Refs #1417) auf; dessen Commit steht hier mit drin, bis er gemergt ist.

Wählt man für die ganze Zahlung eines Zahlungsdienstleisters eine Rechnung oder einen Beleg, ordnet „Zuordnen und Gebühr buchen“ beides in einer Transaktion zu (allocatePaymentWithFee):

  • Zahlung mit vollem Bruttobetrag auf die Rechnung bzw. den Beleg (voller Erlös, bei Ist-Versteuerung die Umsatzsteuer am Tag der Zahlung).
  • Gebühr derselben Bewegung: standardmäßig als Nebenkosten des Geldverkehrs ohne Steuer. Unter Steuer der Gebühr lässt sich stattdessen der gebuchte Beleg der Gebühr wählen (Rechnung des Dienstleisters); dann laufen Vorsteuer bzw. § 13b über den Beleg und nichts wird doppelt gebucht. So bleibt die Steuer je Gebühr wählbar (Stripe-Gebühren aus Irland sind meist § 13b). Der Hinweis am Kästchen nennt, was gerade gebucht wird.
  • Ein Kästchen „Gebühr mitbuchen“ nimmt die Gebühr heraus; sie erscheint dann nach dem Zuordnen der Zahlung als eigene Zeile (Sammelrechnung wie bisher).
  • Die Zuordnungen bleiben einzeln und lassen sich einzeln aufheben, jede in der Zeile ihres Umsatzes.
  • Der Server findet die Gebühr über die Referenz und lehnt ab, wenn nicht die ganze Zahlung zugeordnet wird, Zahlung oder Gebühr nicht mehr ganz offen sind, die Gebühr fehlt oder nicht eindeutig ist, oder es kein Eingang mit abgezogener Gebühr ist; dann wird nichts gebucht, auch nicht die Zahlung, wenn der Beleg der Gebühr nicht passt.
  • Die Oberfläche steht in components/BankGebuehr.tsx, damit AllocationPanel kaum wächst.
  • Playwright: eigener Durchlauf zahlung-gebuehr (e2e/zahlung-gebuehr.spec.ts, Port +34): Liste mit Zahlung und Gebühr in einer Zeile, kein Angebot ohne passenden Posten, Zuordnen und Gebühr buchen, einzeln aufheben, Zahl am Reiter, axe.
  • Doku: docs/bank-zahlungsdienstleister.md.

Oberfläche (Zuordnungsfeld mit Kästchen und Steuer der Gebühr; die Liste steht in #1431), hell und dunkel:

Zuordnen hell
Zuordnen dunkel

Bewusst nicht dabei: Erstattungen mit zurückgebuchter Gebühr, Teilzahlungen mit Gebühr, Etsy.

Geprüft: bun run lint, bun run typecheck, bun run test packages/core apps/web/src/server/modules/bank gegen Postgres. Neu: zahlung-gebuehr.test.ts (7 Tests: Zahlung plus Gebühr samt Salden, Gebühr an Beleg ohne und mit 19 % Vorsteuer, Rücknahme bei zu kleinem Beleg, SKR04 mit Soll-Versteuerung, teilweise zugeordnete Zahlung, Ablehnungen ohne Buchung). Playwright-Durchlauf zahlung-gebuehr gegen den gebauten Server (E2E_SERVER_COMMAND="bun .output/server/index.mjs"), 4 Tests grün; im Dev-Server läuft die erste Anmeldung auf dem Runner in den 10-Sekunden-Timeout von Bun.serve, das betrifft jeden Durchlauf. Nicht grün sind 3 Tests in bank/fints.test.ts; sie schlagen auch auf unverändertem main fehl. Nicht gelaufen: die übrigen E2E-Durchläufe, Tests außerhalb von packages/core und dem Bankmodul. Ein unabhängiges Review und eine Selbstprüfung (jeweils frischer Agent) haben Befunde geliefert, sie sind eingearbeitet.

Die Regel-Prüfung meldet nur Hinweise zur Länge (BankPage +2, AllocationPanel +12 Zeilen, ohne die ausgelagerten Teile wäre es mehr); der Rest der Funktionen ist unverändert.

Mit #1431 und dem Entwurf #1237 (Name aus dem Charge) ist #1417 erfüllt; Umgesetzt setzt der Maintainer beim Merge des letzten Teils.

Vor dem Merge geht der Pull Request noch einmal an den Maintainer, weil er Buchung und Steuer berührt (#1417).

🤖 Generated with Claude Code

@github-actions

github-actions Bot commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

PR-Regeln

Hinweise (der Check bleibt grün, bitte trotzdem ansehen):

  • apps/web/src/routes/_app/bank.tsx wächst von 1782 auf 1807 Zeilen: Lässt sich das Neue in eine eigene Datei legen?
  • apps/web/src/routes/_app/bank.tsx: Funktion „BankPage“ wächst von 86 auf 89 Zeilen (Grenze 80): das Neue vor dem Merge in eine eigene Funktion legen (docs/entwicklung.md, Konventionen).
  • apps/web/src/routes/_app/bank.tsx: Funktion „AllocationPanel“ wächst von 280 auf 292 Zeilen (Grenze 80): das Neue vor dem Merge in eine eigene Funktion legen (docs/entwicklung.md, Konventionen).
  • Vor dem Merge: Selbstprüfung mit beitrag-pruefen als Kommentar im Pull Request, dann ein unabhängiges Review mit tdd-review für den Code und parallel doku-pruefen für die Markdown-Dateien durch jemand anderen oder einen frischen Agenten. Die Skills liegen in .claude/skills/; fehlt eins davon, prüfen wir den Pull Request nicht (docs/mitwirken.md, Beiträge annehmen).

Was bei jeder Meldung zu tun ist: Wenn eine Prüfung anschlägt. Agenten arbeiten sie nach Skill beitrag, Schritt 6, ab.

Stand 513c9fc. Dieser Kommentar ändert sich mit jedem Push.

@JB1985

JB1985 commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor Author

Selbstprüfung

Stand: efa7c33. Geprüft von einem frischen Agenten ohne den Verlauf der Entstehung, nach Skill beitrag-pruefen; die Befunde sind eingearbeitet, offene stehen unten. Der Pull Request enthält den Commit von #1431 (NUL-Zeichen-Fix dort).

Wollen wir das? Ja, es ist Schritt 3 der in #1417 abgestimmten Skizze, mit den beiden Bedingungen des Maintainers: Steuer je Gebühr wählbar, Rückfrage vor dem Merge. Neu sind eine Server-Funktion, ein Zod-Schema und ein Playwright-Durchlauf; keine Tabelle, keine Migration. Alles läuft über das vorhandene allocateIn, die Zuordnungen sind die bisherigen (invoice, document, gebuehren) und lassen sich einzeln aufheben. Refs #1417, weil der API-Teil in #1237 noch aussteht.

Nach den Quellen gebaut, fachlich richtig? Heikel: ja (Buchung, Ist/Soll, Vorsteuer, § 13b). Getestet gegen Postgres: SKR03 mit Ist, SKR04 mit Soll; Gebühr ohne Beleg (Aufwand 4970 bzw. 6855, ohne Steuer), Gebühr an einen Beleg ohne Steuer und mit 19 % Vorsteuer (Aufwand 1,26 €, Vorsteuer 0,24 €, Bankkonto ausgeglichen); zu kleiner Beleg nimmt die Zuordnung der Zahlung mit zurück; teilweise zugeordnete Zahlung wird abgelehnt. Nicht gegen das Gesetz nachgerechnet habe ich, ob eine konkrete Stripe-Gebühr unter § 13b UStG oder § 4 Nr. 8 UStG fällt; das hängt an der Rechnung des Dienstleisters. Deshalb ist „ohne Beleg“ nur für steuerfreie Gebühren richtig, und die Auswahl „Steuer der Gebühr“ weist im Hinweis auf § 13b hin.

Einfachste Lösung? Keine eigene Buchungslogik, kein neuer Zustand in der Datenbank; die Oberfläche liegt in components/BankGebuehr.tsx, damit AllocationPanel kaum wächst.

Nach unseren Regeln? Titel, Refs, KI-Kennzeichnung, Doku, Screenshots hell und dunkel, Playwright-Durchlauf zahlung-gebuehr (axe auf dem Zuordnungsfeld). Lint, Typecheck, Tests grün bis auf die FinTS-Tests, die auch auf main fehlschlagen.

Eingearbeitet aus dem Review: Server prüft jetzt auch, dass Zahlung und Gebühr noch ganz offen sind (wie die Oberfläche); Test mit 19 % Vorsteuer; Test für teilweise zugeordnete Zahlung; Doku gekürzt.

Fragen an den Maintainer (vor dem Merge):

  1. Ein Test für eine Zahlung auf einen Beleg (statt auf eine Rechnung) fehlt; die Oberfläche bietet beides an.
  2. Die Regel-Prüfung meldet AllocationPanel um 12 Zeilen länger (der Rest liegt in BankGebuehr.tsx).

Erzeugt mit Claude Code.

Nachtrag, Stand 513c9fc: Kontozweck im Server geprüft, Test für ein Bankkonto, Doku als Unterliste. Die Befunde der Reviews (tdd-review, doku-pruefen) stehen in den Kommentaren darunter.

Copy link
Copy Markdown
Owner

@JB1985 Wie in #1430: Die Selbstprüfung liegt vor, bis efa7c334. Es fehlen noch tdd-review für den Code und doku-pruefen für die Markdown-Dateien, je in einem frischen Agenten bis zu deinem letzten Commit und als Kommentar (Skill beitrag, Schritt 6). Weil der PR bucht, also Zuordnungen mit Gebühr und Steuer, prüfen wir ihn danach vollständig. Gemergt wird er erst nach #1431.


Generated by Claude Code

@JB1985
JB1985 force-pushed the zahlung-gebuehr-zuordnen-1417 branch from efa7c33 to 8171671 Compare November 18, 2026 14:50
JB and others added 2 commits November 18, 2026 15:53
…anzeigen (firsttris#1417)

Der Import legt aus einer Zeile mit Brutto und Gebühr zwei Umsätze an; die
Gebühr trägt die Referenz der Zahlung mit Anhang (`-gebuehr`, bei Shopify
`|gebuehr`). Daran fasst die Bankliste beide zu einer Zeile zusammen
(`gruppiereGebuehren` in @haben/core): unter dem Betrag der Zahlung steht die
Gebühr. Das gilt, solange Zahlung (Eingang) und Gebühr (Abzug) ganz offen sind
und die Referenz im Konto genau eine Zahlung und eine Gebühr trifft; sonst
bleiben beide eigene Zeilen, damit jede Zuordnung einzeln erreichbar ist. Die
Umsätze, ihre Kennungen und die Datenbank bleiben unverändert, es gibt keine
Migration. Die Zahl am Reiter „Offen“ zählt die Zeilen wie die Liste. Das Zuordnen in einem Schritt folgt
in einem eigenen Pull Request.

Refs firsttris#1417

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…Schritt zuordnen (firsttris#1417)

Wählt man für die ganze Zahlung eines Zahlungsdienstleisters eine Rechnung oder
einen Beleg, ordnet „Zuordnen und Gebühr buchen“ beides in einer Transaktion zu
(`allocatePaymentWithFee`): die Zahlung mit vollem Bruttobetrag, die Gebühr
derselben Bewegung ohne Steuer als Nebenkosten des Geldverkehrs oder, wenn man
den gebuchten Beleg der Gebühr wählt, diesem Beleg zugeordnet; dann laufen
Vorsteuer bzw. § 13b über den Beleg. Ein Kästchen nimmt die Gebühr heraus. Die
Zuordnungen bleiben einzeln und lassen sich einzeln aufheben. Zahlung und
Gebühr findet der Server selbst über die Referenz; er lehnt ab, wenn nicht die
ganze Zahlung zugeordnet wird, Zahlung oder Gebühr nicht mehr ganz offen sind,
die Gebühr fehlt oder nicht eindeutig ist, und bucht dann nichts. Die Auswahl-
und Kästchenlogik liegt in `components/BankGebuehr.tsx`. Ein eigener
Playwright-Durchlauf (`zahlung-gebuehr`) klickt Liste, Zuordnen, Aufheben und die
Zahl am Reiter durch.

Refs firsttris#1417

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@JB1985
JB1985 force-pushed the zahlung-gebuehr-zuordnen-1417 branch from 8171671 to 513c9fc Compare November 18, 2026 14:54
@JB1985

JB1985 commented Nov 18, 2026

Copy link
Copy Markdown
Contributor Author

Code-Review (tdd-review), Runde 1 und 2

Runde 1, Stand efa7c33 (frischer Agent): 1 belegtes Finding, behoben. Gruppierung und allocatePaymentWithFee galten für jedes Konto statt nur für Zahlungsdienstleister (auf einem Bankkonto mit den Referenzen RE-1 und RE-1-gebuehr hätte der Server die Belastung als Gebühr derselben Bewegung ohne Steuer gebucht; zwei rote Tests). Behoben: Kontozweck-Prüfung im Server, Gruppierung nur für Zahlungsdienstleister-Konten, dazu ein Test.

Geprüft und grün: Rennen bei zwei gleichzeitigen Aufrufen, Atomarität (Beleg zu klein, storniert, Entwurf, falsches Vorzeichen, Rechnung kleiner als die Zahlung: jeweils nichts gebucht), Steuer (SKR04/Soll mit 19 % Vorsteuer, § 13b mit Ist/SKR03, zusammen mit den Tests des PR SKR03/SKR04 und Ist/Soll abgedeckt), Aufheben einzeln in beiden Reihenfolgen, Zahlung auf einen Beleg mit zu kleinem Betrag.

Runde 2, Stand 8171671 (anderer frischer Agent): keine Findings. Die Behebung wirkt (Kontozweck unter Sperre geprüft, Gruppierung gefiltert, kein Regress), git diff efa7c334 81716719 enthält nur die erwarteten Dateien; eigene Proben (Überzahlung abgelehnt, Teilzahlung bucht Rechnung und Gebühr in zwei Zuordnungen) grün.

Nicht belegt: bei einer Teilzahlung auf eine größere Rechnung sagt der Hinweis am Kästchen „die Rechnung gilt mit dem vollen Betrag als bezahlt“, obwohl nur die Teilzahlung gebucht wird (die Buchung ist richtig, nur der Text ungenau); hinter dem Listenlimit von 500 Umsätzen kann eine Gebühr aus der Liste fallen.

@JB1985

JB1985 commented Nov 18, 2026

Copy link
Copy Markdown
Contributor Author

Doku-Prüfung (doku-pruefen)

Stand: 8171671 (frischer Agent). Ein Befund (gering), behoben in 513c9fc. Schritt 5 hatte fünf Fälle in einem Absatz, und der Halbsatz „die Gebühr einer offenen Zahlung wählst du erst, wenn die Zahlung zugeordnet ist“ galt nur für die zusammengefasste Zeile. Jetzt als Unterliste, mit „ordnest du die Zahlung ohne sie zu, erscheint die Gebühr danach als eigene Zeile“.

Sachlich stimmt der Text mit dem Code überein: nur ganz offene Umsätze, nur Konten des Zahlungsdienstleisters, „Zuordnen und Gebühr buchen“ mit vollem Bruttobetrag, Gebühr als Nebenkosten des Geldverkehrs ohne Steuer (SKR03 4970, SKR04 6855), Auswahl „Steuer der Gebühr“ und Kästchen wie in BankGebuehr.tsx, Aufheben einzeln durch den E2E-Test belegt; § 13b UStG sachlich richtig dargestellt, keine weitergehende Aussage. Keine Doppelung, kein Skill oder CLAUDE.md berührt.

Copy link
Copy Markdown
Owner

@JB1985 Danke, das ist schlank gebaut. Es gibt keine eigene Buchungslogik, alles läuft über allocateIn in einer Transaktion. Der Server prüft Konto, Vorzeichen und „ganz offen“ unter Sperre, und die Zuordnungen bleiben einzeln aufhebbar.

Gegengerechnet haben wir zwei Fälle. Bei 59,50 € Zahlung und 1,50 € Gebühr ergibt SKR03/Ist 4970 +1,50, 8400 −50,00 und 1776 −9,50. Mit einem § 13b-Beleg von Stripe ergeben SKR03/Ist und SKR04/Soll Kz 46 = 1,50 und Kz 47 = Kz 67 = 0,29. Beides stimmt.

Entscheidung des Maintainers zum Standard (vor dem Merge nötig): Das Kästchen „Gebühr mitbuchen“ ist standardmäßig aus. Der Grund:

  • Vorausgewählt ist bisher „mitbuchen, ohne Beleg, ohne Steuer“. Das passt nur für steuerfreie Gebühren wie bei PayPal (§ 4 Nr. 8 Buchst. d UStG).
  • Gebühren von Stripe und Shopify aus Irland fallen meist unter § 13b (§ 13b Abs. 1, Abs. 5 Satz 1 UStG), und ihre Monatsrechnung gibt es beim Zuordnen der Zahlung noch nicht.
  • Mit einem Klick fehlten dann Kz 46, 47 und 67 in der Voranmeldung, und die spätere Sammelrechnung fände keine offenen Gebühren mehr.

Ist das Kästchen aus, wird nur die Rechnung bezahlt, und die Gebühr bleibt offen wie bisher. Wer sie gleich buchen will, setzt das Häkchen bewusst. Bitte mit einem Test, der den Standard prüft, und die Doku in docs/bank-zahlungsdienstleister.md dazu.

Außerdem vor dem Merge:

  • Länge: BankPage wächst von 86 auf 89 und AllocationPanel von 280 auf 292 Zeilen (Konventionen). Lokal hat sich bewährt, zuordnenText, die Tasten J/K (useUmsatzTasten), „Zuordnen und Gebühr buchen“ (Hook useGebuehrWahl) sowie RestAlsGebuehr und SammelrechnungKnopf in BankGebuehr.tsx auszulagern. Danach meldet bun scripts/pr-regeln/pruefen.ts nichts mehr.

Vorschläge:

  • Der Hinweis am Kästchen „die Rechnung gilt mit dem vollen Betrag als bezahlt“ stimmt bei einer Teilzahlung und bei einem Beleg als Ziel nicht.
  • Je ein Test für eine Zahlung auf einen Beleg und für eine Gebühr an einem § 13b-Beleg (Kz 46/47/67).

Bitte alles als eigene Commits obendrauf, kein Force-Push (Mitwirken), und danach tdd-review in einem frischen Agenten bis zum letzten Commit. Gemergt werden #1431 und #1432 zusammen.


Generated by Claude Code

This branch has not been deployed

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants