Artikel-Attribute ändern
jtl_artikel_attribute_aendern
Was das Tool macht
Setzt oder löscht Attributwerte eines Artikels (Textbausteine, USPs usw.) je Sprache und optional je Verkaufskanal - mit Vorschau, Backup und Rückgängig-Funktion. Nicht genannte Attribute und Sprachen bleiben unverändert; wert=null löscht den Wert dieser Sprache. Das Attribut wird über seine Nummer aus jtl_artikel_attribute angegeben (JTL kennt für Attribute keine Namen über die Schnittstelle). Braucht JTL-Wawi ab 2.2. Nutze dieses Tool für 'Setze bei SKU X den Textbaustein 1945 auf …', 'Übertrage die Textbausteine von A nach B' (erst beide mit jtl_artikel_attribute lesen). 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) |
| aenderungenPflicht | Ohne Beschreibung |
| 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 Artikel per SKU, liest ihn über REST v2 und bildet den Ist-Stand aller Attributwerte je Attributnummer, Sprache und Kanal.
- 3Jede Änderung nennt Attributnummer, Sprache, Wert und optional einen Kanal (per Name aufgelöst). Die Attribut-GUID entsteht aus dem GUID-Anfang der Felder dieses Mandanten und der Nummer.
- 4Hat der Artikel für eine genannte Attributnummer bisher keinen Wert, warnt die Vorschau (Nummer am Vergleichsartikel prüfen).
- 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.
- 6Geschrieben wird per PATCH /v2/items/{guid} nur mit dem Block attributes. JTL führt ihn zusammen: nicht genannte Attribute und Sprachen bleiben, ein leerer Wert löscht den Wert dieser Sprache (live belegt an Wawi 2.2.2).
- 7Danach wird der Artikel erneut gelesen und jeder Wert mit der Erwartung verglichen. Der Rück-Payload setzt die vorherigen Werte (oder leert neu angelegte).
Annahmen und Grenzen
- Attribute haben über die Schnittstelle keine Namen - die Zuordnung Nummer zu Bedeutung muss aus dem Inhalt oder einem Vergleichsartikel kommen.
- Braucht JTL-Wawi ab 2.2.
- Ob JTL eine unbekannte Attributnummer ablehnt oder still übergeht, ist nicht belegt - die Rückprüfung zeigt es als Abweichung.
- 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 SKU KIUSER-TEST-1 – noch nichts geändert: • Attribut 1945 / EN: „Attribute 1 EN“ → „Smartphone Protection Set“ • Attribut 2131 / DE: (leer) → „1x Schutzglas, 1x Hülle“ Alle anderen Attribute und Sprachen bleiben unverändert. Soll ich die Werte schreiben?
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.