72 Endpoints in der Steuer-API — Webapp-Spiegel komplett

Von Thomas Hakenes15.05.20264 Min. Lesezeit

apisteuerrechnerupdatecalver-2026.24batch-endpointsopenapi

TL;DR

72 Endpoints in der Steuerrechner-API, CalVer 2026.24 (Stand 15. Mai 2026)
39 neue Endpoints in fünf Wochen — jeder Webapp-Rechner hat jetzt ein API-Pendant
Fünf Batch-Endpoints für Payroll-Massenberechnung (bis 1.000 Items, per-Item-Fehler-Isolation)
1.344+ Tests grün, Cross-Validation API gegen Webapp pro Endpoint

Wo wir Mitte April standen

Am 13. April hatte das API-Listing 33 Endpoints. Genug für den Standardfall — Brutto-Netto, Abfindung, Grunderwerb, Erbschaft. Aber für eine ernsthafte Integration in eine Buchhaltungs- oder Lohnabrechnungs-App reicht das nicht. Wenn der Brutto-Netto-Endpoint da ist, aber der Midijob-Übergangsbereich (603 bis 2.000 EUR) fehlt, hat man für einen ganzen Lohnkorridor keine konsistente Antwort. Wenn die Photovoltaik-Steuer da ist, aber haushaltsnahe Leistungen fehlen, ist der Hauseigentümer-Use-Case zerstückelt.

Die Plan-Antwort: acht Tranchen in fünf Wochen, Cluster für Cluster sauber schließen, statt zwischen Themen zu springen. Heute steht das API-Listing bei 72 Endpoints, und die Disziplin hat gehalten — jeder Webapp-Rechner hat jetzt ein API-Pendant.

Acht Tranchen, 24 Endpoint-Themen

CalVer	Cluster	Endpoints
2026.17	Solo-Investitionen	`/v1/afa`, `/v1/iab`, `/v1/gwg`
2026.18	Werbungskosten	`/v1/homeoffice`, `/v1/haushaltsnah`, `/v1/kleinunternehmer`
2026.19	Hauseigentümer/Energie	`/v1/photovoltaik`, `/v1/sanierung`, `/v1/waermepumpe`
2026.20	Löhne/Familie	`/v1/stundenlohn`, `/v1/kindesunterhalt`, `/v1/wohngeld`
2026.21	Rente/Sonstige	`/v1/aktivrente`, `/v1/vorfaelligkeitsentschaedigung`, `/v1/gez-befreiung`
2026.22	Altersvorsorge	`/v1/rente`, `/v1/altersvorsorgedepot`, `/v1/fruehstartrente`
2026.23	International/Freelance	`/v1/at-krypto`, `/v1/freelancer`, `/v1/kirchensteuer-austritt`
2026.24	Krypto	`/v1/krypto-steuer` (§ 23 EStG Spot + § 32d EStG Futures)

Dazu kamen seit April weitere Endpoints außerhalb der Tranchen: Verlustverrechnung, Vorabpauschale-Portfolio, Werte-Bundle, Basiszinssatz, Verzugszinsen, Kapitalertragsteuer-Standalone — und die fünf Payroll-Batches.

Payroll-Batches: 1.000 Mitarbeiter in einem Call

Lohnabrechnungen für mehr als zwei oder drei Mitarbeiter im Einzel-POST? Skaliert nicht. Seit CalVer 2026.13 und 2026.16 gibt es deshalb fünf Batch-Endpoints:

POST /v1/brutto-netto/batch          # bis 1.000 Mitarbeiter pro Call
POST /v1/minijob/batch
POST /v1/midijob/batch
POST /v1/arbeitgeber-kosten/batch
POST /v1/lohnkosten-netto/batch

Kernpunkt: Fehler werden pro Item isoliert. Eine kaputte Zeile fällt als calculation_error zurück, der Rest des Batches läuft durch. Kein All-or-Nothing, kein Re-Request für 999 valide Zeilen wegen einer falschen.

Drei Töpfe, ein Call: Verlustverrechnung

Aktien, sonstige Kapitalerträge und Krypto haben jeweils einen eigenen Verlustverrechnungstopf. Verluste aus dem Aktien-Topf dürfen nur mit Aktien-Gewinnen verrechnet werden — nicht mit Zinsen, nicht mit Krypto. Wer einen Robo-Advisor oder einen Steuer-Estimator baut, kann das in der Praxis nicht ignorieren.

POST /v1/verlustverrechnung deckt das in einem Call: Sparer-Pauschbetrag-Verteilung, BVerfG-Banner bei entstehendem Aktien-Verlustvortrag (Aktenzeichen 2 BvL 3/21), Anlage-KAP/Anlage-SO-Mapping in der Response. Cross-validiert gegen den gleichnamigen Webapp-Rechner.

Werte-Bundle: alle Stichtagswerte auf einmal

Früher musste man Grundfreibetrag, Sparer-Pauschbetrag oder Beitragsbemessungsgrenze pro Wert einzeln abfragen — oder die Zahlen in die eigene App hardcoden. Beides nervt. Der neue GET /v1/werte/current und GET /v1/werte/stichtag?datum=YYYY-MM-DD liefern alle Werte in einer Response, mit Quellenangabe (BGBl., BMF-Schreiben). Praktisch für Apps, die ihre eigenen Validierungs-Regeln aus offiziellen Werten ableiten wollen statt aus Random-Quellen im Internet.

Basiszins und Verzugszinsen

Die Bundesbank publiziert den Basiszinssatz halbjährlich (§ 247 BGB). Verzugszinsen sind Basiszins+5 % (Verbraucher) bzw. Basiszins+9 % (B2B-Geldforderungen). POST /v1/verzugszins rechnet konkrete Forderungen durch — Betrag mal Tage mal effektiver Zinssatz. Wer ein Mahnsystem baut, hat damit den gesetzlich korrekten Satz ohne eigene Tabellen-Pflege.

Kapitalertragsteuer mit §51a-Spezialformel

POST /v1/kapitalertragsteuer rechnet Bruttogewinn auf Netto-nach-Steuer um: 25 % Abgeltungsteuer, 5,5 % Soli darauf, plus Bundesland-spezifische Kirchensteuer (8 % BW/BY, 9 % Rest) nach der § 51a EStG-Spezialformel statt einer pauschalen 26,375-%-Annahme. Differenz liegt typisch bei 0,1 bis 0,3 Prozentpunkten — kleinklein, aber bei größeren Volumina spürbar.

Was die OpenAPI-Spec daraus macht

Die /openapi.json ist mit 72 Endpoints, JSON-Schemas pro Endpoint und vollständiger DE-Dokumentation in den Field-Descriptions ein vollwertiger Code-Generator-Input. Python-, TypeScript- oder Go-Clients lassen sich direkt aus der Spec generieren, ohne Nachzubessern. Postman-User importieren die Spec direkt über "Import → OpenAPI" und haben sofort alle 72 Endpoints als Collection.

Test-Disziplin

Die Test-Suite ist von 957 auf 1.344+ Tests gewachsen. Pro Endpoint gibt's mindestens einen Golden-Snapshot plus Cross-Validation gegen den entsprechenden Webapp-Rechner. Wenn API und Webapp jemals auseinanderlaufen, schlägt der Test an, bevor der Code in main landet. CalVer-Disziplin (2026.16, 2026.17 …) hält Breaking Changes nachvollziehbar — bisher gab's nur additive Changes.

Was als nächstes kommt

Der Webapp-Spiegel ist komplett. Nächste Etappe: Szenario-Bundles für die neuen Cluster. Wer eine PV-Anlage installiert und gleichzeitig die Wohnung saniert, soll einen Call statt drei brauchen — gleiches Pattern wie bei /v1/szenario/jobwechsel und /v1/szenario/immobilie. Daneben kommen ein paar GET-Endpoints für einzelne Stichtagswerte, weil nicht jeder Integrator das gesamte Werte-Bundle braucht.

FAQ

Brauche ich einen RapidAPI-Account, um die API zu nutzen? Ja, für alle nicht-öffentlichen Endpoints. Die Authentifizierung läuft über den RapidAPI-Proxy-Secret-Header (X-RapidAPI-Proxy-Secret). Die /openapi.json und der /health-Endpoint sind ohne Auth erreichbar.

Sind die 72 Endpoints stabil — also nicht Beta? Ja. Alle Endpoints sind unter dem Versions-Prefix /v1 und CalVer-versioniert. Bisher gab's nur additive Changes (neue Felder, neue Endpoints). Ein Bruch wäre /v2 — und ist nicht geplant.

Wie aktuell sind die Steuerwerte? Stichtag für alle Werte ist der Tag der API-Antwort. Das Werte-Bundle (GET /v1/werte/current) gibt die aktuell gültigen Werte plus Quellenangabe (BGBl./BMF-Schreiben). Historische Werte über GET /v1/werte/stichtag?datum=YYYY-MM-DD. Updates folgen typisch innerhalb von 2 Wochen nach BGBl.-Verkündung.

Was kostet die API? RapidAPI-Preis-Tier ab 0 EUR (Free-Tier mit Quota), dann gestaffelte Paid-Plans. Aktuelle Preisliste auf der RapidAPI-Listing-Seite.

Gibt es einen SLA? Nein, im Free-Tier nicht. Für Enterprise-Use mit SLA: direkt anfragen über das Impressum.