Angebot stornieren
jtl_angebot_stornieren
Was das Tool macht
Storniert ein Angebot mit einem Stornogrund (Name wie in JTL) - mit Vorschau und Backup-Eintrag. Nicht umkehrbar. Braucht JTL-Wawi ab 2.2. Nutze dieses Tool für 'Storniere Angebot AN-512015, Kunde hat abgesagt'. 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
| angebotsnummerPflicht | Angebotsnummer (exakt) |
| stornogrundPflicht | Stornogrund (Name wie in JTL) |
| kommentaroptional | Kommentar zum Storno |
| 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.
- 2Findet das Angebot per Nummer; ein bereits storniertes ist gesperrt.
- 3Der Stornogrund wird per Name gegen die JTL-Liste aufgelöst; verlangt er einen Kommentar, ist der Kommentar Pflicht.
- 4Ohne 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.
- 5Geschrieben wird per POST /v2/sales-quotations/{guid}/cancel; danach wird das Storno-Kennzeichen geprüft.
Annahmen und Grenzen
- Braucht JTL-Wawi ab 2.2.
- Nicht umkehrbar.
- 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 für Angebot AN-512015 – noch nichts geändert: Storno mit Grund „Käuferstorno“. Ein Storno lässt sich nicht rückgängig machen. Soll ich das Angebot stornieren?
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.