Artikelstammdaten ändern
jtl_artikel_stammdaten_aendern
Was das Tool macht
Ändert Stammdaten eines Artikels: Anmerkung, Suchbegriffe, Herkunftsland, Zolltarifnummer, Kennungen (GTIN, Herstellernummer, ISBN, UPC), Warengruppe, Hersteller, Versand- und Steuerklasse (jeweils per Name), Beschaffungszeit, Mindestbestand, Puffer, Sortiernummer und Schalter wie Negativbestand oder Preisliste - mit Vorschau, Backup und Rückgängig-Funktion. Nutze dieses Tool für 'Setze die Zolltarifnummer von SKU X', 'Verschiebe Y in die Warengruppe Z', 'GTIN für Artikel A eintragen'. 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) |
| anmerkungoptional | Interne Anmerkung - weglassen = unverändert, null = leeren |
| suchbegriffeoptional | Suchbegriffe - weglassen = unverändert, null = leeren |
| herkunftslandIsooptional | Herkunftsland als ISO-Code, z.B. CN - weglassen = unverändert, null = leeren |
| zolltarifnummeroptional | Zolltarifnummer (TARIC) - weglassen = unverändert, null = leeren |
| gtinoptional | GTIN / EAN - weglassen = unverändert, null = leeren |
| herstellernummeroptional | Herstellernummer (HAN) - weglassen = unverändert, null = leeren |
| isbnoptional | ISBN - weglassen = unverändert, null = leeren |
| upcoptional | UPC - weglassen = unverändert, null = leeren |
| eigeneKennungoptional | Eigene Kennung - weglassen = unverändert, null = leeren |
| warengruppeoptional | Warengruppe - Name wie in JTL (kein Id); weglassen = unverändert |
| herstelleroptional | Hersteller - Name wie in JTL (kein Id); weglassen = unverändert |
| versandklasseoptional | Versandklasse - Name wie in JTL (kein Id); weglassen = unverändert |
| steuerklasseoptional | Steuerklasse - Name wie in JTL (kein Id); weglassen = unverändert |
| beschaffungszeitTageoptional | Beschaffungszeit in Tagen - weglassen = unverändert |
| mindestbestandoptional | Globaler Mindestbestand - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| pufferoptional | Puffer - weglassen = unverändert |
| sortiernummeroptional | Sortiernummer - weglassen = unverändert |
| negativbestandErlaubtoptional | Negativbestand erlauben - weglassen = unverändert |
| preislisteAktivoptional | In Preisliste aufnehmen - weglassen = unverändert |
| rabatteIgnorierenoptional | Rabatte ignorieren - weglassen = unverändert |
| workflowsAuslassenoptional | true = automatische JTL-Workflows für diese Änderung nicht auslösen (Default false). |
| 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 den Artikel exakt per SKU, dazu die Namen von Warengruppe, Hersteller, Versand- und Steuerklasse aus den JTL-Stammdatenlisten (60 Minuten zwischengespeichert), damit die Vorschau Namen statt Ids zeigt.
- 3Verwaltet werden Anmerkung, Suchbegriffe, Herkunftsland, Zolltarifnummer, Kennungen (GTIN, Herstellernummer, ISBN, UPC, eigene Kennung), Beschaffungszeit, Mindestbestand, Puffer, Sortiernummer und drei Schalter.
- 4Warengruppe, Hersteller, Versand- und Steuerklasse werden per Name aufgelöst (exakt oder eindeutiger Namensanfang); unbekannte oder mehrdeutige Namen brechen mit einer Auswahlliste ab. Textfelder leert null.
- 5Ändert sich nichts, endet der Aufruf als „keine Änderung“. Warnungen gibt es bei aktiv gelisteten Artikeln und bei einer neuen Steuerklasse, weil sie die Bruttopreise aller Kanäle verändert.
- 6Ohne 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.
- 7Geschrieben wird per PATCH auf den Artikel: Einzelfelder nur bei Angabe, die Blöcke Kennungen (inklusive vorhandener ASINs) und Lageroptionen dagegen immer vollständig; auf Wunsch ohne JTL-Workflows.
- 8Danach wird der Artikel erneut gelesen, der tatsächliche Stand mit dem erwarteten verglichen und das Protokoll mit Vorher/Nachher, Abweichungen und backupId abgeschlossen.
Annahmen und Grenzen
- Mindestbestand, Puffer und Beschaffungszeit lassen sich nicht leeren, nur auf 0 setzen; weitere Lageroptionen wie Seriennummernpflicht gehen mit dem bestehenden Wert mit und werden nicht geändert.
- Preise, Texte, Maße und Freifelder haben eigene Tools; Bestände, Kategorien und Bilder ändert kein Tool.
- 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.
- Der Vorgang lässt sich per jtl_aenderung_wiederherstellen zurücknehmen; das Änderungsprotokoll wird 12 Monate aufbewahrt.
So sieht eine Antwort aus
Vorschau für SKU 100234 – noch nichts geändert: • Zolltarifnummer: (leer) → 85076000 • Herkunftsland: (leer) → CN Soll ich beide Felder so eintragen?
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.