Chargen, MHD & Seriennummern
Überblick
Für nachweispflichtige Ware genügt der Bestand nicht — es zählt, welches Stück wohin ging. Dieses Modul führt Chargen, Mindesthaltbarkeitsdaten und Seriennummern und macht daraus einen Verwendungsnachweis.
Der Ernstfall, für den es gebaut ist: Ein Lieferant meldet eine fehlerhafte Charge. Die Frage lautet dann nicht „haben wir davon noch etwas", sondern „an wen ist sie gegangen" — und die beantwortet nur der Verwendungsnachweis.
Kernaufgaben
Nachweispflicht je Artikel sehen. Nicht jeder Artikel braucht Rückverfolgung. Welche Artikel eine verlangen, steht hier; gesetzt wird die Pflicht über die Schnittstelle (siehe „Felder im Detail").
Chargenbestände sehen. Bestand je Charge, mit Haltbarkeit.
Verwendungsnachweis ziehen. Wohin eine Charge oder Seriennummer gegangen ist.
Charge sperren. Eine gesperrte Charge steht nicht mehr für Verkauf und Versand zur Verfügung. Das ist der schnellste Griff im Rückruffall — schneller, als jeden Auftrag einzeln zu suchen.
Einstand je Einheit. Beim Wareneingang übernimmt jede Serieneinheit und jede Charge den Einstandspreis der Bestellposition. Er ist die Bemessungsgrundlage der Differenzbesteuerung (§ 25a UStG): versteuert wird die Marge genau dieses Stücks, nicht ein Durchschnitt. Eine Retoure behält den Einstand des Einkaufs; ein unbekannter Einstand bleibt unbekannt und wird nie als 0 € angenommen.
Felder im Detail
Die Spalte Was es bewirkt beantwortet, was sich im System ändert. Der graue Name dahinter ist das Feld der API: unter ihm läuft dasselbe über Automation, Import und KI-Werkzeuge.
Diese Seite hat genau eine Eingabemaske: das Sperren einer Charge. Chargen und Seriennummern selbst entstehen aus Wareneingängen und lassen sich nicht von Hand anlegen — eine von Hand angelegte Charge wäre Bestand ohne Bewegung, und genau diese Lücke sucht eine Prüfung.
Charge sperren
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Grund der Sperre reason | ja | Text, höchstens 200 Zeichen | Warum die Charge aus dem Verkehr gezogen wird. Ohne Grund wird die Sperre abgewiesen: eine Sperre, die den Verkauf anhält, muss später nachvollziehbar sein. Der Grund steht danach in der Zustandsspalte der Chargenliste. |
Das Aufheben der Sperre braucht kein Feld — es ist eine eigene Handlung mit demselben Recht.
Nachweispflicht je Artikel — nur über Schnittstelle und Automation
Die Seite zeigt die Nachweispflicht je Artikel; angelegt und geändert wird sie über die Schnittstelle (POST/PATCH auf /v1/batch-serial/product-tracking). Die Umstellung ist nur möglich, solange keine Einheiten ohne Nachweis im Bestand liegen — sonst gäbe es ab dem nächsten Abgang Ware ohne Charge.
| Feld | Werte / Format | Was es bewirkt |
|---|---|---|
productId | bestehender Artikel (Pflicht beim Anlegen) | Für welchen Artikel die Pflicht gilt. |
mode | none · batch · serial | Welcher Nachweis verlangt wird: keiner, eine Charge (eine Menge) oder eine Seriennummer (genau ein Stück). |
expiryRequired | Ja/Nein | Ob zusätzlich ein Mindesthaltbarkeitsdatum verlangt wird. Setzt Chargenführung voraus — das MHD hängt an der Charge, nicht am Artikel. |
minShelfLifeDays | 0 bis 3650 Tage | Mindest-Restlaufzeit bei der Auslieferung. Ware darunter wird beim FEFO-Vorschlag nicht mehr angeboten; 0 heißt: keine Regel. |
Was die Chargenliste zeigt
| Spalte | Feld | Was sie zeigt |
|---|---|---|
| Charge | batchNumber | Die Kennung der Charge. Sie begleitet die Ware von der Annahme bis zum Kunden. |
| Artikel | productId | Wozu die Charge gehört. |
| Restmenge | remainingQty | Was von der ursprünglich vereinnahmten Menge (receivedQty) noch da ist. |
| Haltbar bis | expiresAt | Das Mindesthaltbarkeitsdatum; leer bei nicht verderblicher Ware. Die Kommissionierung nimmt die kürzeste Restlaufzeit (shelfLifeDays) zuerst — sonst verfällt Ware im Regal, während frischere hinausgeht. |
| Zustand | blocked, blockReason | Gesperrt oder frei, mit dem Grund der Sperre. Ob eine Charge heute überhaupt ausgeliefert werden darf, steht in deliverable — sie fasst Sperre, Restmenge und Restlaufzeit zusammen. |
Der Verwendungsnachweis über der Liste ist kein Formular, sondern eine Suche: eine Chargen- oder Seriennummer, beantwortet aus dem Bewegungsjournal — nicht aus dem Restbestand. Deshalb findet er auch Ware, die das Haus längst verlassen hat.
Einstellungen & Rechte
- Modul
module.batchserial. batchserial.tracking.view/.managefür die Rückverfolgung,batchserial.batch.block
für das Sperren — ein eigenes Recht, weil eine Sperre den Verkauf anhält.
- Etiketten mit Chargen-Angabe druckt das Druck-Modul.
- Ohne Nachweispflicht am Artikel entsteht keine Rückverfolgung — auch rückwirkend nicht.
FAQ & Fehlerbilder
Zu einem Artikel gibt es keine Chargen. Dann ist er nicht nachweispflichtig gesetzt. Rückwirkend lässt sich das nicht herstellen.
Eine gesperrte Charge taucht noch auf. Prüfen Sie, ob bereits ausgelieferte Ware betroffen ist — die Sperre wirkt auf den Bestand, nicht auf das, was das Haus verlassen hat. Dafür ist der Verwendungsnachweis da.
Das MHD wird nicht berücksichtigt. Es hängt an der Charge. Ohne Chargenführung gibt es kein MHD.
Ich kann nicht sperren. Dann fehlt batchserial.batch.block.