fegger/odoo-at-payroll
1
0
Fork 0
mirror of http://100.103.83.12:3003/fegger/odoo-at-payroll.git synced 2026-09-17 08:52:45 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
ec33dfacf23fae1193c6cffc51c1a898e7c7740f
odoo-at-payroll/addons/l10n_at_hr_payroll_private/docs/benutzerhandbuch.md
T
fegger 8b9dbf7612 [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.
2026-09-12 20:43:55 +02:00

7.2 KiB
Raw Blame History

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 View Git Blame Copy Permalink