Auftrags-Freifeld ändern
jtl_auftrag_freifeld_aendern
Was das Tool macht
Setzt den Wert eines Freifelds (eigenes Feld) an einem Auftrag - per Feldname, mit Vorschau, Backup und Rückgängig-Funktion. Verfügbare Felder: jtl_feldbedeutungen; aktuelle Werte: jtl_auftrag_freifelder. Nutze dieses Tool für 'Setze bei OR-123 das Freifeld Logistikkennzeichen auf Express'. 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) |
| freifeldPflicht | Name des Freifelds, wie in JTL |
| wertPflicht | Neuer Wert; null leert das Feld |
| 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 samt Freifeldwerten und dem Feldkatalog der Verbindung. Stornierte Aufträge sind gesperrt.
- 3Das Freifeld wird per Name aufgelöst: exakt (ohne Groß-/Kleinschreibung), sonst über einen eindeutigen Namensanfang; kommt der Name mehrfach vor, ist der vollständige Name aus jtl_feldbedeutungen nötig.
- 4Verglichen wird nur der Wert dieses Freifelds; null leert das Feld. Die Vorschau nennt den Datentyp laut JTL.
- 5Ohne Bestätigung endet der Aufruf als Vorschau mit Vorher/Nachher und einem einmaligen Token, 15 Minuten gültig und an Verbindung, Tool, Auftrag, Eingaben und den gelesenen Ist-Stand gebunden.
- 6Beim scharfen Aufruf wird der Token eingelöst; weichen Eingaben oder der Stand in JTL inzwischen ab, wird abgelehnt. Dann werden Tageslimit und Schreibkontingent verbraucht und ein Backup-Datensatz angelegt.
- 7Geschrieben wird per PATCH auf das einzelne Freifeld des Auftrags (salesOrders/{id}/customfields/{feldId}); Leeren sendet eine leere Zeichenkette.
- 8Danach werden die Freifelder erneut gelesen, der tatsächliche Wert mit dem erwarteten verglichen und das Protokoll mit Vorher/Nachher, Abweichungen und backupId abgeschlossen.
Annahmen und Grenzen
- Der Wert wird so gesendet, wie er angegeben wurde; ob er zum Datentyp passt, entscheidet JTL. Auswahlwerte werden hier nicht gegen die Liste geprüft.
- Andere Freifelder und Auftragsfelder bleiben unberührt; 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.
- Der alte Wert wird als Rück-Payload gesichert; das Änderungsprotokoll wird 12 Monate aufbewahrt.
So sieht eine Antwort aus
Vorschau für Auftrag OR-526202, Freifeld „Spezialauftrag“ – noch nichts geändert: • Nein → Ja Laut Bedeutung: erklärungsbedürftiger Auftrag, vor Versand Rücksprache mit dem Vertrieb. Soll ich das so setzen?
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.