Auftrag zurückhalten oder freigeben
jtl_auftrag_zurueckhalten
Was das Tool macht
Hält einen Auftrag zurück (setzt einen Rückhaltegrund per Name) oder gibt ihn wieder frei (freigeben=true) - mit Vorschau, Backup und Rückgängig-Funktion. Ein zurückgehaltener Auftrag läuft nicht in den Versand. Nutze dieses Tool für 'Halte OR-123 zurück', 'Setze OR-123 auf Terminauftrag', 'Gib OR-123 frei'. Ohne Grund und ohne freigeben nennt das Tool die verfügbaren Rückhaltegründe. 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, z.B. OR-526202 (exakt) |
| rueckhaltegrundoptional | Rückhaltegrund (Name wie in JTL) |
| freigebenoptional | true = Rückhalt aufheben, der Auftrag kann in den Versand laufen |
| workflowsAuslassenoptional | true = automatische JTL-Workflows für diese Änderung nicht auslösen (Default false). |
| 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 vollständig; ein stornierter Auftrag ist gesperrt.
- 3Mit rueckhaltegrund wird der Grund per Name gegen die JTL-Liste aufgelöst; mit freigeben=true wird der Rückhalt aufgehoben (gesperrt, wenn der Auftrag gar nicht zurückgehalten ist). Ohne beides nennt das Tool die verfügbaren Gründe.
- 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.
- 5Geschrieben wird per PATCH salesOrders/{id} mit dem vollständigen Versanddetail-Block (Versandart, Priorität, Termine, Zusatzgewicht bleiben unverändert) und dem neuen Rückhaltegrund bzw. null.
- 6Danach wird der Auftrag erneut gelesen und der Rückhaltegrund mit der Erwartung verglichen.
Annahmen und Grenzen
- Der Rückhalt wirkt nur auf offene Lieferungen; bereits erzeugte Lieferscheine und Pakete bleiben bestehen.
- Rückgängig stellt den vorherigen Rückhaltegrund wieder her (oder hebt ihn auf, wenn vorher keiner gesetzt war).
- 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: Rückhaltegrund: (keiner) → „Terminauftrag“. Der Auftrag läuft damit nicht in den Versand. Soll ich den Auftrag zurückhalten? Die Änderung wird gesichert und lässt sich rückgängig machen.
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.