Skip to content

Rechnungen: Platzhalter {KUNDENNR} im Nummernformat (#1426) - #1443

Open
herrschmidt wants to merge 2 commits into
firsttris:mainfrom
herrschmidt:nummernformat-kundennummer
Open

herrschmidt wants to merge 2 commits into
firsttris:mainfrom
herrschmidt:nummernformat-kundennummer

Conversation

@herrschmidt

Copy link
Copy Markdown
Contributor

Rechnungen und Angebote können im Nummernformat den Platzhalter {KUNDENNR} verwenden, etwa RE-{KUNDENNR}-{NNN} → RE-ACME-001. Die Kundennummer kommt aus dem festgeschriebenen Käufer-Snapshot, deshalb tragen Storno und Rechnungskorrektur die Kundennummer der ursprünglichen Rechnung, auch wenn sich die des Kontakts später ändert. Der laufende Zähler bleibt für alle Kunden gemeinsam.

Refs #1426

Änderungen

  • packages/core/src/number-format.ts: formatDocumentNumber nimmt eine optionale Kundennummer; numberFormatError kennt allowCustomer für Rechnungs- und Angebotsformate — {KUNDENNR} höchstens einmal und nie direkt neben dem Zähler, beides variabel breit. Neu: usesCustomerNumber und customerNumberProblem (fehlende oder ungültige Kundennummer, erlaubt sind A–Z, a–z, 0–9, Punkt, Unterstrich, Bindestrich).
  • Nummernvergabe (number-counter.ts): prüft die Kundennummer vor dem Formatieren und vor jedem Zählerstand-Eintrag; ein Problem wirft einen UserError und lässt den Zähler unverändert.
  • Festschreiben von Rechnung und Angebot: der Käufer-Snapshot steht jetzt vor der Nummer, documentNumber bekommt buyer.kundennummer; finalizeIssues/quoteIssues melden eine fehlende Kundennummer schon vorher. Storno und Korrektur nehmen corrects.buyer — dafür lädt getInvoice das Feld buyer des Originals mit.
  • NumberFormatCard: Vorschau und Validierung mit einer Beispiel-Kundennummer aus dem Kundennummernformat (K-0001), Hilfetext erklärt {KUNDENNR} und die Regel zum Abstand zum Zähler. Das Kundennummernformat selbst lehnt {KUNDENNR} weiter ab.
  • InvoiceEditor: die Nummernvorschau nutzt die Kundennummer des gewählten Kontakts, bei Storno/Korrektur die des Originals; fehlt sie bei einem Format mit {KUNDENNR}, steht statt einer falschen Vorschau der Hinweis.
  • Doku: docs/einrichtung.md beschreibt {KUNDENNR} in der Platzhaltertabelle und weist beim Kundennummernformat darauf hin, dass es den Platzhalter dort nicht gibt.

Bewusst nicht dabei

  • Prüfung auf doppelte Kundennummern: kommt mit PR 2. Hier bleibt der Zähler für alle Kunden gemeinsam, die Eindeutigkeit der Belegnummer trägt wie bisher der Zähler — zwei Kunden mit derselben Kundennummer erzeugen trotzdem eindeutige Nummern. Erst wenn PR 2 einen Zähler je Kunde einführt, muss die Kundennummer eindeutig sein; die Migration dafür ist dort Thema.
  • Keine Migration, kein eigener Nummernkreis je Kunde, keine E2E-Tests (nicht trivial, Deckung über Postgres-Tests beim Festschreiben).

Geprüft

  • bun run lint: grün (74 bestehende Infos zu Funktionslängen, keine neuen)
  • bun run typecheck: grün
  • bun run test mit Testdatenbank (--maxWorkers=8): 12.106 grün, 210 übersprungen, 18 rot — alle in unveränderten Modulen und umgebungsbedingt: 8× deploy/backup/backup-status.test.ts (braucht psql auf dem Rechner, fehlt), 7× FinTS (packages/import/src/fints/sitzung.test.ts, bank/fints.test.ts: MT940/lib-fints-Version und Datumserwartungen, deterministisch), dazu drei Last-Timeouts, die in einem gezielten Lauf mit wenigen Workern grün liefen (attachments.test.ts, external-import-review-2.test.ts, versteuerungswechsel.test.ts). Die Tests dieses Beitrags — nummernformat.test.ts (8 Tests) und number-format.test.ts (20 Tests) — sind grün.
  • bun run build: grün
  • zensical build --strict: grün
  • bun scripts/pr-regeln/pruefen.ts: grün; Hinweise nur zu ohnehin schon zu langen Dateien und Funktionen (u. a. wächst finalizeDraft um wenige Zeilen)
  • Postgres-Tests (nummernformat.test.ts, 8 Tests): Festschreiben mit RE-{KUNDENNR}-{NNN} → RE-ACME-001, fehlende Kundennummer hält das Festschreiben auf und lässt den Zähler stehen, Storno trägt die Kundennummer des Originals auch nach Änderung am Kontakt, Angebot analog
  • Übersprungene Tests: keine durch diese Änderung; die Suite hat bestehende Skips (ohne ERiC usw.)
  • E2E: nicht aufgenommen, die Wege sind über die Postgres-Tests gedeckt

Screenshots

Einstellungen › Rechnungen › Nummernformat, Desktop:

hell vorher hell nachher
hell vorher hell nachher
dunkel vorher dunkel nachher
dunkel vorher dunkel nachher

🤖 Generated with Devin

Rechnungs- und Angebotsnummern können die Kundennummer des Käufers tragen,
etwa RE-{KUNDENNR}-{NNN}. Sie kommt aus dem festgeschriebenen
Käufer-Snapshot: Storno und Rechnungskorrektur behalten die Kundennummer
der ursprünglichen Rechnung. Der Zähler bleibt für alle Kunden gemeinsam;
die Prüfung auf doppelte Kundennummern und ein Zähler je Kunde kommen mit
einem Folge-Pull-Request.

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@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 88485b4. Dieser Kommentar ändert sich mit jedem Push.

…irsttris#1426)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>

Copy link
Copy Markdown
Owner

@herrschmidt Danke für den PR zu #1426 und die ausführliche Beschreibung. Bevor wir prüfen, fehlen noch die drei Prüfungen, je durch einen frischen Agenten ohne den Verlauf des Beitrags und bis zu deinem letzten Commit, als Kommentar im PR (Skill beitrag, Schritt 6):

  • beitrag-pruefen (Selbstprüfung): fehlt.
  • tdd-review für den Code: fehlt.
  • doku-pruefen für docs/einrichtung.md: fehlt; parallel zu tdd-review.

Weil der PR das Festschreiben und die Nummernvergabe berührt (GoBD, lückenlose Nummern), schauen wir danach selbst genau hin. Achte bei der Selbstprüfung bitte auch darauf, dass finalizeDraft nicht weiter wächst (Konventionen). Der PR-Regeln-Hinweis nennt das schon.


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