odoo-at-payroll/personalverrechnung/PLAN-TASY-SV-Import.md

Plan — SV-Werte-Implementierung (AP4) auf Basis TASY-LSWH-Export

Status: Plan zur Freigabe (AGENTS.md-Workflow). Ergänzt den freigegebenen IMPLEMENTIERUNGSPLAN-Bgld.md (AP4/AP8) um den TASY-gestützten Wertelayer.

• Stand: 2026-09-09 · Branch dev-payroll
• Quelle: personalverrechnung/TASY-LSWH-Export-20260324.xml (ÖGK-Tarifsystem-Export, Gültigkeitstichtag 2026-07-01, 5 MB)

1. Befunde aus der Datei (verifiziert)

Aspekt	Befund
Aufbau	tarife (356) mit DN/DG-Anteil je tarifZweig + Gültigkeit; tarifsets/tarifgruppen/tarifgruppeSetZuordnungen als Zuordnungskette zu beschaeftigtengruppen (B-Codes, 408); beitragbemessungsbetraege (158 Codes) mit bbbwerten (612, Cent-Werte je von/bis)
Zweige	KV, PV, AV, UV, IE (Insolvenz/IESG), DG (SV-Dienstgeberbeitrag), AK, WF, BV, LK, SW, …
Verifizierte 2026er Werte	Geringfügigkeitsgrenze 551,10 € (GFGBTG), HBG SZ 13.860 € (HBGSZ), KV-Split 3,87/3,78, AV 2,95/2,95, PV-DG 12,55 — deckungsgleich mit dem offiziellen SV-Werte-Report 2026 ✓
Raten-Auflösung	Am Stichtag gelten je Zweig 21–67 Tarif-Varianten (Sondergruppen, §-2a-AMPFG-Staffelanteile, freie DN …). Der Standard-Angestelltensatz muss über beschaeftigtengruppe (z. B. „Angestellte") → tarifgruppeSetZuordnung → tarifset → tarife aufgelöst werden
Nicht enthalten	Öffentlicher FLAF-DB (§ 49a Abs 8/9 — null Treffer), Lohnsteuer, Kommunalsteuer → bleiben separate, RIS/usg-basierte Parameter (AP0)
Offene Detailpunkte	HBG monatlich = HBGALLG (tgl.) × 30 oder eigener bbbwert; exakte Abbildung der §-2a-AMPFG-Staffel über Tarif-Varianten (Grenzwerte werden zusätzlich gegen den SV-Werte-Report gespiegelt)

2. Zielbild

Zwei Schichten — kein Eigenbau-Speicher, die Engine-Mechanik bleibt alleiniger Wertespeicher:

1. Seed 2026 (data/rule_parameters_2026.xml): hr.rule.parameter
   • hr.rule.parameter.value (date_from = Stichtag) aus DIESEM Export, einmalig per Generator-Script generiert und gegen den SV-Werte-Report 2026 gespiegelt (Herkunftsnachweis wie beim GemBG-Katalog).
2. TASY-Import-Wizard (gemeinde.payroll.tasy.import.wizard, TransientModel) für die Jahrespflege (AP8):
   • Upload des jährlichen Exports (ir.attachment), sicheres Parsen (lxml, resolve_entities=False);
   • Auflösung am gueltigkeitstichtag: bbwerte der Mapping-Codes (Cent→€) + Standard-Raten über die Gruppenkette; fehlende/ mehrdeutige Auflösungen landen zur manuellen Klärung im Preview;
   • Preview-Differenz (Parameter, alter Wert, neuer Wert, Stichtag, Plausibilitätsprüfung ±10 % Sprungwarnung);
   • Bestätigung schreibt hr.rule.parameter.value (date_from = Stichtag; historische Werte bleiben versioniert), Protokoll.
3. Mapping-Tabelle gemeinde.payroll.tasy.mapping (TASY-Code/Zweig → rule-parameter-code) als data XML — transparent, ohne feste Werte im Code, erweiterbar (z. B. BVAEB-Export später).

Regeln (AP2/AP4) konsumieren ausschließlich payslip._rule_parameter('at_sv_kv_dn') usw. — keine Literale (payroll-Skill-Architekturregel).

3. Parameter-Katalog (Seed 2026)

hr.rule.parameter	Wert 2026	TASY-Quelle
at_sv_gfg_monatlich	551.10	GFGBTG
at_sv_hbg_monatlich	6.930,00	HBGALLG (tgl. 231,00 × 30; Auflösung klären)
at_sv_hbg_sz_jaehrlich	13.860,00	HBGSZ
at_sv_kv_dn / at_sv_kv_dg	3.87 / 3.78	Tarif KV (Standard-Angestellte)
at_sv_pv_dn / at_sv_pv_dg	10.25 / 12.55	Tarif PV
at_sv_av_dn / at_sv_av_dg	2.95 / 2.95	Tarif AV
at_sv_uv_dg	1.10	Tarif UV
at_sv_iesg_dg	0.10	Tarif IE
at_sv_bv_dg	1.53	Tarif BV
at_sv_ak_dn / at_sv_wf_…	(geführt; für GemBG nicht anwendbar — Datenbasis vollständig, Anwendungslogik entscheidet)	AK/WF
at_sv_av_staffel_ampfg	Grenzen 2.225/2.427/2.630 + Anteile 0/1/2 %	SV-Report + TASY-Kreuzcheck

Getrennt gepflegt (nicht TASY): at_flaf_db_oeffentlich (§ 49a Abs 8/9 — AP0/RIS), Lohnsteuer-Parameter (usp/RIS).

4. Umfang / Dateien

l10n_at_gemeinde_payroll/
  models/tasy.py             # gemeinde.payroll.tasy.mapping + import-wizard
  data/rule_parameters_2026.xml   # Seed (generator-erzeugt)
  data/tasy_mapping.xml
  wizard/… (transient im models-File oder wizard/ je nach Konvention)
  views/tasy_views.xml        # Mapping-View + Wizard-Form
  security/ir.model.access.csv (Ergänzung)
  tests/test_tasy_import.py   # Parser-/Resolutions-Tests (kleines Fixture)
personalverrechnung/tools/gen_sv_parameters_2026.py   # Herkunftsnachweis

Die 5-MB-Exportdatei: Vorschlag unter personalverrechnung/quellen/TASY-LSWH-Export-20260324.xml committen (öffentliches Tarifdatenmaterial, keine Personendaten) — oder unversioniert lassen, wenn du das Repo klein halten willst (bitte entscheiden).

5. Tests (Rechenfälle)

1. Parser: Fixture-Slice (handgebaut, gleiche Struktur) → bbwerte Cent→€, Stichtagsfilterung, fehlende Werte → Preview-Fehler.
2. Auflösung: Standard-Raten für „Angestellte" (KV 3.87/3.78 …) aus der echten Exportdatei (Test liest sie aus dem Repo, wenn committet; sonst aus dem Fixture mit den verifizierten Werten).
3. Seed-Spiegelung: at_sv_kv_dn == 3.87 usw. gegen SV-Werte-Report (gleiche Anker wie RECHTSQUELLEN Abschnitt 4).
4. Wizard: neuer Stichtag → neue hr.rule.parameter.value, alte Version bleibt; Sprungwarnung bei >10 % Abweichung.
5. HBG-Rechnung tgl. × 30 gegen monatlich (je nach Auflösungsvariante).

6. Risiken / offene Fragen

1. Auflösungstiefe der Tarif-Varianten (Standardgruppe vs. Sonderfälle) — im Wizard als Preview-Schritt sichtbar, mehrdeutige Sätze werden nie automatisch übernommen.
2. HBG monatlich (×30-Konvention vs. eigener bbbwert) — Klärung in der Implementierung mit Quellenabgleich.
3. TASY liefert ÖGK-Werte; BVAEB-Angelegenheiten (falls je benötigt) folgen über dasselbe Mapping-Modell als eigener Import.
4. FLAF-DB öffentlich bleibt AP0 (RIS) — bewusst außerhalb TASY.
5. Verbindlichkeit: Wizard schreibt erst nach expliziter Bestätigung (kein stiller Jahresüberschreib).

7. Freigabe-Antrag

Mit Freigabe: (a) TASY-Datei committen ja/nein (Abschnitt 4), (b) Seed 2026 generieren + rule_parameters_2026.xml, (c) Mapping-Modell + Import-Wizard, (d) Tests; Gesamtaufwand ~6–9 PT (in AP4/AP8-Kalkulation enthalten — ersetzt die dort angesetzte manuelle Wertepflege zum Großteil).