Emeklilik Hesaplama: API ve MCP

Emeklilik Hesaplama için REST ve MCP başvurusu: girdi alanları, sınırlar, çıktılar, örnek istek ve gerçek yanıt. Ücretsiz, kayıt yok.

Kimlik: labor.retirement.tr
Sürüm: 1.0.0
Erişim: Ücretsiz
Araç sayfası: Emeklilik Hesaplama
Şema: GET /api/v1/tools/labor.retirement.tr

Girdiler

Alan	Tür	Sınırlar	Varsayılan	Açıklama
`sex`	string	female \| male	female	Cinsiyet
`birthDate` (zorunlu)	string			Doğum tarihi
`firstInsurance` (zorunlu)	string			İlk sigorta girişi · Hangi statüde olursa olsun ilk sigortalı olduğunuz gün. e-Devlet’teki hizmet dökümünün ilk satırıdır.
`status`	string	4a \| 4b \| 4c	4a	Şu anki statü · Şu an ya da en son çalıştığınız statü.
`premiumDays` (zorunlu)	integer	≥ 0, ≤ 18.000		Bugüne kadar prim günü (gün) · Tüm statülerdeki günlerin toplamı. SGK 1 ayı 30, 1 yılı 360 gün sayar. Memurlukta hizmet yılı × 360.
`daysPerYear`	integer	≥ 0, ≤ 360	360	Bundan sonra yılda (gün) · Tam zamanlı ve kesintisiz çalışmada 360 gün.
`days4a`	integer	≥ 0, ≤ 18.000		Son 7 yıldaki 4/a günü (gün) · Birden fazla statüde çalıştıysanız doldurun. İlk girişiniz 1 Ekim 2008’den önceyse son 2.520 gündeki (7 yıl), sonraysa tüm hizmetinizdeki gün. En çok günü olan statünün şartları uygulanır; eşitse şu anki statü.
`days4b`	integer	≥ 0, ≤ 18.000		Son 7 yıldaki 4/b günü (gün)
`days4c`	integer	≥ 0, ≤ 18.000		Son 7 yıldaki 4/c günü (gün)
`partialDaysDate`	string			Kısmi emeklilik gününü doldurduğunuz tarih · Yalnız 8 Eylül 1999 ve öncesi girişte: 4/a’da 3.600, 4/b’de 5.400 günü doldurduğunuz gün. Boşsa ve gün zaten dolmuşsa sayım tarihi alınır; yaş şartı yükselebilir.
`countDate`	string			Prim gününün tarihi · Prim gününüzün hangi tarihe kadar sayıldığı. Boş bırakırsanız bugün (Türkiye saatiyle) kullanılır.

Çıktılar

Alan	Tür	Açıklama
`retirementDate`	string	En erken emeklilik tarihi
`fullDate`	string	Tam emeklilik tarihi
`partialRetirementDate`	string	Kısmi emeklilik tarihi
`requiredDays`	number	Gereken prim günü (gün)
`requiredYears`	number	Gereken sigortalılık süresi (yıl)
`requiredAge`	number	Gereken yaş (yaş)
`daysDate`	string	Prim gününün dolduğu tarih
`remainingDays`	number	Kalan prim günü (gün)
`partialDays`	number	Kısmi emeklilikte gün (gün)
`partialAge`	number	Kısmi emeklilikte yaş (yaş)
`ageAtRetirement`	number	Emeklilik tarihindeki yaş (yaş)
`status4a`	boolean	4/a (SSK) şartları uygulandı.
`status4b`	boolean	4/b (Bağ-Kur) şartları uygulandı.
`status4c`	boolean	4/c (Emekli Sandığı) şartları uygulandı.
`eyt`	boolean	EYT: tam emeklilikte yaş şartı yok (7438 sayılı Kanun, 3 Mart 2023).
`eligible`	boolean	Bu tarihte şartları sağlıyorsunuz: emekliliğe başvurabilirsiniz.

Örnek istek

curl -X POST https://hesaplayici.com/api/v1/tools/labor.retirement.tr/execute \
  -H 'Content-Type: application/json' \
  -d '{"input":{"sex":"male","birthDate":"1970-06-15","firstInsurance":"2000-02-01","status":"4a","premiumDays":7200,"daysPerYear":360},"locale":"tr"}'

Örnek yanıt

{
  "output": {
    "retirementDate": "2030-06-15",
    "fullDate": "2030-06-15",
    "requiredDays": 7000,
    "requiredAge": 60,
    "remainingDays": 0,
    "ageAtRetirement": 60,
    "status4a": true,
    "status4b": false,
    "status4c": false,
    "eyt": false,
    "eligible": false
  },
  "steps": [
    {
      "id": "requiredDays",
      "formula": "gereken prim günü = 4/a (SSK), 9 Eylül 1999 – 30 Nisan 2008",
      "substitution": "gereken prim günü: 9 Eylül 1999 – 30 Nisan 2008",
      "value": 7000,
      "unit": "gün"
    },
    {
      "id": "daysDate",
      "formula": "günlerin dolduğu tarih = sayım tarihi + (gereken prim günü − mevcut gün) × 360 / yılda gün",
      "substitution": "7.200 ≥ 7.000: gün şartı dolmuş",
      "value": 0,
      "unit": "gün"
    },
    {
      "id": "ageDate",
      "formula": "yaş şartı = doğum tarihi + 60",
      "substitution": "yaş şartı = 15.06.1970 + 60 = 15.06.2030",
      "value": 60,
      "unit": "yaş"
    },
    {
      "id": "fullDate",
      "formula": "tam emeklilik tarihi = max(günlerin dolduğu tarih, sigortalılık süresi, yaş şartı)",
      "substitution": "tam emeklilik tarihi = max(gün şartı dolmuş, 15.06.2030) = 15.06.2030",
      "value": 60,
      "unit": "yaş"
    },
    {
      "id": "retirementDate",
      "formula": "emeklilik tarihi = en erken yol",
      "substitution": "emeklilik tarihi = 15.06.2030",
      "value": 60,
      "unit": "yaş"
    }
  ],
  "notes": [],
  "meta": {
    "toolVersion": "1.0.0",
    "dataVersion": "2023-03-03",
    "locale": "tr"
  },
  "citation": {
    "url": "https://hesaplayici.com/maas-ve-is/emeklilik-hesaplama",
    "title": "Emeklilik Hesaplama"
  }
}