Auftragsposition entfernen

jtl_auftrag_position_entfernen

Aufträgeschreibend, mit Vorschau und Backup

Was das Tool macht

Entfernt eine Position aus einem Auftrag (per SKU, bei Dubletten per positionsId) - mit Vorschau, Backup und Rückgängig-Funktion (die Position wird beim Wiederherstellen mit den alten Werten neu angelegt). Gelieferte Positionen lassen sich nicht entfernen. Nutze dieses Tool für 'Nimm SKU X aus Auftrag OR-123'. 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

auftragsnummerPflicht	Auftragsnummer (exakt)
skuoptional	SKU der Position
positionsIdoptional	Positions-Id, nur wenn die SKU mehrfach vorkommt
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 Auftrag per Nummer (Belegdatum aus GraphQL, dann Suche in der REST-v1.3-Auftragsliste) und liest ihn mit allen Positionen.
3Die Position wird per SKU gewählt (exakt, Groß-/Kleinschreibung egal), bei Dubletten per positionsId. Gesperrt sind stornierte Aufträge und Positionen, von denen bereits etwas geliefert wurde.
4Die Vorschau zeigt die Position als entfernt und warnt bei teil- oder vollgelieferten Aufträgen; als Rück-Payload werden Artikel-Id, SKU, Bezeichnung, Menge, Nettopreis, Rabatt und Hinweis gesichert.
5Ohne 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.
6Die Position wird per DELETE entfernt (salesOrders/{id}/lineitems/{positionId}).
7Danach werden die Positionen erneut gelesen und das Protokoll mit Vorher/Nachher, Abweichungen und backupId abgeschlossen.

Annahmen und Grenzen

Beim Wiederherstellen entsteht eine neue Position mit den alten Werten und einer neuen Positions-Id; Reihenfolge und weitere Felder der alten Position werden nicht übernommen.
Eine Option zum Unterdrücken von JTL-Workflows gibt es bei diesem Tool nicht.
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

Claude · Auftragsposition entfernen

Vorschau für Auftrag OR-526202 – noch nichts geändert: Position 100290 (2 Stück, 14,90 € netto) wird entfernt. Sie ist noch nicht geliefert und lässt sich beim Wiederherstellen mit den alten Werten neu anlegen. Soll ich die Position entfernen?

Erfundene Musterdaten. Im Betrieb dieselbe Struktur mit deinen JTL-Daten.

In wenigen Minuten die erste Antwort aus deinen JTL-Daten.

Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.

Kostenlos starten Erst verstehen, wie es funktioniert