Artikelmaße und Gewichte ändern
jtl_artikel_masse_aendern
Was das Tool macht
Ändert Länge, Breite, Höhe (cm) sowie Artikel- und Versandgewicht (kg) eines Artikels mit Vorschau, Backup und Rückgängig-Funktion. Nur angegebene Werte werden geändert. Nutze dieses Tool für 'Setze die Maße von SKU X auf 20 x 10 x 5 cm', 'Versandgewicht von Y auf 0,8 kg'. 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
| skuPflicht | Artikelnummer / SKU (exakt) |
| laengeCmoptional | Länge in cm - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| breiteCmoptional | Breite in cm - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| hoeheCmoptional | Höhe in cm - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| gewichtKgoptional | Artikelgewicht in kg - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| versandgewichtKgoptional | Versandgewicht in kg - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| 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.
- 2Liest den Artikel exakt per SKU aus der REST-v1.3-Artikelliste (nur bei genau gleicher SKU) und danach den vollständigen Datensatz als Sicherungs-Snapshot.
- 3Verwaltet werden Länge, Breite, Höhe in Zentimetern sowie Artikel- und Versandgewicht in Kilogramm. Nur angegebene Werte ändern sich; Leeren ist nicht möglich (stattdessen 0), negative Werte werden abgelehnt.
- 4Ändert sich nichts, endet der Aufruf als „keine Änderung“. Springt ein Wert um mehr als 50 % gegenüber dem alten, erscheint eine Warnung in der Vorschau.
- 5Ohne Bestätigung endet der Aufruf als Vorschau mit Vorher/Nachher und einem einmaligen Token, 15 Minuten gültig und an Verbindung, Tool, Artikel, 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 den Artikel: die Blöcke Maße (Dimensions) und Gewichte (Weights) jeweils vollständig, bestehende Werte plus Änderungen; auf Wunsch ohne automatische JTL-Workflows.
- 8Danach wird der Artikel erneut gelesen, der tatsächliche Stand mit dem erwarteten verglichen und das Protokoll mit Vorher/Nachher, Abweichungen und backupId abgeschlossen.
Annahmen und Grenzen
- Andere Artikelfelder werden nicht gesendet; Preise, Texte, Kennungen und Lageroptionen bleiben unverändert.
- Fehlt ein Maß oder Gewicht im Ist-Stand, wird es beim Senden als 0 übertragen, weil beide Blöcke immer vollständig gehen.
- 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 Vorgang lässt sich per jtl_aenderung_wiederherstellen zurücknehmen; das Änderungsprotokoll wird 12 Monate aufbewahrt.
So sieht eine Antwort aus
Vorschau für SKU 100234 – noch nichts geändert: • Versandgewicht: 0,25 kg → 0,31 kg Maße und Artikelgewicht bleiben gleich. Soll ich das Versandgewicht so setzen?
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.