API wächst auf 33 Endpoints — Szenario-Bundles sind neu
Was neu ist
Vor drei Tagen stand die API bei 22 Endpoints. Jetzt sind es 33. Die großen Baustellen: Grundsteuer ab 2025, Sozialleistungen (Bürgergeld, BAföG) und vier Szenario-Bundles, die drei bis vier Rechner in einem Request zusammenfassen.
Grundsteuer: ein Endpoint, sechs Modelle
Das war das härteste Stück. Elf Bundesländer rechnen nach dem Bundesmodell, die anderen fünf nach ihren eigenen Formeln — Baden-Württemberg (Bodenwert), Bayern (Fläche), Hamburg (Wohnlage), Hessen (Fläche-Faktor), Niedersachsen (Fläche-Lage). Du schickst das Bundesland und die zum Modell passenden Felder, die API nimmt das richtige Verfahren. Fehlt ein Feld, sagt dir die Fehlermeldung welches — statt stumm zu raten.
{"bundesland": "Bayern", "hebesatz_prozent": 535, "grundstuecksflaeche_m2": 500, "gebaeudeflaeche_m2": 140}
Szenario-Bundles
Die eigentliche Neuerung. Wenn jemand den Job wechselt, kommen normalerweise vier Rechner ins Spiel: Brutto-Netto alt, Brutto-Netto neu, Abfindung mit Fünftelregel, und falls Lücke dazwischen, ALG I plus Progressionsvorbehalt. Statt vier API-Requests reicht jetzt einer an /v1/szenario/jobwechsel. Dasselbe Prinzip für drei andere Lebenslagen:
| Bundle | Kombiniert |
|---|---|
/v1/szenario/jobwechsel | Brutto-Netto alt + neu, Abfindung, ALG I, Progression |
/v1/szenario/familie | Basiselterngeld, ElterngeldPlus, Kindergeld, Steuerklassen-Empfehlung |
/v1/szenario/immobilie | Grunderwerbsteuer, Jahres-Grundsteuer, Notar, Grundbuch, Makler |
/v1/szenario/freelance-start | Einzelunternehmer vs. GmbH — Gesamtbelastung mit Break-even |
Die Bundles sind schlank im Input, die Response trägt alle Teilergebnisse. Wer nur eines davon braucht, kann weiterhin den Einzel-Endpoint nehmen.
Der Rest
- POST /v1/pendlerpauschale — 0,38 EUR pro Entfernungskilometer ab dem ersten. Jahresdeckel 4.500 EUR gilt für ÖPNV, Fahrrad und Mitfahrer, beim eigenen Auto nicht.
- POST /v1/schenkungsteuer — bekam einen eigenen Endpoint. Anders als bei der Erbschaftsteuer greifen hier die Versorgungsfreibeträge nach §17 ErbStG nicht.
- POST /v1/bürgergeld — Regelbedarf, Mehrbedarfe §21 SGB II, KdU, Erwerbstätigen-Freibeträge nach §11b. Die Response zeigt, wie die Abzugskette gelaufen ist.
- POST /v1/bafög — Grundbedarf §13, Wohnpauschale, KV/PV-Zuschlag, Elterneinkommen mit Freibeträgen §25, Vermögensanrechnung.
- POST /v1/kurzarbeitergeld — §§95–109 SGB III. Seit 2026 rechnet die API mit der neuen 21-%-SV-Pauschale statt 20 %.
- POST /v1/hebesätze/bulk — bis 1.000 AGS pro Request, für Portfolios mit vielen Standorten. Nicht gefundene AGS landen im Feld
nicht_gefunden, statt den ganzen Call zu kippen.
Unter der Haube
Das Subpaket steuerlogik ist jetzt sauber von FastAPI getrennt. Wer nur die Berechnungslogik braucht, installiert pip install rechner-hub-api und bekommt null externe Dependencies. Wer den FastAPI-Layer will, nimmt pip install rechner-hub-api[api]. Für Tests heißt das: Die Webapp kann direkt gegen steuerlogik als Library prüfen, statt einen HTTP-Roundtrip zu machen.
Dazu gab's Snapshot-Tests für alle neuen Endpoints und Cross-Validation gegen die bestehenden Webapp-Rechner. Wenn API und Webapp jemals auseinanderlaufen, schlägt der Test an.