Auftragsposition hinzufügen
jtl_auftrag_position_hinzufuegen
Was das Tool macht
Fügt einem Auftrag eine Artikelposition hinzu (SKU, Menge, optional Nettopreis, Rabatt, Hinweis) - mit Vorschau und Backup-Eintrag. Ohne Preis nimmt JTL den Artikelpreis. Nutze dieses Tool für 'Füge in OR-123 zweimal SKU X hinzu'. Rückgängig über jtl_auftrag_position_entfernen. 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) |
| skuPflicht | SKU des Artikels |
| mengePflicht | Menge |
| preisNettooptional | Einzelpreis netto (leer = Artikelpreis laut JTL) - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| rabattProzentoptional | Rabatt in Prozent - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| hinweisoptional | Positionshinweis |
| 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; den Artikel exakt per SKU aus der Artikelliste. Stornierte Aufträge sind gesperrt.
- 3Die Menge muss größer als 0 sein; optional Nettopreis, Rabatt (nicht negativ) und Hinweis. Ohne Preis setzt JTL den Artikelpreis, der endgültige Preis steht erst im Ergebnis.
- 4Die Vorschau zeigt die neue Position neben den bestehenden und warnt, wenn die SKU im Auftrag schon vorkommt (es entsteht eine zweite Position) oder der Auftrag teil- oder vollgeliefert ist.
- 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 geht per POST an die Auftragspositionen (salesOrders/{id}/lineitems) mit Artikel-Id, SKU, Menge und den optionalen Feldern.
- 7Danach werden die Positionen erneut gelesen; das Protokoll speichert den tatsächlichen Stand inklusive des von JTL gesetzten Preises.
Annahmen und Grenzen
- Nur Artikelpositionen zu einer vorhandenen SKU; Freipositionen, Versandkosten- oder Rabattpositionen werden nicht angelegt.
- Nicht automatisch rückgängig: Rückgängig ist jtl_auftrag_position_entfernen mit dieser SKU.
- 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 Auftrag OR-526202 – noch nichts geändert: Neue Position: 2 × 100290 „Powerbank Travel 5000mAh mit Kabel, weiß“ zum Artikelpreis laut JTL. Soll ich die Position so hinzufügen?
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.