Kontenrahmen SKR03/SKR04 per KI abfragen

Was GET /accounts zurückgibt

Ein lesender Aufruf liefert den Kontenplan Ihrer Firma als Stammdaten — jedes Konto maschinenlesbar und mit HGB-Bedeutung, Salden bleiben außen vor.

Kontensuche per Prompt statt SQL

Der Agent liest die fertige Liste und sucht darin selbst — kein Datenbankzugriff, keine Abfragesprache.

Sie beschreiben den Geschäftsvorfall in normalem Deutsch: „Eingangsrechnung für Bürobedarf, 119 Euro brutto" oder „Erlös aus einer Beratungsleistung mit 19 Prozent". Ihr Agent ruft daraufhin den Kontenrahmen ab, liest die zurückgegebene Liste und filtert sie nach Stichwort, HGB-Key und Normalseite — allein durch Sprachverständnis, nicht durch eine SQL-Abfrage.

Das ist bewusst so gebaut: Der Agent sieht ausschließlich das, was der feste Endpunkt für Ihre eine Firma zurückgibt. Er hat keinen direkten Zugriff auf die Datenbank und kann keine freien Abfragen formulieren. Wer die Ergebnismenge vorab einengen möchte, hängt einen optionalen Parameter ?q= an — eine reine Stichwortsuche auf Nummer und Bezeichnung, ebenfalls ohne SQL.

Für Sie bedeutet das: Sie müssen die passende SKR-Nummer nicht mehr auswendig kennen. Der Agent übersetzt Ihre Alltagssprache in einen konkreten Kontovorschlag und begründet ihn mit Bezeichnung und HGB-Zuordnung, sodass Sie den Vorschlag in Sekunden prüfen können.

Konto und Gegenkonto vorschlagen lassen

Weil HGB-Key und Normalseite je Konto mitgeliefert werden, kann der Agent beide Seiten der Buchung benennen.

• Beispiel Bürobedarf: Der Agent schlägt das Aufwandskonto vor — SKR03 4930 bzw. SKR04 6815 „Bürobedarf", HGB-Position „8. Sonstige betriebliche Aufwendungen" — und dazu als Gegenkonto die Verbindlichkeiten aus Lieferungen und Leistungen bzw. den passenden Kreditor.
• Beide Seiten auf einmal: Da das Feld is_debit_normal je Konto die Soll- oder Haben-Normalseite nennt, benennt der Agent für den Aufwand die Soll- und für die Verbindlichkeit die Haben-Seite in einem Vorschlag. Den passenden Steuerschlüssel (etwa 19 Prozent Vorsteuer) leitet er aus Ihrer Beschreibung ab, nicht aus dem Kontenrahmen.
• Sie behalten die Kontrolle: Der Vorschlag ist zunächst nur ein Textvorschlag. Erst wenn Sie ihn bestätigen, erzeugt eines der vier schreibenden Werkzeuge die tatsächliche Buchung — und dafür braucht der Schlüssel zusätzlich den write-Scope.
• Kein erfundenes Konto: Weil nur real angelegte, aktive Konten in der Antwort stehen, kann der Agent nichts auf ein ausgedachtes Konto buchen. Die Kontenliste liefert die Schnittstelle, der Vorschlag ist die Denkleistung Ihres Agenten.

SKR03 oder SKR04 — der Agent muss nicht raten

Der Kontenrahmen ist pro Firma festgelegt; der HGB-Key überbrückt beide Systeme.

Welcher Kontenrahmen gilt, entscheidet sich auf Ebene der Firma und steht im Feld chart_type. GET /accounts liefert genau den, den Ihr Unternehmen führt — der Agent bekommt also nie beide Rahmen gemischt und muss nicht raten, ob 4930 oder 6815 gemeint ist.

Der HGB-Key macht die Zuordnung robust: Ein Agent, dessen Vorwissen eher auf SKR04 beruht, landet auch bei einer SKR03-Firma auf der richtigen Position, weil er über die HGB-Zuordnung abgleicht und nicht allein über die Kontonummer. Aufwand bleibt Aufwand, eine Forderung bleibt eine Forderung — unabhängig von der Nummerierung.

So funktioniert derselbe Prompt zuverlässig für unterschiedliche Mandanten, ohne dass Sie Ihrem Agenten den Kontenrahmen jedes Mal erklären müssen — für Steuerberater mit gemischten SKR03-/SKR04-Beständen ein spürbarer Unterschied.

So ruft der Agent den Kontenrahmen ab

Ein einziger lesender Aufruf genügt — der Agent filtert die Antwort anschließend selbst.

# Kontenrahmen der Firma abrufen: SKR03 oder SKR04, eigene Konten,
# jedes Konto mit HGB-Zuordnung. Nur read-Scope nötig.
curl -s "$BASIS_URL/accounts?q=Büro&limit=200" \
  -H "Authorization: Bearer jab_live_…"

# Antwort je Konto: account_number, account_name, hgb_key,
# is_debit_normal (Soll- oder Haben-Normalseite), is_active.
# Der Agent liest die Liste und schlägt daraus Konto + Gegenkonto vor —
# ohne SQL. Optional grenzt ?q= schon am Endpoint ein.
# Welche Firma gemeint ist, ergibt sich aus dem Schlüssel, nicht aus einem Parameter.

Grenzen und GoBD

Was die Schnittstelle abdeckt — und was bewusst außen vor bleibt.

• Ein Schlüssel, eine Firma: /accounts liefert nur den Kontenrahmen des Unternehmens, das aus dem jab_live_-Schlüssel abgeleitet wird. Eine Firmen-ID als Parameter gibt es nicht — der Zugriff auf fremde Mandanten ist damit ausgeschlossen.
• Nur Buchhaltung: Die Schnittstelle liest und verbucht Buchhaltungsdaten. Einen Jahresabschluss, eine E-Bilanz oder eine Steuererklärung erzeugt oder übermittelt sie nicht — diese Zahlen bereiten Sie hier vor, der eigentliche Abschluss entsteht später im Programm.
• GoBD bei jedem Schreibvorgang: Bestätigen Sie einen Kontovorschlag, greifen dieselben Regeln wie bei manueller Erfassung — Festschreibung, Soll gleich Haben und Storno statt Löschen. Eine gebuchte Buchung wird nie einfach entfernt. Das reine Abfragen von /accounts berührt davon nichts.
• Der Agent ist Ihr Werkzeug: Ob Claude, Claude Code, ChatGPT, Cursor oder ein eigener Client — der Agent gehört Ihnen. Unsere Software stellt nur die Schnittstelle bereit und ist an keinen bestimmten KI-Anbieter gebunden.

Häufige Fragen

Liefert die Schnittstelle SKR03 und SKR04?

Sie liefert den Kontenrahmen, den Ihre Firma tatsächlich führt — also entweder SKR03 oder SKR04, ausgewiesen im Feld chart_type. GET /accounts gibt die dort angelegten Konten mit Nummer, Bezeichnung, HGB-Zuordnung und Normalseite zurück. Der Agent bekommt damit genau den Rahmen, der für Ihr Unternehmen gilt, und muss nicht zwischen beiden Systemen wählen.

Muss mein Agent SQL können?

Nein. GET /accounts gibt eine fertige, strukturierte Liste zurück, die der Agent per Sprachverständnis durchsucht und filtert. Es gibt keinen direkten Datenbankzugriff und keine Abfragesprache — höchstens einen optionalen Parameter ?q= für eine einfache Stichwortsuche. Die eigentliche Kontensuche findet allein auf der gelieferten Antwort statt.

Bekomme ich über /accounts auch die Salden der Konten?

Nein. GET /accounts liefert die Kontenstammdaten — Nummer, Bezeichnung, HGB-Zuordnung, Normalseite und Aktiv-Kennzeichen —, nicht die aktuellen Salden. Die Salden je Konto ruft Ihr Agent über die Saldenliste ab; /accounts beantwortet die Frage, welche Konten überhaupt existieren und wofür sie stehen. Beides zusammen ergibt den vollständigen Kontovorschlag.

Schlägt der Agent auch das Gegenkonto vor?

Ja. Weil zu jedem Konto HGB-Key und Normalseite mitgeliefert werden, kann der Agent beide Seiten einer Buchung benennen — Soll- und Habenkonto samt Steuerschlüssel. Der Vorschlag bleibt aber ein Vorschlag: Erst nach Ihrer Bestätigung bucht eines der vier schreibenden Werkzeuge, und dafür braucht der Schlüssel den write-Scope.

Sieht der Agent auch meine eigenen Konten?

Ja. Selbst angelegte und umbenannte Konten stehen in derselben Antwort wie die Standardkonten des SKR03 oder SKR04. So schlägt der Agent nur Konten vor, die es in Ihrem Kontenplan wirklich gibt, und nutzt auch Ihre individuellen Konten mit der richtigen HGB-Zuordnung.

Kann ich damit eine E-Bilanz oder den Jahresabschluss erstellen?

Nein. Die Schnittstelle deckt ausschließlich die Buchhaltung ab — Kontenrahmen, Salden und Buchungen. Eine E-Bilanz, einen Jahresabschluss oder eine Steuererklärung erzeugt oder übermittelt sie nicht. Sie bereiten mit sauberen Buchungen die Zahlen vor; der Abschluss selbst entsteht danach im Programm.

Welchen Scope brauche ich zum Abfragen des Kontenrahmens?

Für GET /accounts genügt ein Schlüssel mit read-Scope — der Abruf verändert nichts. Erst wenn der Agent nach Ihrer Bestätigung tatsächlich buchen soll, brauchen Sie zusätzlich write. Zum reinen Suchen und Vorschlagen von Konto und Gegenkonto reicht der lesende Zugriff vollständig.