Artikeltexte je Sprache und Kanal ändern
jtl_artikel_sprachtexte_aendern
Was das Tool macht
Schreibt Name, Kurz- und Langbeschreibung sowie SEO-Felder eines Artikels in einer bestimmten Sprache (z.B. en, fr) und optional für einen bestimmten Verkaufskanal - mit Vorschau, Backup und Rückgängig-Funktion. Fehlt der Text in dieser Sprache, wird er angelegt (dann ist name Pflicht). Nutze dieses Tool für 'Schreibe die englischen Texte von SKU X', 'Setze den französischen Namen von Y', 'SEO-Titel auf Englisch'. Texte für einen Shop gehen nur, wenn der Artikel dort aktiv ist. 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) |
| sprachePflicht | Sprache als ISO-Code, z.B. en |
| kanaloptional | Verkaufskanal per Name, z.B. JTL-Shop: B2B Onlineshop. Leer = Standardtext der Wawi |
| nameoptional | Artikelname - weglassen = unverändert |
| kurzbeschreibungoptional | Kurzbeschreibung (HTML erlaubt) - weglassen = unverändert, null = leeren |
| beschreibungoptional | Beschreibung (HTML erlaubt) - weglassen = unverändert, null = leeren |
| seoPfadoptional | SEO-Pfad - weglassen = unverändert, null = leeren |
| seoTiteloptional | SEO-Titel - weglassen = unverändert, null = leeren |
| seoBeschreibungoptional | SEO-Beschreibung - weglassen = unverändert, null = leeren |
| seoSuchbegriffeoptional | SEO-Suchbegriffe - weglassen = unverändert, null = leeren |
| 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 und seine Texte je Kanal und Sprache aus REST v1.3 (items/{id}/descriptions).
- 3Prüft, ob die Sprache in JTL aktiv ist, und löst den Verkaufskanal per Name auf; ohne Kanal gilt der Standardtext der Wawi. Nur angegebene Felder ändern sich, null leert ein Feld.
- 4Gibt es den Text noch nicht, wird er angelegt, dann ist der Name Pflicht. Für einen Shop-Kanal, in dem der Artikel nicht aktiv ist, endet der Aufruf mit einer Erklärung.
- 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 POST (neu) oder PATCH (vorhanden) auf items/{id}/descriptions.
- 8Danach wird der Stand erneut gelesen, mit dem erwarteten verglichen und das Protokoll mit Vorher/Nachher, Abweichungen und backupId abgeschlossen.
Annahmen und Grenzen
- Texte für einen Shop-Kanal nimmt JTL nur an, wenn der Artikel dort aktiv ist; die Aktivierung geht per API derzeit nicht.
- Der Vorgang lässt sich zurücknehmen; neu angelegte Texte werden dabei wieder gelöscht.
- 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.
So sieht eine Antwort aus
Vorschau für SKU 100234, Englisch – noch nichts geändert: • Name: (leer) → „Compact Power Bank 10000mAh, black“ • Kurzbeschreibung: (leer) → „Compact power bank with USB-C Power Delivery“ Der englische Text wird neu angelegt. Soll ich ihn so schreiben?
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.