Auftragsposition ändern
jtl_auftrag_position_aendern
Was das Tool macht
Ändert eine Position eines Auftrags: Menge, Nettopreis, Rabatt in Prozent, Bezeichnung oder Hinweis - mit Vorschau, Backup und Rückgängig-Funktion. Die Position wird über ihre SKU gewählt (bei Dubletten über positionsId aus jtl_auftrag_details). Bereits gelieferte Mengen lassen sich nicht unterschreiten. Nutze dieses Tool für 'Ändere in OR-123 die Menge von SKU X auf 5', 'Gib auf Position Y 10 % Rabatt'. 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 |
| mengeoptional | Neue Menge - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| preisNettooptional | Neuer Einzelpreis netto - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| rabattProzentoptional | Rabatt in Prozent - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| bezeichnungoptional | Positionsbezeichnung - weglassen = unverändert, null = leeren |
| hinweisoptional | Positionshinweis - weglassen = unverändert, null = leeren |
| 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. Stornierte Aufträge sind gesperrt.
- 3Die Position wird per SKU gewählt (exakt, Groß-/Kleinschreibung egal); kommt die SKU mehrfach vor, ist die positionsId nötig. Fehlt beides oder passt nichts, bricht der Aufruf mit der Liste der vorhandenen SKUs ab.
- 4Verwaltet werden Menge, Nettopreis, Rabatt in Prozent (max. 100), Bezeichnung (nicht leer) und Hinweis. Eine Menge unter der bereits gelieferten Menge wird abgelehnt, negative Werte ebenso.
- 5Die Vorschau zeigt alle Positionen mit Menge, Preis, Rabatt, Bezeichnung, Hinweis und gelieferter Menge; sie warnt bei mehr als 10 % Preisabweichung, bei teil-/vollgelieferten und bei vollständig bezahlten Aufträgen.
- 6Ohne 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.
- 7Geschrieben wird per PATCH auf die einzelne Position (salesOrders/{id}/lineitems/{positionId}); es gehen nur die angegebenen Felder mit.
- 8Danach werden die Positionen erneut gelesen, der tatsächliche Stand mit dem erwarteten verglichen und das Protokoll mit Vorher/Nachher, Abweichungen und backupId abgeschlossen.
Annahmen und Grenzen
- Artikelzuordnung, Steuersatz und Lieferstatus der Position werden nicht geändert; Kopfdaten ändert jtl_auftrag_aendern.
- 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.
- Die alten Positionswerte werden als Rück-Payload gesichert; das Änderungsprotokoll wird 12 Monate aufbewahrt.
So sieht eine Antwort aus
Vorschau für Auftrag OR-526202, Position 100234 – noch nichts geändert: • Menge: 3 → 5 • Einzelpreis netto bleibt 24,90 € Der Auftrag ist noch nicht geliefert. Soll ich die Menge so ändern?
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.