Auftrag anlegen

Was das Tool macht

Legt einen neuen Auftrag für einen bestehenden Kunden an - mit Vorschau und Backup-Eintrag. Pflicht sind Kundennummer und mindestens eine Position (Artikel per SKU oder freie Position mit Bezeichnung). Adressen, Zahlungsart und Zahlungsziel übernimmt JTL vom Kunden, sofern nichts anderes angegeben ist; ohne Preis gilt der Preis des Kunden laut JTL. Optional: Rückhaltegrund (der Auftrag ist dann sofort zurückgehalten), Versandart, Versandkosten, Zahlungsart, Zahlungsziel, Skonto, externe Nummer, Kommentare, Liefertermin, abweichende Rechnungs- und Lieferadresse. Nutze dieses Tool für 'Lege für Kunde 4005 einen Auftrag über 10x SKU X an und halte ihn zurück'. Ein angelegter 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

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.

1. 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.
2. 2Findet den Kunden exakt per Kundennummer und liest ihn vollständig; die JTL-Firma ist die genannte oder die erste.
3. 3Versandart, Zahlungsart und Rückhaltegrund werden per Name gegen die JTL-Listen aufgelöst (exakt oder eindeutiger Namensanfang). Ohne Rückhaltegrund warnt die Vorschau und nennt die verfügbaren Gründe.
4. 4Jede Artikelposition wird exakt per SKU gefunden; inaktive Artikel und doppelte SKUs erzeugen Warnungen. Freie Positionen (ohne SKU) brauchen Bezeichnung, Nettopreis und Steuersatz.
5. 5Gibt es zur externen Nummer bereits einen nicht stornierten Auftrag, warnt die Vorschau vor einer Dublette.
6. 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.
7. 7Schritt 1: POST salesOrders (REST v1.3) legt den Kopf an - mit Rückhaltegrund, falls genannt. Adressen, Zahlungsart, Zahlungsziel und Skonto übernimmt JTL vom Kunden, soweit nicht angegeben.
8. 8Schritt 2: POST salesOrders/{id}/lineitems legt alle Positionen in einem Aufruf an. JTL setzt dabei Name und Steuersatz der Artikel und - ohne Preisangabe - den Preis des Kunden.
9. 9Scheitert Schritt 2, wird der leere Auftrag automatisch storniert und der Aufruf endet mit der Fehlermeldung von JTL.
10. 10Schritt 3 (nur mit versandkostenNetto): Die Versandposition entsteht über PATCH /v2/sales-orders/{guid}. Weil dieser Aufruf die Positionsliste ersetzt, gehen alle eben angelegten Positionen mit ihrer Id mit; stimmt ihre Anzahl nicht, wird nichts geschrieben. Steuersatz der Versandkosten = höchster Satz der Warenpositionen.
11. 11Danach wird der Auftrag samt Positionen gelesen und mit der Erwartung verglichen; Werte, die JTL selbst festlegt (Nummer, Kundenpreise, Steuersätze, Kundenadressen), gelten nicht als Abweichung. Eine fehlende Versandposition erscheint als Abweichung.

So sieht eine Antwort aus