Artikelbilder sortieren
jtl_artikel_bilder_sortieren
Was das Tool macht
Ändert die Reihenfolge der Bilder eines Artikels oder setzt das Hauptbild, mit Vorschau, Backup und Rückgängig-Funktion. Position 1 ist das Hauptbild, die aktuellen Positionen zeigt jtl_artikel_bilder. Nutze dieses Tool für 'Mach Bild 3 von SKU X zum Hauptbild', 'Sortiere die Bilder von Y als 2, 1, 3'. 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) |
| hauptbildPositionoptional | Bisherige Position des Bildes, das Hauptbild werden soll |
| reihenfolgeoptional | Neue Reihenfolge als Liste der bisherigen Positionen, z.B. [3,1,2]; muss alle Bilder enthalten |
| 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 die Reihenfolge der Bilder; maßgeblich ist GraphQL, weil REST je Bild mehrere widersprüchliche Zeilen liefert. Fällt GraphQL aus, gilt die kleinste Sortiernummer aus REST.
- 3Prüft hauptbildPosition oder die vollständige Reihenfolge.
- 4Ohne 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.
- 5Beim 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.
- 6Geschrieben wird je Bild und Kanal per PATCH; zuerst der Wawi-Kanal, der gelingen muss, danach die Shop-Kanäle. Amazon-Bildkanäle nehmen keine Sortierung an und werden ausgelassen.
- 7Danach wird der Stand erneut gelesen, mit dem erwarteten verglichen und das Protokoll mit Vorher/Nachher, Abweichungen und backupId abgeschlossen.
Annahmen und Grenzen
- Bei sehr vielen Bildern kann das Zeitbudget die Sortierung in späteren Kanälen abbrechen; das Nachlesen zeigt den tatsächlichen Stand der Hauptreihenfolge.
- Der Vorgang lässt sich per jtl_aenderung_wiederherstellen zurücknehmen.
- 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 – noch nichts geändert: • Hauptbild: powerbank-front.jpg → powerbank-seite.jpg • Bild 2: powerbank-seite.jpg → powerbank-front.jpg Soll ich die Reihenfolge so setzen?
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.