iToverDose/Yazılım· 14 HAZIRAN 2026 · 12:02

Her ABD eyaletine özel net maaş hesaplayıcısı yaparken öğrendiklerim

Adet vergi dilimine tabi federal sistemden eyaletlere özel kurallara kadar ABD'de net maaş hesaplamak, beklenenden çok daha karmaşık bir süreç. Peki bir geliştirici bu süreci nasıl basitleştiriyor?

DEV Community4 dk okuma0 Yorumlar

ABD’de net maaş hesaplamak, ilk bakışta basit bir matematik işleminden ibaret gibi görünür. Ne var ki, gerçek dünya vergi sistemleri, her eyaletin farklı kurallarıyla bu hesaplamayı adeta bir bulmaca haline getiriyor. Nihayetinde, federal vergi dilimlerinden eyalet ve yerel vergilere, sosyal güvenlikten Medicare’e kadar birçok bileşeni dikkate almak gerekiyor. Peki, bu karmaşık yapıyı doğru ve sürdürülebilir şekilde modellemek mümkün mü?

ABD’de net maaş hesaplamak: sadece bir sayıdan ibaret değil

Net maaş hesaplarken dört temel unsurla karşılaşıyorsunuz:

  • Federal gelir vergisi: Artan oranlı dilimler üzerinden hesaplanır ve standart indirimler düşüldükten sonra uygulanır.
  • FICA vergisi: Sosyal Güvenlik (%6.2) ve Medicare (%1.45) bileşenlerinden oluşur. Sosyal Güvenlik için 2025’te 176.100 dolar limiti bulunurken, Medicare için 200.000 doların üzerindeki gelirlerde ek %0.9 oran uygulanıyor.
  • Eyalet gelir vergisi: Her eyaletin kendine özgü vergi dilimleri, indirimler ve istisnaları var. Bazı eyaletlerde vergi bile uygulanmıyor.
  • Yerel vergiler: County, şehir ve okul bölgelerine göre değişen ek vergiler de hesaplamaya dahil edilebilir.

Basit bir "gelir x vergi oranı" yaklaşımı, bu karmaşık yapıyı doğru şekilde yansıtamaz. Çünkü vergi dilimleri artan oranlıdır; yani gelirin her dilimi farklı bir oranda vergilendirilir. Bu yüzden, hesaplamanın her adımda doğru yapılması gerekiyor.

Vergi hesaplamalarında sık yapılan hata: sabit oranlar

Birçok ücretsiz maaş hesaplayıcısı, vergi oranını sabit olarak varsayıyor. Oysa federal ve eyalet vergi dilimleri, gelirinizin sadece bir kısmı için geçerli olabilir. Örneğin, 2025’te bekar bir vergi mükellefi için standart indirim 15.000 dolar olarak belirlenmiş durumda. Bu indirimden sonra kalan gelir, artan oranlı vergi dilimlerine göre vergilendirilir.

Aşağıdaki fonksiyon, artan oranlı vergi hesaplamasının nasıl yapıldığını gösteriyor:

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;
}

Bu fonksiyon, her dilim için sadece o dilime denk gelen gelirin ilgili oranla çarpılması esasına dayanıyor. Bu sayede, vergi hesaplaması hem doğru hem de sürdürülebilir hale geliyor.

FICA: Sosyal Güvenlik ve Medicare’in incelikleri

FICA vergisi, birçok kişi tarafından %7.65 olarak sabit bir oran olarak düşünülüyor. Ancak gerçekte bu oran, gelir düzeyinize göre değişiyor:

  • Sosyal Güvenlik: 2025’te 176.100 doların altındaki gelirler için %6.2 oranında uygulanır. Bu limite ulaşan gelirler için ise Sosyal Güvenlik vergisi kesilmez.
  • Medicare: Tüm gelirler için %1.45 oranında kesilir. 200.000 doların üzerindeki gelirlerde ise ek %0.9 oranında bir vergi daha uygulanır.

Bu nedenle, FICA vergisini hesaplarken gelir düzeyine göre değişen kuralları dikkate almak gerekiyor. Aşağıdaki fonksiyon, bu hesaplamayı doğru şekilde yapıyor:

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;
}

Eyaletlerin sunduğu sürprizler: vergi hesaplamalarının karmaşıklığı

Eyaletler, vergi hesaplamalarında birbirinden çok farklı kurallara sahip. Hatta bazı eyaletler, hesaplama mantığını tamamen değiştirebiliyor. Örneğin:

  • Oregon ve Alabama: Federal gelir vergisini, eyalet vergi matrahından düşmenize izin veriyor. Bu, hesaplamanın eyalet düzeyinde federal vergi sonucunu da bilmesini gerektiriyor. Bu durum, hesaplama fonksiyonunun mimarisini değiştirdi.
  • Wisconsin: Standart indirimin gelirinizle birlikte azaldığı bir sisteme sahip.
  • Utah: Beklenmedik bir şekilde, artan oranlı dilimler yerine, sabit bir oran ve azalan vergi kredisi sistemi kullanıyor.
  • Connecticut: Kişisel muafiyetlerin belli bir gelirin üzerinden kademeli olarak düşürüldüğü, tablolaşmış bir sisteme sahip.
  • Indiana ve Kentucky: İlçe ve yerel vergilerin eyalet vergisine eklenmesi gerekiyor.

Bu farklılıklar, vergi hesaplama motorunun esnek ve genişletilebilir olmasını zorunlu kılıyor.

Vergi hesaplama motorunun mimarisi: esneklik ve doğruluk

Her eyalet için ayrı bir hesaplama fonksiyonu yerine, genel bir motor ve eyaletlere özel yapılandırma kullanmak, hem performansı hem de bakım kolaylığını artırıyor. Örneğin:

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

Bu yapı sayesinde, her eyalet için sadece bir yapılandırma dosyası eklemek yeterli oluyor. Özel durumlar içinse computeOverride fonksiyonu kullanılarak hesaplama motorunun değiştirilmesi gerekiyor.

Doğrulama: hesaplamaların güvenilirliği için kritik adımlar

Vergi hesaplamalarında "yaklaşık doğru" olmak yeterli değil. Çünkü insanlar kendi maaşlarını bilirler ve hesaplamalardaki küçük hataları hemen fark ederler. Bu nedenle, her eyalet için el ile yapılan hesaplamaların devletin yayınladığı resmi rakamlarla karşılaştırılması gerekiyor. Örneğin:

  • Kaliforniya’nın en yüksek vergi oranı %12.3 iken, Kuzey Dakota’da 48.000 dolara kadar vergi neredeyse sıfırdır.
  • Hawaii’nin en yüksek vergi oranı %11 iken, Teksas gibi eyaletlerde eyalet gelir vergisi uygulanmaz.

Bu farklılıklar, hesaplamaların doğruluğunu test etmek için sürekli kontroller yapılmasını gerektiriyor. Projede şu anda 229 adet birim testi bulunuyor. Her eyalet için ayrı testler, hesaplamaların güncel ve doğru kalmasını sağlıyor.

Sonuç: ABD’de net maaş hesaplamak için neler gerekiyor?

ABD’de net maaş hesaplamak, sadece bir matematik problemi değil; aynı zamanda vergi sistemlerinin karmaşıklığını anlamak ve doğru şekilde modellemekle ilgili. Federal, eyalet ve yerel vergiler arasındaki etkileşimler, hesaplamaların her adımda dikkatle yapılması gerektiğini gösteriyor. İyi tasarlanmış bir hesaplama motoru, bu karmaşıklığı yönetilebilir hale getirirken, sürekli testlerle de hesaplamaların doğruluğu garanti altına alınıyor.

Gelecekte, daha fazla eyaletin vergi sistemindeki değişikliklere uyum sağlamak için bu motorun esnekliğini korumak gerekiyor. ABD’nin vergi sistemi kadar sürekli değişen bir alanda, doğru ve güncel hesaplamalar sunmak, kullanıcılar için güvenilir bir kaynak olmanın anahtarı olacak.

Yapay zeka özeti

ABD’de net maaş hesaplamak neden bu kadar karmaşık? Federal, eyalet ve yerel vergiler arasındaki etkileşimleri keşfedin ve doğru bir hesaplama motoru nasıl tasarlanır öğrenin.

Yorumlar

00
YORUM BIRAK
ID #PTF34L

0 / 1200 KARAKTER

İnsan doğrulaması

9 + 3 = ?

Editör onayı sonrası yayına girer

Moderasyon · Spam koruması aktif

Henüz onaylı yorum yok. İlk yorumu sen bırak.