Artikel anlegen
jtl_artikel_anlegen
Was das Tool macht
Legt einen neuen Artikel in JTL an - mit Vorschau und Backup-Eintrag. Pflicht sind SKU und Name; Preise, Maße, Kennungen, Warengruppe, Hersteller, Versand- und Steuerklasse (per Name) sind optional. Existiert die SKU bereits, wird nichts angelegt. Nutze dieses Tool für 'Lege den Artikel X mit SKU Y an'. Ein angelegter Artikel lässt sich per API nicht löschen, nur deaktivieren - deshalb die Vorschau besonders sorgfältig bestätigen lassen. 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 | Neue Artikelnummer / SKU |
| namePflicht | Artikelname |
| kurzbeschreibungoptional | Ohne Beschreibung |
| beschreibungoptional | Ohne Beschreibung |
| verkaufspreisNettooptional | Verkaufspreis netto - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| uvpoptional | UVP - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| ekNettooptional | Einkaufspreis netto - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| laengeCmoptional | Länge in cm - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| breiteCmoptional | Breite in cm - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| hoeheCmoptional | Höhe in cm - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| gewichtKgoptional | Artikelgewicht in kg - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| versandgewichtKgoptional | Versandgewicht in kg - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| gtinoptional | Ohne Beschreibung |
| herstellernummeroptional | Ohne Beschreibung |
| zolltarifnummeroptional | Ohne Beschreibung |
| herkunftslandIsooptional | Ohne Beschreibung |
| anmerkungoptional | Ohne Beschreibung |
| 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 |
| 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.
- 2Sucht die neue SKU exakt in der REST-v1.3-Artikelliste; gibt es den Artikel schon, endet der Aufruf mit „existiert bereits“ und legt nichts an.
- 3Pflicht sind SKU und Name; optional Kurz- und Langbeschreibung, drei Preise, Maße, Gewichte, GTIN, Herstellernummer, Zolltarifnummer, Herkunftsland (wird großgeschrieben), Anmerkung sowie vier Zuordnungen per Name.
- 4Warengruppe, Hersteller, Versand- und Steuerklasse werden gegen die JTL-Stammdatenlisten aufgelöst (exakt oder eindeutiger Namensanfang). Negative Zahlen werden abgelehnt; die Vorschau zeigt alle gesetzten Felder.
- 5Ohne Bestätigung endet der Aufruf als Vorschau mit einmaligem Token (15 Minuten, an die Eingaben gebunden); sie warnt, dass der Artikel per API nicht löschbar ist und ohne Steuerklasse der JTL-Standard greift.
- 6Der scharfe Aufruf löst den Token ein, verbraucht Tageslimit und Schreibkontingent, legt den Backup-Datensatz an und sendet den Artikel per POST an JTL (Kategorienliste leer); auf Wunsch ohne JTL-Workflows.
- 7Anschließend wird der neue Artikel über die von JTL gelieferte Id (ersatzweise per SKU) inklusive Stammdatennamen gelesen und im Protokoll als Nachher-Stand gespeichert.
Annahmen und Grenzen
- Bestände, Lagerplätze, Kategorien, Bilder, Freifelder und Kanalzuordnungen werden nicht angelegt; eBay- und Amazon-Preis lassen sich beim Anlegen nicht setzen.
- Der Vorgang lässt sich nicht automatisch rückgängig machen; Rückgängig bedeutet Deaktivieren in JTL.
- 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 100310 „Powerbank Compact 10000mAh, blau“ in der Warengruppe Power – Powerbanks, Verkaufspreis 24,90 € netto, UVP 34,90 €, EK 11,40 €, 210 g. Wichtig: Ein angelegter Artikel lässt sich per API nicht löschen, nur deaktivieren. Soll ich ihn so anlegen?
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.