Angebot anlegen
jtl_angebot_anlegen
Was das Tool macht
Legt ein neues Angebot für einen bestehenden Kunden an - mit Vorschau und Backup-Eintrag. Pflicht sind Kundennummer und mindestens eine Position (Artikel per SKU oder freie Position). Preise, Kundenrabatt und Steuersätze der Artikel rechnet JTL (Preis des Kunden, sofern kein preisNetto angegeben ist); Adressen kommen vom Kunden, sofern nichts anderes angegeben ist. Optional: Versandart, Versandkosten, Zahlungsart, Zahlungsziel, Skonto, Liefertermin, externe Nummer, Kommentare, Drucktext. Braucht JTL-Wawi ab 2.2. Nutze dieses Tool für 'Erstelle für Kunde 4005 ein Angebot über 100x SKU X zu 4,50'. Weiter mit jtl_angebot_aendern oder jtl_angebot_in_auftrag. 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 | Kundennummer (exakt) |
| positionenPflicht | Positionen in der gewünschten Reihenfolge |
| versandkostenNettooptional | Versandkosten netto - legt eine Versandposition an - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| externeNummeroptional | Externe Angebotsnummer / Anfragenummer des Kunden |
| kommentaroptional | Interner Kommentar |
| kundenkommentaroptional | Kundenkommentar |
| drucktextoptional | Text, der auf dem Angebot gedruckt wird |
| 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 |
| 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 den Kunden exakt per Kundennummer (GUID per GraphQL, Adressen und USt-IdNr. aus REST v1.3). Adressen kommen vom Kunden, sofern nichts anderes angegeben ist; Straße, Ort und Land sind Pflicht.
- 3Firma, eigene USt-IdNr., Abgangsland und Währung stammen aus der Auftragsvorlage von JTL (sales-orders/new).
- 4Artikel werden exakt per SKU gefunden. Preis, Kundenrabatt und Steuersatz jeder Artikelposition rechnet JTL über sales-orders/calculate (Preis des Kunden, sofern kein preisNetto angegeben ist; Steuersatz nach Lieferland).
- 5Freie Positionen brauchen Bezeichnung, Nettopreis und Steuersatz. Versandkosten: der angegebene Betrag, sonst der von JTL für die Versandart berechnete; 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 POST /v2/sales-quotations mit vollständigen Positionen (Name, SKU, Preis, Rabatt, Steuersatz, Steuerklasse) - JTL füllt eine Position bei diesem Aufruf nicht selbst aus dem Artikel.
- 8Danach wird das Angebot gelesen und mit der Erwartung verglichen; die Summen rechnet JTL.
Annahmen und Grenzen
- Braucht JTL-Wawi ab 2.2.
- Ein Angebot lässt sich nicht löschen, nur stornieren.
- Stücklisten-, Konfigurations- und Variationspositionen sowie Gutscheine legt das Tool nicht an.
- 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 ein neues Angebot – noch nichts angelegt: Kunde 4005 - KOMSA GmbH, Versandart Palettenversand, Zahlungsziel 45 Tage. • Position 1: 100 × 541908 zu 4,50 € netto, 19 % • Position 2: 50 × 541564 zum Kundenpreis 4,69 € netto, 19 % Preise und Steuersätze hat JTL berechnet. Soll ich das Angebot anlegen?
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.