Wie ich einen Gehaltsrechner für alle 50 US-Bundesstaaten entwickelte

Ein einfacher Wunsch führte zu einem komplexen Projekt: Ein freier Gehaltsrechner sollte zeigen, was nach Steuern und Abgaben wirklich auf dem Konto landet. Die meisten bestehenden Tools waren entweder mit Werbung überladen oder verlangten eine E-Mail-Adresse für eine minimale Funktion. Die Lösung? Ein eigener Rechner – doch die Unterstützung aller 50 US-Bundesstaaten erwies sich als überraschend anspruchsvoll. Die finale Version ist unter FinanceTool verfügbar. Dieser Artikel beleuchtet die mathematischen Herausforderungen und die überraschendsten Erkenntnisse.

Warum „Nettolohn“ kein einfacher Rechenvorgang ist

Der Begriff „Nettolohn“ klingt simpel, doch tatsächlich setzt er sich aus vier separaten Komponenten zusammen:

• Bundeseinkommensteuer (progressiv gestaffelt nach Einkommensklassen)
• FICA-Beiträge (Sozialversicherung und Medicare mit eigenen Regeln)
• Staatseinkommensteuer (unterschiedliche Steuersätze oder gar keine Steuer)
• Lokale Steuern (in einigen Counties oder Städten)

Der häufigste Fehler ist die Annahme, die Steuer berechne sich einfach als „Einkommen multipliziert mit einem festen Satz“. Doch Steuern funktionieren nach dem Marginalprinzip: Jede Einkommensportion wird in ihrer jeweiligen Klasse besteuert. Die folgende Funktion veranschaulicht die korrekte Berechnung für progressive Steuern:

type Bracket = {
  upTo: number;
  rate: number;
};

function progressiveTax(taxable: number, brackets: Bracket[]): number {
  let tax = 0;
  let last = 0;
  for (const { upTo, rate } of brackets) {
    if (taxable <= last) break;
    const slice = Math.min(taxable, upTo) - last;
    tax += slice * rate;
    last = upTo;
  }
  return tax;
}

Die Bundeseinkommensteuer folgt diesem Muster, nachdem der Standardabzug (2025: 15.000 USD für Einzelveranlagung) abgezogen wurde. Doch bereits bei den FICA-Beiträgen zeigen sich erste Besonderheiten.

FICA: Sozialversicherung und Medicare mit Grenzen

FICA besteht aus zwei Teilen:

• Sozialversicherung: 6,2 % auf Einkommen bis zur Bemessungsgrenze (2025: 176.100 USD). Einkommen darüber hinaus bleiben unbesteuert.
• Medicare: 1,45 % auf das gesamte Einkommen, plus 0,9 % auf Einkommen über 200.000 USD.

Die korrekte Berechnung erfordert daher eine differenzierte Logik:

function fica(wages: number): number {
  const SS_WAGE_BASE = 176_100; // 2025
  const socialSecurity = Math.min(wages, SS_WAGE_BASE) * 0.062;
  const medicare = wages * 0.0145 + Math.max(0, wages - 200_000) * 0.009;
  return socialSecurity + medicare;
}

Ein häufiger Fehler ist die Annahme eines einheitlichen FICA-Satzes von 7,65 %. Doch für Spitzenverdiener führt dies zu falschen Ergebnissen, da die Sozialversicherungskomponente wegfällt.

Die Staaten: Wo Steuerregeln zum Albtraum werden

Die Annahme, dass sich Staaten einfach wie der Bund verhalten – nur mit niedrigeren Steuersätzen – erwies sich als Trugschluss. Einige Bundesstaaten überraschten mit ungewöhnlichen Regelungen:

Steuerbefreiungen und komplexe Abzüge

• Neun Staaten erheben gar keine Einkommensteuer (z. B. Texas, Florida, Washington).
• Oregon und Alabama erlauben einen Abzug der Bundessteuer vor Berechnung der Staatsteuer. Oregon begrenzt diesen Abzug (2025: ca. 8.500 USD), während Alabama ihn vollständig zulässt.

Diese Regelung erforderte eine Anpassung der Code-Struktur. Statt einer einfachen Funktion wie

stateTax(taxableIncome, filingStatus)

musste nun ein Kontext übergeben werden, der auch die Bundessteuer enthält:

type StateTaxContext = {
  grossIncome: number;
  filingStatus: FilingStatus;
  federalIncomeTax: number; // Wird in Oregon und Alabama benötigt
};

Weitere Ausnahmen und Sonderfälle

Einige Staaten erforderten spezielle Logik:

• Wisconsin: Der Standardabzug sinkt mit steigendem Einkommen und ist daher einkommensabhängig.
• Utah: Keine klassische Steuerstaffelung, sondern ein pauschaler Steuersatz mit auslaufendem Steuerguthaben.
• Connecticut: Der persönliche Freibetrag wird über eine Tabelle mit festen Stufen reduziert – eine glatte Formel reicht hier nicht aus.
• Indiana und Kentucky: County- oder Stadtsteuern werden zusätzlich zur Staatsteuer erhoben.
• New York City: Eine eigene Steuer wird zusätzlich zur Staatsteuer New Yorks erhoben.

Die Unterschiede sind enorm: Während in North Dakota Einkommen bis etwa 48.000 USD kaum besteuert werden, liegt der Spitzensteuersatz in Hawaii bei 11 % und in Kalifornien sogar bei 12,3 %. Ein identisches Bruttoeinkommen führt hier zu völlig unterschiedlichen Nettolöhnen.

Code-Architektur: Wie die Komplexität beherrschbar blieb

Um den Überblick zu behalten und die Pflege zu erleichtern, wurde ein modularer Ansatz gewählt. Jeder Bundesstaat wird als Konfiguration definiert, die von einer zentralen Berechnungslogik verarbeitet wird. Spezialfälle erhalten eigene Funktionen.

type StateConfig = {
  code: string;
  noIncomeTax?: boolean;
  brackets?: Record<FilingStatus, Bracket[]>;
  standardDeduction?: (income: number, status: FilingStatus) => number;
  deductsFederalTax?: "full" | { cap: number };
  computeOverride?: (ctx: StateTaxContext) => number; // Für besonders komplexe Fälle
};

Die Sonderfälle (wie Oregon oder Connecticut) erhalten eine eigene computeOverride-Funktion, während der Rest der Staaten über Standard-Logik abgewickelt wird. Dies verhindert, dass sich die Komplexität im gesamten Code ausbreitet.

Qualitätssicherung: Warum „ungefähr richtig“ hier nicht ausreicht

Ein fehlerhafter Gehaltsrechner kann schwerwiegende Folgen haben. Daher wurde ein umfassendes Testsystem implementiert:

• Für jeden Bundesstaat wurde der erwartete Nettolohn für definierte Einkommenswerte manuell berechnet.
• Diese Werte wurden mit den offiziellen Steuerberechnungen der Bundesstaaten für 2025 abgeglichen.
• Anschließend wurden 229 automatisierte Unit-Tests erstellt, die bei jeder Änderung durchlaufen.

Steuerberechnungen sind ein Bereich, in dem Präzision unverzichtbar ist. Selbst kleine Abweichungen führen zu Rückmeldungen – besonders von Nutzern, die ihre eigenen Gehaltsabrechnungen kennen. Ein Fehler, der serverseitig unentdeckt blieb, führte dazu, dass die Startseite im Browser einen Fehler warf, nachdem neue Berechnungskategorien hinzugefügt wurden.

Fazit: Ein Projekt mit unerwarteter Tiefe

Die Entwicklung eines Gehaltsrechners für alle 50 US-Bundesstaaten offenbarte, wie vielfältig und komplex Steuergesetze sein können. Von progressiven Steuersätzen über lokale Aufschläge bis hin zu ungewöhnlichen Abzugsregelungen – die Umsetzung erforderte viel mehr als nur eine einfache Formel.

Doch die modularisierte Architektur und das rigorose Testsystem machen den Rechner wartbar und erweiterbar. Für Entwickler, die ähnliche Projekte planen, ist die zentrale Erkenntnis: Steuerlogik sollte nie „nebenbei“ implementiert werden. Sie erfordert Sorgfalt, Tests und eine Architektur, die Sonderfälle sauber kapselt. Wer diese Regeln befolgt, vermeidet nicht nur Fehler, sondern auch den Ärger unzufriedener Nutzer.