Saldenliste per KI abrufen

Saldenliste per KI-Agent abrufen

Ein KI-Agent zieht die Summen- und Saldenliste (SuSa) eines Wirtschaftsjahres in Sekunden aus Ihrer Buchhaltung — ohne Export und ohne Klickpfad durch die Menüs. Sie fragen in natürlicher Sprache, der Agent ruft das lesende Werkzeug get_saldenliste beziehungsweise den Endpoint GET /saldenliste auf und legt Ihnen die Gesamtsummen, die getrennten Soll- und Haben-Zahlen, das balanced-Flag und die HGB-Zuordnung als Tabelle vor. Der Agent gehört dabei Ihnen: Er ist Ihr Werkzeug, nicht Teil unserer Software — wir stellen nur die offene Schnittstelle bereit, an die Sie ihn anbinden.

Was der Saldenliste-Abruf liefert

Ein einziger lesender Aufruf gibt die vollständige SuSa eines Wirtschaftsjahres strukturiert zurück — genau die Felder, die Sie für Kontrolle und Abstimmung brauchen.

Summen und Salden je Konto

Zu jedem bebuchten Konto liefert der Abruf Nummer, Bezeichnung und Saldo. Die Summenzeile nennt die Gesamt-Soll- und Gesamt-Haben-Beträge des Wirtschaftsjahres. So sehen Sie auf einen Blick, wie sich der Kontenrahmen über das Jahr entwickelt hat.

Soll und Haben getrennt

Soll- und Haben-Verkehrszahlen werden getrennt ausgewiesen, nicht nur der Nettosaldo. Das ist die Grundlage jeder Bewegungsanalyse und macht nachvollziehbar, aus welchen Buchungen sich ein Saldo zusammensetzt.

balanced-Flag als Prüfsumme

Ein boolesches balanced-Flag zeigt sofort, ob Summe Soll gleich Summe Haben ist. Steht es auf true, ist die SuSa in sich schlüssig — die zentrale Kontrolle der doppelten Buchführung, ohne dass Sie selbst nachrechnen.

HGB-Zuordnung pro Konto

Jedes Konto trägt seine HGB-Zuordnung, also den Bilanz- oder GuV-Posten, in den es später einfließt. Damit erkennt Ihr Agent schon in der laufenden Buchhaltung, welche Zahlen in welche Position des Abschlusses wandern werden.

Von der Frage zur Tabelle

Sie formulieren die Anfrage in natürlicher Sprache. Der Agent übersetzt sie in den passenden lesenden Aufruf und gibt Ihnen das Ergebnis als Tabelle zurück.

Statt sich durch die Übersicht zu klicken und einen Export anzustoßen, schreiben Sie einfach: „Gib mir die Saldenliste 2024 als Tabelle.“ Der Agent erkennt das gemeinte Wirtschaftsjahr, ruft get_saldenliste auf und formatiert die Antwort so, wie Sie sie brauchen — als Tabelle im Chat, als CSV oder als Grundlage für eine Rückfrage wie „Welche Konten haben sich gegenüber dem Vorjahr am stärksten verändert?“.

Welcher Agent das übernimmt, entscheiden Sie. Claude Code, Claude Desktop, ein Custom GPT in ChatGPT, Cursor oder ein Ablauf in n8n — alle sprechen über denselben Bearer-Schlüssel mit der Schnittstelle. Der Agent bleibt dabei ausdrücklich Ihr Werkzeug; er läuft in Ihrer Umgebung und greift nur mit dem Schlüssel zu, den Sie ihm geben.

# Im Chat, natürliche Sprache:
"Gib mir die Saldenliste 2024 als Tabelle."

# Was der Agent im Hintergrund aufruft (REST):
GET /saldenliste?wirtschaftsjahr=2024
Authorization: Bearer jab_live_…

# Antwort (gekürzt):
{
  "wirtschaftsjahr": 2024,
  "summe_soll": 812450.00,
  "summe_haben": 812450.00,
  "balanced": true,
  "konten": [
    { "konto": "1200", "bezeichnung": "Bank",
      "saldo": 42310.55, "hgb_posten": "B.IV" }
  ]
}

Das balanced-Flag richtig lesen

Die Kontrollsumme ist die schnellste Aussage über den Zustand Ihrer Bücher. So nutzt Ihr Agent sie sinnvoll.

  • balanced = true bedeutet: Summe Soll und Summe Haben stimmen überein — die SuSa ist in sich geschlossen und abstimmungsfähig.
  • Fällt das Flag auf false, kann der Agent gezielt nachhaken und über weitere lesende Werkzeuge (Buchungsjournal, offene Posten) die Differenz eingrenzen.
  • Weil jedes Konto seine HGB-Zuordnung mitbringt, lässt sich die SuSa direkt entlang der späteren Bilanz- und GuV-Posten gruppieren — die Vorstufe jeder Abstimmung vor dem Abschluss.
  • Der Abruf ist rein lesend: Er verändert keine einzige Buchung. Sie können ihn beliebig oft ausführen, ohne die Festschreibung oder den Bestand zu berühren.
  • Weil Soll und Haben getrennt ausgewiesen werden, erkennt der Agent auch Konten mit hohen Verkehrszahlen bei kleinem Saldo — ein typisches Signal für Verrechnungs- oder Durchlaufkonten, die einen zweiten Blick verdienen.

Ein Schlüssel, eine Firma, ein Wirtschaftsjahr

Die Zuordnung ist eindeutig — und das ist Absicht.

Jeder API-Schlüssel beginnt mit dem Präfix jab_live_ und ist genau einer Gesellschaft zugeordnet. Die Firma ergibt sich aus dem Schlüssel selbst und ist kein Parameter, den der Agent frei setzen könnte. So kann ein Agent mit dem Schlüssel Ihrer Mustermann GmbH niemals versehentlich die Zahlen einer anderen Mandantin abrufen. Betreuen Sie mehrere Firmen, legen Sie je Gesellschaft einen eigenen Schlüssel an.

Das Wirtschaftsjahr dagegen ist ein Parameter des Aufrufs: „Saldenliste 2024“ liefert eine andere Antwort als „Saldenliste 2023“. Ihr Agent muss also nur das Jahr benennen — die Firma steht durch den Schlüssel bereits fest. Insgesamt stehen 14 Werkzeuge zur Verfügung, davon 10 lesende wie get_saldenliste und 4 schreibende; für den reinen SuSa-Abruf genügt ein Schlüssel mit Leserecht.

Nur lesen — die GoBD bleiben unberührt

Ein Saldenlisten-Abruf ist ein Lesevorgang. An den Grundsätzen ordnungsmäßiger Buchführung ändert sich dadurch nichts.

get_saldenliste liest ausschließlich. Es entstehen keine Buchungen, nichts wird verändert oder gelöscht. Schreibende Aufrufe — und nur diese — laufen durch denselben Buchungskern wie die Eingabe in der Anwendung: Der Bestand ist append-only, festgeschriebene Buchungen werden nicht gelöscht, sondern per Storno neutralisiert, und Soll muss gleich Haben sein. Diese Regeln greifen unabhängig davon, ob eine Buchung aus der Anwendung oder von einem Agenten kommt.

Für die Saldenliste heißt das konkret: Sie können den Abruf so oft ausführen, wie Sie möchten, in jeder Prüf- oder Abstimmungsrunde, ohne Ihre Belegkette zu berühren. Die SuSa spiegelt jederzeit den aktuellen, revisionssicheren Stand Ihrer Bücher wider.

Häufige Fragen

Welches Werkzeug ruft die Saldenliste ab?

Der lesende Aufruf get_saldenliste, technisch der Endpoint GET /saldenliste mit dem Wirtschaftsjahr als Parameter. Er gehört zu den 10 lesenden von insgesamt 14 Werkzeugen und benötigt lediglich einen Schlüssel mit Leserecht. Zurück kommen die Gesamtsummen, die getrennten Soll- und Haben-Zahlen, das balanced-Flag und je Konto die HGB-Zuordnung.

Kann der Agent damit meinen Jahresabschluss oder die E-Bilanz erstellen?

Nein. Die Schnittstelle arbeitet ausschließlich mit Buchhaltungsdaten. Sie liefert die Saldenliste und andere laufende Zahlen — aber sie erstellt oder übermittelt keinen Jahresabschluss, keine E-Bilanz und keine Steuererklärung. Der SuSa-Abruf bereitet die Zahlen auf, die später in der Anwendung zum Abschluss verarbeitet werden; der Abschluss selbst entsteht dort, nicht über die API.

Für welche Firma gilt der Abruf?

Immer für genau die Gesellschaft, die dem verwendeten Schlüssel zugeordnet ist. Die Firma wird aus dem jab_live_-Schlüssel abgeleitet und ist kein Parameter, den der Agent setzen kann. Wer mehrere Mandanten betreut, verwendet je Firma einen eigenen Schlüssel — eine Verwechslung ist damit ausgeschlossen.

Brauche ich das npm-Paket, um die Saldenliste abzurufen?

Nein. Das npm-Paket @jahresabschluss/buchhaltung-mcp ist noch nicht veröffentlicht. Der verlässliche Weg ist derzeit die gehostete MCP-Variante, die Sie per URL in Ihren Client eintragen, oder der direkte REST-Aufruf GET /saldenliste. Beide nutzen denselben Bearer-Schlüssel und dieselben Rechte.

Wie formuliere ich die Anfrage am besten?

In normaler Sprache, zum Beispiel „Gib mir die Saldenliste 2024 als Tabelle.“ Ihr Agent erkennt das gemeinte Wirtschaftsjahr und den passenden Aufruf selbst. Sie können direkt anschließen mit Rückfragen wie „Zeig mir nur Konten über 10.000 Euro Saldo“ oder „Vergleich das mit 2023“ — die Antwort bleibt jeweils eine strukturierte Tabelle.