Auftrag ausliefern (Lieferschein erzeugen)
jtl_auftrag_ausliefern
Was das Tool macht
Liefert einen Auftrag aus: JTL erzeugt die Lieferscheine und bucht den Bestand aus - mit Vorschau und Protokoll. Die Vorschau prüft zuerst die Lieferbarkeit und nennt die Gründe, wenn der Auftrag nicht lieferbar ist (zurückgehalten, unbezahlt, Kunde gesperrt, keine Versandart, kein Bestand); dann wird nichts geschrieben. Anders als in manchen anderen Werkzeugen wird KEINE Rechnung automatisch erstellt - dafür gibt es jtl_rechnung_erstellen. Eine Auslieferung lässt sich nicht rückgängig machen (nur über Retoure in JTL). Nutze dieses Tool für 'Liefere OR-123 aus', 'Kann OR-123 raus und wenn nein, warum nicht?'. Braucht JTL-Wawi ab 2.2; JTL stuft den Vorgang selbst noch als experimentell ein. 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
| auftragsnummerPflicht | Auftragsnummer (exakt) |
| 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 Auftrag per Nummer (GraphQL) und liest Beträge, Zahl-, Liefer- und Rechnungsstatus, dazu über REST v2 die Zahlungsart des Auftrags, die gebuchten Zahlungen, die Lieferscheine und die Lieferbarkeit. Ein stornierter Auftrag ist gesperrt.
- 3Die Lieferbarkeit kommt aus JTL: lieferbar, teilweise lieferbar oder nicht lieferbar, mit den Gründen (zurückgehalten, unbezahlt, Kunde gesperrt, keine Versandart, Versandsperre, bereits geliefert). Ist der Auftrag nicht lieferbar oder lässt sich die Lieferbarkeit nicht prüfen, endet der Aufruf ohne Schreiben.
- 4Bei teilweiser Lieferbarkeit und bei offenem Zahlbetrag warnt die Vorschau.
- 5Ohne 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 den Protokolleintrag an.
- 6Ausgeliefert wird über den JTL-Befehl DeliverSalesOrder: JTL erzeugt die Lieferscheine und bucht den Bestand aus. Danach wird der Auftrag erneut gelesen.
- 7Schutz vor Doppelbuchung: Wird dieselbe Bestätigung ein zweites Mal geschickt, antwortet das Tool mit dem Ergebnis des ersten Laufs und schreibt nicht erneut; eine neue Vorschau mit denselben Eingaben innerhalb von 24 Stunden warnt ausdrücklich. Zusätzlich geht ein Idempotenz-Schlüssel an JTL mit.
Annahmen und Grenzen
- Eine Auslieferung lässt sich nicht rückgängig machen, nur über eine Retoure in JTL.
- Es wird keine Rechnung erstellt und kein Versandetikett erzeugt.
- JTL stuft den Befehl selbst als experimentell ein; sein Verhalten kann sich mit einem Wawi-Update ändern.
- Welche Mengen bei teilweiser Lieferbarkeit geliefert werden, entscheidet 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
Auftrag OR-526203 kann gerade nicht ausgeliefert werden. JTL nennt zwei Gründe: • Der Auftrag ist zurückgehalten. • Der Auftrag ist nicht bezahlt. Geschrieben wurde nichts. Soll ich den Rückhalt aufheben oder zuerst den Zahlungseingang buchen?
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.