Zahlung auf einen Auftrag buchen
jtl_zahlung_buchen
Was das Tool macht
Bucht einen Zahlungseingang auf einen Auftrag - mit Vorschau, Protokoll und Rückgängig-Funktion (die gebuchte Zahlung wird dann wieder gelöscht). Ohne betrag wird der gesamte offene Betrag gebucht; die Vorschau nennt ihn. Ohne zahlungsart gilt die Zahlungsart des Auftrags, ohne datum der heutige Tag. Die Vorschau zeigt bezahlt und offen vorher und nachher und warnt bei Überzahlung und bei einer möglichen Doppelbuchung. Nutze dieses Tool für 'Buche 279,06 Euro Zahlungseingang auf OR-123', 'Markiere OR-123 als bezahlt'. 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, z.B. OR-526202 (exakt) |
| betragoptional | Zahlungsbetrag brutto in der Währung des Auftrags - leer = gesamter offener Betrag - weglassen = unverändert; Komma oder Punkt als Dezimaltrenner |
| datumoptional | Tag des Zahlungseingangs als JJJJ-MM-TT - Default: heute |
| zahlungsartoptional | Zahlungsart - Default: Zahlungsart des Auftrags - Name wie in JTL (kein Id); weglassen = unverändert |
| kommentaroptional | Kommentar zur Zahlung, z.B. Verwendungszweck |
| transaktionsnummeroptional | Transaktions- oder Belegnummer der Bank bzw. des Zahlungsanbieters |
| 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.
- 3Ohne betrag gilt der gesamte offene Betrag des Auftrags; ist nichts offen, muss der Betrag ausdrücklich angegeben werden. Ohne zahlungsart gilt die Zahlungsart des Auftrags, ohne datum der heutige Tag in deutscher Zeit.
- 4Die Vorschau rechnet bezahlt = bisher bezahlt + Betrag und offen = bisher offen − Betrag und warnt bei Überzahlung und bei einem Datum in der Zukunft.
- 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.
- 6Gebucht wird per POST auf die Zahlungen des Auftrags (REST v2). Danach wird der Auftrag erneut gelesen und mit der Erwartung verglichen; den Zahlstatus legt JTL selbst fest.
- 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
- Rückgängig löscht genau die gebuchte Zahlung wieder (DELETE auf die Zahlung). Liefert JTL beim Buchen keine Kennung der Zahlung zurück, ist der Vorgang nicht automatisch rückgängig machbar; das Tool sagt das.
- Workflows in JTL, etwa die Versandfreigabe nach Zahlungseingang, können durch die Buchung ausgelöst werden und werden beim Rückgängigmachen nicht zurückgenommen.
- Skonto, Gutschriften und Mahngebühren verrechnet das Tool nicht; der offene Betrag ist der, den JTL nennt.
- Braucht JTL-Wawi ab 2.2 und in JTL das Recht, Zahlungen 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 gebucht: Zahlungseingang 279,06 € am 12.11.2026, Zahlungsart „Überweisung“. • Bezahlt: 0,00 € → 279,06 € • Offen: 279,06 € → 0,00 € • Zahlstatus: unbezahlt → vollständig bezahlt In JTL können dadurch Workflows anlaufen, etwa die Versandfreigabe. Die Buchung lässt sich rückgängig machen. Soll ich die Zahlung buchen?
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.