Bestand buchen (Zugang / Abgang)
jtl_bestand_buchen
Was das Tool macht
Bucht einen Warenzugang oder Warenabgang für einen Artikel in einem Lager - mit Vorschau, Backup und Rückgängig-Funktion (Gegenbuchung). Die Menge ist eine Veränderung, kein Zielbestand: Zugang erhöht, Abgang verringert den Bestand. Für Artikel mit Charge, MHD oder Seriennummern die Angaben mitgeben. Braucht JTL-Wawi ab 2.2. Nutze dieses Tool für 'Buche 50 Stück von SKU X ins Hauptlager ein', 'Buche 3 Stück von Y als Abgang aus'. Bestände zeigen jtl_bestand_je_sku und die Vorschau dieses Tools. Vorschau zuerst: Ohne dryRun=false wird nichts geändert. Zeige dem Nutzer Vorher/Nachher aus der Vorschau, hole seine Zustimmung ein und rufe dann mit dryRun=false und der bestaetigung erneut auf.
Eingaben
| skuPflicht | Artikelnummer / SKU (exakt) |
| lagerPflicht | Lager (Name wie in JTL) |
| richtungPflicht | zugang = einbuchen, abgang = ausbuchen |
| mengePflicht | Menge (größer als 0) |
| chargeoptional | Chargennummer - nur für chargengeführte Artikel |
| mhdoptional | Mindesthaltbarkeitsdatum JJJJ-MM-TT - nur für MHD-geführte Artikel |
| seriennummernoptional | Seriennummern - nur für seriennummerngeführte Artikel |
| dryRunoptional | true (Default) = nur Vorschau, in JTL wird nichts geändert. false = wirklich schreiben - nur zusammen mit der bestaetigung aus der Vorschau und nach ausdrücklicher Zustimmung des Nutzers. |
| bestaetigungoptional | Bestätigungs-Token aus der Vorschau (Dry-Run). Pflicht bei dryRun=false. |
Die Eingaben füllt die KI aus deiner Frage. Du musst dir keine Parameternamen merken.
So wird gerechnet
Der Rechenweg in der Reihenfolge, in der das Tool arbeitet: Abruf, Filter, Berechnung, Ausgabe. Aus dem Tool-Code abgeleitet, damit nachvollziehbar ist, warum eine Zahl so ist. Dieselbe Auskunft liefert das Tool kiuser_tool_logik direkt im KI-Chat.
- 1Prüft zuerst die Rechte: Server erlaubt Schreiben, JTL-Verbindung für Schreibzugriff freigeschaltet, AVV in aktueller Fassung angenommen, Add-on „Schreiben“ aktiv. Fehlt eines, endet der Aufruf mit dem Grund.
- 2Findet den Artikel per SKU und liest seinen Bestand in jedem aktiven Lager (REST v2, warehouses/{lager}/items/{artikel}/stocks).
- 3Das Lager wird per Name aufgelöst. Ein Abgang, der den Bestand im Lager unter 0 brächte, wird abgelehnt; bei Seriennummern muss ihre Anzahl der Menge entsprechen.
- 4Ohne Bestätigung endet der Aufruf als Vorschau mit einmaligem Token (15 Minuten gültig, an Eingaben und Ist-Stand gebunden); der scharfe Aufruf löst ihn ein, verbraucht die Limits und legt das Backup an.
- 5Gebucht wird per POST .../stock-postings/inbound (Zugang) bzw. /outbound (Abgang) mit der Menge als Veränderung, nicht als Zielbestand.
- 6Danach wird der Bestand erneut gelesen und verglichen. Rückgängig ist die Gegenbuchung derselben Menge.
Annahmen und Grenzen
- Braucht JTL-Wawi ab 2.2.
- Kein Lagerplatz wählbar - JTL bucht auf den Standardplatz des Lagers.
- Ersetzt keinen Wareneingang zu einer Bestellung und keine Inventur.
- Die Gegenbuchung scheitert, wenn der Bestand inzwischen verbraucht ist.
- In der Einführungsphase gelten 3 Schreibvorgänge je Entität und Tag; das Limit entfällt, sobald der Admin alle drei Entitäten freigegeben hat. Vorschauen zählen nicht.
- Das Änderungsprotokoll wird 12 Monate aufbewahrt und danach automatisch gelöscht.
So sieht eine Antwort aus
Vorschau für SKU 541908 – noch nichts gebucht: Bestand Hauptlager - Moos: 213 → 263 (Zugang 50). Der verfügbare Bestand steigt sofort, auch für Shops und Marktplätze. Soll ich buchen?
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.