Artikel anlegen

Was das Tool macht

Legt einen neuen Artikel in JTL an - mit Vorschau und Backup-Eintrag. Pflicht sind Name und mindestens eine Kategorie (Name oder Pfad). Ohne SKU vergibt JTL die nächste Artikelnummer. Preise, Maße, Kennungen, Warengruppe, Hersteller, Versand- und Steuerklasse (per Name) und ein Lieferant (per Nummer oder Name) sind optional, ebenso Texte in weiteren Sprachen (sprachtexte), Preise je Kundengruppe auch als Staffel (staffelpreise), Merkmale (merkmale) und Attribute wie Textbausteine (attribute, per Nummer, ab Wawi 2.2). Existiert die SKU bereits, wird nichts angelegt. Nutze dieses Tool für 'Lege den Artikel X an', 'Neuer Artikel mit nächster SKU in Kategorie A und B, Lieferant 102'. Eine freie GTIN aus der JTL-Verwaltung kann die API nicht vergeben - eine GTIN muss angegeben werden. Bilder und Shop-Texte je Kanal folgen danach mit den Pflege-Tools. Ein angelegter Artikel lässt sich per API nicht löschen und nicht 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

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.

1. 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.
2. 2Sucht eine angegebene SKU exakt in der REST-v1.3-Artikelliste; gibt es den Artikel schon, endet der Aufruf mit „existiert bereits“ und legt nichts an. Ohne SKU vergibt JTL die nächste Artikelnummer, die Vorschau nennt sie voraussichtlich.
3. 3Pflicht sind Name und mindestens eine Kategorie (Name oder Pfad, mehrdeutige Namen brechen ab; fehlt sie, erklärt die Meldung auch, dass ein Client mit alter Tool-Liste neu verbunden werden muss); optional Kurz- und Langbeschreibung, drei Preise, Maße, Gewichte, GTIN, Herstellernummer, Zolltarifnummer, Herkunftsland, Anmerkung, vier Zuordnungen per Name und ein Lieferant per Nummer oder Name. Bei einer GTIN warnt die Vorschau vor falscher Prüfziffer und Dubletten.
4. 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.
5. 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.
6. 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; auf Wunsch ohne JTL-Workflows. Ein Lieferant wird danach per GraphQL zugeordnet.
7. 7Optionale Zusatzdaten werden schon in der Vorschau geprüft und aufgelöst: Sprachen müssen in JTL aktiv sein, Kundengruppen und Merkmale werden per Name gefunden, Merkmalswerte müssen existieren, Attribute werden über ihre Nummer angegeben (hinterlegte Bedeutungen zeigt die Vorschau).
8. 8Nach dem Anlegen gehen die Zusatzdaten einzeln hinterher: Texte je Sprache per POST items/{id}/descriptions (Standardkanal der Wawi), Preise je Kundengruppe und Staffel per POST items/{id}/salesChannelPrices, Merkmale per POST items/{id}/properties (alle REST v1.3), Attribute per PATCH /v2/items/{guid} (ab Wawi 2.2). Scheitert ein Schritt, bleibt der Artikel bestehen.
9. 9Anschließend wird der neue Artikel über die von JTL gelieferte Id (ersatzweise per SKU) inklusive Stammdatennamen gelesen und im Protokoll als Nachher-Stand gespeichert; angeforderte Zusatzdaten werden mitgelesen und fehlende Werte als Abweichung gemeldet.

So sieht eine Antwort aus