Bankumsätze per KI-Agent buchen

Was der KI-Agent mit Ihren Bankumsätzen tut

Drei Werkzeuge tragen den Kern des Ablaufs: eines liest den Kontoauszug, zwei verbuchen die Umsätze.

Wer kontiert — und was die App prüft

Die Schnittstelle liefert jeden Umsatz mit Betrag, Verwendungszweck und Gegenpartei. Welches Gegenkonto passt oder zu welcher offenen Rechnung eine Zahlung gehört, schlägt Ihr Agent vor — gestützt auf offene Posten, Kontenrahmen und Ihre Anweisungen. Die App übernimmt diesen Vorschlag nicht ungeprüft: Sie bucht über denselben Weg wie die Bankzuordnung in der Oberfläche, mit denselben Prüfungen.

Beim Bilanzierer gilt dabei die Belegpflicht: Aufwand und Erlös kommen aus dem Beleg, nicht aus der Bankzeile. Nennt Ihr Agent für eine Zahlung ohne Beleg ein Aufwands- oder Erlöskonto, parkt die App sie als offenen Posten auf dem Kreditor- oder Debitorenkonto der Gegenpartei; ist die Rechnung später gebucht, ordnet match_bank_transaction die geparkte Zahlung ihr zu. Gehört der Umsatz zu einer schon gebuchten Eingangsrechnung, übergibt der Agent deren Beleg (receipt_id), und die App gleicht die Rechnung aus. Ausnahmen wie Bankentgelte gelten nur über eine in der App freigegebene Regel; wer eine Einnahmen-Überschuss-Rechnung führt, bucht am Geldfluss.

Fehlen Umsätze, liest der Agent den Kontoauszug ein: import_bank_statement nimmt eine Datei im Format CSV, CAMT.053 oder MT940 für ein Bankkonto mit zugeordnetem Sachkonto entgegen, und die App prüft Konto, Salden und Dubletten. Die Bankanbindung selbst und die Zuordnung des Sachkontos richten Sie in der App ein. Ob Sie Claude Code, Claude Desktop, Codex, Cursor oder einen n8n-Ablauf einsetzen, bleibt Ihre Entscheidung — die Schnittstelle ist für jede Anbindung dieselbe, und Ihr write-Schlüssel bleibt in Ihrer Umgebung.

Vom Kontoauszug zur Buchung: der Ablauf per Prompt

Ein einziger Prompt genügt, um den kompletten Ablauf anzustoßen. Formulieren Sie ihn so vorsichtig, wie es Ihre Sorgfaltspflicht verlangt — mit der ausdrücklichen Regel, unklare Umsätze lieber nicht zu buchen.

# Beispiel-Prompt an Ihren verbundenen KI-Agenten:

Rufe die noch offenen Bankumsätze für Juni 2025 ab
(list_bank_transactions, status=unbooked).
Gehört ein Umsatz zu einer offenen Rechnung, ordne ihn zu
(match_bank_transaction). Buche die übrigen mit Gegenkonto und
Steuerschlüssel (book_bank_transaction).
Was keinem Beleg und keiner Rechnung eindeutig zuzuordnen ist,
buchst du NICHT — liste es am Ende zur manuellen Klärung auf.

Skonto, Teilzahlung, Sammelüberweisung — was der Agent abgleicht

• Kundenzahlungen: Der Agent sucht zu eingehenden Beträgen die offene Ausgangsrechnung und ordnet sie mit match_bank_transaction zu — Grundlage sind Betrag, Verwendungszweck und Gegenpartei aus dem Umsatz.
• Lieferantenzahlungen: Ausgehende Beträge ordnet er offenen Eingangsrechnungen zu; vereinbarten Skonto und Zahlungsdifferenzen prüft der Server wie in der App, statt dass der Agent Beträge frei vorgibt.
• Teilzahlungen und Sammelposten: Eine Teilzahlung lässt den Rest der Rechnung offen. Passt ein Umsatz nicht eindeutig zu einem Beleg — etwa eine Sammelüberweisung ohne aufgeschlüsselten Verwendungszweck —, weisen Sie den Agenten per Prompt an, ihn zur manuellen Klärung zu markieren statt zu raten.
• Wiederkehrende Umsätze: Miete, Beiträge oder Daueraufträge lassen sich regelbasiert derselben Kontierung zuordnen — der Agent wendet Ihre Vorgabe auf den ganzen Zeitraum an.

GoBD und Sicherheit bleiben erzwungen

• Soll = Haben: Jede Buchung muss ausgeglichen sein; unausgeglichene Sätze weist die Schnittstelle ab — unabhängig davon, welcher Agent sie schickt.
• Append-only und Festschreibung: Ein einmal festgeschriebener Satz wird nie gelöscht. Eine Korrektur läuft ausschließlich über einen Storno und eine saubere Neubuchung.
• Scope-Trennung: Der write-Scope ist Voraussetzung fürs Buchen. Ein reiner read-Schlüssel kann Bankumsätze lesen, aber niemals schreiben — ideal, um einen Agenten zunächst nur beobachten zu lassen.
• Feste Endpunkt-Liste: Der Agent kann keine beliebigen Datenbankbefehle absetzen, sondern nur die definierten Werkzeuge aufrufen, die sein Schlüssel freigibt. Alles läuft durch denselben Buchungskern wie die manuelle Erfassung im Programm.

Häufige Fragen

Kontiert mein Agent die Bankumsätze selbst?

Er schlägt vor, die App prüft und bucht. Die Schnittstelle liefert jeden Umsatz mit Betrag, Verwendungszweck und Gegenpartei; Ihr Agent nennt das Gegenkonto oder die offene Rechnung, zu der eine Zahlung gehört. Gebucht wird über book_bank_transaction oder match_bank_transaction auf demselben Weg wie in der App — beim Bilanzierer ohne Beleg nicht in die GuV, sondern als offener Posten beim Kreditor oder Debitor.

Welche MCP-Werkzeuge braucht der Agent zum Bankbuchen?

list_bank_transactions zum Lesen, match_bank_transaction zum Zuordnen einer Zahlung zu einer offenen Rechnung und book_bank_transaction für die übrigen Umsätze; fehlende Umsätze liest import_bank_statement aus einer CSV-, CAMT.053- oder MT940-Datei ein. Private oder irrelevante Umsätze blendet ignore_bank_transaction mit Begründung aus. Für den Abgleich zieht der Agent oft zusätzlich lesende Werkzeuge für offene Posten und den Kontenrahmen heran. Zum Buchen benötigt der Schlüssel den write-Scope.

Was passiert mit Bankumsätzen, die der Agent keinem Beleg zuordnen kann?

Sie legen die Sorgfaltsregel selbst im Prompt fest. Bewährt hat sich die Anweisung, unklare Umsätze — etwa eine Sammelüberweisung ohne aufgeschlüsselten Verwendungszweck oder eine Teilzahlung — bewusst NICHT zu buchen, sondern am Ende separat aufzulisten. Der Agent bucht dann nur die eindeutigen Fälle und übergibt die Zweifelsfälle zur manuellen Klärung an Sie.

Wie korrigiere ich eine falsche Bankbuchung?

Gelöscht wird nie. Nach der Festschreibung stornieren Sie den fehlerhaften Satz und buchen sauber neu. So bleibt die append-only, GoBD-konforme Belegkette lückenlos nachvollziehbar — unabhängig davon, ob die Buchung aus dem Programm oder über den Agenten kam.

Kann der Agent aus den Bankbuchungen gleich die E-Bilanz oder den Jahresabschluss erstellen?

Nein. Die Schnittstelle deckt ausschließlich die Buchhaltung ab — Umsätze lesen und Buchungen anlegen. Sie bereiten damit die Zahlen vor; die E-Bilanz, den Jahresabschluss und die Steuererklärung erzeugen und übermitteln Sie später im Programm, nicht über die API.

Wie verbinde ich meinen Agenten fürs Bankbuchen — brauche ich ein npm-Paket?

Nein, ein npm-Paket brauchen Sie nicht. Sie hinterlegen den gehosteten MCP-Server per URL und jab_live_-Schlüssel in Ihrem Agenten — etwa Claude Code, Codex oder Cursor; Claude Desktop verbindet sich über die Brücke mcp-remote. Wer lieber ohne MCP arbeitet, etwa in n8n, spricht dieselben Endpunkte direkt als REST-API an.