Repository navigation
Description
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):
- Ein Kreis je Belegart und Jahr, beim durchlaufenden Zähler der eine Kreis
0(schema.ts, number-counter.ts). - Platzhalter im Format nur
{JJJJ},{JJ},{MM}und{N}–{NNNNNN}(number-format.ts). - Festgeschriebene Rechnungen und Angebote tragen ihren Kreis in
number_year/number_counter, eindeutig über den Unique-Index(number_year, number_counter)(0002_rechnungen.sql, 0043_angebote.sql). Die Zähler dürfen nicht sinken (haben_counter_monotonic), das Audit nutzt das Jahr als Zeilenkennung (0058_sperren_audit.sql); die Datumsprüfung aus Rechnungen: Warnung, wenn das Rechnungsdatum vor dem der letzten festgeschriebenen Rechnung liegt #713 und die Verfahrensdokumentation (texte.ts) kennen „jährlich“ und „durchlaufend“. - Die Kundennummer am Kontakt ist schon frei wählbar, Ziffern wie Buchstaben (contacts.ts, customer-numbers.ts), aber nicht eindeutig erzwungen.
Vorschlag
Zwei Stufen, die auch einzeln Sinn ergeben:
- Platzhalter
{KUNDENNR}im Nummernformat, ersetzt durch die Kundennummer des Empfängers, wie sie am Kontakt steht:RE-{KUNDENNR}-{NNNN}→RE-10042-0001oderRE-ACME-0001. Allein verbirgt das die Gesamtzahl noch nicht, weil der Zähler gemeinsam bleibt, macht die Nummer aber sprechend. - 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 KundennummerACMEdie NummerRE-ACME-001. - Mit Zähler je Kunde bekommen die ersten Rechnungen an zwei Kunden
RE-10042-001undRE-10007-001, die zweite an den ersten KundenRE-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
- § 14 Abs. 4 Nr. 4 UStG; UStAE 14.5 Abs. 10 und 11; GoBD Rz. 40 (Lücken- und Mehrfachbelegungsanalyse)
- Monat im Rechnungsnummernformat aus Rechnungsdatum ableiten #328: die Kreis-Dimension „jährlich | durchlaufend“; Rechnungen: Warnung, wenn das Rechnungsdatum vor dem der letzten festgeschriebenen Rechnung liegt #713: Datumsprüfung je Kreis; Kontakte: Kundennummer automatisch mit eigenem Format #227: Kundennummer mit eigenem Format
- Roadmap „Bewusst nicht“: „Frei vergebene Rechnungsnummer je Entwurf“ bleibt unberührt
- sevDesk Webinar-FAQ Rechnung, sevDesk Hilfe: Nummernkreise, Billomat/aifinyo: Nummernkreise, Lexware-Forum
Metadata
Metadata
Assignees
Labels
Projects
- StatusShow more project fieldsIn Arbeit
Activity
firsttris commentedon Nov 18, 2026
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
/übernehmenhier ins Issue, dann ist es euch zugewiesen (Etwas übernehmen).herrschmidt commentedon Nov 18, 2026
/übernehmen
github-actions commentedon Nov 18, 2026
@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).herrschmidt commentedon Nov 18, 2026
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.{KUNDENNR}im Format stehen (Prüfung innumberFormatError).Zählertabellen (
invoice_number_counters,quote_number_counters, heute PKyear)contact_id uuid NULL REFERENCES contacts(id); NULL = der gemeinsame Kreis wie heute. Bestehende Zeilen bleiben unverändert.yearwird durch einen Unique-Index(year, contact_id) NULLS NOT DISTINCTersetzt (Postgres ≥ 15; ein PK erlaubt kein NULL).takeNumberundsetNextCounternehmen ihn als Konfliktziel.haben_counter_monotonic(0003) und die Truncate-Sperre (0201) wirken je Zeile und bleiben unverändert.haben_audit(zuletzt 0189) nimmt alsrow_idid, sonstyear. Neu perCREATE OR REPLACEin der neuen Migration:year, bei gesetztemcontact_idyear || ':' || contact_id. Die Zeilen des gemeinsamen Kreises behalten ihre bisherigerow_id, die Historie läuft also durch.haben.nummernkreis.<art>.<kreis>bekommt den Kontakt angehängt.Belege (
invoices,quotes)number_contact_id uuid NULL; NULL = der gemeinsame Kreis, bestehende Belege bleiben so.(number_year, number_counter)(0002/0043) wird zu(number_year, number_contact_id, number_counter) NULLS NOT DISTINCT.haben_reject_lockedvergleicht bei invoices die ganze Zeile, bei quoteshaben_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_columnszum Zeitpunkt des Siegels), alte Siegel bleiben gültig.Vergabe
contact_id, nicht der Text der Kundennummer: eine Umbenennung unterbricht den Kreis nicht). Storno und Korrektur nehmennumber_contact_idund das Jahr des Originals.contacts.kundennummerwürde bestehende Daten brechen, deshalb prüft das die Vergabe mit einer klaren Meldung, nur bei Zähler je Kunde.texte.ts) nennt die dritte Wahl.Offen für dich: Ist dir Spalte +
NULLS NOT DISTINCTlieber, 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
firsttris commentedon Nov 18, 2026
@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:
contact_id, die Nummer aber an{KUNDENNR}. Ändert sich die Kundennummer nachRE-ACME-003, heißt die nächsteRE-ACMEX-004: Der Kreis ist nicht mehr an der Nummer ablesbar (UStAE 14.5 Abs. 11). Übernimmt danach ein anderer KontaktACME, beginnt sein Kreis bei 001 und stößt aufinvoices_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.contact_id(Zähler und Belege)ON DELETE RESTRICTausdrü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 überhashtext, Postgres ≥ 15. Weil Zähler, Sperren und Audit berührt sind, kommt der PR vor dem Merge noch einmal zu mir.Rechnungen: Kundennummer-Prüfung und Vorschau in eigene Funktionen (f…
Rechnungen: finalizeDraft wächst nicht mehr (firsttris#1426)