Artikelbild hochladen
jtl_artikel_bild_hochladen
Was das Tool macht
Lädt ein neues Bild zu einem Artikel hoch (JPEG, PNG, GIF, WebP, max. 8 MB) und hängt es hinten an; auf Wunsch wird es Hauptbild. JTL verteilt es selbst auf die Bildkanäle. Mit Vorschau und Protokoll. Nutze dieses Tool für 'Lade dieses Bild zu SKU X hoch', 'Setze das Bild von dieser URL als Hauptbild von Y'. Rückgängig geht mit jtl_artikel_bild_loeschen. 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) |
| 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) |
| alsHauptbildoptional | true = das Bild wird Position 1 (Default: hinten anhängen) |
| 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 das Bild aus Base64 oder von einer öffentlichen URL (mit Sperre für interne Adressen) und prüft Typ (JPEG, PNG, GIF, WebP) und Größe (max. 8 MB).
- 3Liest den Artikel und die Reihenfolge seiner Bilder. Die Vorschau zeigt die neue Reihenfolge; ein Hash bindet die Bestätigung an genau dieses Bild.
- 4Die Bilddaten selbst landen nicht im Protokoll, nur Name und Hash.
- 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 auf items/{id}/images im Wawi-Kanal; JTL verteilt das Bild selbst auf die Bildkanäle. Mit alsHauptbild wird es danach auf Position 1 gesetzt.
- 8Danach wird der Stand erneut gelesen, mit dem erwarteten verglichen und das Protokoll mit Vorher/Nachher, Abweichungen und backupId abgeschlossen.
Annahmen und Grenzen
- Ist genau dieses Bild schon am Artikel, legt JTL kein zweites an.
- Nicht automatisch rückgängig machbar; das Bild lässt sich mit jtl_artikel_bild_loeschen entfernen.
- 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: Neues Bild powerbank-lifestyle.jpg (412 KB) wird Bild 4. JTL verteilt es selbst auf die Bildkanäle. Soll ich es hochladen?
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.