Artikel-Lieferant ändern
jtl_artikel_lieferant_aendern
Was das Tool macht
Ordnet einem Artikel einen Lieferanten zu (per Lieferantennummer oder Name), ändert dessen Artikeldaten (Lieferanten-Artikelnummer, EK, Lieferzeit, Mindestabnahme, Dropshipping, Notiz, Standardlieferant) oder entfernt ihn - mit Vorschau, Backup und Rückgängig-Funktion. Nutze dieses Tool für 'Ordne SKU X den Lieferanten 102 zu', 'Neuer EK bei Lieferant Y: 12,50', 'Entferne Lieferant Z von Artikel A'. 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) |
| lieferantPflicht | Lieferantennummer oder Name |
| artikelnummerLieferantoptional | Artikelnummer beim Lieferanten |
| artikelnameLieferantoptional | Artikelname beim Lieferanten |
| ekNettooptional | Einkaufspreis netto bei diesem Lieferanten - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| lieferzeitTageoptional | Lieferzeit in Tagen |
| mindestabnahmeoptional | Mindestabnahme |
| dropshippingoptional | Dropshipping aktiv |
| notizoptional | Notiz zum Lieferanten am Artikel |
| alsStandardoptional | true = wird Standardlieferant |
| entfernenoptional | true = Zuordnung entfernen |
| 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 und seine Lieferanten und löst den Lieferanten per Lieferantennummer oder Name auf (Liste aus REST v2).
- 3Ist er noch nicht zugeordnet, wird er hinzugefügt, sonst werden nur die angegebenen Felder geändert; entfernen=true nimmt die Zuordnung weg. Der erste Lieferant wird automatisch Standardlieferant.
- 4Ohne Bestätigung endet der Aufruf als Vorschau mit Vorher/Nachher und einem einmaligen Token, 15 Minuten gültig und an Verbindung, Tool, Artikel, Eingaben und den gelesenen Ist-Stand gebunden.
- 5Beim scharfen Aufruf wird der Token eingelöst; weichen Eingaben oder der Stand in JTL inzwischen ab, wird abgelehnt. Dann werden Tageslimit und Schreibkontingent verbraucht und ein Backup-Datensatz angelegt.
- 6Geschrieben wird per GraphQL (AddItemSupplier, ChangeItem), weil REST POST und PATCH auf Wawi 2.0.5 an der Validierung scheitern; Entfernen läuft per REST DELETE.
- 7Danach wird der Stand erneut gelesen, mit dem erwarteten verglichen und das Protokoll mit Vorher/Nachher, Abweichungen und backupId abgeschlossen.
Annahmen und Grenzen
- Staffelpreise des Lieferanten pflegt das Tool nicht und stellt sie beim Rückgängigmachen nicht wieder her.
- Beim Ändern geht immer die vollständige Lieferantenliste an JTL, weil fehlende Lieferanten sonst entfernt würden; ihre Daten und Staffelpreise bleiben erhalten.
- 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.
So sieht eine Antwort aus
Vorschau für SKU 100234 – noch nichts geändert: Lieferant Muster Trading wird zugeordnet: Artikelnummer MT-4411, EK 11,40 €, Lieferzeit 30 Tage. Als erster Lieferant wird er automatisch Standardlieferant. Soll ich ihn so zuordnen?
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.