Angebot in Auftrag umwandeln
jtl_angebot_in_auftrag
Was das Tool macht
Erzeugt aus einem Angebot einen Auftrag mit denselben Positionen, Preisen und Adressen - mit Vorschau und Backup-Eintrag. Mit rueckhaltegrund wird der neue Auftrag direkt danach zurückgehalten; ohne kann er sofort in den Versand laufen. Braucht JTL-Wawi ab 2.2. Nutze dieses Tool für 'Wandle Angebot AN-512015 in einen Auftrag um und halte ihn zurück'. Der Auftrag lässt sich nicht löschen, nur stornieren (jtl_auftrag_stornieren). 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) |
| rueckhaltegrundoptional | Rückhaltegrund (Name wie in JTL) für den neuen Auftrag |
| 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.
- 2Findet das Angebot per Nummer und liest es vollständig; ein storniertes ist gesperrt.
- 3Ein Rückhaltegrund wird per Name gegen die JTL-Liste aufgelöst; ohne ihn warnt die Vorschau und nennt die verfügbaren Gründe.
- 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.
- 5Schritt 1: POST /v2/sales-quotations/{guid}/sales-order - JTL legt den Auftrag mit den Positionen, Preisen und Adressen des Angebots an.
- 6Schritt 2 (nur mit rueckhaltegrund): PATCH /v2/sales-orders/{guid} setzt den Rückhaltegrund.
- 7Danach wird der neue Auftrag gelesen: Auftragsnummer, Rückhaltegrund, Anzahl Positionen und Nettosumme werden mit der Erwartung verglichen.
Annahmen und Grenzen
- Braucht JTL-Wawi ab 2.2.
- Zwischen Anlegen und Rückhalt liegt ein kurzer Moment ohne Rückhalt.
- Der Auftrag lässt sich nicht löschen, nur stornieren. Was mit dem Angebot danach geschieht (Status), bestimmt 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: Aus Angebot AN-512015 (Kunde 4005 - KOMSA GmbH, 3 Positionen, 694,50 € netto) entsteht ein Auftrag mit Rückhaltegrund „B2B Auftrag. Manuell freigeben“. Der Auftrag lässt sich nicht löschen, nur stornieren. Soll ich das Angebot in einen Auftrag umwandeln?
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.