Artikel in einem Verkaufskanal aktivieren oder deaktivieren
jtl_artikel_kanal_aktivieren
Was das Tool macht
Aktiviert einen Artikel in einem Onlineshop-Verkaufskanal (aktiv=true) oder nimmt ihn dort heraus (aktiv=false) - mit Vorschau, Backup und Rückgängig-Funktion. Achtung: Ein aktivierter Artikel wird beim nächsten Abgleich in den Shop übertragen und ist dort sichtbar. Braucht JTL-Wawi ab 2.2. Nutze dieses Tool für 'Schalte SKU X im B2B Onlineshop frei', 'Nimm Y aus dem Shop'. 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) |
| kanalPflicht | Verkaufskanal per Name, z.B. JTL-Shop: B2B Onlineshop |
| aktivPflicht | true = aktivieren, false = deaktivieren |
| bilderUebernehmenoptional | Beim Aktivieren die Artikelbilder für den Kanal übernehmen (Default true) |
| 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 und liest seine aktiven Verkaufskanäle (ActiveSalesChannels aus REST v1.3), aufgelöst zu Kanalnamen.
- 3Der Kanal wird per Name aufgelöst; aktivierbar sind nur Kanäle, die REST v2 (sales-channels) mit onlineShopActivation meldet. Ist der Artikel dort bereits im gewünschten Zustand, ist der Aufruf gesperrt.
- 4Ohne 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.
- 5Geschrieben wird per POST /v2/items/{guid}/sales-channels/{kanal}/activate bzw. /deactivate; beim Aktivieren steuert bilderUebernehmen, ob die Artikelbilder für den Kanal übernommen werden.
- 6Danach wird der Artikel erneut gelesen und die Liste der aktiven Kanäle verglichen. Rückgängig führt den Gegenschritt aus.
Annahmen und Grenzen
- Die Übertragung in den Shop macht der JTL-Abgleich, nicht dieses Tool - sichtbar wird die Änderung erst danach.
- Marktplätze (Amazon, eBay) lassen sich so nicht aktivieren. Einzelne Shop-Kanäle lehnt JTL trotz gemeldeter Fähigkeit mit „not found“ ab (bei 4smarts: TESTshop).
- Braucht JTL-Wawi ab 2.2.
- 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 541908 – noch nichts geändert: Aktive Kanäle: JTL-Shop: B2B Onlineshop → JTL-Shop: B2B Onlineshop, Connector-Shop: Bilder-Kategorie. Der Artikel wird beim nächsten Abgleich in den Kanal übertragen und ist dort sichtbar. Soll ich ihn aktivieren?
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.