Rechnung zu einem Auftrag erstellen
jtl_rechnung_erstellen
Was das Tool macht
Erstellt die Rechnung zu einem Auftrag - mit Vorschau und Protokoll. Optional nur für bereits gelieferte Mengen (nurGeliefertes) oder als Entwurf (alsEntwurf). Die Rechnungsnummer vergibt JTL; nach dem Schreiben nennt das Tool sie. Eine Rechnung lässt sich nicht löschen, nur in JTL stornieren - dieser Vorgang ist deshalb nicht rückgängig machbar. Nutze dieses Tool für 'Erstelle die Rechnung zu OR-123', 'Berechne OR-123, aber nur das Gelieferte'. Braucht JTL-Wawi ab 2.2. 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) |
| nurGeliefertesoptional | true = nur bereits gelieferte Mengen berechnen (Default false: alles Offene) |
| alsEntwurfoptional | true = Rechnung als Entwurf anlegen, ohne endgültige Rechnungsnummer (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 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.
- 3Gibt es zu dem Auftrag schon Rechnungen, nennt die Vorschau ihre Nummern. Mit nurGeliefertes werden nur bereits gelieferte Mengen berechnet, mit alsEntwurf entsteht ein Entwurf ohne endgültige Nummer.
- 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 den Protokolleintrag an.
- 5Erstellt wird per POST auf die Rechnungen des Auftrags (REST v2). Die Rechnungsnummer vergibt JTL; nach dem Schreiben liest das Tool den Auftrag erneut und nennt die Rechnungsnummern.
- 6Schutz 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 Rechnung lässt sich nicht löschen. Dieser Vorgang ist deshalb nicht rückgängig machbar; stornieren geht nur in JTL.
- Was genau berechnet wird, entscheidet JTL: bereits berechnete Mengen werden nicht doppelt berechnet, und ist nichts offen, lehnt JTL ab.
- Rechnungs-Workflows in JTL, etwa Druck oder Mail an den Kunden, können ausgelöst werden.
- Braucht JTL-Wawi ab 2.2 und in JTL das Recht, Rechnungen zu schreiben.
- 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 Auftrag OR-526202 – noch nichts erstellt: Berechnet wird der ganze Auftrag über 279,06 € brutto. Die Rechnungsnummer vergibt JTL. Eine Rechnung lässt sich nicht löschen, nur in JTL stornieren. Beim Erstellen können Workflows anlaufen, etwa der Versand der Rechnung per Mail. Soll ich die Rechnung erstellen?
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.