Bestand
Überblick
Diese Seite zeigt den Lagerbestand aller lagergeführten Artikel. Drei Zahlen stehen nebeneinander, und sie auseinanderzuhalten erspart die meisten Missverständnisse:
| Zahl | Bedeutung |
|---|---|
| Bestand | was physisch da ist |
| Reserviert | was durch Aufträge bereits versprochen ist |
| Verfügbar | Bestand minus Reserviert — die einzige Zahl, die etwas zusagt |
Wer auf Bestand plant statt auf Verfügbar, verkauft Ware, die einem anderen Auftrag gehört.
Dazu kommen Meldebestand und Nachbestellmenge sowie Ø Einstand und Bestandswert; Artikel ohne Wert erscheinen als unbewertet.
B-Ware getrennt führen. Auch ohne Multilager hat jeder Artikelzustand — Neuware, B-Ware/gebraucht, geprüft wiederaufbereitet, beschädigt — seinen eigenen Bestand. Eine Retoure als B-Ware landet nie in der Neuware; verkaufbar für Aufträge ist nur Neuware. Ein Kanal-Angebot mit Zustand (z. B. gebraucht) wird genau aus diesem Bestand bedient. Geprüfte B-Ware machen Sie über Zustand umbuchen wieder zu Neuware — eine eigene, protokollierte Lagerbewegung; der Einstandswert bleibt dabei unverändert.
Kernaufgaben
Unterdeckung finden. Der Filter Nur unter Meldebestand zeigt, wo nachbestellt werden muss — die Zeile weist das zusätzlich aus. Verglichen wird der verfügbare Bestand, nicht der physische.
Bestand korrigieren. Bestandskorrektur bucht eine Differenz — positiv zu, negativ ab — mit Grund/Notiz. Der Grund ist keine Formalie: Eine Korrektur ohne Begründung ist später von einem Fehler nicht zu unterscheiden.
Bestands-Einstellungen aufrufen. Meldebestand und Nachbestellmenge werden je Artikel gepflegt.
B-Ware sehen und umbuchen. Liegt ein Artikel auch in einem anderen Zustand als Neuware, steht unter seinem Namen je Zustand ein Kennzeichen mit der Stückzahl (z. B. B-Ware/gebraucht: 3). Die Spalten Bestand, Reserviert und Verfügbar zählen nur Neuware. Mit dem Knopf Zustand umbuchen in der Zeile buchen Sie Ware von einem Zustand in einen anderen — vorbelegt ist der Normalfall „geprüfte B-Ware wird Neuware"; die Maske nennt den freien Bestand des Quellzustands. Den Knopf sehen nur Nutzer mit dem Recht zum Umbuchen.
Felder im Detail
Die Liste selbst ist eine Anzeige — geschrieben wird über zwei Masken je Artikelzeile: Bestandskorrektur und Bestands-Einstellungen. Beide arbeiten auf ProductStockResource, angesprochen über die Artikel-ULID (productUlid).
Bestandskorrektur
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Korrektur (±) delta | ja | ganze Zahl mit Vorzeichen, ungleich 0 | Die Menge, die gebucht wird — positive Werte buchen zu, negative buchen ab. Es wird nichts überschrieben: die Korrektur entsteht als eigene Zeile im Bestandsjournal (Herkunft manual). Fehlt sie oder ist sie 0, weist der Server die Buchung ab. |
Grund/Notiz note | nein | Text | Warum korrigiert wurde. Formal freiwillig, praktisch die halbe Miete: Eine Korrektur ohne Begründung ist später von einem Fehler nicht zu unterscheiden. |
Bringt eine Abbuchung den Bestand unter 0, wird sie abgewiesen — es sei denn, für den Artikel ist Negativbestand erlauben gesetzt.
Bestands-Einstellungen
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Meldebestand reorderPoint | nein | ganze Zahl, in der Maske ab 0; leer = keine Überwachung | Ab welchem verfügbaren Bestand nachbestellt werden soll. Unterschreitung markiert die Zeile und ist die Grundlage der Bestellvorschläge. Verglichen wird available, nicht onHand. |
Nachbestellmenge reorderQty | nein | ganze Zahl, in der Maske ab 0 | Wie viel bei Unterschreitung vorgeschlagen wird. |
Negativbestand erlauben allowNegative | nein | Ja/Nein (Standard: Nein) | Aus: eine Buchung, die den Bestand unter 0 brächte, wird abgewiesen. An: Abbuchungen unter 0 sind zugelassen — für Rückstände gedacht, nicht als Dauerzustand. |
Zustand umbuchen
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Artikel productId | ja | lagergeführter Artikel | Welcher Artikel umgebucht wird. Ein Verkaufs-Set lässt sich nicht umbuchen — sein Bestand liegt an den Komponenten. |
Von Zustand fromCondition | ja | Neuware, B-Ware/gebraucht, geprüft wiederaufbereitet, beschädigt | Aus welchem Bestand die Ware kommt. Umbuchbar ist nur der freie Bestand dieses Zustands; mehr wird mit einer Meldung abgewiesen. |
Nach Zustand toCondition | ja | wie Von Zustand, aber ein anderer | In welchen Bestand die Ware geht — z. B. geprüfte B-Ware wird Neuware und ist damit wieder für Aufträge verkaufbar. |
Menge qty | ja | ganze Zahl größer 0 | Wie viele Stück den Zustand wechseln. |
Lager warehouseId | nein | Lager (nur Multilager) | In welchem Lager umgebucht wird. Bei Multilager steht in der Maske die Lagerwahl, vorbelegt mit dem Standard-Lager; der Hinweis zur Menge zeigt dann den freien Bestand dieses Lagers. Über die Schnittstelle heißt leer: Standard-Lager. |
Lagerplatz binId | nein | Lagerplatz (nur Multilager) | An welchem Platz die Ware liegt. Abgang und Zugang bleiben am selben Platz, die Verteilung auf Plätze stimmt je Zustand weiter. Zur Wahl stehen die Plätze des gewählten Lagers, an denen Ware im Quellzustand liegt; ohne Platz nimmt die Buchung, was im Lager frei ist. Ein Platz ohne Lager wird abgewiesen. |
Grund note | nein | Text, max. 1000 Zeichen | Warum umgebucht wird, z. B. das Prüfergebnis. Steht im Protokoll und im Bestandsjournal. |
Jede Umbuchung steht mit Wer und Wann im Protokoll und als zwei Zeilen der Art Zustandsumbuchung im Bestandsjournal. Der Einstandswert ändert sich dabei nicht — eine Abwertung von B-Ware ist eine bewusste Buchung der Buchhaltung.
Angezeigte Werte
Diese Angaben werden nicht eingegeben, sondern gerechnet. Sie ändern sich durch Buchungen: Wareneingang, Lieferung, Inventur oder Umlagerung.
| Angabe | Feld | Was sie bedeutet |
|---|---|---|
| SKU / Artikel | sku, name | Um welchen Artikel es geht. |
| Bestand | onHand | Was physisch da ist — die Summe aller Journalzeilen. |
| Reserviert | reserved | Was zwar liegt, aber durch Aufträge schon jemandem gehört. |
| Verfügbar | available | onHand minus reserved. Die einzige Zahl, die etwas zusagt. |
| Ø Einstand | avgCostAmount | Gleitender Durchschnitts-Einstandspreis je Einheit, in Cent. Leer heißt unbekannt, nicht „null Euro". |
| Bestandswert | stockValueAmount | avgCostAmount × onHand, in Cent; ohne bekannten Einstandspreis unbewertet. |
| Zuletzt bewertet | valuedAt | Wann der Durchschnitt zuletzt fortgeschrieben wurde. |
| Bewegungen | movements | Die letzten 50 Journalzeilen (nur beim Einzelabruf über die Schnittstelle). |
| Artikel-Id | productId | Die interne Nummer des Artikels — über sie spricht Zustand umbuchen den Artikel an. |
| B-Ware je Zustand | conditionStock | Je Zustand außer Neuware: Bestand, reserviert und frei (condition, onHand, reserved, available). Nur Zustände mit Bestand oder Reservierung; erscheint als Kennzeichen unter dem Artikelnamen. |
Über der Liste stehen zwei Summen, die bewusst nicht den Listenfiltern folgen: der gesamte Bestandswert und die Zahl der Artikel ohne Einstandspreis. Solange die zweite Zahl größer als 0 ist, ist der ausgewiesene Bestandswert eine Untergrenze — die Seite sagt das ausdrücklich.
Negativer Bestand. Steht ein Artikel im Minus (nur möglich, wenn negativer Bestand erlaubt ist), geht er mit 0 in den gesamten Bestandswert ein — nicht als Abzug. Die Seite nennt solche Zeilen und ihre Stückzahl in einem eigenen Hinweis; über die Schnittstelle stehen sie in negativeStockLines und negativeStockOnHand.
B-Ware im Bestandswert. B-Ware wird zum Ø Einstand der Neuware desselben Artikels bewertet und ist im gesamten Bestandswert enthalten; eine eigene Kachel Davon B-Ware nennt ihren Anteil und die Stückzahl. Eine automatische Abwertung gibt es nicht — sie ist eine bewusste Buchung der Buchhaltung. Fehlt der Ø Einstand der Neuware, bleibt die B-Ware unbewertet und die Seite weist die Stückzahl als Lücke aus. Über die Schnittstelle liefert der Bestandswert-Bericht (/v1/product-stock-value) je Artikel und Zustand eine Zeile (condition) und die Summen conditionOnHand, conditionValueAmount und conditionUnvaluedOnHand.
Einstellungen & Rechte
- Modul
module.products. products.stock.viewzum Sehen,products.stock.managefür Korrekturen.products.stock.change_conditionzum Umbuchen des Artikelzustands — ein eigenes Recht, weil es
B-Ware verkaufbar macht (Rolle Umsetzung).
- Nur lagergeführte Artikel erscheinen. Das Kennzeichen setzen Sie am Artikel, siehe
- Für regelmäßige Zählungen ist die Inventur der richtige Weg —
nicht eine Reihe von Einzelkorrekturen.
FAQ & Fehlerbilder
Ein Artikel fehlt in der Liste. Er ist nicht als lagergeführt markiert.
Verfügbar ist kleiner als Bestand, obwohl nichts verkauft wurde. Dann ist Ware reserviert — durch offene Aufträge. Das ist der Normalfall, kein Fehler.
**Der Bestandswert steht auf unbewertet.** Dann liegt kein Einstandswert vor. Er entsteht aus Zugängen mit Preis.
Wir haben viele Differenzen von Hand korrigiert. Nutzen Sie eine Inventur. Sie friert den Sollstand ein, protokolliert die Zählung und ist damit belegbar — Einzelkorrekturen sind es nicht.