noch-digitaler/lohnsteuer-rechner

Deutsche Lohnsteuer- und Sozialversicherungs-Berechnung (§32a EStG) fuer Laravel - Tarifformel, Solidaritaetszuschlag, Steuerklasse-III-Splitting.

dev-main 2026-08-31 20:08 UTC

Requires

• php: ^8.2
• illuminate/database: ^11.0|^12.0
• illuminate/support: ^11.0|^12.0

MIT

• Julius Noch

• laravel
• payroll
• germany
• lohnsteuer
• gehaltsabrechnung
• steuerrecht

Published on Packagist.org on 2026-08-31 20:23 UTC

README

Berechnet die deutsche Lohnsteuer und den Solidaritätszuschlag nach der Tarifformel aus §32a EStG — inklusive der Steuerklasse-III-Besonderheit (Splittingverfahren) bei der Soli-Freigrenze. Bildet den Kern des amtlichen Lohnsteuer-Programmablaufplans nach.

Was dieses Paket macht

• Wendet die 5-Zonen-Tarifformel (Nullzone, Progressionszone 1 & 2, Proportionalzone 1 & 2) auf ein zu versteuerndes Jahreseinkommen an
• Berechnet die Vorsorgepauschale aus den tatsächlichen Arbeitnehmer-SV-Beiträgen
• Prüft den Solidaritätszuschlag gegen die monatliche Freigrenze — korrekt getrennt nach Steuerklasse III (Splitting, doppelte Freigrenze) und den übrigen Klassen, ein Detail, das viele einfachere Lohnrechner falsch oder gar nicht abbilden
• Liefert ein LohnsteuerParameter-Eloquent-Model + Migration, um die jahresabhängigen Werte (Grundfreibetrag, Beitragssätze, Beitragsbemessungsgrenzen, Tarifformel-Koeffizienten) sauber versioniert in der eigenen Datenbank zu halten

Was dieses Paket bewusst NICHT macht

Siehe Docblock-Kommentare in LohnsteuerRechner.php für die vollständige Liste der Vereinfachungen (u. a. keine volle Günstigerprüfung bei der Vorsorgepauschale, keine Milderungszone beim Soli). Für die meisten Standardfälle (keine Freibeträge auf der Steuerkarte, keine Mehrfachbeschäftigung) ist das Ergebnis korrekt — für Sonderfälle sollte der Aufrufer eine manuelle Prüfung markieren.

Installation

composer require noch-digitaler/lohnsteuer-rechner
php artisan vendor:publish --tag=lohnsteuer-rechner-migrations
php artisan migrate

Verwendung

use NochDigitaler\LohnsteuerRechner\LohnsteuerRechner;
use NochDigitaler\LohnsteuerRechner\Models\LohnsteuerParameter;

$parameter = LohnsteuerParameter::where("gueltig_ab_jahr", 2026)->firstOrFail();

$rechner = new LohnsteuerRechner();

$ergebnis = $rechner->berechneMonatlich(
    bruttolohnMonat: 3500.00,
    rvArbeitnehmerMonat: 325.50,
    kvArbeitnehmerMonat: 273.00,
    pvArbeitnehmerMonat: 68.25,
    steuerklasse: 1,
    parameter: $parameter,
);

// $ergebnis["lohnsteuer"] und $ergebnis["soli"]

⚠️ Wichtig: Die Zahlenwerte sind NICHT im Paket enthalten

Dieses Paket liefert die Rechenlogik, aber bewusst keine Steuerwerte — die ändern sich jährlich zum 1.1. (Tarifzonen-Koeffizienten, Beitragssätze, Beitragsbemessungsgrenzen, Minijob-/Midijob-Grenzen). Ein Lohnrechner mit veralteten Werten ist gefährlicher als gar keiner, weil er selbstbewusst falsche Zahlen ausgibt.

Zwei Wege, an die Werte zu kommen:

1. Selbst recherchieren (kostenlos) — die Feldstruktur des LohnsteuerParameter-Models zeigt genau, was benötigt wird. Quellen: BMF-Programmablaufplan für die maschinelle Lohnsteuerberechnung, GKV-Spitzenverband-Beitragssätze, Minijob-Zentrale.
2. Geprüfte Jahreswerte abonnieren — wir recherchieren und verifizieren die Werte jedes Jahr neu gegen offizielle Quellen und stellen sie als fertigen Datensatz bereit, damit du das nicht selbst tun musst. Details: noch-digitaler.de

Lizenz

MIT — siehe LICENSE.