Artikelbild ersetzen
jtl_artikel_bild_ersetzen
Was das Tool macht
Ersetzt das Bild an einer Position durch ein neues (in allen Bildkanälen), mit Vorschau und Protokoll. Das alte Bild ist danach weg und lässt sich nicht automatisch wiederherstellen. Nutze dieses Tool für 'Tausche Bild 2 von SKU X gegen dieses'. Die aktuelle Reihenfolge zeigt die Vorschau jedes Bild-Tools. 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) |
| positionPflicht | Position des zu ersetzenden Bildes (1 = Hauptbild) |
| bildBase64optional | Bilddaten als Base64 (JPEG, PNG, GIF oder WebP, max. 8 MB). Alternativ bildUrl. |
| bildUrloptional | Öffentlich erreichbare URL des Bildes. Alternativ bildBase64. |
| dateinameoptional | Dateiname des Bildes in JTL (optional, Endung wird aus dem Bildtyp gesetzt) |
| 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.
- 2Lädt und prüft das neue Bild wie beim Hochladen und sucht das bisherige Bild über seine Position.
- 3Die Vorschau warnt, dass das alte Bild überschrieben wird.
- 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 per PATCH auf das Bild; das gilt in allen Bildkanälen und JTL vergibt intern eine neue Bild-Id.
- 7Danach wird der Stand erneut gelesen, mit dem erwarteten verglichen und das Protokoll mit Vorher/Nachher, Abweichungen und backupId abgeschlossen.
Annahmen und Grenzen
- Das alte Bild lässt sich nicht automatisch wiederherstellen.
- 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: Bild 2: powerbank-seite.jpg → powerbank-seite-neu.jpg Warnung: Das alte Bild wird überschrieben und lässt sich nicht automatisch wiederherstellen. Soll ich es ersetzen?
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.