API Changelog

1 neuer Endpoint — Webapp-Authority-Modul portiert

• +POST /v1/krypto — Krypto-Steuer (§ 23 EStG Spot + § 32d KapESt Futures). Single-Transaktion Kauf → Verkauf. Spot: Haltefrist-Prüfung mit BMF-Jahrestag-Logik (>12 Mo steuerfrei), Freigrenze 1.000 EUR ab 2024 (600 EUR bis 2023, KEIN Freibetrag — bei Überschreitung wird gesamter Gewinn steuerpflichtig), progressive ESt via Differenzmethode + Soli + KiSt. Futures: pauschale KapESt 25 % + Soli 5,5 % + ggf. KiSt (§ 32d Abs. 1 Satz 3 EStG-Spezialformel), keine Haltefrist, keine Freigrenze, Verlustverrechnung max 20.000 EUR/Jahr (§ 20 Abs. 6 Satz 5 EStG). Ampel: GRUEN (Haltefrist), GELB (Verlust/Freigrenze), ROT (steuerpflichtig).

Strategischer Hinweis

Krypto-Steuer-Markt ist von Cointracking/Blockpit dominiert. Dieser Endpoint zielt nicht auf Tracking-Konkurrenz, sondern auf einfache Single-Trade-Vorab-Prüfungen — ideal als Embed in Wallets, Börsen-Frontends oder Steuer-Bot-Integrationen ohne CSV-Import-Komplexität.

Endpoint-Count 71 → 72. Pytest 1.343+ grün, mypy clean (134 source files), ruff clean. Damit alle reinen Pure-Python-Webapp-Libs API'd — verbleibend nur co2steuer (braucht DB-Layer, Roadmap-defer).

3 neue Endpoints — AT-Krypto + Freelancer + Kirchenaustritt

• +POST /v1/at-krypto — Österreichische Krypto-KESt (§ 27b EStG AT). Fixer KESt-Satz 27,5 % unabhängig von Haltefrist + Einkommen. ACB-Bewertungsmethode (gleitender Durchschnittspreis, Pflicht seit 01.01.2023). Altbestand-Prüfung: Kauf vor 01.03.2021 + >1 J gehalten = steuerfrei. Liefert ACB, Gewinn/Verlust, KESt-Höhe, Netto-Erlös, E1kv-Hinweise bei Verlust.
• +POST /v1/freelancer — Freelancer-Stundensatz (§ 18 / § 15 EStG). Iterativ kostendeckender Stundensatz aus Wunsch-Netto + Betriebsausgaben + ESt + Soli + KiSt + KV/PV (21,1 % freiwillig, min 250 EUR/Mo) + Altersvorsorge (10 % pauschal) + ggf. Gewerbesteuer (Freibetrag 24.500 EUR × 14 %). Auslastungsmodell mit Urlaub + Krankheits-Puffer + Billable-Ratio. Marktvergleich 104 EUR Durchschnitt + 20 % Sicherheitspuffer.
• +POST /v1/kirchensteuer-austritt — Kirchenaustritt-Ersparnis (KiStG + § 10 Abs. 1 Nr. 4 EStG). KiSt 8 % BY/BW, 9 % übrige. Sonderausgaben-Effekt (KiSt × Grenzsteuersatz) abgezogen. Austrittsgebühren je BL (0 EUR BY/BW/SN/TH bis 30 EUR übrige), Break-even-Tage gegen Gebühr, 10/20/30-J-Projektion. Eingabe ist zvE direkt; Splitting für Zusammenveranlagung.

B2B-Use-Cases (D1-Tranche-7 — finale Drift-Sweep-Tranche)

• AT-Krypto-Börsen / Wallets: Bitpanda-Konkurrenz mit eigener KESt-Berechnung. Bislang kein DACH-API-Anbieter außer Inhouse.
• Freelancer-/Coworking-Plattformen: Live-Stundensatz-Empfehlung als Onboarding-Tool für neue Selbst.
• Steuersoftware / Finanzberater: Kirchenaustritt-ROI-Rechner als Kundenservice-Feature.

Endpoint-Count 68 → 71. Pytest 1.328+ grün, mypy clean (132 source files), ruff clean. D1-Tranche-7 schließt den Cross-Repo-Drift-Sweep ab — die nächsten Webapp-Libs (krypto, co2steuer) benötigen DB-Layer und werden in späteren Sprints angegangen.

3 neue Endpoints — Renten-Cluster (gesetzlich + privat + Kinder)

• +POST /v1/rente — Gesetzlicher Rentenrechner (§§ 63-68 SGB VI). Rentenformel: Punkte × Zugangsfaktor × Rentenwert (42,52 EUR 2026) × Rentenartfaktor. Regelaltersgrenze gestaffelt 1947-1963, § 77 SGB VI Zugangsfaktor (-0,3 %/Monat früh, +0,5 %/Monat spät), BBG RV 101.400 EUR/J. 4 Szenarien (63/65/67/70) + Rentenlücke + ETF-Sparplan-Empfehlung + inflationsbereinigte Kaufkraft.
• +POST /v1/altersvorsorgedepot — Riester-Nachfolger (Altersvorsorgedepotgesetz ab 2027). Zulagen-Staffel: 50 % auf erste 360 EUR (max 180), 25 % auf 360-1.800 EUR (max 360), Kinderzulage 100 % auf 300 EUR/Kind. SA-Abzug § 10a EStG bis 3.000 EUR. Günstigerprüfung Zulage vs Steuervorteil. Riester-Vergleich + 37-J-Projektion.
• +POST /v1/fruehstartrente — Kinder-Rentendepot 2026 (Eckpunkte 17.12.2025, BMF-FAQ 27.01.2026). Staatlich 10 EUR/Mo Kind-6-18 + optional Eltern-/Kind-Aufstockung. ETF-Rendite 6 %, Auszahlung bei Renteneintritt 67. Liefert Kapitalstock bei 18 + bei Renteneintritt, 25-J-Annuität, Vorteil mit Eltern vs nur-Staat, Wachstumsfaktor.

B2B-Use-Cases (D1-Tranche-6)

• Renten-/Vorsorge-Plattformen: Rentenlücken-Analyse als Lead-Gen-Tool für ETF-Sparplan-Anbieter.
• Versicherer / Bauspar-Kassen: Altersvorsorgedepot vs Riester-Vergleich als Verkaufsargument für 2027er-Migration.
• Familien-/Kinder-Finanz-Apps: Frühstart-Rente-Rechner als Engagement-Feature für Familien.

Endpoint-Count 65 → 68. Pytest 1.310+ grün, mypy clean (126 source files), ruff clean. Rente nach §§ 63-68 SGB VI mit aktuellem Rentenwert 42,52 EUR (Stand 01.07.2026 Projektion).

3 neue Endpoints — Rente, Immobilien-Finanzierung & Sozial

• +POST /v1/aktivrente — Aktivrente-Freibetrag (Aktivrentegesetz 01.01.2026). Bis 2.000 EUR/Monat (24.000 EUR/Jahr) steuerfreier Hinzuverdienst — OHNE Progressionsvorbehalt. ESt+Soli+KiSt-Vergleich altes vs neues Recht, monatliche/jährliche Ersparnis. KiSt 8 % BY/BW oder 9 % übrige Bundesländer. Besteuerungsanteil 50-100 % einstellbar.
• +POST /v1/vorfaelligkeitsentschaedigung — VFE-Rechner BGH-Aktiv-Passiv-Methode (BGH XI ZR 27/00). Refinanzschaden × Restlaufzeit, abzüglich ersparte Verwaltungs- und Risikokosten. §502 BGB-Cap für Verbraucherkredite (max 1 % bzw 0,5 % Restschuld). §489 BGB-Sonderkündigungsrecht nach 10 J Volltransfer (OHNE VFE). Werbungskosten-Absetzbarkeit §9 EStG bei Vermietung (BFH IX R 38/16).
• +POST /v1/gez — GEZ-Befreiungsrechner §4 RBStV. 7-stufiger Entscheidungsbaum: Nebenwohnung (§4 Abs. 2a), Pflegeheim, 10 Katalog-Sozialleistungen (Bürgergeld/Sozialhilfe/BAföG/Asyl/Pflege/...), Merkzeichen TBl (Vollbefreiung) und RF (Ermäßigung 6,12 EUR), Härtefall-Prüfung. Liefert Status + Ampel + Ersparnis + Rechtsgrundlage + Dokumentenliste + Antrags-Link.

B2B-Use-Cases (D1-Tranche-5)

• Renten-/Vorsorge-Plattformen: Aktivrente-Ersparnis als Mehrverdienst-Anreiz zeigen.
• Bauspar-/Hypothekenkredit-Plattformen: VFE-Prüfung als Vorab-Check bei Umschuldung oder Kündigung — Standard-Tool, bislang ohne API-Konkurrent.
• Sozialberatungs- und Bürgerservice-SaaS: GEZ-Befreiungs-Check als Vor-Prüfung mit Dokumentenliste.

Endpoint-Count 62 → 65. Pytest 1.283+ grün, mypy clean (120 source files), ruff clean. Aktivrente nach Aktivrentegesetz 2026, VFE nach BGH XI ZR 27/00 Aktiv-Passiv-Methode, GEZ nach §4 RBStV.

3 neue Endpoints — Arbeit, Familie & Wohnen

• +POST /v1/stundenlohn — Stundenlohn ↔ Monatsgehalt-Umrechner. Bidirektional: 25 EUR/h → 4.333 EUR Monat oder umgekehrt. Wochenfaktor 52/12 = 4,333 Stunden/Woche ↔ Stunden/Monat. Netto via BMF-PAP 2026 inkl. Steuerklasse 1-6, Bundesland, Kirchensteuer, Kinder-PV-Abschlag, Sachsen-Sonderregel.
• +POST /v1/kindesunterhalt — Kindesunterhalt nach Düsseldorfer Tabelle 2026. 15 Einkommensstufen × 4 Altersstufen (0-5/6-11/12-17/ab 18). Bereinigung 5 % Berufskosten (min 50, max 150 EUR), Kindergeld-Anrechnung hälftig (259 EUR/2), Mangelfallprüfung gegen Selbstbehalt 1.450/1.200 EUR. Bedarfssätze 486-1.396 EUR.
• +POST /v1/wohngeld — Wohngeld nach § 19 WoGG (Wohngeld-Plus 2023+). Formel W = M - (a+b·M+c·Y)·Y mit Koeffizienten je Haushaltsgröße (Anlage 2). Mietobergrenzen Stufe 1-7 × HH-Größe 1-12+, Heizkomponente 2,00 EUR/qm + Klimakomponente 0,40 EUR/qm. Pauschalabzug 20 %, Werbungskostenpauschale, Schwerbehindertenfreibetrag 125 EUR.

B2B-Use-Cases (D1-Tranche-4)

• HR-/Job-Plattformen: Stundenlohn-Netto live anzeigen — Standard im KMU-Segment, bislang ohne API-Konkurrent.
• Mediations-/Rechtsanwalts-SaaS: Kindesunterhalt als Verhandlungsbasis. Kein DACH-API-Wettbewerber.
• Wohnungsbau-/Sozialberatungs-Software: Wohngeld-Prüfung als Vor-Prüfung statt Behördengang.

Endpoint-Count 59 → 62. Pytest 1.254+ grün, mypy clean (114 source files), ruff clean. Düsseldorfer Tabelle 2026 i.d.F. OLG Düsseldorf, gültig ab 01.01.2026.

3 neue Endpoints — Energiewende-Bundle (Eigentümer-Förderungen)

• +POST /v1/photovoltaik — PV-Steuer-Befreiung § 12 Abs. 3 UStG + § 3 Nr. 72 EStG. Nullsteuersatz USt automatisch bis 30 kWp, ESt-Befreiung 30 kWp pro EFH/Gewerbe bzw. 15 kWp je Wohneinheit MFH, max 100 kWp Summengrenze. USt-Ersparnis Anschaffung + ESt-Ersparnis über Laufzeit (default 20 Jahre).
• +POST /v1/sanierung — Energetische Sanierung § 35c EStG 20 % der Kosten über 3 Jahre (7/7/6 %), max 40.000 EUR pro Objekt mit Jahres-Caps 14k/14k/12k. Prüfung Voraussetzungen (Gebäude >= 10 J, Eigennutzung, kein Doppel-Förderung). Programmlaufzeit bis 2029.
• +POST /v1/waermepumpe — KfW 458 Wärmepumpen-Förderung (BEG EM). 4 Bonus-Bausteine: Grund 30 %, Klimabonus 20 % (bis 2028), Einkommen 30 % (HH-zvE ≤ 40k), Effizienz 5 %. Gesetzlicher Max-Cap 70 %. Vergleicht mit § 35c-Alternative (Doppelförderverbot).

B2B-Use-Cases (D1-Tranche-3)

• Solarteur-/Installateur-CRM: Live-Berechnung der Steuer-/Förderungs-Ersparnis als Verkaufsargument.
• Energieberater-Tools: § 35c + KfW 458 in einer API statt Inhouse-Pflege der vielen BEG-EM-Regeln.
• Immobilien-SaaS: Modernisierungs-Förderungs-Optionen pro Objekt anzeigen.

Endpoint-Count 56 → 59. Pytest 1.232 grün, mypy clean (108 source files), ruff clean. PV-/Sanierungs-/Wärmepumpen-Daten aus 2026er BEG-Förderrichtlinie i.d.F. 17.07.2025.

3 neue Endpoints — Arbeitnehmer- & Selbständigen-Standards

• +POST /v1/homeoffice — Homeoffice-Pauschale + Pendlerpauschale-Optimierung. § 4 Abs. 5 Nr. 6c EStG (6 EUR/Tag, max 1.260 EUR p.a.) vs § 9 Abs. 1 Nr. 4 EStG (0,38 EUR/km ab 2026, einheitlich ab dem 1. Kilometer). Brute-force aller Aufteilungen, Break-even bei ~15,8 km, Steuerersparnis im Marginal-Satz.
• +POST /v1/haushaltsnah — Haushaltsnahe Leistungen § 35a EStG, 3 Kategorien: Minijob (Cap 510 EUR), Dienstleistungen (Cap 4.000 EUR), Handwerker (Cap 1.200 EUR). 20 % auf Lohn-Anteil — Cap-Flags pro Kategorie. § 35a Abs. 5 EStG-Hinweise: Banküberweisung Pflicht, kein Material absetzbar.
• +POST /v1/kleinunternehmer — Kleinunternehmer-Grenze § 19 UStG (JStG 2024). Prüft Vorjahresgrenze (25.000 EUR) und laufende Grenze (100.000 EUR), Hochrechnung aus monatlichem Schnitt, Warnmonat ab dem 100k voraussichtlich erreicht wird, Ampel-Status grün/gelb/rot.

B2B-Use-Cases (D1-Tranche-2)

• HR-/Lohn-SaaS: Homeoffice-Optimierung als Mitarbeiter-Service-Feature.
• Steuersoftware-Komponenten: § 35a-Ermäßigung als standardisierter Endpoint anstelle Inhouse-Pflege der Caps und Grenzen.
• Buchhaltungs-SaaS für Solo-Selbst.: Kleinunternehmer-Status-Check als Live-Monitoring-Feature mit monatlichem Hochrechnungs-Update.

Endpoint-Count 53 → 56. Pytest 1.210 grün, mypy clean (102 source files), ruff clean.

3 neue Endpoints — Anlagevermögen & KMU-Investitionen

• +POST /v1/afa — Lineare vs degressive AfA 2025-2027. § 7 Abs. 1 EStG (linear) vs § 7 Abs. 2 EStG i.d.F. Wachstumsbooster-Gesetz (degressiv, Faktor max 3,0 × linear, gedeckelt 30 %). Jahresplan beider Methoden inkl. automatischem Wechsel degressiv → linear (§ 7 Abs. 3 EStG) und Liquiditäts-Vorzieheffekt im Marginalsteuersatz. Pro-rata-temporis (§ 7 Abs. 1 Satz 4 EStG) per Anschaffungsmonat.
• +POST /v1/iab — Investitionsabzugsbetrag + Sonder-AfA nach § 7g EStG. Bis 50 % der geplanten AK (max 200.000 EUR) außerbilanziell vor Anschaffung + 40 % Sonder-AfA. Berechtigungs-Prüfung Gewinn-Vorjahr ≤ 200.000 EUR (§ 7g Abs. 1 Nr. 1b EStG), Jahresplan Jahr 0..ND, Vergleich Liquiditäts-Vorzieheffekt vs Nur-Linear.
• +POST /v1/gwg — Geringwertige Wirtschaftsgüter (§ 6 Abs. 2 / 2a EStG). Vergleicht Sofort (≤ 800 EUR), Sammelposten (250,01-1.000 EUR auf 5 Jahre) und lineare AfA. Liefert pro Methode den Jahresplan und die Steuerwirkungs-Bilanz im Marginalsteuersatz, plus die beste Methode für das Wirtschaftsgut.

B2B-Use-Cases

• Buchhaltungs-/Steuersoftware: Standard-Berechnungen die DATEV, Lexware oder sevDesk-Konkurrenten brauchen.
• FinTech/InvestTech: Investment-Plattformen die KMU-Beratung anbieten (was lohnt sich steuerlich?).
• Asset-Management-SaaS: Tools für Anlageverwaltung mit deutschen Steuerrechtsregeln.

D1-Tranche-1 aus Cross-Repo-Drift-Sweep. Pure-Python-Libs aus dem Webapp-Repo extrahiert (zero deps, byte-gleich-verifiziert). Pytest 1.188 grün, mypy clean.

3 neue Endpoints — Lohn-Batches komplettiert (A1.5)

• +POST /v1/midijob/batch — Midijob-Berechnung im Übergangsbereich (603,01 - 2.000 EUR) für bis zu 1.000 Mitarbeiter in einem Aufruf. Per-Item-Error-Isolation: Items außerhalb des Bereichs werden als success=False markiert, andere Items werden trotzdem berechnet.
• +POST /v1/arbeitgeber-kosten/batch — Vollständige AG-Gesamtkosten (KV/PV/RV/AV + Umlagen U1/U2/Insolvenzgeld + BG-Beitrag) für bis zu 1.000 Mitarbeiter. Killer-Use-Case für Lohn-/HR-SaaS mit konfigurierbaren Umlagesätzen.
• +POST /v1/lohnkosten-netto/batch — Lohnkosten-zu-Netto-Umkehrrechnung (AG-Gesamtkosten-Budget → Brutto → Netto) für bis zu 1.000 Mitarbeiter. Items mit unerreichbarem Ziel werden als per-row-error isoliert.

Phase A1 abgeschlossen

• Komplettes Lohn-Batch-Quintett: brutto-netto + minijob + midijob + arbeitgeber-kosten + lohnkosten-netto laufen jetzt alle als Batch via api/_batch.py Generic-Helper. Sechs Batch/Portfolio-Routen insgesamt (mit Vorabpauschale-Portfolio).
• Pattern unverändert: Per-Item-Error-Isolation, top-level success=True, per-row data.items[i].success, max 1.000 Items, 422 ab 1.001.
• Single-Endpoints unberührt: kein Breaking-Change für bestehende Aufrufer von /v1/midijob, /v1/arbeitgeber-kosten, /v1/lohnkosten-netto. Single-Handler ruft intern dieselbe _compute_*_data-Funktion wie der Batch-Handler — byte-gleich-verifiziert.

Pytest: 1.164 Tests grün (+21 Batch). Mypy clean. Ruff clean. Defer-Versprechen aus 2026.13 eingelöst.

4 neue Endpoints — Basiszinssatz §247 BGB + Verzugszinsen §288 BGB

• +GET /v1/basiszins/current — aktueller Basiszinssatz nach §247 BGB (halbjährlich Anpassung 1.1./1.7.). 2026-01-01: 1,27 %. Cache-Control: public, max-age=86400.
• +GET /v1/basiszins/series — komplette Reihe seit Einführung 2002 (49 Einträge). Killt das Hardcoden bei jedem halbjährlichen Wechsel.
• +GET /v1/basiszins/{stichtag} — Satz für einen frei wählbaren Stichtag (mind. 2002-01-01). Auflösung des Geltungsbeginns automatisch.
• +POST /v1/verzugszins — Verzugszinsen-Berechnung §288 BGB: Forderung + Fälligkeit + Zahlungsdatum (default heute) -> Verzugszinsen pro Halbjahres-Fenster. b2c (+5 Pkt) oder b2b (+9 Pkt). actual/365. Optional 40-EUR-Pauschale §288 Abs. 5 BGB (B2B-only).

Was ist daran besonders?

• Halbjahres-genaue Aufschlüsselung: Wechselt der Basiszins während des Verzugszeitraums (1.1./1.7.), rechnet die API pro Fenster mit dem dort gültigen Satz — keine Mischzinsen, keine Tagesdurchschnittsbildung. Entspricht BGH-Standard.
• Verzugsbeginn = Tag NACH Fälligkeit nach §286 Abs. 1 BGB — Fälligkeitstag selbst zählt nicht. Endpunkt = Zahlungsdatum (zählt MIT). Viele Online-Verzugszinsrechner bauen den Off-by-One-Fehler hier rein.
• Pauschale §288 Abs. 5 BGB wird separat ausgewiesen, NICHT in verzugszinsen_summe_eur addiert — gibt dem Aufrufer Kontrolle ob er die 40 EUR mahnen will (B2B-Recht, nicht zwingend).
• Pflege-Hinweis: Nächster Basiszins wird am 1. Juli 2026 publiziert (Bundesbank). Reihe wird dann mit dem neuen Wert ergänzt — bestehende Berechnungen bleiben deterministisch.

Cache-Strategie: /v1/basiszins/* liegt im Public-Cache (24h CDN), /v1/verzugszins ist no-store (rechnet pro Request mit Heutedatum als Default). Cross-Validation via SOURCES_2026.md §9e/§9f.

2 neue Endpoints — Werte-Bundle (alle deutschen Lohn-/Steuerwerte als 1-Call-JSON)

• +GET /v1/werte/current — Snapshot zum heutigen Tag: BBG (KV/PV/RV/AV), alle SV-Sätze AN+AG, ESt-Tarif (5 Zonen + Grundfreibetrag), Lohnsteuer-PAP-Hilfsbeträge (ANP/SAP/EFA/KFB/VSP), Pfändungsfreigrenzen-Bekanntmachung, Firmenwagen-1%-Regelung incl. BEV-Stichtag-Logik, alle 16 Bundesländer (KiSt + GrESt + PV-Sachsen-Sonder), Vorabpauschale-Basiszins-Reihe seit 2018, Sachbezugswerte SvEV (Verpflegung/Unterkunft/Wohnung), Inland-Reisekostenpauschalen (§9 Abs. 4a EStG inkl. Mahlzeitenkürzung).
• +GET /v1/werte/{stichtag} — gleiches Bundle für einen frei gewählten Stichtag (ISO YYYY-MM-DD). Pfändungs-Bekanntmachung wird per Stichtag korrekt ausgewählt, Jahres-Werte aus dem Stichtag-Jahr.

Was ist neu daran?

• Single-Call-Snapshot: bisher musstest du 8+ Endpoints abfragen oder die Werte hardcoden. Jetzt 1 Call à ~20 KB JSON.
• Cache-Control: public, max-age=86400 — abweichend vom globalen no-store der API. Determi­nistic per Stichtag, daher CDN-cachebar.
• ETag + If-None-Match Roundtrip: Client schickt ETag zurück, Server antwortet 304 wenn unverändert. Spart Bandbreite bei daily-Cron-Use-Cases.
• Last-Modified-Header: zeigt das jüngste relevante Datum im Bundle (Pfändungs-Bekanntmachungs-Beginn oder Jahresanfang).
• Sachbezug + Inland-Reisekosten: bisher in keinem Endpoint exposed. SvEV §2 (Verpflegung 333 EUR/Mo, Unterkunft 282 EUR/Mo) und §9 Abs. 4a EStG (Volltag 28 EUR, Halbtag 14 EUR, Mahlzeitenkürzung 5,60/11,20/11,20).
• Quellen-Array: jeder Snapshot enthält Primärquellen-URLs mit Abrufdatum.

Wartungs-Hinweis: BASISZINS jährlich Anfang Januar (BMF-Schreiben) erweitern, SvEV-Werte jährlich Anfang Dezember nachziehen falls 14./15. ÄndVO neue Werte bringt. Auslandsreisekosten 195 Länder als separater Endpoint (Phase A4) geplant.

3 neue Endpoints — Vorabpauschale-Portfolio + Lohn-Batches

• +POST /v1/vorabpauschale/portfolio — Multi-Fonds-Vorabpauschale für einen Anleger (max 1.000 Fonds in einem Aufruf). Optimiert für Robo-Advisor-Use-Cases mit n Kunden × m Fonds. Per-Item-Error-Isolation: Schlägt ein Fonds fehl (z.B. Lib-Fehler), werden andere dennoch berechnet. Aggregierte summe_steuerpflichtig-Bilanz über erfolgreiche Items.
• +POST /v1/brutto-netto/batch — n Mitarbeiter-Brutto-Netto-Berechnungen in einem Aufruf (max 1.000). Killer-Use-Case für Lohn-/HR-SaaS mit pro-Monat-Slip-Generation.
• +POST /v1/minijob/batch — Minijob/Midijob-Status für bis zu 1.000 Mitarbeiter, gleiche Per-Item-Error-Isolation.

Warum diese Endpoints?

• Vorabpauschale-Portfolio ist verifizierter DACH-White-Space — aktuell gibt es nur eine GitHub-Lib (MStrecke) und Parqet-Inhouse als Konkurrenz. Robo-Advisors berechnen die VAP heute per Inhouse-Job zum Jahresanfang und sparen mit dem API-Call Engineer-Tage.
• Brutto-Netto-Batch + Minijob-Batch covern den Lohn-/HR-SaaS-Use-Case — ein Batch statt n Single-Calls, mit per-row-Error-Isolation statt Whole-Body-422.
• Top-level success=True bleibt bestehen solange das Body well-formed war — per-row Status liegt in data.items[i].success.
• Performance-verifiziert: 1.000 Items <3 s Pure-Python-Decimal-Math, kein I/O.

Defer auf spätere Version: midijob/batch, arbeitgeber-kosten/batch, lohnkosten-netto/batch — in 2026.16 nachgereicht.

1 neuer Endpoint — Standalone-Kapitalertragsteuer

• +POST /v1/kapitalertragsteuer — KapESt 25 %, Soli 5,5 % und bundeslandspezifische Kirchensteuer (8 % BY/BW, 9 % übrige) auf eine bereits bereinigte Bemessungsgrundlage. Bei aktiver KiSt greift die §51a Abs. 2c EStG-Spezialformel KapESt = e / (4 + k), die viele Marketplace-Wettbewerber falsch ansetzen.

Warum dieser Endpoint?

• Wer Sparer-Pauschbetrag und Verlustverrechnung selbst aufbereitet (Buchhaltung, Broker-Backend), kann jetzt nur die Quellensteuer-Mathematik anziehen — ohne den Bundle /v1/szenario/aktien-etf mit-anstoßen zu müssen.
• Webapp-Pendant unter /aktien/verkauf-steuer-rechner/ — Single-Position-UX für einen einzelnen Aktien-/ETF-Verkauf.
• Additiv, kein Breaking-Change.

FirmenwagenData Transparenz-Felder

• +bev_grenze_applied (int|null) — angewandte BEV-Listenpreis-Grenze in EUR (70.000 vor 01.07.2025, 100.000 ab Stichtag, null für Verbrenner/PHEV).
• +bev_stichtag (date) — Stichtag des Investitionssofortprogramms (2025-07-01).
• +anschaffungsdatum_used (date) — effektiv genutztes Anschaffungsdatum (Request-Wert oder date.today()).

Warum?

• API-Consumer in Steuersoftware können jetzt nachvollziehen, welche BEV-Listenpreis-Grenze (70k oder 100k EUR) auf eine Berechnung angewendet wurde.
• Webapp-Frontend exposed das seit 25.04.2026 — API zog jetzt nach (Inkonsistenz behoben).
• Additiv, kein Breaking-Change — bestehende Clients ignorieren die neuen Felder.

Sentry-PII-Hardening (intern)

• Performance-Traces (before_send_transaction) strippen jetzt X-RapidAPI-User, X-RapidAPI-Subscription, Authorization-Header. Keine User-Identifier in Sentry.

1 neuer Bündel-Endpoint — Aktien & ETF Komplett-Steuer

• +POST /v1/szenario/aktien-etf — Aggregiert Vorabpauschale (§18 InvStG) + 3-Topf-Verlustverrechnung (§20 Abs. 6 EStG + §23 EStG) + echte Kapitalertragsteuer mit bundeslandspezifischer Kirchensteuer (§51a Abs. 2c EStG-Spezialformel) in einem Aufruf. Liefert die tatsächliche Steuerlast statt der überschlägigen 26,375-%-Pauschale.

Warum dieser Bündel-Endpoint?

• Ein API-Call statt drei (Vorabpauschale + Verlustverrechnung + KapESt-Aufschlüsselung).
• BL-spezifische KiSt: 8 % in Bayern und Baden-Württemberg, 9 % in den übrigen 14 Ländern. Effektivsatz inkl. KiSt: 27,82 % (BY/BW) bzw. 27,99 % (übrige) statt der pauschalen 26,375 %, die viele Online-Rechner ansetzen.
• Hinweis: Krypto-Saldo wird mit persönlichem ESt-Tarif §32a EStG versteuert — nicht mit 25 % KapESt. Der Endpoint markiert das explizit.

2 neue Endpoints — Aktien & ETF Cluster

• +POST /v1/verlustverrechnung — 3-Topf-Verlustverrechnung nach §20 Abs. 6 EStG (Aktien-Topf, Sonstiger Topf) und §23 EStG (Krypto-Topf). Mit Sparer-Pauschbetrag, §23-Freigrenze 1.000 EUR und BVerfG-Watch (2 BvL 3/21).
• +POST /v1/vorabpauschale — Vorabpauschale für thesaurierende ETF/Fonds nach §18 InvStG. Basiszins-Reihe 2018–2026 (BMF-Schreiben jährlich), 70-Prozent-Faktor §16, Wertsteigerungs-Cap, Teilfreistellung §20 (5 Quoten 0/15/30/60/80 %).

Quellen

• Basiszins 2026 = 3,20 % laut BMF-Schreiben vom 13. Januar 2026.
• Die frühere 20.000-EUR-Verlustverrechnungs-Begrenzung für Termingeschäfte (§20 Abs. 6 Satz 5 EStG a.F.) wurde durch das Jahressteuergesetz 2024 (06.12.2024) ersatzlos aufgehoben.

11 neue Endpoints

• +POST /v1/pendlerpauschale — Entfernungspauschale nach §9 EStG mit Steuerersparnis
• +POST /v1/schenkungsteuer — Schenkung zu Lebzeiten, eigener Endpoint (ohne §17-Versorgungsfreibetrag)
• +POST /v1/grundsteuer — Bundesmodell plus 5 Landesmodelle (BW, BY, HE, NI, HH)
• +POST /v1/kurzarbeitergeld — §§95–109 SGB III mit 21 %-SV-Pauschale
• +POST /v1/buergergeld — SGB II mit Mehrbedarfen und Einkommens-Freibeträgen
• +POST /v1/bafoeg — Förderbetrag inkl. Elterneinkommen und Vermögensanrechnung
• +POST /v1/hebesaetze/bulk — Lookup bis 1.000 AGS pro Request
• +POST /v1/szenario/jobwechsel — Brutto-Netto alt/neu + Abfindung + ALG I + Progression
• +POST /v1/szenario/familie — Elterngeld + Kindergeld + Steuerklassen-Empfehlung
• +POST /v1/szenario/immobilie — GrESt + Grundsteuer + Kaufnebenkosten
• +POST /v1/szenario/freelance-start — Einzelunternehmer vs. GmbH mit Break-even

Datenaktualisierung

• ~SV-Pauschale beim Kurzarbeitergeld 20 % → 21 % (seit 2026)
• ~BEV-Grenze Firmenwagen 70.000 EUR → 95.000 EUR (Änderung Wachstumschancengesetz)
• ~Diverse kleinere Konstanten-Korrekturen nach SOURCES_2026.md

Infrastruktur

• ·steuerlogik ist jetzt ein dep-freies Subpaket — FastAPI/uvicorn nur noch unter [api]-Extra
• ·Golden-Snapshot-Tests für alle neuen Endpoints + Cross-Validation gegen Webapp

13 neue Endpoints

• +POST /v1/netto-brutto — Umkehrrechnung: Wunsch-Netto → Brutto
• +POST /v1/lohnkosten-netto — AG-Budget → Brutto + Netto
• +POST /v1/arbeitgeber-kosten — Alle AG-Anteile einzeln (KV, PV, RV, AV, U1, U2)
• +POST /v1/pfaendung — Pfändungsfreigrenzen nach §850c ZPO
• +POST /v1/progressionsvorbehalt — Mehrbelastung durch Lohnersatzleistungen
• +POST /v1/gewerbesteuer — GewSt mit Hebesatz-DB (10.754 Gemeinden)
• +GET /v1/hebesaetze + GET /v1/hebesaetze/{ags} — Hebesatz-Suche
• +POST /v1/koerperschaftsteuer — GmbH-Gesamtbelastung + EU-Vergleich
• +POST /v1/firmenwagen — Geldwerter Vorteil (1%/0,5%/0,25%-Regel)
• +POST /v1/elterngeld — Basis + ElterngeldPlus nach BEEG
• +POST /v1/alg1 — Arbeitslosengeld I mit Bezugsdauer
• +POST /v1/krankengeld — Gesetzliches Krankengeld (70%/90%-Regel)

Technisch

• •SQLite-DB mit allen Steuerjahr-Parametern, ESt-Tarifen und Gemeinde-Hebesätzen
• •Hebesatz-Suche 10x schneller (SQL statt Python-Filter)
• •tax_year-Parameter auf ALG I, KSt und Firmenwagen
• •Sparplan: jahresverlauf nur bei detail: true

API umfasst jetzt 22 Endpoints (20 POST + 2 GET). Keine Breaking Changes an bestehenden Endpoints.

Neue Endpoints

• +POST /v1/abfindung — Steuer auf Abfindungen mit/ohne Fünftelregelung (§34 EStG)
• +POST /v1/erbschaftsteuer — Erbschaft- und Schenkungsteuer nach ErbStG
• +POST /v1/weihnachtsgeld — Netto-Sonderzahlung, Sechstelregel
• +POST /v1/steuerklassen — III/V vs. IV/IV für Ehepaare
• +POST /v1/einkommensteuer — Reiner §32a-Tarif mit Grenzsteuersatz und Tarifzone
• +POST /v1/sparplan — Zinseszinsrechner mit jährlicher KapESt

API umfasste danach 9 Endpoints.

Erster Release

• +POST /v1/brutto-netto — Gehaltsabrechnung mit Lohnsteuer, SV, AG-Kosten
• +POST /v1/grunderwerbsteuer — Kaufnebenkosten, 16-Bundesländer-Vergleich
• +POST /v1/minijob — Minijob/Midijob-Erkennung, SV-Beiträge

Technisch

• •BMF-Programmablaufpläne 2026
• •Response-Envelope: success, data, input_echo, meta
• •Geldbeträge als Dezimal-Strings
• •Verfügbar auf RapidAPI