Kunde ändern
jtl_kunde_aendern
Was das Tool macht
Ändert Stammdaten eines Kunden: Kundengruppe und Zahlungsart (per Name), Sprache, USt-IdNr., Webseite, Handelsregisternummer, Zahlungsziel, Rabatt, Kreditlimit, Sperre sowie Rechnungs- und Lieferadresse - mit Vorschau, Backup und Rückgängig-Funktion. Nur angegebene Felder werden geändert; Adressen werden feldweise zusammengeführt. Nutze dieses Tool für 'Ändere die Rechnungsadresse von Kunde K-123', 'Setze Kunde X auf Kundengruppe Händler', 'Neue E-Mail für Kunde Y'. 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
| kundennummerPflicht | JTL-Kundennummer (exakt) |
| kundengruppeoptional | Kundengruppe - Name wie in JTL (kein Id); weglassen = unverändert |
| zahlungsartoptional | Zahlungsart - Name wie in JTL (kein Id); weglassen = unverändert |
| spracheIsooptional | Sprache als ISO-Code, z.B. DE - weglassen = unverändert, null = leeren |
| ustIdoptional | USt-IdNr. - weglassen = unverändert, null = leeren |
| webseiteoptional | Webseite - weglassen = unverändert, null = leeren |
| handelsregisternummeroptional | Handelsregisternummer - weglassen = unverändert, null = leeren |
| erstkontaktoptional | Erstkontakt / Herkunft - weglassen = unverändert, null = leeren |
| ebayNameoptional | eBay-Name - weglassen = unverändert, null = leeren |
| zahlungszielTageoptional | Zahlungsziel in Tagen - weglassen = unverändert |
| rabattProzentoptional | Kundenrabatt in Prozent - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| kreditlimitoptional | Kreditlimit - weglassen = unverändert |
| gesperrtoptional | Kunde für den Shop sperren - weglassen = unverändert |
| rechnungsadresseoptional | Ohne Beschreibung |
| lieferadresseoptional | Ohne Beschreibung |
| 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 Kunden exakt per Kundennummer aus der REST-v1.3-Kundenliste (nur bei genau gleicher Nummer), dann den vollständigen Datensatz; Kundengruppe und Zahlungsart werden als Namen aufgelöst.
- 3Verwaltet werden Sprache, USt-IdNr., Webseite, Handelsregisternummer, Erstkontakt, eBay-Name, Sperre, Kundengruppe und Zahlungsart per Name, Zahlungsziel, Rabatt, Kreditlimit sowie Rechnungs- und Lieferadresse.
- 4Adressen werden feldweise zusammengeführt: 17 Felder je Adresse, angegebene Felder ersetzen, null leert, alles andere bleibt. Der Sprachcode wird großgeschrieben, negativer Rabatt abgelehnt.
- 5Ändert sich nichts, endet der Aufruf als „keine Änderung“. Warnungen gibt es bei einer Sperre (kein Bestellen im Shop) und bei neuer Kundengruppe (kann Preise und Rabatte verändern).
- 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 Kunden: Einzelfelder nur bei Angabe, Zahlungseinstellungen und Adressen als vollständige Blöcke (Bestand plus Änderung); auf Wunsch ohne JTL-Workflows.
- 8Danach wird der Kunde erneut gelesen, der tatsächliche Stand mit dem erwarteten verglichen und das Protokoll mit Vorher/Nachher, Abweichungen und backupId abgeschlossen.
Annahmen und Grenzen
- Ansprechpartner, zusätzliche Lieferadressen, Freifelder und Notizen werden nicht geändert; Freifeld und Notiz haben eigene Tools.
- Sobald Zahlungsart, Zahlungsziel, Rabatt oder Kreditlimit gesetzt wird, geht der Block Zahlungseinstellungen komplett an JTL, inklusive des bestehenden Kennzeichens StopPaymentRequest.
- 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 Kunde K-17650 (Muster Handels GmbH) – noch nichts geändert: • Rechnungsadresse Straße: Hauptstraße 1 → Industriepark 12 • Rechnungsadresse PLZ: 86150 → 86167 • Alle anderen Adressfelder bleiben gleich. Soll ich die Adresse so übernehmen?
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.