Skip to content

Rechnungen: eigener Nummernkreis je Kunde und Kundennummer als Platzhalter im Nummernformat #1426

Open

Description

@herrschmidt

Anlass

Wer seine Rechnungen je Kunde nummeriert, kann dieses Schema nach Haben nicht mitnehmen. Üblich ist eine Kundenkennung plus eigene laufende Nummer: RE-10042-001, RE-10042-002 beim einen Kunden, RE-ACME-001 beim anderen.

Der Grund ist meist derselbe: Wer wenige große Auftraggeber hat – typisch für Berater, Agenturen und Kreative –, will dem Kunden nicht offenlegen, wie viele Rechnungen insgesamt laufen. Im Lexware-Forum beschreibt eine Nutzerin ihr Schema aus Kundenkürzel und laufender Nummer so: „Ich mag es einfach überhaupt nicht, wenn irgendwie ersichtlich ist, die wievielte Rechnung das in diesem Jahr oder Monat ist.“ sevDesk beantwortet die Frage „Kann auch pro Kunde ein eigener Rechnungsnummernkreis vergeben werden?“ in seiner Webinar-FAQ mit „Nein, wir bieten nur einen Rechnungsnummernkreis in sevDesk an.“ Billomat erlaubt im Präfix Platzhalter „für Datum oder Kunde“, und der Zähler hängt dort vom Präfix ab, läuft also je Kunde.

Nebenbei erkennt man den Kunden schon am Dateinamen der PDF.

Zulässig ist das ausdrücklich: Mehrere separate Nummernkreise sind erlaubt, auch für organisatorisch abgegrenzte Bereiche, solange jede Rechnung eindeutig ihrem Kreis zugeordnet werden kann und die Nummer einmalig ist (UStAE 14.5 Abs. 10 und 11).

Stand in Haben

Geprüft auf main (d1ebcb89):

Vorschlag

Zwei Stufen, die auch einzeln Sinn ergeben:

  1. Platzhalter {KUNDENNR} im Nummernformat, ersetzt durch die Kundennummer des Empfängers, wie sie am Kontakt steht: RE-{KUNDENNR}-{NNNN} → RE-10042-0001 oder RE-ACME-0001. Allein verbirgt das die Gesamtzahl noch nicht, weil der Zähler gemeinsam bleibt, macht die Nummer aber sprechend.
  2. Zähler je Kunde als dritte Wahl neben „beginnt jedes Jahr neu“ und „läuft weiter“. Der Kreis ist dann der Kunde, beim jährlichen Neubeginn Kunde und Jahr. Die Vergabe bleibt automatisch und lückenlos je Kreis.

Regeln:

  • Beim Zähler je Kunde ist {KUNDENNR} im Format Pflicht. Das Jahr allein trennt die Kunden nicht, und so ordnet die Nummer selbst jede Rechnung ihrem Kreis zu (UStAE 14.5 Abs. 11).
  • Beim Festschreiben braucht der Kontakt eine Kundennummer aus A–Z, 0–9, ., -, _, die kein anderer Kontakt trägt; sonst eine verständliche Meldung statt einer Unique-Verletzung.
  • Storno und Korrektur bleiben im Kreis des Originals, „Nächste Nummer festlegen“ wirkt je Kunde, Angebote analog.

Festschreibung und GoBD

Die Garantien von heute sollen je Kreis genauso gelten:

  • Der Kreis steht am festgeschriebenen Beleg selbst und ist mit ihm versiegelt; die Eindeutigkeit sichert weiter ein Unique-Index, der den Kreis einschließt. Bestehende Belege bleiben im gemeinsamen Kreis, die Migration ändert an ihnen nichts.
  • Zähler können weiterhin weder sinken noch gelöscht werden; Trigger und Audit-Zeilenkennung gehen auf den Schlüssel aus Kunde und Jahr über.
  • Die Verfahrensdokumentation nennt die Einstellung, und die Lückenprüfung bleibt möglich: je Kreis lückenlos, der Kreis an der Nummer ablesbar.

Grenzen: keine frei vergebene Nummer am Entwurf, keine Umbenennung bestehender Belege; die Einstellung gilt ab Aktivierung, wie heute das Format.

Akzeptanzkriterien

  • RE-{KUNDENNR}-{NNN} ergibt mit Kundennummer ACME die Nummer RE-ACME-001.
  • Mit Zähler je Kunde bekommen die ersten Rechnungen an zwei Kunden RE-10042-001 und RE-10007-001, die zweite an den ersten Kunden RE-10042-002.
  • Mit Zähler je Kunde lehnt die Einstellung ein Format ohne {KUNDENNR} ab.
  • Fehlende, doppelte oder ungültige Kundennummer: verständliche Meldung beim Festschreiben.
  • Storno und Korrektur ziehen ihre Nummer aus dem Kreis des Originals.
  • Ohne die Einstellung bleibt alles wie heute; bestehende Belege und Zähler bleiben unverändert.

Wenn das aufs Board passt, setzen wir es gern um, Stufe 1 auch vorab.

Bezug

Activity

  1. moved this from Später to Geplant in Roadmapon Nov 18, 2026
  2. firsttris commented on Nov 18, 2026

    @firsttris
    Owner

    Danke! Ist jetzt im Board unter „Geplant“, Bereich Rechnungen, bei den Wünschen zu Rechnungstexten und Nummern. Die Reihenfolge in der Spalte ist die Priorität.

    Der Vorschlag passt so, auch die Trennung in zwei Stufen: Stufe 1 ({KUNDENNR} im Format) kann als eigener Pull Request vorab kommen. Stufe 2 berührt Zähler, Sperrtrigger und Audit; dort bitte vorher kurz die Migration skizzieren.

    Ihr wollt es umsetzen: Schreib dafür /übernehmen hier ins Issue, dann ist es euch zugewiesen (Etwas übernehmen).

  3. herrschmidt commented on Nov 18, 2026

    @herrschmidt
    ContributorAuthor

    /übernehmen

  4. github-actions commented on Nov 18, 2026

    @github-actions
    Contributor

    @herrschmidt gehört dir! Das Issue ist dir zugewiesen, die Karte steht jetzt im Board unter „In Arbeit“.

    Ein kurzer Plan hier im Issue oder ein früher Entwurf als Pull Request hilft, wenn du unsicher bist, ob der Weg passt. Kommt 14 Tage nichts, fragen wir nach; aufhören geht jederzeit mit /freigeben (Etwas übernehmen).

  5. moved this from Geplant to In Arbeit in Roadmapon Nov 18, 2026
  6. herrschmidt commented on Nov 18, 2026

    @herrschmidt
    ContributorAuthor

    Stufe 1 liegt als #1443 ({KUNDENNR} im Format, Zähler bleibt gemeinsam, keine Migration).

    Skizze der Migration für Stufe 2 (Zähler je Kunde), Stand main @ 596e23ba:

    Einstellung

    • company.invoice_counter_per_customer / quote_counter_per_customer boolean NOT NULL DEFAULT false, neben dem vorhandenen *_counter_running (0156). Kombiniert ergibt das die Kreise „Kunde“ (durchlaufend) und „Kunde + Jahr“ (jährlich neu); kein Umbau der vorhandenen Spalten.
    • Mit Zähler je Kunde muss {KUNDENNR} im Format stehen (Prüfung in numberFormatError).

    Zählertabellen (invoice_number_counters, quote_number_counters, heute PK year)

    • Neue Spalte contact_id uuid NULL REFERENCES contacts(id); NULL = der gemeinsame Kreis wie heute. Bestehende Zeilen bleiben unverändert.
    • PK year wird durch einen Unique-Index (year, contact_id) NULLS NOT DISTINCT ersetzt (Postgres ≥ 15; ein PK erlaubt kein NULL). takeNumber und setNextCounter nehmen ihn als Konfliktziel.
    • haben_counter_monotonic (0003) und die Truncate-Sperre (0201) wirken je Zeile und bleiben unverändert.
    • Audit: haben_audit (zuletzt 0189) nimmt als row_id id, sonst year. Neu per CREATE OR REPLACE in der neuen Migration: year, bei gesetztem contact_id year || ':' || contact_id. Die Zeilen des gemeinsamen Kreises behalten ihre bisherige row_id, die Historie läuft also durch.
    • Sperre: der Advisory-Lock-Schlüssel haben.nummernkreis.<art>.<kreis> bekommt den Kontakt angehängt.

    Belege (invoices, quotes)

    • Neue Spalte number_contact_id uuid NULL; NULL = der gemeinsame Kreis, bestehende Belege bleiben so.
    • Unique (number_year, number_counter) (0002/0043) wird zu (number_year, number_contact_id, number_counter) NULLS NOT DISTINCT.
    • Versiegelung: haben_reject_locked vergleicht bei invoices die ganze Zeile, bei quotes haben_reject_locked_quote (0044) alles außer der Ausnahmeliste. Die neue Spalte ist damit an beiden Tabellen ohne Änderung gesperrt. Die Hash-Kette nimmt sie nur in neue Siegel auf (haben_columns zum Zeitpunkt des Siegels), alte Siegel bleiben gültig.

    Vergabe

    • Kreis = Kontakt des Belegs (contact_id, nicht der Text der Kundennummer: eine Umbenennung unterbricht den Kreis nicht). Storno und Korrektur nehmen number_contact_id und das Jahr des Originals.
    • Beim Festschreiben braucht der Kontakt eine Kundennummer, die kein anderer Kontakt trägt. Ein Unique-Index auf contacts.kundennummer würde bestehende Daten brechen, deshalb prüft das die Vergabe mit einer klaren Meldung, nur bei Zähler je Kunde.
    • „Nächste Nummer festlegen“ wirkt je Kunde. Die Datumsprüfung (Rechnungen: Warnung, wenn das Rechnungsdatum vor dem der letzten festgeschriebenen Rechnung liegt #713) läuft je Kreis, die Verfahrensdokumentation (texte.ts) nennt die dritte Wahl.

    Offen für dich: Ist dir Spalte + NULLS NOT DISTINCT lieber, oder eine eigene Zählertabelle für Kundenkreise (dann blieben PK und Audit der bestehenden Tabellen unberührt, die Vergabe hätte aber zwei Wege)?

    🤖 Generated with Devin

  7. firsttris commented on Nov 18, 2026

    @firsttris
    Owner

    @herrschmidt danke, die Skizze passt so. Zur offenen Frage: Spalte mit NULLS NOT DISTINCT, keine eigene Zählertabelle. So bleibt die Vergabe ein Weg, und Monotonie-Trigger, Truncate-Sperre und Audit gelten für die Kundenkreise ohne neuen Code.

    Zwei Ergänzungen:

    1. Kundennummer sperren, sobald ein Kreis sie trägt. Der Kreis hängt an contact_id, die Nummer aber an {KUNDENNR}. Ändert sich die Kundennummer nach RE-ACME-003, heißt die nächste RE-ACMEX-004: Der Kreis ist nicht mehr an der Nummer ablesbar (UStAE 14.5 Abs. 11). Übernimmt danach ein anderer Kontakt ACME, beginnt sein Kreis bei 001 und stößt auf invoices_number_unique; die Vergabe rollt zurück, und dieser Kunde bekommt nie eine Rechnung. Deshalb: Hat ein Kontakt einen festgeschriebenen Beleg in einem Kundenkreis, lässt sich seine Kundennummer nicht mehr ändern, mit klarer Meldung; dazu ein Test für genau diesen Fall.
    2. Am Fremdschlüssel contact_id (Zähler und Belege) ON DELETE RESTRICT ausdrücklich setzen.

    Den Rest der Skizze nachgeprüft: Audit-row_id (0189), Siegel über die Spalten zum Zeitpunkt des Siegels (0063, neue Spalten ändern alte Siegel nicht), Advisory-Lock über hashtext, Postgres ≥ 15. Weil Zähler, Sperren und Audit berührt sind, kommt der PR vor dem Merge noch einmal zu mir.

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

Metadata

Metadata

Assignees

Labels

wunschNeue Funktion oder Verbesserung

Projects

  • Status
    In Arbeit

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions