Kundennotiz anlegen
jtl_kunde_notiz_anlegen
Was das Tool macht
Hängt eine interne Notiz an einen Kunden an (JTL-Notizen am Kundenstamm) - mit Vorschau und Backup-Eintrag. Bestehende Notizen bleiben unverändert. Nutze dieses Tool für 'Notiere bei Kunde K-123: Rückruf am Montag vereinbart'. 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) |
| textPflicht | Notiztext |
| 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 und dazu seine bestehenden Notizen; als Ist-Stand gelten die Anzahl der Notizen und der Text der letzten Notiz.
- 3Der Notiztext wird getrimmt (1 bis 4.000 Zeichen); die Vorschau zeigt als Nachher-Stand die um eins erhöhte Anzahl und den neuen Text als letzte Notiz.
- 4Ohne Bestätigung endet der Aufruf als Vorschau mit einem einmaligen Token, 15 Minuten gültig und an Verbindung, Tool, Kunde, Text und die gelesenen Notizen gebunden.
- 5Beim scharfen Aufruf wird der Token eingelöst; weichen Text oder Notizstand inzwischen ab, wird abgelehnt. Dann werden Tageslimit und Schreibkontingent verbraucht und ein Backup-Datensatz angelegt.
- 6Die Notiz geht per POST an die Kundennotizen (customers/{id}/notes); danach werden die Notizen erneut gelesen und Abweichungen bei Anzahl oder letztem Text im Ergebnis gemeldet.
Annahmen und Grenzen
- Bestehende Notizen bleiben unverändert; Notizen lassen sich über KI User nicht löschen oder bearbeiten, Rückgängig nur direkt in JTL.
- Der Vorgang zählt als Kundenänderung: in der Einführungsphase 3 Schreibvorgänge je Entität und Tag, dazu das Schreibkontingent des Plans.
- Das Änderungsprotokoll wird 12 Monate aufbewahrt und danach automatisch gelöscht.
So sieht eine Antwort aus
Vorschau für Kunde K-17650 – noch nichts angelegt: Neue Notiz: „Rückruf am Montag vereinbart, Interesse an Powerbank-Serie.“ Bisher 3 Notizen am Kunden. Soll ich die Notiz so anlegen?
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.