Artikelpreise ändern
jtl_artikel_preise_aendern
Was das Tool macht
Ändert Verkaufspreis netto, UVP, Einkaufspreis netto, eBay- oder Amazon-Preis eines Artikels mit Vorschau, Backup und Rückgängig-Funktion. Nur angegebene Preise werden geändert. Warnt bei Abweichungen über 10 %. Nutze dieses Tool für 'Setze den VK von SKU X auf 24,90', 'Ändere die UVP von Y', 'Neuer EK für Artikel Z'. 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) |
| verkaufspreisNettooptional | Verkaufspreis netto - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| uvpoptional | Unverbindliche Preisempfehlung (wie in JTL gepflegt) - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| ekNettooptional | Einkaufspreis netto - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| ebayPreisoptional | eBay-Preis - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| amazonPreisoptional | Amazon-Preis - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| 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: Suche in der REST-v1.3-Artikelliste, Übernahme nur bei genau gleicher SKU (Groß-/Kleinschreibung egal), dann der vollständige Datensatz als Sicherungs-Snapshot.
- 3Verglichen werden fünf Preisfelder: Verkaufspreis netto, UVP, Einkaufspreis netto, eBay- und Amazon-Preis. Nur angegebene Preise ändern sich; mindestens einer ist Pflicht, negative Werte und Leeren sind nicht erlaubt.
- 4Ändert sich rechnerisch nichts, endet der Aufruf ohne Token als „keine Änderung“. Weicht ein neuer Preis um mehr als 10 % vom alten ab oder ist der Artikel aktiv in Verkaufskanälen gelistet, warnt die Vorschau.
- 5Ohne 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.
- 6Beim 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.
- 7Geschrieben wird per PATCH auf den Artikel: der komplette Preisblock (ItemPriceData) mit bestehenden Werten plus Änderungen; auf Wunsch ohne automatische 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
- Kundengruppen-, Sonder- und Kanalpreise bleiben unberührt; alle Preise sind netto außer der UVP, so wie JTL sie führt.
- 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 Rück-Payload enthält den vollständigen alten Preisblock, damit sich der Vorgang per jtl_aenderung_wiederherstellen zurücknehmen lässt.
- Lehnt JTL die Änderung ab, bleibt der Vorgang als fehlgeschlagen im Protokoll; das Änderungsprotokoll wird 12 Monate aufbewahrt und danach automatisch gelöscht.
So sieht eine Antwort aus
Vorschau für Powerbank Compact 10000mAh, schwarz (SKU 100234) – noch nichts geändert: • Verkaufspreis netto: 24,90 € → 22,90 € • UVP bleibt bei 34,90 € Hinweis: Der Artikel ist aktiv und in zwei Verkaufskanälen gelistet, die Änderung wirkt sofort nach außen. Soll ich den Preis so schreiben? Der alte Stand wird vorher gesichert und lässt sich jederzeit wiederherstellen.
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.