Angebot ändern
jtl_angebot_aendern
Was das Tool macht
Ändert ein bestehendes Angebot: Kommentare, Drucktext, externe Nummer, Versandart, Zahlungsart, Zahlungsziel, Skonto, Liefertermin, Adressen sowie Positionen (hinzufügen, ändern über die Positionsnummer aus jtl_angebote, entfernen) und Versandkosten - mit Vorschau und Backup. Nicht genannte Felder und Positionen bleiben unverändert. Kopf-Änderungen lassen sich rückgängig machen, Positions-Änderungen nicht automatisch. Braucht JTL-Wawi ab 2.2. Nutze dieses Tool für 'Ändere in AN-512015 die Menge von Position 2 auf 50', 'Füge dem Angebot 10x SKU X hinzu', 'Setze das Zahlungsziel auf 30 Tage'. 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) |
| kommentaroptional | Interner Kommentar - weglassen = unverändert, null = leeren |
| kundenkommentaroptional | Kundenkommentar - weglassen = unverändert, null = leeren |
| drucktextoptional | Drucktext - weglassen = unverändert, null = leeren |
| externeNummeroptional | Externe Angebotsnummer - weglassen = unverändert, null = leeren |
| versandartoptional | Versandart - Name wie in JTL (kein Id); weglassen = unverändert |
| zahlungsartoptional | Zahlungsart - Name wie in JTL (kein Id); weglassen = unverändert |
| zahlungszielTageoptional | Zahlungsziel in Tagen - weglassen = unverändert |
| skontoProzentoptional | Skonto in Prozent - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| skontoTageoptional | Skontofrist in Tagen - weglassen = unverändert |
| lieferterminoptional | Geplanter Liefertermin als Datum JJJJ-MM-TT - weglassen = unverändert, null = leeren |
| rechnungsadresseoptional | Ohne Beschreibung |
| lieferadresseoptional | Ohne Beschreibung |
| positionenHinzufuegenoptional | Neue Positionen - werden hinten angefügt |
| positionenAendernoptional | Ohne Beschreibung |
| positionenEntfernenoptional | Positionsnummern, die entfernt werden |
| versandkostenNettooptional | Versandkosten netto - ändert die Versandposition oder legt sie an - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| 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 über REST v2; ein storniertes Angebot ist gesperrt.
- 3Kopffelder (Texte, externe Nummer, Versandart, Zahlungsart, Zahlungsziel, Skonto, Liefertermin, Adressen) gehen als Teil-Änderung: JTL übernimmt nur genannte Felder.
- 4Bei Positions-Änderungen geht die Positionsliste immer vollständig, weil JTL sie ersetzt: unveränderte Positionen nur mit ihrer Id, geänderte mit Id und den neuen Feldern, entfernte fehlen, neue stehen hinten. Neue Artikelpositionen rechnet JTL vorher über sales-orders/calculate.
- 5Versandkosten ändern den Betrag der Versandposition oder legen sie an (Steuersatz = höchster Satz der Warenpositionen).
- 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 /v2/sales-quotations/{guid}; danach wird das Angebot erneut gelesen und verglichen.
Annahmen und Grenzen
- Braucht JTL-Wawi ab 2.2.
- Kopf-Änderungen sind rückgängig machbar, Positions-Änderungen nicht automatisch.
- Die Positionsnummer ist die Stelle in der Liste laut jtl_angebote - nach einer Änderung kann sie sich verschieben.
- 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: • Position 2: Menge 50 → 80 • Neue Position 3: 10 × 464448 zum Kundenpreis 4,99 € netto • Zahlungsziel: 45 → 30 Tage Alle anderen Positionen und Felder bleiben unverändert. Soll ich das Angebot ändern?
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.