Steuer-API kostenlos: der Schlüssel zum Steuer-Modul

Wer den Schlüssel bekommt

• Eine Gesellschaft, die weder das Buchhaltungs- noch das EÜR-Modul nutzt, deren Steuer-Modul aber aktiv und eingerichtet ist.
• Anlegen dürfen Administratoren und Ersteller des Arbeitsbereichs, denen der Bereich „KI-Agent & API“ und das Steuer-Modul freigeschaltet sind. Bestätigt wird mit dem zweiten Faktor.
• Der Weg in der App: Steuern → Einstellungen → Karte „KI-Agent & API“ → „Schlüssel verwalten“.
• Jeder Schlüssel gilt für genau eine Gesellschaft, braucht ein Ablaufdatum (höchstens 366 Tage) und wird nur einmal im Klartext angezeigt; gespeichert wird ein Hash. Je Gesellschaft sind höchstens 10 Schlüssel gleichzeitig aktiv.
• Auf derselben Seite sehen Sie die API-Nutzung der letzten 30 Tage je Schlüssel und können jeden Schlüssel widerrufen.

Was der Schlüssel erreicht

Der MCP-Server zeigt einem solchen Schlüssel nur die Steuer-Werkzeuge und die Stammdaten. Die REST-API prüft dieselbe Grenze, bevor eine Route etwas liest.

GET /v1/ nennt die Reichweite des Schlüssels im Feld umfang: steuer, dazu einen Hinweis im Klartext. Ein Agent, der das zuerst liest, weiß, welche Fragen er beantworten kann und welche nicht.

Rechte: Lesen und Schreiben

Für eine Gesellschaft nur mit dem Steuer-Modul gibt es die Rechte read und write. Schreiben heißt hier: Steuern prüfen, vorbereiten, Entwürfe anlegen und den Freigabe-Link anfordern — nichts davon wirkt nach außen. Die Rechte send, webhooks und finalize gehören zur Buchhaltung; wer sie für einen solchen Schlüssel wählt, bekommt eine klare Ablehnung.

Ein Recht, mit dem ein Schlüssel ohne die App an ELSTER übermittelt, wird derzeit nicht vergeben. Übermittelt wird über den Freigabe-Link: Sie öffnen ihn angemeldet in der App, sehen die vorbereiteten Werte und den Abgleich mit dem aktuellen Stand und übermitteln dort mit Ihrer PIN.

Was kostet was

Bei E-Bilanz und Anlage EÜR meldet der vorbereitete Vorgang eine offene Zahlung als Hindernis zahlung_offen. Bezahlt wird in der App; amtlich prüfen lässt sich unabhängig davon.

Beispiel: der erste Aufruf

So prüft ein Agent — oder Sie selbst im Terminal —, was der Schlüssel darf. Den Schlüssel legen Sie in eine Umgebungsvariable, nie in den Chat:

export JAB_API_KEY="jab_live_…"

curl -s -H "Authorization: Bearer $JAB_API_KEY" \
  https://api.jahresabschluss.io/functions/v1/bookkeeping-api/v1/

# Antwort (gekürzt)
{
  "entity_id": "…",
  "scopes": ["read", "write"],
  "umfang": "steuer",
  "umfang_hinweis": "Dieser API-Schlüssel gehört zu einer Gesellschaft, die nur das Steuer-Modul nutzt. …",
  "key_expires_at": "…"
}

# Eine Buchhaltungsroute mit demselben Schlüssel
curl -s -H "Authorization: Bearer $JAB_API_KEY" \
  https://api.jahresabschluss.io/functions/v1/bookkeeping-api/v1/journal-entries
# → 403 { "error": "…", "code": "nur_steuer_routen" }

Für ein KI-Programm wie Claude Code genügt eine Zeile: claude mcp add --transport http --scope user steuern https://api.jahresabschluss.io/functions/v1/bookkeeping-mcp --header "Authorization: Bearer $JAB_API_KEY". Die Shell setzt den Wert beim Anlegen ein; Claude Code speichert die Verbindung samt Schlüssel in Ihrer Benutzerkonfiguration (~/.claude.json), nicht im Projekt.

Ein typischer Auftrag

• list_tax_deadlines mit status offen: die offenen Fristen des Jahres, auch die in diesem Jahr fälligen Jahreserklärungen der Vorjahre.
• list_tax_filings mit art kst und year 2025: Status und ob die Erklärung freigegeben ist.
• check_tax_filing und prepare_tax_filing mit art kst: amtliche Prüfung und Vorgang mit Sendewerten und Prüfwert.
• request_tax_filing_approval: Link in die App, wo Sie die Sendewerte bestätigen und übermitteln.

Ein Beispiel: Eine GmbH, deren laufende Buchhaltung die Kanzlei führt, nutzt in der Software den Jahresabschluss und das Steuer-Modul. Ein Auftrag an den Agenten könnte lauten: „Welche Steuerfristen sind in diesem Jahr noch offen? Ist die Körperschaftsteuererklärung 2025 freigegeben? Wenn ja, amtlich prüfen und den Freigabe-Link schicken.“

Grenzen und der Weg zur vollen Reichweite

• Keine Buchhaltungsdaten: Journal, Belege, Bank und Rechnungen gibt die API erst mit dem Buchhaltungs- oder EÜR-Modul heraus.
• Keine Webhooks, kein Rechnungsversand, keine Festschreibung.
• Höchstens 30 Prüfungen, Vorbereitungen und Entwürfe je Stunde und Schlüssel, allgemein 120 Anfragen pro Minute je Schlüssel (429 mit Retry-After).
• Sachverhalte, Freigaben und die Übermittlung bleiben in der App.

Die Reichweite wird bei jedem Aufruf neu bestimmt. Kommt das Buchhaltungs- oder EÜR-Modul dazu und ist es Ihnen freigeschaltet, erreicht derselbe Schlüssel im Rahmen seiner Rechte auch die Buchhaltung — ohne neuen Schlüssel. Die Software ersetzt keine Steuerberatung; Ihre Kanzlei kann in derselben Software mitarbeiten.

Häufige Fragen

Ist die Steuer-API wirklich kostenlos?

Schlüssel und Aufrufe der Steuer-Routen kosten mit dem kostenlosen Steuer-Modul nichts, ebenso Erstellen und amtliche Prüfung. Die Übermittlung selbst ist je nach Meldung im Abo enthalten oder wird je Übermittlung berechnet — siehe /preise.

Ist das eine kostenlose ELSTER-Schnittstelle?

Nur für das Prüfen. Der Agent lässt Meldungen amtlich mit ERiC prüfen, ohne etwas zu senden. Übermittelt wird über den Freigabe-Link in der App mit Ihrer PIN; ein Recht zum Übermitteln ohne die App wird derzeit nicht vergeben.

Was bedeutet 403 nur_steuer_routen?

Der Schlüssel gehört zu einer Gesellschaft, die nur das Steuer-Modul nutzt. Er erreicht /v1/tax/…, /v1/vat-returns… sowie /v1/, /v1/entity und /v1/fiscal-years; Buchhaltungsrouten antworten mit diesem Code, bevor etwas gelesen wird.

Wo lege ich den Schlüssel an?

In der App unter Steuern → Einstellungen, Karte „KI-Agent & API“, Schaltfläche „Schlüssel verwalten“. Anlegen dürfen Administratoren und Ersteller; bestätigt wird mit dem zweiten Faktor.

Welche Rechte kann ich vergeben?

read und write. send, webhooks und finalize gehören zur Buchhaltung und sind für einen Schlüssel nur mit dem Steuer-Modul nicht wählbar.

Muss ich später einen neuen Schlüssel anlegen, wenn ich die Buchhaltung dazubuche?

Nein. Die Reichweite wird bei jedem Aufruf neu bestimmt; mit dem Buchhaltungs- oder EÜR-Modul erreicht derselbe Schlüssel im Rahmen seiner Rechte auch die Buchhaltung, sofern sie Ihnen freigeschaltet ist.