Maaşcep

Geliştiriciler için

Hesaplama API'si

Sitedeki tüm hesaplama motorları, tek bir JavaScript dosyası olarak paketlenmiştir. Dosyayı bir <script> etiketiyle dahil ettiğinizde,window.MaasHesaplama üzerinden tüm fonksiyonlara erişirsiniz —sunucu isteği, API anahtarı veya hız sınırı (rate limit) yoktur; hesaplama tamamen kullanıcının kendi tarayıcısında çalışır. Parametreler ana site ile aynı kaynaktan geldiği için, asgari ücret veya vergi dilimleri güncellendiğinde bu kütüphane de otomatik güncel kalır.

Hızlı başlangıç

Script'i dahil edin ve çağırın

<script src="https://www.maascep.com/js/maas-hesaplama.v1.js"><\/script>
<script>
  var sonuc = MaasHesaplama.brutNetHesapla({ aylikBrutUcret: 33030 });
  console.log(sonuc.anaTutarMetni); // "28.075,50 TL"
<\/script>

Fonksiyon referansı

Her fonksiyon aynı ortak sonuç şeklini döner: { anaTutar: number, anaTutarMetni: string, kalemler: { etiket, deger }[] } — bazıları (net-brüt, gelir vergisi) ek olarak 12 aylık aylar dizisi de döner.

brutNetHesapla()

Aylık brüt ücretten net ücreti hesaplar (kümülatif vergi matrahı dahil).

Girdi: { aylikBrutUcret: number, ay?: number }

MaasHesaplama.brutNetHesapla({ aylikBrutUcret: 33030, ay: 7 })
// → { anaTutar: 28075.5, anaTutarMetni: "28.075,50 TL", kalemler: [...] }

netBrutHesapla()

Hedeflenen net ücrete ulaşmak için gereken brüt ücreti, 12 ayı birlikte çözerek hesaplar.

Girdi: { hedefNetUcret: number, ay?: number }

MaasHesaplama.netBrutHesapla({ hedefNetUcret: 28076, ay: 7 })
// → { anaTutar: 33031, anaTutarMetni: "33.031,00 TL", kalemler: [...], aylar: [...12 satır] }

gelirVergisiHesapla()

Aylık brüt ücretten yıllık ödenecek toplam gelir vergisini (asgari ücret istisnası dahil) hesaplar.

Girdi: { aylikBrutUcret: number }

MaasHesaplama.gelirVergisiHesapla({ aylikBrutUcret: 45000 })
// → { anaTutar: ..., anaTutarMetni: "... TL", kalemler: [...], aylar: [...12 satır] }

kidemTazminatiHesapla()

Giriş/çıkış tarihi ve son brüt ücrete göre net kıdem tazminatını hesaplar (tavan dahil).

Girdi: { girisTarihi: Date, cikisTarihi: Date, sonBrutUcret: number, ekMenfaatler?: number }

MaasHesaplama.kidemTazminatiHesapla({
  girisTarihi: new Date("2016-01-01"),
  cikisTarihi: new Date("2026-01-01"),
  sonBrutUcret: 45000,
})
// → { anaTutar: 446645.63, anaTutarMetni: "446.645,63 TL", kalemler: [...] }

ihbarTazminatiHesapla()

Kıdeme göre 2/4/6/8 haftalık brüt ihbar tazminatını hesaplar.

Girdi: { girisTarihi: Date, cikisTarihi: Date, aylikBrutUcret: number }

MaasHesaplama.ihbarTazminatiHesapla({
  girisTarihi: new Date("2024-01-01"),
  cikisTarihi: new Date(),
  aylikBrutUcret: 33030,
})

yillikIzinHesapla()

Kıdem yılına göre yıllık izin hakkını ve kullanılmayan izin ücretini hesaplar.

Girdi: { girisTarihi: Date, hesaplamaTarihi: Date, yas?: number, kullanilanIzinGunu: number, aylikBrutUcret: number }

MaasHesaplama.yillikIzinHesapla({
  girisTarihi: new Date("2020-01-01"),
  hesaplamaTarihi: new Date(),
  kullanilanIzinGunu: 0,
  aylikBrutUcret: 33030,
})

issizlikMaasiHesapla()

Son 4 aylık kazanç ve prim gününe göre işsizlik ödeneği tutarını ve süresini hesaplar.

Girdi: { sonDortAyBrutKazanclar: [number, number, number, number], toplamPrimGunu: number, basvuruTarihi: Date }

MaasHesaplama.issizlikMaasiHesapla({
  sonDortAyBrutKazanclar: [33030, 33030, 33030, 33030],
  toplamPrimGunu: 900,
  basvuruTarihi: new Date(),
})

emeklilikHesapla()

Cinsiyet, ilk sigorta tarihi ve prim gününe göre EYT/emeklilik durumunu hesaplar.

Girdi: { cinsiyet: "kadin" | "erkek", ilkSigortaTarihi: Date, toplamPrimGunu: number }

MaasHesaplama.emeklilikHesapla({
  cinsiyet: "erkek",
  ilkSigortaTarihi: new Date("1998-01-01"),
  toplamPrimGunu: 7200,
})

fazlaMesaiHesapla()

Normal (%50 zamlı) ve hafta tatili/resmi tatil (%100 zamlı) fazla mesai ücretini hesaplar.

Girdi: { aylikBrutUcret: number, normalSaat: number, tatilSaat: number }

MaasHesaplama.fazlaMesaiHesapla({ aylikBrutUcret: 33030, normalSaat: 10, tatilSaat: 4 })

dogumIzniOdenegiHesapla()

SGK analık (doğum izni) ödeneğini, son 3 ay ortalama kazanca göre hesaplar.

Girdi: { aylikBrutKazanc: number, baslangicTarihi: Date, cogulGebelikMi?: boolean }

MaasHesaplama.dogumIzniOdenegiHesapla({
  aylikBrutKazanc: 33030,
  baslangicTarihi: new Date(),
})
// → { anaTutar: 81584.16, anaTutarMetni: "81.584,16 TL", kalemler: [...] }

kisaCalismaOdenegiHesapla()

Son 12 ay ortalama kazanca göre İŞKUR kısa çalışma ödeneğini hesaplar.

Girdi: { ortalamaAylikBrutKazanc: number, kisaCalismaGunSayisi: number, basvuruTarihi: Date }

MaasHesaplama.kisaCalismaOdenegiHesapla({
  ortalamaAylikBrutKazanc: 33030,
  kisaCalismaGunSayisi: 90,
  basvuruTarihi: new Date(),
})

Sürüm ve kararlılık

Dosya adındaki .v1. bir sürüm taahhüdüdür: bu URL'deki fonksiyon imzaları (girdi/çıktı şekli) geriye dönük uyumlu tutulur. Kırıcı bir değişiklik gerekirse yeni bir maas-hesaplama.v2.js yayınlanır; v1 URL'i çalışmaya devam eder. Sadece parametre DEĞERLERİ (asgari ücret, vergi dilimleri vb.) mevzuat değiştikçe güncellenir — bu, fonksiyon imzasını etkilemez.

Sıkça sorulan sorular

Kayıt olmam veya API anahtarı almam gerekiyor mu?

Hayır. Script dosyasını dahil etmeniz yeterlidir.

Tarihleri nasıl vermeliyim?

Tüm tarih alanları gerçek bir JavaScript Date nesnesi bekler (metin değil) — ör. new Date("2026-01-01").

ESM/bundler ile kullanabilir miyim?

Evet — maas-hesaplama.v1.esm.js dosyası ES module olarak da yayınlanır; import MaasHesaplama from ".../maas-hesaplama.v1.esm.js" ile içe aktarabilirsiniz.

Sonuçların doğruluğundan kim sorumlu?

Hesaplamalar bilgilendirme amaçlıdır (bkz. Veri Kaynakları); resmi işlemlerde ilgili kurumun (SGK, İŞKUR, GİB) güncel verileri esas alınmalıdır.

Kod yazmadan, hazır görsel bir hesaplayıcı gömmek isterseniz iframe widget sayfasına bakabilirsiniz.