Kunde anlegen
jtl_kunde_anlegen
Was das Tool macht
Legt einen neuen Kunden in JTL an - mit Vorschau und Backup-Eintrag. Pflicht sind Kundengruppe (per Name) und eine Rechnungsadresse mit Ort und Land; Kundennummer optional (sonst vergibt JTL sie), Lieferadresse, Sprache, USt-IdNr. und Zahlungsart optional. Nutze dieses Tool für 'Lege den Kunden Muster GmbH in Augsburg als Händler an'. 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
| kundengruppePflicht | Kundengruppe (Name wie in JTL) |
| kundennummeroptional | Gewünschte Kundennummer - leer = JTL vergibt sie |
| rechnungsadresseoptional | Ohne Beschreibung |
| lieferadresseoptional | Ohne Beschreibung |
| spracheIsooptional | Sprache als ISO-Code, Default DE |
| ustIdoptional | Ohne Beschreibung |
| zahlungsartoptional | Zahlungsart - Name wie in JTL (kein Id); weglassen = unverändert |
| firmaoptional | JTL-Firma (Mandant), falls mehrere - sonst die erste - 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.
- 2Ist eine Kundennummer angegeben, wird sie exakt in JTL gesucht; existiert der Kunde, endet der Aufruf mit „existiert bereits“. Ohne Nummer entfällt die Prüfung und JTL vergibt die nächste freie Nummer.
- 3Pflicht sind Kundengruppe (per Name) und eine Rechnungsadresse mit Ort, Land und Firma oder Nachname; optional Lieferadresse, Sprache (Default DE), USt-IdNr. und Zahlungsart per Name.
- 4Die JTL-Firma (Mandant) kommt per Name oder ist die erste der Firmenliste; ohne Firma ist kein Anlegen möglich. Ländercodes werden großgeschrieben, die Lieferadresse erbt ohne eigenes Land das der Rechnungsadresse.
- 5Ohne Bestätigung endet der Aufruf als Vorschau mit einmaligem Token (15 Minuten, an die Eingaben gebunden); sie nennt die Firma, in der der Kunde entsteht, und warnt, dass er über das Tool nicht löschbar ist.
- 6Der scharfe Aufruf löst den Token ein, verbraucht Tageslimit und Schreibkontingent, legt den Backup-Datensatz an und sendet den Kunden per POST; Adressen gehen mit allen 17 Feldern, nicht angegebene leer.
- 7Anschließend wird der neue Kunde über die von JTL gelieferte Id (ersatzweise per Kundennummer) gelesen und im Protokoll als Nachher-Stand gespeichert.
Annahmen und Grenzen
- Ansprechpartner, weitere Lieferadressen, Freifelder, Notizen, Zahlungsziel, Rabatt und Kreditlimit werden beim Anlegen nicht gesetzt; sie lassen sich danach mit jtl_kunde_aendern pflegen.
- Der Vorgang lässt sich nicht automatisch rückgängig machen; Rückgängig nur direkt 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 Kunde „Beispiel Handel GmbH“, Musterweg 5, 86150 Augsburg (DE), Kundengruppe Händler, Sprache DE. Die Kundennummer vergibt JTL. Soll ich den Kunden so anlegen?
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.