Artikel duplizieren
jtl_artikel_duplizieren
Was das Tool macht
Legt einen neuen Artikel als Kopie eines bestehenden an - mit neuer SKU und neuem Namen, mit Vorschau und Backup-Eintrag. Übernommen werden standardmäßig Texte, Verkaufs- und Einkaufspreise, Merkmale, Attribute, Bilder, Freifelder, Maße, Kennungen (ohne GTIN), Stammdaten und Lieferanten; mit ohne lässt sich einzelnes ausschließen. Verkaufskanäle werden nie mitkopiert - das Duplikat steht in keinem Shop. Braucht JTL-Wawi ab 2.2. Nutze dieses Tool für 'Lege SKU Y als Kopie von X an'. Ein angelegter Artikel lässt sich per Schnittstelle nicht löschen. 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
| quelleSkuPflicht | SKU des Artikels, der kopiert wird (exakt) |
| neueSkuPflicht | SKU des neuen Artikels |
| namePflicht | Name des neuen Artikels |
| ohneoptional | Bereiche, die NICHT übernommen werden |
| mitoptional | Bereiche, die zusätzlich übernommen werden (Standard aus: sonderpreise) |
| 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 die Vorlage exakt per SKU und prüft, dass die neue SKU noch nicht vergeben ist.
- 3Aus mit/ohne entsteht die Liste der übernommenen Bereiche (Standard: alles außer Sonderpreisen). Verkaufskanäle werden nie mitkopiert.
- 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}/duplicate mit neuer SKU, neuem Namen und den Duplikat-Optionen; der Workflow „Artikel erstellt“ wird nicht ausgelöst.
- 6Danach wird der neue Artikel per SKU gelesen und SKU und Name mit der Erwartung verglichen.
Annahmen und Grenzen
- Ein angelegter Artikel lässt sich per Schnittstelle weder löschen noch deaktivieren.
- JTL kopiert die GTIN mit, auch wenn sie ausgeschlossen ist (live belegt) - am Duplikat ersetzen.
- Der Name gilt für die Standardsprache; die Namen weiterer Sprachen kommen von der Vorlage und müssen angepasst werden (jtl_artikel_sprachtexte_aendern).
- 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 – noch nichts angelegt: Neuer Artikel 541999 „Hybrid Case Ibiza für iPhone 18“ als Kopie von 541564. Übernommen werden Texte, Preise, Merkmale, Attribute, Bilder, Freifelder, Maße, Kennungen, Stammdaten und Lieferanten. Das Duplikat steht in keinem Verkaufskanal. Die GTIN der Vorlage wird mitkopiert und muss ersetzt werden. Ein angelegter Artikel lässt sich nicht löschen. Soll ich ihn anlegen?
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.