odoo-at-payroll/personalverrechnung/IMPLEMENTIERUNGSPLAN-Bgld.md

# Implementierungsplan — Gemeinde-Personalverrechnung Bgld.
## Modul `l10n_at_gemeinde_payroll` (Odoo 19)

**Status:** Plan zur Freigabe (AGENTS.md-Workflow, Phase 3 — Implementierung
startet erst nach ausdrücklicher Freigabe). Basis: Rechtsquellen
(`RECHTSQUELLEN-Bgld.md`), Angebotskalkulation (APs, Prämissen P1–P10),
payroll-Skill. Alle Odoo-APIs wurden am vorliegenden Odoo-19-Source
verifiziert (Nachweise in Abschnitt 2).

- **Stand:** 2026-09-09 · Branch `dev-payroll` · lokal
- **Scope R1:** GemBG-Gemeindebedienstete (inkl. Kinderbetreuungspersonal);
  Optionen (Organe, Altpensionen, Lehrlinge, Folgebundesländer) und
  Ausschlüsse gem. Kalkulation Abschnitt 5/6.

## 1. Anforderung (Verständnis)

Vollständige Monatsverrechnung für Bedienstete burgenländischer Gemeinden
nach dem **Bgld. GemBG 2014**-Eigenregime: Entlohnung aus
Entlohnungsgruppen/-stufen (Jahreswerte aus Bgld. Bezügeanpassungs-
Sammelgesetzen), quartalsweise Sonderzahlung, Zulagen, Über-/Mehrdienst-
leistung; Lohnsteuer (§ 33/§ 68 EStG) und SV/Dienstgeberbeiträge (ASVG,
öffentlicher FLAF-DB, IESG); Belege (Lohnzettel, Monatsdienstliste,
Monatsjournal); Meldedateien (L16/FinOnl, eSV/ELDA-XML, Beitragsgrundlagen-
nachweis) — dateibasiert, Übertragung beim Kunden (P7); FI-Buchung auf den
VRV-Kontenplan mit Ansatz-/MVAG-Attribution und EHH/FHH-korrektem Verhalten
plus Abfertigungsrückstellung; Jahreswechsel-Prozess.

## 2. Verifizierte Odoo-Basen (Erweiterungspunkte)

| Mechanismus | Nachweis (odoo/addons/…) | Verwendung im Plan |
|---|---|---|
| `hr.rule.parameter` + Werte je `date_from` (Python-Datenstruktur, safe_eval) | `hr_payroll/models/hr_rule_parameter.py` | Alle jährlichen/variablen Werte: LSt-Tarif & Absetzbeträge, SV-Sätze, Grenzen, FLAF-DB-Satz, IESG, Überstundenfreibetrag |
| Konsum in Regeln: `payslip._rule_parameter('code')` | `hr_payslip.py` L951; Praxis l10n_be (`data/cp200/*_data.xml`) | Regeln lesen keine Literale |
| Regel-Kontext `localdict`: `categories`, `rules`, `payslip`, `worked_days`, `inputs`, `employee`, `result_rules`, `version` | `hr_payslip.py` L1051–1072 | Entgelt-/Abzugsregeln; GemBG-Komponenten als Work-Entry-Types/Inputs |
| Strukturen: `hr.payroll.structure` (mit `journal_id`), `hr.payroll.structure.type`; Zuordnung über Mitarbeiter-Version | `hr_payroll_structure.py`, `hr_version.py` | EINE Struktur „GemBG Bgld. Gemeindebedienstete“; Gruppen/Stufen über Vertragsfelder, nicht über Struktur-Vielfalt |
| Work-Entry-Types (`hr.work.entry.type`: Rounding, `unpaid_structure_ids`) | `hr_work_entry_type.py` | Dienstzeit-Komponenten: Über-/Mehrdienstleistung, Journaldienst, Bereitschaft, Karenz/Herabsetzung |
| Buchung: `hr.salary.rule.account_debit/account_credit` (company_dependent, restrict), Netto-Ausschluss-Flag, Tags | `hr_payroll_account/models/hr_salary_rule.py`, `hr_payslip.py` | Regel→VRV-Konto-Mapping direkt am Regelobjekt; Buchungs-ohne-Netto-Regeln für DG-Sicht |
| Posting-Batch je Journal+Monat: `_action_create_account_move` → `_prepare_slip_lines`/`_prepare_line_values`/`_prepare_adjust_line` | `hr_payroll_account/models/hr_payslip.py` L54–222 | **Hook:** Überschreiben von `_prepare_line_values`, um je Regel `budget_position_id` (Ansatz aus `l10n_at_vrv2015`) + korrekte HH-Attribution zu setzen |
| Retro/Korrekturen: `is_refund_payslip`, `_action_refund_payslips` | `hr_payslip.py` L130–735 | Korrekturläufe ohne Eigenbau |
| Batches `hr.payslip.run`; SEPA-Auszahlung `hr_payroll_account_iso20022` | Engine | Monatsläufe, Zahlungsdatei (FHH via Zahlungslauf) |

## 3. Modul-Layout (Dateien/Komponenten)

```
l10n_at_gemeinde_payroll/
  models/
    entlohnung.py          # Katalog: gemeinde.payroll.entlohnungsgruppe / -stufe
    hr_employee_contract.py# GemBG-Felder auf Employee/Contract-Version
    hr_salary_rule.py      # vrv_ansatz_id (+ VRV-Default-Konto je Regel)
    hr_payslip.py          # Posting-Hook (Ansatz/HH), SZ-Quartil-Helfer
    lohnsteuer.py          # § 33-Tarif als pure Python-Utility (unit-testbar)
    vorrueckung.py         # BDA-/Vorrückungstermin-Berechnung
    abfertigung.py         # §-130-Rückstellungs-Engine (Anwartschaft, Zuführung)
    l16_export.py          # FinOnl-L16-Export (Datei + Prüfprotokoll)
    elda_export.py         # eSV/ELDA-XML (JASV, An-/Ab-/Änderung, Fehlanzeige, BGN)
  data/
    structure_bgld.xml     # Structure-Type + Structure (Journal-Verweis)
    salary_rules_bgld.xml  # Kategorien + Regelinventar (Abschnitt 4.2)
    rule_parameters_2026.xml # LSt/SV/Grenzen/FLAF-DB/IESG/ÜStd-Freibetrag 2026
    katalog_bgld_2026.xml  # Entlohnungsgruppen/-stufen 2026 (aus RV 0715; Seed)
    work_entry_types.xml, input_types.xml
  wizard/
    bezuegeanpassung_import.py  # Jahreswechsel: Tabellen-Import + Validierung
    vorrueckung_run.py          # Vorrückungen je Stichtag anwenden (explizit)
  report/                   # Lohnzettel (AT-Layout), Monatsdienstliste, Monatsjournal
  security/ir.model.access.csv
  tests/  (Abschnitt 6)
```

## 4. Vorgeschlagene Umsetzung

### 4.1 Katalogmodell (AP1)

- `gemeinde.payroll.entlohnungsgruppe`: `code` (z. B. `gv1`, `gb3`), Name,
  `bundesland` (Auswahl; Bgld. befüllt, weitere Länder als Daten),
  Verwendungsbeschreibung.
- `gemeinde.payroll.entlohnungsstufe`: `gruppe_id`, `stufe` (int),
  `monatsentgelt`, `gueltig_ab` (Datum); unique(Gruppe, Stufe, gueltig_ab)
  → jährliche Versionen aus der Bezügeanpassung; Seed 2026 aus
  RV 0715 (`.firecrawl/bezuege2026-rv0715.md`), Folgejahre über den
  Import-Wizard (Tabellenpaste + Plausibilitätsprüfung ±x %).
- Mitarbeiter/Vertragsversion (erben in `hr.employee`/`hr.version`-Kontext):
  `entlohnungsgruppe_id`, `entlohnungsstufe` (bezogen auf Stichtag),
  `besoldungsdienstalter` (Datum; Anrechnungszeiten als Zusatzfelder),
  `vorrueckungstermin` (compute), Teilzeit-Ausmaß via Resource-Kalender.
- **Vorrückungen** werden nicht still im Lohnlauf mutiert: eigener
  Wizard/Cron je Stichtag mit Protokoll (Vorrückung ist besoldungs-
  rechtlich ein Verwaltungsakt mit Dokumentationspflicht).

### 4.2 Regelinventar (AP2–AP4)

Kategorien: `GEMBG_BRUTTO`, `GEMBG_ABZUG`, `GEMBG_NETTO`, `GEMBG_DG`
(Arbeitgeberanteile, buchungs-/journalwirksam), `VRV_BUCHUNG`
(nicht netto-wirksam).

| Regel (Code) | Quelle/Mechanik |
|---|---|
| `ME` Monatsentgelt | Katalog-Lookup Gruppe+Stufe(Stichtag); Prorate Ein-/Austritt (Konvention AP1: Kalender- vs. Arbeitstage) und Teilzeit-Ausmaß |
| `KIZU` Kinderzulage | Kinder-Anzahl × Satz (Rule-Parameter); **bei Teilzeit ungekürzt** (§ 59) |
| `FUZU/ERZU/JZU/SFZU/BERB` Funktions-/Erschwernis-/Journaldienst-/Sonn-Feiertags-/Bereitschafts-Bezüge | Inputs/Work-Entry-Types mit Sätzen aus Rule-Parametern |
| `UEZ` Über-/Mehrdienstleistung | Inputs + § 68-Pauschalbesteuerung (steuerfreier Anteil; 2026: max. 170 €/15 ÜStd — Mechanik nach LStR, siehe 8.) |
| `JUB` Jubiläumszuwendung | Stichtagslogik (Dienstzeit) aus § 89/§ 157d |
| `SZQ` Sonderzahlung | **Quartalsweise**: im Auszahlungsmonat (Ende Q) 50 % des Monatsentgelts (inkl. KIZU); anteilig bei unterbrochenem Vierteljahr (§ 60 Abs 3: „nur der entsprechende Teil“) |
| `LSTL` Lohnsteuer laufend | `lohnsteuer.py`-Utility: § 33-Tarif auf Jahres-Progressionsbasis (LStBMG-Systematik), Absetzbeträge (Rule-Parameter 2026) |
| `LSTSZ` Lohnsteuer SZ | Begünstigte Bezüge (§ 68 Abs 5/6): Grenzwerte aus Rule-Parametern; Zuordnung quartalsweiser SZ — offene Detailfrage (Abschnitt 8) |
| `SVDN` SV Dienstnehmer | KV+PV+AV mit je-Zweig-HBG (6.930 €/13.860 € SZ), Geringfügigkeits-Check (551,10 €), AV-Staffel § 2a AMPFG |
| `SVDG` SV Dienstgeber | DG-Anteile (KV/UV/PV/AV) |
| `FLAFDB` | Öffentlicher FLAF-DB (§ 49a ASVG; Satz als Parameter — P5, AP0-Wert) |
| `IESG` | Insolvenz-Zuschlag 0,10 % (DG) |
| `NETTO` | Kategoriensummen |
| Abfertigungs-Rückstellung | **Nicht** als Slip-Regel: eigene Engine (4.4) |

### 4.3 VRV-Buchung (AP7)

- Regel→Konto: `account_debit/account_credit` auf den Regeln (Anlage-3b-
  Konten Klassen 4/5/6; exakte Codes aus der **Buchungsmatrix AP0** mit der
  Gemeindebuchhaltung; Ansätze 2211/2212/… aus dem verifizierten
  Bereichsbudget-Export ableitbar).
- Regel→Ansatz: neues Feld `vrv_ansatz_id` (`vrv2015.va.position`,
  company_dependent) auf `hr.salary.rule`; der Posting-Hook setzt
  `budget_position_id` je Move-Line (Vererbung von `_prepare_line_values`)
  → damit laufen die Bezüge automatisch durch die bestehende Detailnachweis-/
  Anlage-1a/2a-Engine des `l10n_at_vrv2015`.
- EHH/FHH: Lohnlauf bucht EHH (Ergebnishaushalt); die Auszahlung läuft über
  den Zahlungsverkehr (SEPA/Iso20022) → FHH über die normale Zahlungs-
  Verrechnung des VRV-Moduls (kein Sonderweg).
- DG-Beiträge (SV-DG, FLAF-DB, IESG) als buchungswirksame Regeln ohne
  Nettoeffekt (Netto-Ausschluss-Flag der Engine).

### 4.4 Abfertigungsrückstellung (AP7)

`gemeinde.payroll.abfertigung`-Engine: Anwartschaft je Dienstverhältnis
(§ 130-GemBG-Matrix), monatliche Zuführungsberechnung, Buchungs-Wizard
(Aufwandkonto Ansatz 2211 ↔ Rückstellungskonto 37x) mit Verprobungs-
Anker zur VRV-Engine. Keine Pseudo-Slip-Regel.

### 4.5 Meldewesen (AP5, dateibasiert — P7)

- `l16_export`: Wizard → L16-Datei (FinOnl-Format; **Spec in AP0
  beschaffen**) + Prüfprotokoll; Jahresbelegmeldung bis Ende Februar.
- `elda_export`: eSV-XML-Dateien (JASV-Monatsmeldung, An-/Ab-/Änderung,
  Fehlanzeige, Beitragsgrundlagennachweis; **eSV-XML-Spec in AP0**) +
  Validierungsprotokoll.
- Struktur der Dateien als Schema-Test gegen Spec-Beispiele (Abschnitt 6).

### 4.6 Jahreswechsel (AP8)

- Bezügeanpassungs-Import-Wizard (Tabellen des neuen Sammelgesetzes →
  neue `entlohnungsstufe`-Versionen; Plausibilitätsprüfung, Freigabe,
  Änderungsprotokoll).
- `rule_parameters_<jahr>.xml` je Jahr (LSt/SV/Grenzen) als normale
  Modul-Daten; Fristenkalender (L16 Ende Februar, JASV 15. Folgemonat —
  AP0 verifizieren).

## 5. Daten-/Modell-/Report-Implikationen

- Multi-Company je Gemeinde unverändert über Engine/Security; Katalog-
  Daten global (kein `company_id`), Regeln company-dependent-Konten.
- Reports: Lohnzettel = Payslip-Report im AT-Layout (qweb), Monatsdienst-
  liste (je Mitarbeiter/Periode), Monatsjournal (je Ansatz/Konto, DG-Summen)
  — alles qweb auf `hr.payslip`/Aggregaten, keine eigene Reporting-Engine.
- Rechenfall-Dokumentation je Regel (im `docs/` des Moduls) als Review-Grundlage.

## 6. Tests (hinzuzufügen)

`tests/` mit Rechenfall-Suiten (Lohntarif- und SV-Werte aus den verifizierten
2026er Quellen; Katalogwerte aus RV 0715):

1. `test_katalog`: Import 2026, Versionierung, Lookup Stichtag, Vorrückungstermin
2. `test_entgelt`: Vollzeit/Stufe; Teilzeit 50 % (KIZU ungekürzt); Eintritt
   am 15. (Prorate); Überstunden; Journaldienst/Bereitschaft; Jubiläum
3. `test_sz_quartalsweise`: Q-Ende voll; unterbrochenes Vierteljahr anteilig
4. `test_lohnsteuer`: Tarifgrenzen 2026 (0 %-Zone, Mittelzone, > 104.859),
   § 68-ÜStd-Pauschale, SZ-Behandlung (per LStR-Konvention AP0)
5. `test_sv`: HBG je Zweig inkl. SZ-HBG; Geringfügigkeit 551,10 + § 53a;
   AV-Staffel; FLAF-DB (Parameter); IESG 0,10 %
6. `test_posting_vrv`: Regel→Konto/Ansatz; Summe je Ansatz = Summe Regel;
   **L2-Anker: Kontenklasse-5-Ist des Lohnlaufs = Anlage-1a-Engine-Wert**
   (Muster wie im VRV-Modul); Rückstellungszuführung
7. `test_meldewesen`: Schema-/Beispielvalidierung L16 + ELDA (sobald Specs);
   Prüfprotokolle
8. Refund-Lauf (Korrektur) ohne Doppelbuchung

## 7. VRV-/Buchhaltungs-Überlegungen

- EHH zuerst, FHH über Zahlungsverkehr (keine künstlichen FHH-Buchungen im
  Lohnlauf); § 12/Barvorlagen irrelevant für Personal.
- Ansatz-Attribution über `budget_position_id` je Move-Line (bestehende
  Felder/Engine des VRV-Moduls; keine Parallelstruktur).
- Rückstellungen (Abfertigung § 130) buchungsseitig mit Verprobungsankern;
  Altpensionen/Versorgung sind **Option O2**, nicht R1.

## 8. Risiken / offene Fragen (vor Implementierungsbeginne in AP0 klären)

1. **Buchungsmatrix**: exakte Anlage-3b-Konten je Bezugsart mit der
   Gemeindebuchhaltung (AP0-Workshop) — Voraussetzung für 4.3.
2. **FLAF-DB öffentlich (P5)**: exakter aktueller Satz § 49a Abs 8/9 ASVG
   (RIS-Verifikation; Firecrawl-Limit ausnehmen).
3. **SZ ↔ Lohnsteuer (P9)**: quartalsweise SZ in der § 68 Abs 5/6-Systematik
   (LStR 2002; ggf. BMF-Auskunft) — betrifft Regel `LSTSZ`.
4. **ELDA-/FinOnl-Specs**: Beschaffung + Testdaten (AP0) — bis dahin werden
   die Exporte als „strukturvalidiert gegen Spec-Beispiel“ abgenommen.
5. **Prorate-Konvention** Ein-/Austritt (Kalender-/Arbeitstage) aus
   GemBG § 64 und Praxis der Gemeinde (AP0/Bestandsaufnahme).
6. **SV-Träger** ÖGK Bgld. (P6) aus Unterwart-Läufen bestätigen.
7. Bestands-Sonderfälle (Lehrlinge/Organe/Altpensionen) — Optionen O1–O3.

## 9. Meilensteine (AP-Mapping, post-Auftragserteilung)

| M | Inhalt | APs | Dauer |
|---|---|---|---|
| M0 | Freigabe dieses Plans | — | heute |
| M1 | Bestandsaufnahme Pilotmandant, Buchungsmatrix, P5/Träger/Specs, Konventionen | AP0 | ~2 Wo |
| M2 | Katalogmodell + 2026er Daten + Vertragsfelder + Erstläufe intern | AP1 | ~3 Wo |
| M3 | Entgelt-Engine (Zulagen/ÜStd/SZ), Lohnsteuer, SV/DB | AP2–AP4 | ~6 Wo |
| M4 | Meldedateien + Belege | AP5–AP6 | ~4 Wo |
| M5 | VRV-Buchung + Rückstellung + Jahreswechsel-Importer | AP7–AP8 | ~3 Wo |
| M6 | Rechenfall-Suiten komplett, UI/Security/Doku/Schulung, **2–3 Monate Parallellauf**, Abnahme | AP9–AP10, PM | ~2,5 Mo |

Gesamtkalkulation unverändert ≈ 260 PT (Kalkulationsdokument);
M1-M5 sequenziell, M6 teilweise parallel zu M3–M5.

## 10. Freigabe-Antrag

Mit Freigabe dieses Plans startet die Umsetzung mit **M1 (AP0)** und
anschließend M2 (AP1: Katalogmodell + Seed-Daten + Vertragsfelder).
Änderungen am Scope (Prämissen-Verletzungen, Optionen) laufen über
Change-Requests.