Krankenkassen (HealthInsuranceFund)

Zweck

Die Krankenkassen-Stammdaten (/health-insurance-funds) liefern dem Lohnlauf die Sätze, mit denen Sozialversicherung und Umlagen berechnet werden: Zusatzbeitrag, U1/U2-Umlagesätze (Arbeitgeber-Zahlung) und U1/U2-Erstattungssätze (AAG-Erstattung an den Arbeitgeber). Über den GKV-Sync lassen sich die aktuellen Sätze aus der offiziellen Krankenkassen-Stammdatendatei abgleichen.

Voraussetzungen

- Berechtigung `view:FE_HealthInsuranceFund` und `view:HealthInsuranceFund`. - Zum Anlegen/Ändern/Löschen die jeweiligen Rechte; für den GKV-Sync `update:HealthInsuranceFundContribution`.

Berechtigungen (CASL)

Action	Subject	Wirkung
view	FE_HealthInsuranceFund, HealthInsuranceFund	Seite aufrufbar
create/update/delete	HealthInsuranceFund	Krankenkasse pflegen
view/update	HealthInsuranceFundContribution	Zusatzbeitrags-Historie + GKV-Sync

Felder

Feldname	Datentyp	Bedeutung
name	String	Name der Krankenkasse (eindeutig).
shortName	String	Kurzname/Akronym (z. B. „AOK").
betriebsnummer	String	Betriebsnummer — Join-Schlüssel zur ITSG-Stammdatendatei (GKV-Sync).
zusatzbeitragPercent	Decimal	Aktueller Zusatzbeitragssatz (%).
u1UmlagesatzPercent / u2UmlagesatzPercent	Decimal	Umlagesätze (Arbeitgeber-Zahlung) für U1 (Krankheit) bzw. U2 (Mutterschaft).
u1ErstattungssatzPercent / u2ErstattungssatzPercent	Decimal	Erstattungssätze (AAG) — wie viel der Arbeitgeber zurückbekommt.
iban / creditorId	String	Zahlungsverkehr (IBAN, SEPA-Gläubiger-ID).
transactionAccountId	UUID	Zugeordnetes Bankkonto.
active	Boolean	Aktiv (fließt in den Forecast ein).

GKV-Sync

Der GKV-Sync (POST /health-insurance-funds/sync) gleicht die hinterlegten Kassen über die Betriebsnummer gegen die offizielle Stammdatendatei ab:

1. Vorschau (Dry-Run, apply: false): zeigt, welche Betriebsnummern zugeordnet werden und welche Beitragssätze sich ändern — ohne zu schreiben.
2. Übernehmen (apply: true): schreibt die geänderten Zusatzbeiträge als neue Zusatzbeitrags-Einträge (HealthInsuranceFundContribution) mit Gültigkeit (validFrom/validTo).

So bleibt die Beitrags-Historie nachvollziehbar (alte Sätze bleiben mit ihrem Gültigkeitszeitraum erhalten).

Der GKV-Sync **ergänzt** nicht nur Sätze bestehender Kassen, sondern **legt auch Kassen neu an**, die in der offiziellen GKV-Stammdatendatei stehen, aber noch nicht in SpeamCore existieren (Name, Betriebsnummer, Gläubiger-ID, Zusatzbeitrag, U1/U2-Umlagen). Damit lässt sich eine **leere Krankenkassen-Tabelle mit einem Klick** aus der amtlichen Quelle befüllen. Dubletten werden über **Betriebsnummer/Name** vermieden. In der Vorschau werden die neu anzulegenden Kassen mit angezeigt; der Sync-Button meldet anschließend die Zahl der erstellten Kassen.

Zusatzbeitrags-Historie

Pro Kasse gibt es eine bearbeitbare Liste der Zusatzbeiträge (HealthInsuranceFundContribution): zusatzbeitragPercent, validFrom, validTo. Aufruf: /health-insurance-funds/:id/contributions.

API/Schnittstellen

Methode	Endpoint	Zweck	CASL
GET	/api/health-insurance-funds	Liste	view HealthInsuranceFund
POST	/api/health-insurance-funds	Anlegen	create HealthInsuranceFund
PATCH	/api/health-insurance-funds/:id	Ändern	update HealthInsuranceFund
DELETE	/api/health-insurance-funds/:id	Löschen	delete HealthInsuranceFund
POST	/api/health-insurance-funds/sync	GKV-Sync (Vorschau/Übernehmen)	update HealthInsuranceFundContribution
GET/POST	/api/health-insurance-fund-contributions	Zusatzbeitrags-Historie	view/create HealthInsuranceFundContribution

Verknüpfungen zu anderen Modulen

• Lohnlauf — nutzt die Sätze für SV, Umlagen und U1/U2.
• Buchhaltungskonten — Zahlungskonto der Kasse.

Versionshinweise

• 2026-06-08: GKV-Sync legt jetzt auch fehlende Kassen automatisch an (One-Click-Bootstrap einer leeren Tabelle aus der amtlichen Stammdatendatei; Dedup über Betriebsnummer/Name) — nicht mehr nur Anreicherung. Verifiziert an Commit 424bda2d (syncFromStammdatendatei).
• 2026-06-06: Initiale Veröffentlichung. Krankenkassen-Stammdaten (Zusatzbeitrag, U1/U2-Umlage-/Erstattungssätze, Betriebsnummer), GKV-Sync (Vorschau/Übernehmen) + Zusatzbeitrags-Historie. Verifiziert an healthInsuranceFund.model.ts, healthInsuranceFundFieldsConfig.ts, healthInsuranceFund.router.ts.