[IMP] l10n_at_hr_payroll_private: GP9 Mitarbeiter-UI, NSchAB-Company-View, Multi-Company-Rules, Demo-Datensatz, Benutzerhandbuch (AP9)
Mitarbeiter-UI (views/mitarbeiter_views.xml): All-in-Felder (l10n_at_ue_pauschale_monatlich, l10n_at_grundlohn_ausweis, § 2g AVRAG) als Gruppe am Mitarbeiterformular; NSchAB-Company-Flag am Lohnverrechnungs-Reiter (l10n_at_nschab — Feld nur im Privatmodul). Multi-Company-Record-Rules (security/security_rules.xml): ir.rule für l10n.at.payroll.mbgm, .mbgm.line, .vr, .vr.event. Demo-Datensatz (data/demo.xml, noupdate): 3 AN (Angestellte Vollzeit, Arbeiter Teilzeit, Lehrling) mit Verträgen, KV-Einstufung, VSNR, BMSVG-Flag; Demo-Company mit BKNR/Lohnsteuernummer/Bundesland; nur im Demo-Modus aktiv. Benutzerhandbuch (docs/benutzerhandbuch.md): Quick-Start deutsch — Stammdaten, Monatsabrechnung, Meldewesen (mBGM/Versichertenmeldung/L16), Belege drucken, Fristenkalender, Jahreswechsel, BV-Endabrechnung. 19.0.8.1.0. 100/100 grün (Wegwerf-DB); odoo_dev auf GP9 aktualisiert.
This commit is contained in:
@@ -0,0 +1,199 @@
|
||||
# Benutzerhandbuch — AT-Payroll (Privatwirtschaft)
|
||||
|
||||
## Übersicht
|
||||
|
||||
Dieses Modul ermöglicht die vollständige monatliche Lohnverrechnung für
|
||||
die österreichische Privatwirtschaft nach Kollektivvertrag (KV) auf
|
||||
Basis von Odoo 19. Es deckt ab:
|
||||
|
||||
| Baustein | Funktion |
|
||||
|---|---|
|
||||
| Entgelt (GP2) | KV-Gehalt, AZG-Zuschläge (ÜStd, Nacht, So/Fei, Mehrarbeit), Urlaubsentgelt, 13./14. Bezug |
|
||||
| Lohnsteuer (GP3) | § 66 kumulativ, § 67 Sechstel/Fixsätze, § 68-Steuerfreiheiten |
|
||||
| SV/DB (GP4) | ÖGK-Beitragssätze, Geringfügigkeit, § 49-Freibeträge, FLAF, KommSt, DZ |
|
||||
| Abfertigung Neu (GP5) | BMSVG 1,53 %, Anwartschaft, Endabrechnung |
|
||||
| FI-Buchung (GP6) | UGB-Konten (KFS/BW 6), Journal SLR |
|
||||
| Meldewesen (GP7) | mBGM/JASV, Versichertenmeldung, Lohnzettel L16, Arbeitsstättenmeldung |
|
||||
| Belege (GP7) | Lohnzettel AT, Monatsdienstliste, Monatsjournal |
|
||||
| Jahreswechsel (GP8) | Fristenkalender, Kontrollsechstel, §-77-Aufrollung |
|
||||
|
||||
---
|
||||
|
||||
## 1. Stammdaten anlegen
|
||||
|
||||
### 1.1 Unternehmen (Company)
|
||||
|
||||
Öffnen Sie **Einstellungen → Unternehmen** und wählen Sie Ihr
|
||||
Unternehmen. Im Reiter **„Lohnverrechnung (AT)"** pflegen Sie:
|
||||
|
||||
| Feld | Beschreibung | Pflicht |
|
||||
|---|---|---|
|
||||
| Beitragskontonummer (BKNR) | 10-stellige eSV-Nummer (z. B. 1412345678) | Ja — ohne sie brechen alle Meldewesen-Läufe ab |
|
||||
| Lohnsteuernummer | 9-stellig: 2 Stellen Finanzamt + 7 Stellen Steuernummer | Ja — für L16 |
|
||||
| Bundesland | Betriebsstätten-Bundesland (steuert DZ-Satz) | Empfohlen |
|
||||
| WKO-Mitglied | Aktivieren, wenn Ihr Unternehmen WKO-Mitglied ist (DZ-Pflicht) | Optional |
|
||||
|
||||
### 1.2 Mitarbeiter:in
|
||||
|
||||
Öffnen Sie **Personal → Mitarbeiter:innen** und legen Sie eine:n
|
||||
Mitarbeiter:in an. Im Payroll-Bereich des Formulars:
|
||||
|
||||
1. **KV-Einstufung**: Wählen Sie den Kollektivvertrag, die
|
||||
Verwendungsgruppe und die Erfahrungsstufe
|
||||
2. **SV-Stichtage & Status** (GP8): Setzen Sie bei Bedarf
|
||||
Satzausschaltungen (ALV ab 63, UV ab 60, PV-Bonusphase) und
|
||||
Status-Flags (Lehrling, fallweise, Familienabsetzbetrag)
|
||||
3. **Abfertigung Neu** (GP5): Standardmäßig aktiviert (BMSVG);
|
||||
wählen Sie die MV-Kasse und pflegen Sie ggf. Erträge aus dem
|
||||
Kassen-Auszug
|
||||
4. **All-in** (§ 2g AVRAG): Bei All-in-Verträgen die
|
||||
Überstundenpauschale und den ausgewiesenen Grundlohn eintragen
|
||||
5. **Versicherungsnummer (ssnid)**: 10-stellig, Format LLLPTTMMJJ
|
||||
— **Pflicht für alle Meldewesen-Läufe**
|
||||
|
||||
### 1.3 Versichertenmeldung (Anmeldung)
|
||||
|
||||
Bei Eintritt eines:r neuen Mitarbeiter:in:
|
||||
|
||||
1. Öffnen Sie **Meldewesen → Versichertenmeldung**
|
||||
2. Klicken Sie auf **„Meldungen erzeugen (Datei)"**
|
||||
3. Der Wizard erkennt offene Anmeldungen automatisch (Event-
|
||||
Erkennung über die Meldungs-Registry) und erzeugt die ELDA-Datei
|
||||
4. Übertragen Sie die Datei über das ELDA-Portal des Mandanten
|
||||
|
||||
---
|
||||
|
||||
## 2. Monatsabrechnung
|
||||
|
||||
### 2.1 Lohnlauf erstellen
|
||||
|
||||
1. Öffnen Sie **Payroll → Lohnläufe** und erstellen Sie einen Lauf
|
||||
für den Abrechnungsmonat
|
||||
2. Fügen Sie die Mitarbeiter:innen hinzu (oder nutzen Sie den
|
||||
Batch-Modus für alle aktiven AN)
|
||||
3. Klicken Sie auf **„Abrechnen"** — die Engine berechnet:
|
||||
- KV-Grundentgelt (Katalog oder Überzahlung)
|
||||
- AZG-Zuschläge (aus Work-Entries/Zeiterfassung)
|
||||
- Sonderzahlungen B13 (13. Bezug, z. B. November) und B14
|
||||
(14. Bezug, bei Urlaubsantritt oder Austritt)
|
||||
- Lohnsteuer (§ 66 kumulativ, § 67 Sechstel/Fixsätze)
|
||||
- SV-Beiträge (ÖGK DN+DG, historisch versioniert je Beitragsmonat)
|
||||
- Lohnnebenkosten (FLAF-DB, KommSt, DZ)
|
||||
- BV-Beitrag (1,53 % Abfertigung Neu)
|
||||
4. Prüfen Sie das **Netto** und bestätigen Sie den Lauf
|
||||
|
||||
### 2.2 FI-Buchung
|
||||
|
||||
Nach Bestätigung des Laufes bucht Odoo automatisch auf die
|
||||
UGB-Konten (KFS/BW 6). Prüfen Sie:
|
||||
|
||||
- **Aufwand**: Gehälter (6200/6000), SV-DG (6560/6500), BV (6440),
|
||||
KommSt (6660), FLAF (6661), DZ (6662)
|
||||
- **Verbindlichkeiten**: SV (3600), LSt (3540), FLAF (3541),
|
||||
KommSt (3550), DZ (3542)
|
||||
- **Netto**: Lohnverbindlichkeit (3850)
|
||||
|
||||
---
|
||||
|
||||
## 3. Meldewesen (monatlich)
|
||||
|
||||
### 3.1 mBGM/JASV (SV-Meldung)
|
||||
|
||||
**Frist: 15. des Folgemonats** (Gutschriftprinzip)
|
||||
|
||||
1. Öffnen Sie **Meldewesen → mBGM (JASV)**
|
||||
2. Erstellen Sie einen Eintrag für den Beitragsmonat
|
||||
3. Klicken Sie auf **„Lauf erzeugen (Datei)"**
|
||||
4. Der Wizard prüft: BKNR vorhanden, VSNR je AN valide, Tarifsätze
|
||||
parametrisiert (fehlende BSGR → listenweiser Abbruch)
|
||||
5. Laden Sie die Datei ins ELDA-Portal hoch
|
||||
|
||||
### 3.2 Versichertenmeldung (bei Ein-/Austritt)
|
||||
|
||||
- **Anmeldung (M3)**: vor Arbeitsantritt — wird automatisch erkannt
|
||||
- **Abmeldung (M4)**: innerhalb von 7 Kalendertagen nach
|
||||
Beschäftigungsende
|
||||
- **Fallweise (MA)**: je Beschäftigungstag vor Arbeitsantritt
|
||||
|
||||
### 3.3 Lohnzettel L16 (jährlich)
|
||||
|
||||
**Frist: Ende Februar des Folgejahres** (via ELDA)
|
||||
|
||||
1. Öffnen Sie **Meldewesen → Lohnzettel Finanz (L16)**
|
||||
2. Erstellen Sie einen Eintrag für das Abrechnungsjahr
|
||||
3. Klicken Sie auf **„Lauf erzeugen (Dateien)"**
|
||||
4. Es werden **zwei Dateien** erzeugt:
|
||||
- `l16_<Jahr>_<BKNR>.txt` — der Lohnzettel (BEST LF)
|
||||
- `arbeitsstaette_<Jahr>.txt` — die Arbeitsstättenmeldung (BEST AD)
|
||||
5. Beide Dateien werden über ELDA übertragen
|
||||
|
||||
---
|
||||
|
||||
## 4. Belege drucken
|
||||
|
||||
| Beleg | Druckort | Inhalt |
|
||||
|---|---|---|
|
||||
| **Lohnzettel (AT)** | Lohnabrechnung → Drucken | Bezüge, Abzüge, DG-Anteile, Netto |
|
||||
| **Monatsdienstliste** | Lohnlauf → Drucken | mBGM-Kontrollgrößen je AN |
|
||||
| **Monatsjournal** | Lohnlauf → Drucken | Lohnart-Summen je Lauf |
|
||||
| **All-in-Deckungsrechnung** | Lohnabrechnung → Drucken | Pauschale vs. Bezüge |
|
||||
| **DAG-Ausweis** | Lohnlauf → Drucken | § 1 DAG (geringfügig Beschäftigte) |
|
||||
|
||||
---
|
||||
|
||||
## 5. Fristenkalender
|
||||
|
||||
Öffnen Sie **Meldewesen → Fristenkalender**. Der Kalender zeigt:
|
||||
|
||||
- **Monatliche Fristen**: SV 15., DB/DZ/KommSt 15. des Folgemonats
|
||||
- **Jahresfristen**: L16/Arbeitsstätte/§-109a Ende Februar,
|
||||
KommSt-Jahreserklärung Ende März
|
||||
|
||||
Fristen werden automatisch per Cron erzeugt (monatlich am 1.).
|
||||
Überfällige Fristen werden rot markiert. Klicken Sie auf den
|
||||
Pfeil-Button, um direkt zur zugehörigen Deklaration zu springen.
|
||||
|
||||
---
|
||||
|
||||
## 6. Jahreswechsel
|
||||
|
||||
### 6.1 KV-Runde
|
||||
|
||||
1. Neue KV-Gehaltstabellen über den **KV-Katalog-Import** eingeben
|
||||
(Paste oder CSV)
|
||||
2. Neue `gueltig_ab`-Versionen werden automatisch angelegt;
|
||||
historische Werte bleiben unberührt
|
||||
|
||||
### 6.2 LSt/SV-Parameterpflege
|
||||
|
||||
1. Neue Jahreswerte in `rule_parameters_<jahr>.xml` nachpflegen
|
||||
(Beschaffung: „Beitragsrechtliche Werte" von
|
||||
sozialversicherung.at; LSt-Tarif vom BMF)
|
||||
2. Beispiel 2027: `data/rule_parameters_2027.xml` enthält
|
||||
bereits die Struktur
|
||||
|
||||
### 6.3 Kontrollsechstel-Prüfung
|
||||
|
||||
1. Öffnen Sie **Meldewesen → Jahres-Retro-/Aufrollungslauf**
|
||||
2. Wählen Sie das Jahr und klicken Sie auf **„Jahresdaten prüfen"**
|
||||
3. Der Wizard zeigt je AN den §-67-Überhang und ob die
|
||||
Günstig-Aufrollung (Tarif statt Fixsätze) günstiger wäre
|
||||
|
||||
---
|
||||
|
||||
## 7. BV-Endabrechnung (Austritt)
|
||||
|
||||
Bei Austritt eines:r im BMSVG-Systems verbleibenden AN:
|
||||
|
||||
1. Öffnen Sie **Abfertigung Neu → BV-Endabrechnung (Austritt)**
|
||||
2. Wählen Sie den:die Mitarbeiter:in und die Beendigungsart
|
||||
3. Der Wizard prüft: 36 Beitragsmonate? § 14 Abs 2-Matrix
|
||||
(AN-Kündigung, verschuldete Entlassung, unberechtigter Austritt)
|
||||
4. Zeigt Anwartschaft (Beiträge + Erträge) und Fristen
|
||||
|
||||
---
|
||||
|
||||
## Support
|
||||
|
||||
Bei Fragen wenden Sie sich an Ihren Lohnverrechnungs-Dienstleister.
|
||||
Technische Dokumentation: `README.md` und `docs/` im Modul.
|
||||
Reference in New Issue
Block a user