Gutschrift: betragsloser Sachwert bekommt keine Gutschriftsnummer

Ein betragsloser Sachwert ist eher ein Lieferschein als eine Gutschrift
-> er soll KEINE Gutschriftsnummer aus dem Nummernkreis verbrauchen.

- Schema: CreditNote.number nullbar (Migration MODIFY ... NULL, UNIQUE
  bleibt - MySQL erlaubt mehrere NULLs).
- createCreditNote: betragsloser Sachwert -> number=null, assignNextNumber
  wird NICHT aufgerufen (Zaehler unangetastet).
- updateCreditNote: Uebergaenge - wird betragslos -> Nummer entfernen;
  bekommt nachtraeglich Betrag & hatte keine -> jetzt Nummer vergeben.
- PDF/Liste/Modal/Audit: Fallback 'Sachwert-Uebergabe'/'Beleg #id' wenn
  keine Nummer; PDF-Titel 'Sachwert-Uebergabe', kein ZUGFeRD (schon vorher).

Verifiziert: Sachwert 0 -> number null + Zaehler bleibt; Geld -> Nummer
+ Zaehler +1; Sachwert nachtraeglich mit Betrag -> Nummer vergeben.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

backend/src/services/creditNote.service.ts

@@ -44,6 +44,12 @@ export function computeAmounts(params: {
   return { amountNet: net, amountVat: round2(gross - net), amountGross: gross };
 }
 
+// Betragsloser Sachwert = reine Übergabe/Lieferschein (keine Rechnung,
+// keine USt, keine Gutschriftsnummer, kein ZUGFeRD).
+function isNonMonetary(n: { type: CreditNoteType; amountGross: number }): boolean {
+  return n.type === 'SACHWERT' && n.amountGross === 0;
+}
+
 const ALLOWED_TYPES = new Set(['GELD', 'SACHWERT']);
 const ALLOWED_CUSTOMER_TYPES = new Set(['PRIVAT', 'FIRMA']);
 const ALLOWED_BASIS = new Set(['NETTO', 'BRUTTO']);
@@ -217,7 +223,9 @@ export async function createCreditNote(
   if (normalized.payoutBankCardId) {
     await assertBankCardBelongsToContract(contractId, normalized.payoutBankCardId);
   }
-  const number = await assignNextNumber();
+  // Betragsloser Sachwert = Lieferschein → KEINE Gutschriftsnummer vergeben
+  // (Nummernkreis-Zähler bleibt unangetastet). Sonst nächste Nummer ziehen.
+  const number = isNonMonetary(normalized) ? null : await assignNextNumber();
 
   return prisma.creditNote.create({
     data: {
@@ -238,11 +246,22 @@ export async function updateCreditNote(id: number, input: CreateCreditNoteInput)
   if (normalized.payoutBankCardId) {
     await assertBankCardBelongsToContract(existing.contractId, normalized.payoutBankCardId);
   }
-  // Nummer bleibt unverändert (einmal vergeben = fix). Ein evtl. schon
-  // erzeugtes PDF ist nach inhaltlicher Änderung veraltet → Pfad leeren
-  // (der User erzeugt es bei Bedarf neu). Reihenfolge (R140): erst DB-Update,
-  // DANN die alte Datei löschen – schlägt das Update fehl, bleibt die Datei.
-  const updated = await prisma.creditNote.update({ where: { id }, data: { ...normalized, pdfPath: null } });
+
+  // Nummer an den (neuen) monetären Status anpassen:
+  //  - wird betragsloser Sachwert (Lieferschein) → Nummer entfernen,
+  //  - wird eine echte Gutschrift und hatte noch keine Nummer → jetzt vergeben,
+  //  - sonst bestehende Nummer beibehalten (einmal vergeben = fix).
+  let number = existing.number;
+  if (isNonMonetary(normalized)) {
+    number = null;
+  } else if (number === null) {
+    number = await assignNextNumber();
+  }
+
+  // Ein evtl. schon erzeugtes PDF ist nach inhaltlicher Änderung veraltet →
+  // Pfad leeren. Reihenfolge (R140): erst DB-Update, DANN die alte Datei
+  // löschen – schlägt das Update fehl, bleibt die Datei.
+  const updated = await prisma.creditNote.update({ where: { id }, data: { ...normalized, number, pdfPath: null } });
   deleteUploadByRelativePath(existing.pdfPath);
   return updated;
 }

backend/src/services/creditNotePdf.service.ts

@@ -94,7 +94,8 @@ export async function generateCreditNotePdf(creditNoteId: number): Promise<{ buf
   doc.fontSize(18).text(nonMonetary ? 'Sachwert-Übergabe' : 'Gutschrift', { align: 'left' });
   doc.moveDown(0.3);
   doc.fontSize(10);
-  doc.text(`Nr.: ${cn.number}`);
+  // Betragslose Sachwert-Übergabe hat keine Gutschriftsnummer → interne Ref.
+  doc.text(`Nr.: ${cn.number ?? `Beleg #${cn.id}`}`);
   doc.text(`Datum: ${ddmmyyyy(new Date(cn.creditDate))}`);
 
   // ---- Beschreibung / Betrag ----
@@ -201,7 +202,7 @@ export async function generateCreditNotePdf(creditNoteId: number): Promise<{ buf
   if (!nonMonetary) {
     // ---- ZUGFeRD-XML erzeugen + als hybrides PDF/A-3 einbetten ----
     xml = buildZugferdXml({
-      number: cn.number,
+      number: cn.number ?? '',
       issueDate: new Date(cn.creditDate),
       currency: cn.currency,
       seller: {
@@ -234,7 +235,7 @@ export async function generateCreditNotePdf(creditNoteId: number): Promise<{ buf
     });
 
     buffer = await embedZugferd(baseBuffer, xml, {
-      title: `Gutschrift ${cn.number}`,
+      title: `Gutschrift ${cn.number ?? ''}`.trim(),
       date: new Date(cn.creditDate),
     });
   }
@@ -242,7 +243,7 @@ export async function generateCreditNotePdf(creditNoteId: number): Promise<{ buf
   // ---- Speichern ----
   const dir = path.join(process.cwd(), 'uploads', 'credit-notes');
   if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
-  const filename = `gutschrift-${cn.number.replace(/[^A-Za-z0-9_-]/g, '_')}-${cn.id}.pdf`;
+  const filename = `gutschrift-${(cn.number ?? 'sachwert').replace(/[^A-Za-z0-9_-]/g, '_')}-${cn.id}.pdf`;
   const filepath = path.join(dir, filename);
   fs.writeFileSync(filepath, buffer);
   const pdfPath = `/uploads/credit-notes/${filename}`;