Skip to content

Bank: Stripe-Export mit Kunde, Hinweis bei fehlenden Spalten (#1417) - #1430

Merged
firsttris merged 1 commit into
firsttris:mainfrom
JB1985:stripe-csv-hinweis-1417
Nov 18, 2026
Merged

firsttris merged 1 commit into
firsttris:mainfrom
JB1985:stripe-csv-hinweis-1417

Conversation

@JB1985

@JB1985 JB1985 commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

Refs #1417

Der Stripe-Export „Balance history“ nennt Kunde und Beschreibung nur, wenn man die Spalten beim Erstellen des Berichts wählt. Ohne sie hatte eine Zahlung keine Gegenpartei und als Zweck nur Art und Kennung (charge · txn_…); Haben sagte dem Nutzer nicht, woran das liegt.

  • Gegenpartei: customer_name, sonst customer_email, sonst wie bisher die Beschreibung.
  • Zahlungen (charge, payment) ohne Beschreibung bekommen beim Import einen Hinweis, dass der Bericht customer_name und customer_email braucht, aber nur, wenn der Bericht keine Kundenspalte hat (leer bei einer Gast-Zahlung ist normal). Der Import geht trotzdem durch.
  • Tests für den Namen aus customer_email allein und für den Hinweis im Plural.
  • Der Verwendungszweck bleibt unverändert, denn er geht in den Dedup-Hash ein; empfohlen werden deshalb nur die Kundenspalten (der Name steht nicht im Hash). Ein Test zeigt: derselbe Export mit und ohne Kundenspalten ergibt dieselben Hashes, ein erneuter Import legt nichts doppelt an.
  • Doku: docs/bank-zahlungsdienstleister.md nennt die Spalten beim Export.

Der API-Abruf (Name aus dem Charge) steht im Entwurf #1237; Zahlung und Gebühr in einer Zeile und das gemeinsame Zuordnen folgen in zwei weiteren Pull Requests zu #1417.

Geprüft: bun run lint, bun run typecheck, bun run test packages/import (psp-Tests grün). Nicht grün sind 4 Tests in packages/import/src/fints/sitzung.test.ts; sie schlagen auch auf unverändertem main fehl. Nicht gelaufen: Build, E2E, Tests außerhalb von packages/import.

🤖 Generated with Claude Code

@JB1985

JB1985 commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor Author

Selbstprüfung

Stand: 81f1627. Geprüft von einem frischen Agenten ohne den Verlauf der Entstehung, nach Skill beitrag-pruefen; die Befunde sind eingearbeitet.

Wollen wir das? Ja. Der Hinweis zu fehlenden Spalten im CSV-Import ist so in #1417 mit dem Maintainer abgestimmt (Zuordnung dort: eigener Pull Request mit Refs), das Issue ist JB1985 zugewiesen. Keine neue Einstellung, Abhängigkeit oder Migration. Ein anderer Pull Request zum Thema besteht nicht; der API-Teil bleibt in #1237.

Nach den Quellen gebaut, fachlich richtig? Betrifft keine Buchung. Stripe nennt customer_name und customer_email im Balance-Bericht als wählbare Spalten, nicht voreingestellt (Stripe-Dokumentation „Balance report“); description ist voreingestellt. Der Verwendungszweck bleibt unverändert, weil er in den Dedup-Hash eingeht (packages/import/src/dedup.ts); ein Test zeigt, dass Exporte mit und ohne Kundenspalten dieselben Hashes ergeben. Dass customer_name jetzt vor customer_email kommt, ändert nur die Gegenpartei neu importierter Zeilen.

Einfachste Lösung? Eine kleine Funktion für den Hinweis und ein Zähler, kein neues Muster.

Nach unseren Regeln? Titel, Refs #1417, KI-Kennzeichnung, Doku mitgezogen; Tests für customer_name, customer_email allein, den Hinweis im Singular und im Plural und für gleiche Hashes. bun run lint, typecheck, test packages/import grün bis auf 4 FinTS-Tests, die auch auf unverändertem main fehlschlagen.

Offene Frage: Soll der Hinweis auch description nennen? Ich habe es weggelassen, weil ein neuer Zweck den Dedup-Hash ändert und schon importierte Zeiträume doppelt anlegen würde.

Erzeugt mit Claude Code.

Nachtrag, Stand e15c239: Hinweis nur noch ohne Kundenspalten im Export, Satz in der Doku präzisiert. Die Befunde der Reviews (tdd-review, doku-pruefen) stehen in den Kommentaren darunter.

@JB1985
JB1985 marked this pull request as ready for review November 18, 2026 14:04
@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):

  • 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 e15c239. Dieser Kommentar ändert sich mit jedem Push.

Copy link
Copy Markdown
Owner

@JB1985 Danke für die drei PRs zu #1417 und für die Aufteilung in Schritte. Bevor wir sie prüfen, fehlen noch zwei der drei Prüfungen (Skill beitrag, Schritt 6):

  • beitrag-pruefen (Selbstprüfung): liegt vor, bis 81f16278.
  • tdd-review für den Code: fehlt noch.
  • doku-pruefen für die Markdown-Dateien: fehlt noch.

Beide bitte parallel, je in einem frischen Agenten, bis zu deinem letzten Commit laufen lassen und das Ergebnis als Kommentar posten. Dasselbe gilt für #1431 und #1432. #1432 enthält den Commit von #1431, deshalb mergen wir #1431 zuerst.


Generated by Claude Code

…is#1417)

Im Stripe-Export „Balance history“ stehen Kunde und Beschreibung nur, wenn man
die Spalten beim Erstellen des Berichts wählt. Haben nimmt jetzt den Namen aus
`customer_name`, sonst aus `customer_email`. Zahlungen ohne Kunde und ohne
Beschreibung bekommen beim Import einen Hinweis, welche Kundenspalten der Bericht
braucht. Der Verwendungszweck bleibt unverändert, denn er geht in den
Dedup-Hash ein: Ein Export mit und ohne Kundenspalten ergibt dieselben Hashes,
ein erneuter Import legt nichts doppelt an.

Refs firsttris#1417

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@JB1985
JB1985 force-pushed the stripe-csv-hinweis-1417 branch from cc939c0 to e15c239 Compare November 18, 2026 14:53
@JB1985

JB1985 commented Nov 18, 2026

Copy link
Copy Markdown
Contributor Author

Code-Review (tdd-review)

Stand: cc939c0 (frischer Agent, eigener Worktree und eigene Datenbank). 1 belegtes Finding, behoben in e15c239.

Finding: Der Hinweis erschien auch, wenn die Spalten im Export vorhanden, aber leer waren (packages/import/src/psp.ts, Zählung unnamed++). Ein Export mit description,customer_name,customer_email und einer Gast-Zahlung (die drei Felder leer) bekam den Rat, die Kundenspalten zu wählen, die er schon hat. Roter Test: warnings war ["1 Zahlung hat weder Kunde noch Beschreibung …"] statt []. Behoben: Der Hinweis kommt nur noch, wenn der Bericht keine Kundenspalte hat; neuer Test in psp.test.ts.

Geprüft und in Ordnung: Dedup-Hash und Zweck unverändert, customer_name vor customer_email, Hinweis nur für charge und payment, alte Exporte unverändert, Fremdwährung.

Nicht belegt: kein weiterer Verdacht ohne roten Test.

@JB1985

JB1985 commented Nov 18, 2026

Copy link
Copy Markdown
Contributor Author

Doku-Prüfung (doku-pruefen)

Stand: cc939c0 (frischer Agent). Keine Befunde. Der früher beanstandete Satz („sonst haben Zahlungen keinen Namen“) war zu eng und lautet jetzt „ohne Beschreibung“; das stimmt mit psp.ts überein (Name aus Kunde, sonst Beschreibung; Hinweis nur für charge/payment ohne beides). Keine zweite Stelle mit derselben Regel, keine Doppelung, kein Skill oder CLAUDE.md berührt. Nicht geprüft: die Stripe-Oberfläche selbst und zensical build --strict.

Copy link
Copy Markdown
Owner

@JB1985 Danke, sauber geschnitten und gut begründet. Der Verwendungszweck bleibt unverändert, damit der Dedup-Hash gleich bleibt, und der Test mit und ohne Kundenspalten zeigt genau das. Auch dass der Hinweis bei leeren Kundenfeldern einer Gast-Zahlung nichts meldet, passt.

Nachgeprüft auf e15c2399: Die Selbstprüfung reicht mit ihrem Nachtrag bis zum Head. Deine beiden Reviews nennen noch cc939c0b, und der Fix steckt im selben Commit. Deshalb haben wir den Befund am aktuellen Stand selbst rot nachgestellt: Ohne !hatKundenspalten schlagen 2 Tests fehl. Zusätzlich haben wir einen alten Export, eine Erstattung ohne Beschreibung, eine Fremdwährung und Charge in Großschreibung ausprobiert. Alles verhält sich wie beschrieben. Die CI ist grün, kein Konflikt mit main. Wir mergen.

Für #1431, wenn du dort ohnehin docs/bank-zahlungsdienstleister.md anfasst: Der Stripe-Hinweis steht mit eigenen Semikolons mitten in der Liste der Exporte in Schritt 2, und die Liste trennt selbst mit Semikolons („…keinen Namen; Haben warnt dann beim Import; Shopify Payments: …“). Als eigener Satz nach der Klammer liest er sich leichter.

Offen für #1417, nicht für diesen PR: Der Vorschlag im Issue nennt außerdem invoice_id/order_id im Verwendungszweck und den Zweck als Buchungstext bei leerer Gegenpartei. Bevor #1432 Umgesetzt #1417 setzt, klären wir, ob das wegfällt oder ein eigenes Issue wird.


Generated by Claude Code

@firsttris
firsttris merged commit dbfedab into firsttris:main Nov 18, 2026
26 checks passed
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