Gutschrift: separater Lieferschein-Nummernkreis (GoBD, luecken-frei)

Pentester R142: Uebergang Geld->betragsloser Sachwert setzte die schon
vergebene Gutschriftsnummer auf null -> Luecke in der GS-Serie.

Loesung: betragsloser Sachwert = Lieferschein mit eigener
Lieferscheinnummer aus separatem Nummernkreis.

- Schema: CreditNote.deliveryNoteNumber (nullbar, unique) + neues Model
  DeliveryNoteNumberRange (Default-Praefix 'LS-') + Migration.
- deliveryNoteNumberRange.service (mirror, eigener Zaehler, FOR UPDATE).
- Nummern lazy pro Serie, NIE freigeben: Uebergaenge behalten die
  jeweils vergebene Nummer der anderen Serie reserviert -> kein
  Doppelverbrauch, keine Luecke. effectiveNumber() liefert je nach Typ
  die passende (LS/GS) fuer Anzeige/PDF/Audit.
- Endpunkte GET/PUT /credit-notes/delivery-note-number-range; Settings-
  Seite verwaltet jetzt beide Nummernkreise. PDF-Titel 'Sachwert-
  Uebergabe', Dateiname lieferschein-...
- Frontend: Typ + displayNumber in Liste/Modal.

Verifiziert: Sachwert 0 -> LS-Nr, GS-Zaehler unberuehrt; Geld -> GS-Nr;
Uebergaenge behalten beide Nummern (kein Neuverbrauch, keine Luecke).

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

frontend/src/components/contracts/CreditNotesSection.tsx

@@ -35,6 +35,13 @@ function calcAmounts(amount: number, vatRelevant: boolean, basis: CreditNoteAmou
 
 const todayIso = () => new Date().toISOString().split('T')[0];
 
+// Betragsloser Sachwert = Lieferschein → zeigt die Lieferscheinnummer,
+// sonst die Gutschriftsnummer.
+function displayNumber(cn: CreditNote): string {
+  const nonMonetary = cn.type === 'SACHWERT' && cn.amountGross === 0;
+  return (nonMonetary ? cn.deliveryNoteNumber : cn.number) ?? `#${cn.id}`;
+}
+
 interface FormDefaults {
   customerType: CreditNoteCustomerType;
   vatRelevant: boolean;
@@ -158,7 +165,7 @@ function CreditNoteFormModal({
     : amountNum > 0; // Geld: Betrag > 0 Pflicht
 
   return (
-    <Modal isOpen onClose={onClose} title={editing ? `Gutschrift ${editing.number ?? 'Sachwert-Übergabe'} bearbeiten` : 'Gutschrift anlegen'} size="lg">
+    <Modal isOpen onClose={onClose} title={editing ? `Beleg ${displayNumber(editing)} bearbeiten` : 'Gutschrift anlegen'} size="lg">
       <div className="space-y-4">
         <div className="grid grid-cols-1 md:grid-cols-2 gap-4">
           <Select
@@ -448,7 +455,7 @@ export default function CreditNotesSection({ contractId, canEdit }: { contractId
               </div>
               <div className="flex-1 min-w-0">
                 <div className="flex flex-wrap items-center gap-2">
-                  <span className="font-mono text-sm font-medium">{cn.number ?? 'Sachwert-Übergabe'}</span>
+                  <span className="font-mono text-sm font-medium">{displayNumber(cn)}</span>
                   <Badge variant={cn.type === 'GELD' ? 'info' : 'default'}>
                     {cn.type === 'GELD' ? 'Geld' : 'Sachwert'}
                   </Badge>
@@ -511,7 +518,7 @@ export default function CreditNotesSection({ contractId, canEdit }: { contractId
                     <Edit className="w-4 h-4" />
                   </button>
                   <button
-                    onClick={() => { if (confirm(`Gutschrift ${cn.number ?? 'Sachwert-Übergabe'} wirklich löschen?`)) deleteMutation.mutate(cn.id); }}
+                    onClick={() => { if (confirm(`Beleg ${displayNumber(cn)} wirklich löschen?`)) deleteMutation.mutate(cn.id); }}
                     className="text-gray-400 hover:text-red-600 p-1"
                     title="Löschen"
                   >

frontend/src/pages/Settings.tsx

@@ -52,8 +52,8 @@ export default function Settings() {
     {
       to: '/settings/credit-note-number-range',
       icon: Hash,
-      title: 'Gutschrift-Nummernkreis',
-      description: 'Präfix, Jahr und Zähler für die fortlaufende Nummerierung von Gutschriften.',
+      title: 'Nummernkreise (Gutschrift/Lieferschein)',
+      description: 'Präfix, Jahr und Zähler für Gutschriften und Lieferscheine (betragslose Sachwerte).',
       show: hasPermission('settings:read'),
     },
     {

frontend/src/pages/settings/CreditNoteNumberRange.tsx

@@ -6,20 +6,25 @@ import toast from 'react-hot-toast';
 import Button from '../../components/ui/Button';
 import Input from '../../components/ui/Input';
 import { creditNoteApi } from '../../services/api';
+import type { CreditNoteNumberRange } from '../../types';
 import { useAuth } from '../../context/AuthContext';
 
-export default function CreditNoteNumberRange() {
-  const { hasPermission } = useAuth();
-  const canEdit = hasPermission('settings:update');
-  const queryClient = useQueryClient();
+interface RangeEditorProps {
+  title: string;
+  description: string;
+  queryKey: string;
+  load: () => Promise<{ data?: CreditNoteNumberRange }>;
+  save: (payload: Partial<CreditNoteNumberRange>) => Promise<unknown>;
+  defaultPrefix: string;
+  canEdit: boolean;
+}
 
-  const { data, isLoading } = useQuery({
-    queryKey: ['credit-note-number-range'],
-    queryFn: () => creditNoteApi.getNumberRange(),
-  });
+function RangeEditor({ title, description, queryKey, load, save, defaultPrefix, canEdit }: RangeEditorProps) {
+  const queryClient = useQueryClient();
+  const { data, isLoading } = useQuery({ queryKey: [queryKey], queryFn: load });
   const range = data?.data;
 
-  const [prefix, setPrefix] = useState('GS-');
+  const [prefix, setPrefix] = useState(defaultPrefix);
   const [includeYear, setIncludeYear] = useState(true);
   const [separator, setSeparator] = useState('-');
   const [padding, setPadding] = useState(4);
@@ -38,23 +43,84 @@ export default function CreditNoteNumberRange() {
   }, [range]);
 
   const saveMutation = useMutation({
-    mutationFn: () => creditNoteApi.updateNumberRange({ prefix, includeYear, separator, padding, nextNumber, resetYearly }),
+    mutationFn: () => save({ prefix, includeYear, separator, padding, nextNumber, resetYearly }),
     onSuccess: () => {
       toast.success('Nummernkreis gespeichert');
-      queryClient.invalidateQueries({ queryKey: ['credit-note-number-range'] });
+      queryClient.invalidateQueries({ queryKey: [queryKey] });
     },
     onError: (err: Error) => toast.error(err.message || 'Speichern fehlgeschlagen'),
   });
 
-  // Live-Vorschau der nächsten Nummer aus den aktuellen Eingaben.
   const year = new Date().getFullYear();
-  const previewValue =
-    resetYearly && range && range.currentYear !== year ? 1 : nextNumber;
+  const previewValue = resetYearly && range && range.currentYear !== year ? 1 : nextNumber;
   const preview = `${prefix}${includeYear ? `${year}${separator}` : ''}${String(previewValue).padStart(padding, '0')}`;
 
-  if (isLoading) {
-    return <div className="p-6 text-gray-500">Laden …</div>;
-  }
+  return (
+    <div className="bg-white rounded-lg shadow p-6 space-y-4">
+      <div>
+        <h2 className="font-semibold text-gray-800">{title}</h2>
+        <p className="text-sm text-gray-500">{description}</p>
+      </div>
+
+      {isLoading ? (
+        <div className="text-gray-500 text-sm">Laden …</div>
+      ) : (
+        <>
+          <div className="grid grid-cols-1 md:grid-cols-2 gap-4">
+            <Input label="Präfix" value={prefix} onChange={(e) => setPrefix(e.target.value)} disabled={!canEdit} placeholder={defaultPrefix} />
+            <Input label="Trennzeichen (vor der Nummer)" value={separator} onChange={(e) => setSeparator(e.target.value)} disabled={!canEdit} placeholder="-" />
+          </div>
+
+          <div className="grid grid-cols-1 md:grid-cols-2 gap-4">
+            <Input
+              label="Stellen (Nullen auffüllen)"
+              type="number"
+              min={1}
+              max={10}
+              value={padding}
+              onChange={(e) => setPadding(Math.min(Math.max(parseInt(e.target.value) || 1, 1), 10))}
+              disabled={!canEdit}
+            />
+            <Input
+              label="Nächste Nummer"
+              type="number"
+              min={1}
+              value={nextNumber}
+              onChange={(e) => setNextNumber(Math.max(parseInt(e.target.value) || 1, 1))}
+              disabled={!canEdit}
+            />
+          </div>
+
+          <label className="flex items-center gap-2 text-sm">
+            <input type="checkbox" checked={includeYear} onChange={(e) => setIncludeYear(e.target.checked)} disabled={!canEdit} className="h-4 w-4 rounded border-gray-300 text-blue-600 focus:ring-blue-500" />
+            Jahr in die Nummer aufnehmen (z.B. {prefix}{year}{separator}0001)
+          </label>
+
+          <label className="flex items-center gap-2 text-sm">
+            <input type="checkbox" checked={resetYearly} onChange={(e) => setResetYearly(e.target.checked)} disabled={!canEdit} className="h-4 w-4 rounded border-gray-300 text-blue-600 focus:ring-blue-500" />
+            Zähler zum Jahreswechsel auf 1 zurücksetzen
+          </label>
+
+          <div className="rounded-lg bg-blue-50 border border-blue-200 px-3 py-2 text-sm">
+            Nächste Nummer: <span className="font-mono font-semibold">{preview}</span>
+          </div>
+
+          {canEdit && (
+            <div className="flex justify-end">
+              <Button onClick={() => saveMutation.mutate()} disabled={saveMutation.isPending}>
+                {saveMutation.isPending ? 'Speichern …' : 'Speichern'}
+              </Button>
+            </div>
+          )}
+        </>
+      )}
+    </div>
+  );
+}
+
+export default function CreditNoteNumberRange() {
+  const { hasPermission } = useAuth();
+  const canEdit = hasPermission('settings:update');
 
   return (
     <div className="max-w-2xl">
@@ -62,57 +128,32 @@ export default function CreditNoteNumberRange() {
         <ArrowLeft className="w-4 h-4" /> Einstellungen
       </Link>
       <h1 className="text-2xl font-bold flex items-center gap-2 mb-1">
-        <Hash className="w-6 h-6 text-blue-600" /> Gutschrift-Nummernkreis
+        <Hash className="w-6 h-6 text-blue-600" /> Nummernkreise: Gutschrift & Lieferschein
       </h1>
-      <p className="text-gray-500 mb-6">Fortlaufende Nummerierung für Gutschriften.</p>
+      <p className="text-gray-500 mb-6">
+        Getrennte fortlaufende Nummerierung für echte Gutschriften und für Lieferscheine
+        (betragslose Sachwert-Übergaben).
+      </p>
 
-      <div className="bg-white rounded-lg shadow p-6 space-y-4">
-        <div className="grid grid-cols-1 md:grid-cols-2 gap-4">
-          <Input label="Präfix" value={prefix} onChange={(e) => setPrefix(e.target.value)} disabled={!canEdit} placeholder="GS-" />
-          <Input label="Trennzeichen (vor der Nummer)" value={separator} onChange={(e) => setSeparator(e.target.value)} disabled={!canEdit} placeholder="-" />
-        </div>
-
-        <div className="grid grid-cols-1 md:grid-cols-2 gap-4">
-          <Input
-            label="Stellen (Nullen auffüllen)"
-            type="number"
-            min={1}
-            max={10}
-            value={padding}
-            onChange={(e) => setPadding(Math.min(Math.max(parseInt(e.target.value) || 1, 1), 10))}
-            disabled={!canEdit}
-          />
-          <Input
-            label="Nächste Nummer"
-            type="number"
-            min={1}
-            value={nextNumber}
-            onChange={(e) => setNextNumber(Math.max(parseInt(e.target.value) || 1, 1))}
-            disabled={!canEdit}
-          />
-        </div>
-
-        <label className="flex items-center gap-2 text-sm">
-          <input type="checkbox" checked={includeYear} onChange={(e) => setIncludeYear(e.target.checked)} disabled={!canEdit} className="h-4 w-4 rounded border-gray-300 text-blue-600 focus:ring-blue-500" />
-          Jahr in die Nummer aufnehmen (z.B. {prefix}{year}{separator}0001)
-        </label>
-
-        <label className="flex items-center gap-2 text-sm">
-          <input type="checkbox" checked={resetYearly} onChange={(e) => setResetYearly(e.target.checked)} disabled={!canEdit} className="h-4 w-4 rounded border-gray-300 text-blue-600 focus:ring-blue-500" />
-          Zähler zum Jahreswechsel auf 1 zurücksetzen
-        </label>
-
-        <div className="rounded-lg bg-blue-50 border border-blue-200 px-3 py-2 text-sm">
-          Nächste Nummer: <span className="font-mono font-semibold">{preview}</span>
-        </div>
-
-        {canEdit && (
-          <div className="flex justify-end">
-            <Button onClick={() => saveMutation.mutate()} disabled={saveMutation.isPending}>
-              {saveMutation.isPending ? 'Speichern …' : 'Speichern'}
-            </Button>
-          </div>
-        )}
+      <div className="space-y-6">
+        <RangeEditor
+          title="Gutschrift-Nummernkreis"
+          description="Für Geld-Gutschriften und Sachwerte mit Betrag."
+          queryKey="credit-note-number-range"
+          load={() => creditNoteApi.getNumberRange()}
+          save={(p) => creditNoteApi.updateNumberRange(p)}
+          defaultPrefix="GS-"
+          canEdit={canEdit}
+        />
+        <RangeEditor
+          title="Lieferschein-Nummernkreis"
+          description="Für betragslose Sachwert-Übergaben (keine Rechnung/Gutschrift)."
+          queryKey="delivery-note-number-range"
+          load={() => creditNoteApi.getDeliveryNoteNumberRange()}
+          save={(p) => creditNoteApi.updateDeliveryNoteNumberRange(p)}
+          defaultPrefix="LS-"
+          canEdit={canEdit}
+        />
       </div>
     </div>
   );

frontend/src/services/api.ts

@@ -313,6 +313,14 @@ export const creditNoteApi = {
     const res = await api.put<ApiResponse<CreditNoteNumberRange>>(`/credit-notes/number-range`, payload);
     return res.data;
   },
+  getDeliveryNoteNumberRange: async () => {
+    const res = await api.get<ApiResponse<CreditNoteNumberRange>>(`/credit-notes/delivery-note-number-range`);
+    return res.data;
+  },
+  updateDeliveryNoteNumberRange: async (payload: Partial<CreditNoteNumberRange>) => {
+    const res = await api.put<ApiResponse<CreditNoteNumberRange>>(`/credit-notes/delivery-note-number-range`, payload);
+    return res.data;
+  },
   uploadReceipt: async (id: number, file: File) => {
     const formData = new FormData();
     formData.append('document', file);

frontend/src/types/index.ts

@@ -67,6 +67,7 @@ export interface CreditNote {
   id: number;
   contractId: number;
   number: string | null;
+  deliveryNoteNumber: string | null;
   type: CreditNoteType;
   sachwertDescription?: string | null;
   customerType: CreditNoteCustomerType;