{
  "arac_adi": "Kredi Taksit ve Ödeme Planı",
  "slug": "kredi-taksit",
  "aciklama": "Kullanıcının verdiği aylık nominal faiz, KKDF, faiz BSMV'si, vergi hariç tahsis ücreti ve ayrı ücret BSMV'siyle anüite taksitini, kredi türüne göre YMO veya yıllıklandırılmış nakit akışı IRR'sini ve ay ay amortisman planını hesaplar; piyasa faiz oranı yayımlamaz.",
  "kategori": "finans",
  "surum": "2.0.0",
  "guncelleme_tarihi": "2026-07-31",
  "calisma_modeli": {
    "fonksiyon": "krediPlani(girdi)",
    "saf_fonksiyon": true,
    "ag_istegi": false,
    "para_hesaplama_birimi": "kuruş (tam sayı)",
    "para_birimi": "TRY"
  },
  "urun_uygulama_sinirlari": {
    "vade_ay": {
      "min": 1,
      "max": 480,
      "mevzuat_siniri": false,
      "aciklama": "Yalnız hesap motorunun teknik ürün/uygulama sınırıdır; hukuki veya yasal vade değildir."
    },
    "aylik_irr_cozum_araligi": {
      "min": 0,
      "max": 1,
      "aralik_hassasiyeti": 1e-10,
      "mevzuat_siniri": false,
      "aciklama": "Bisection uygulama aralığıdır; mevzuat oranı değildir. Kök bu aralıkta yoksa ymo null döner."
    },
    "para_kurus_tam_sayi": {
      "max": 9007199254740991,
      "mevzuat_siniri": false,
      "aciklama": "JavaScript güvenli tam sayı ürün/uygulama sınırıdır."
    },
    "annuite_us_basamak_butcesi": {
      "max": 25000,
      "mevzuat_siniri": false,
      "aciklama": "Üs alma sırasında kaynak tüketimini sınırlayan ürün/uygulama güvenlik eşiğidir."
    }
  },
  "mevzuat_kurallari": {
    "hesap_cekirdegi_dis_referans": {
      "ad": "Tüketici Kredisi Sözleşmeleri Yönetmeliği m.4/k ve Ek-2",
      "url": "https://tuketici.ticaret.gov.tr/data/5e819a8e13b876a1b04c7a4a/T%C3%BCketici%20Kredisi%20S%C3%B6zle%C5%9Fmeleri%20Y%C3%B6netmeli%C4%9Fi.pdf",
      "dogruladigi": "m.4/k toplam maliyeti akdi faiz, vergi, harç ve ücretlerin tümü olarak tanımlar; Ek-2 düzenli taksitin brüt oranla (i_brüt = i_nominal × (1 + KKDF + BSMV)) belirlenip ay içi nominal faiz, KKDF ve BSMV'nin ayrı kuruşa yuvarlandığı bileşen hesabının dış referansıdır. Ek-2 örneği 50.000 TL, 36 ay, aylık %1, KKDF %15, BSMV %5'tir.",
      "ek2_ornek_bilesenleri": {
        "anapara_tl": 50000,
        "vade_ay": 36,
        "aylik_nominal_yuzde": 1,
        "kkdf_yuzde": 15,
        "bsmv_yuzde": 5,
        "duzenli_taksit_tl": 1718.61,
        "ay_1": {"taksit": 1718.61, "nominal_faiz": 500, "kkdf": 75, "bsmv": 25, "anapara": 1118.61, "kalan_borc": 48881.39},
        "ay_36": {"taksit": 1718.72, "nominal_faiz": 16.98, "kkdf": 2.55, "bsmv": 0.85, "anapara": 1698.34, "kalan_borc": 0},
        "toplam_taksit_tl": 61870.07,
        "toplam_nominal_faiz_tl": 9891.67,
        "toplam_kkdf_tl": 1483.79,
        "toplam_bsmv_tl": 494.61
      },
      "dogrulanmamayan_acik_kusur": "Bankaların gün hesabı, tahsilat tarihi ve kurum içi yuvarlama yöntemi resmî Ek-2 yönteminden ayrıdır; bu araç Ek-2 bileşen yöntemini uygular ve bankaya özgü yuvarlamayı modellemez."
    },
    "ihtiyac_kredisi_genel_vade": {
      "karar_no": "11152",
      "karar_tarihi": "2025-02-13",
      "url": "https://www.bddk.gov.tr/Mevzuat/EkGetir/1210?ekId=281",
      "sinirlar": [
        {"tutar": "≤125.000 TL", "azami_vade_ay": 36},
        {"tutar": ">125.000 TL ve ≤250.000 TL", "azami_vade_ay": 24},
        {"tutar": ">250.000 TL", "azami_vade_ay": 12}
      ],
      "asildiginda_uyari_kodu": "BDDK_11152_VADE_SINIRI_ASILDI"
    },
    "tasit_ve_konut_uygunlugu": {
      "durum": "denetlenmiyor",
      "uyari_kodu": "UYGUNLUK_DENETLENMEDI",
      "aciklama": "Matematiksel ödeme planı taşıt veya konut kredisi uygunluğu/onayı anlamına gelmez. Kredi/değer oranı eksik ham girdi değildir; anapara ile varlık değerinden türetilir.",
      "turetilen_alan": {
        "ad": "kredi_deger_orani",
        "konut_formulu": "anapara / konut_degeri",
        "tasit_formulu": "anapara / tasit_degeri"
      },
      "konut": {
        "eksik_ham_alanlar": [
          "konut_degeri",
          "enerji_sinifi",
          "tuketici_konut_maliki",
          "es_konut_maliki",
          "onsekiz_yas_alti_cocuk_konut_maliki",
          "hane_malik_konut_sayisi",
          "malik_konut_koy_veya_6360_mahallesi",
          "ayni_nitelik_icin_resmi_yazi",
          "hisseli_konut_sayisi",
          "konut_tapu_hisse_orani",
          "malik_tek_konut_riskli_yapi_yikildi",
          "malik_tek_konut_yikim_karari_var"
        ],
        "aciklama": "11364 uyarınca konut değeri ve enerji sınıfı; 10656/10849 uyarınca tüketici, eş ve 18 yaş altı çocukların malikliği ile köy/6360-mahalle, resmi yazı, hisseli tapu ve tek riskli/yıkım kararlı konut istisnasını belirleyen ham nitelikler gerekir.",
        "kaynaklar": [
          {
            "karar_no": "11364",
            "karar_tarihi": "2026-01-29",
            "url": "https://www.bddk.gov.tr/Mevzuat/EkGetir/1210?ekId=283",
            "kapsam": "konut_degeri_ve_enerji_sinifi",
            "dogruladigi": "Güncel azami kredi tutarının konut değeri ve Enerji Kimlik Belgesindeki enerji sınıfına göre belirlendiği; ilk/ikinci el ayrımı bulunmadığı."
          },
          {
            "karar_no": "10656",
            "karar_tarihi": "2023-08-24",
            "url": "https://www.bddk.gov.tr/Mevzuat/EkGetir/1210?ekId=277",
            "kapsam": "hane_konut_malikligi_ve_istisnalari",
            "dogruladigi": "Tüketici, eş veya 18 yaş altı çocukların konut malikliği halinde oran indirimi ile köy/6360 mahallesi ve belirli hisseli tapu istisnaları."
          },
          {
            "karar_no": "10849",
            "karar_tarihi": "2024-02-15",
            "url": "https://www.bddk.gov.tr/Mevzuat/EkGetir/1210?ekId=278",
            "kapsam": "tek_riskli_veya_yikim_kararli_konut_istisnasi",
            "dogruladigi": "Hanenin tek konutunun riskli yapı nedeniyle yıkılmış veya hakkında yıkım kararı alınmış olması halinde malikiyet değerlendirmesinde dikkate alınmaması."
          }
        ]
      },
      "tasit": {
        "eksik_ham_alanlar": ["tasit_degeri", "tasit_niteligi"],
        "aciklama": "tasit_niteligi, genel taşıt dalı ile 5520 sayılı Kanun geçici m.12 kapsamındaki mükelleflerce üretilen sadece elektrik motorlu taşıtlara özgü karar dalı gibi farklı BDDK hükümleri arasından doğru dalı seçmek için zorunludur.",
        "kaynaklar": [
          {
            "karar_no": null,
            "karar_tarihi": null,
            "url": "https://www.bddk.gov.tr/Mevzuat/Detay/1210",
            "kapsam": "tasit_genel_karar_dizini",
            "dogruladigi": "Taşıt niteliğine göre doğru kredi/değer ve vade karar dalının seçilmesi gereken genel BDDK tüketici kredi kararları dizini."
          },
          {
            "karar_no": "11158",
            "karar_tarihi": "2025-03-06",
            "url": "https://www.bddk.gov.tr/Mevzuat/EkGetir/1210?ekId=282",
            "kapsam": "5520_gecici_12_mukelleflerince_uretilen_sadece_elektrik_motorlu_tasitlar",
            "dogruladigi": "Yalnız 5520 sayılı Kanun geçici m.12 kapsamındaki mükelleflerce üretilen sadece elektrik motorlu taşıtlara özgü karar dalı; bütün taşıtlar için genel kaynak değildir."
          }
        ]
      }
    },
    "ymo_dayanaklari": {
      "ihtiyac": {
        "ad": "Efektif yıllık faiz oranı (YMO)",
        "dayanak": "Tüketici Kredisi Sözleşmeleri Yönetmeliği m.14 ve Ek-1",
        "url": "https://tuketici.ticaret.gov.tr/data/5e819a8e13b876a1b04c7a4a/T%C3%BCketici%20Kredisi%20S%C3%B6zle%C5%9Fmeleri%20Y%C3%B6netmeli%C4%9Fi.pdf"
      },
      "tasit": {
        "ad": "Efektif yıllık faiz oranı (YMO)",
        "dayanak": "Tüketici Kredisi Sözleşmeleri Yönetmeliği m.14 ve Ek-1",
        "url": "https://tuketici.ticaret.gov.tr/data/5e819a8e13b876a1b04c7a4a/T%C3%BCketici%20Kredisi%20S%C3%B6zle%C5%9Fmeleri%20Y%C3%B6netmeli%C4%9Fi.pdf"
      },
      "konut": {
        "ad": "Yıllık maliyet oranı (YMO)",
        "dayanak": "Konut Finansmanı Sözleşmeleri Yönetmeliği m.16 ve Ek-1",
        "url": "https://tuketici.ticaret.gov.tr/data/5e819a8e13b876a1b04c7a4a/Konut%20Finansman%C4%B1%20S%C3%B6zle%C5%9Fmeleri%20Y%C3%B6netmeli%C4%9Fi.pdf"
      },
      "ticari": {
        "ad": "Yıllıklandırılmış nakit akışı IRR'si",
        "dayanak": null,
        "url": null,
        "aciklama": "Tüketici mevzuatındaki YMO değildir."
      }
    }
  },
  "girdiler": [
    {
      "ad": "kredi_turu",
      "tip": "enum",
      "birim": null,
      "zorunlu": true,
      "aralik": ["konut", "tasit", "ihtiyac", "ticari"],
      "fonksiyon_varsayilani": null,
      "arayuz_varsayilani": "ihtiyac",
      "aciklama": "Vergi varsayılanı kapsamını seçer. ticari seçeneği olağan TL ticari banka kredisi ve özel istisna bulunmaması varsayımındadır."
    },
    {
      "ad": "konut_sahipligi",
      "tip": "enum",
      "birim": null,
      "zorunlu": "kredi_turu=konut ise",
      "aralik": ["yok", "var"],
      "fonksiyon_varsayilani": null,
      "aciklama": "Yalnız BSMV vergi istisnası için kredi tarihinde tüketicinin adına kayıtlı konut veya konut hissesi durumudur. yok ise koşullu BSMV istisnası varsayılır; var ise tüketici kredisi oranı uygulanır. BDDK kredi/değer uygunluğu için tüketici, eş ve 18 yaş altı çocuk malikliği ile 10656/10849 istisna niteliklerini kapsayan ayrı ham alanların yerine geçmez."
    },
    {
      "ad": "anapara",
      "tip": "sayı veya TR ondalık metni",
      "birim": "TL",
      "zorunlu": true,
      "aralik": {
        "min_haric": 0
      },
      "fonksiyon_varsayilani": null,
      "arayuz_varsayilani": 100000
    },
    {
      "ad": "faiz_orani",
      "tip": "sayı veya TR ondalık metni",
      "birim": "% / ay (nominal)",
      "zorunlu": true,
      "aralik": {
        "min": 0
      },
      "fonksiyon_varsayilani": null,
      "aciklama": "Bankanın aylık ilan ettiği nominal faizdir. Araç piyasa oranı sağlamaz."
    },
    {
      "ad": "vade",
      "tip": "tam sayı",
      "birim": "ay",
      "zorunlu": true,
      "urun_uygulama_araligi": {
        "min": 1,
        "max": 480
      },
      "fonksiyon_varsayilani": null,
      "arayuz_varsayilani": 36,
      "aciklama": "1..480 motorun teknik ürün/uygulama sınırıdır; yasal vade değildir. İhtiyaç kredisi için BDDK 11152 sınırı aşıldığında kaynaklı uyarı döner."
    },
    {
      "ad": "kkdf_orani",
      "tip": "sayı veya TR ondalık metni",
      "birim": "%",
      "zorunlu": false,
      "aralik": {
        "min": 0
      },
      "fonksiyon_varsayilani": {
        "konut": 0,
        "tasit": 15,
        "ihtiyac": 15,
        "ticari_tl_olagan": 0
      },
      "arayuz_varsayilani": "fonksiyon_varsayilani ile aynı matris",
      "aciklama": "Düzenlenebilir. Ticari %0 varsayılanı döviz/altın krediye veya özel işleme uygulanmaz."
    },
    {
      "ad": "bsmv_orani",
      "tip": "sayı veya TR ondalık metni",
      "birim": "%",
      "zorunlu": false,
      "aralik": {
        "min": 0
      },
      "fonksiyon_varsayilani": {
        "konut_sahipligi_yok": 0,
        "konut_sahipligi_var": 15,
        "tasit": 15,
        "ihtiyac": 15,
        "ticari_tl_olagan": 5
      },
      "arayuz_varsayilani": "fonksiyon_varsayilani ile aynı matris",
      "aciklama": "Düzenlenebilir. Konut sahibi kişinin %15'i, konut istisnasını daraltan 7491 ile tüketici kredisi oranını belirleyen 7345'in birlikte uygulanmasının sonucudur."
    },
    {
      "ad": "tahsis_ucreti",
      "tip": "sayı veya TR ondalık metni",
      "birim": "tahsis_ucreti_birimi alanına göre TL veya anapara yüzdesi",
      "zorunlu": false,
      "aralik": {
        "min": 0
      },
      "fonksiyon_varsayilani": 0,
      "arayuz_varsayilani": 0,
      "aciklama": "Vergi hariç tahsis ücreti tabanıdır. Binde beş tavanı bu tutar üzerinden kontrol edilir; tahsis_ucreti_bsmv ayrıca hesaplanır ve ikisi de peşin masrafa/maliyet oranına girer."
    },
    {
      "ad": "tahsis_ucreti_birimi",
      "tip": "enum",
      "birim": null,
      "zorunlu": false,
      "aralik": ["tl", "yuzde"],
      "fonksiyon_varsayilani": "tl",
      "arayuz_varsayilani": "tl"
    },
    {
      "ad": "tahsis_ucreti_bsmv_orani",
      "tip": "sayı veya TR ondalık metni",
      "birim": "%",
      "zorunlu": false,
      "aralik": {
        "min": 0
      },
      "fonksiyon_varsayilani": {
        "konut_sahipligi_yok": 0,
        "konut_sahipligi_var": 15,
        "tasit": 15,
        "ihtiyac": 15,
        "ticari_tl_olagan": 5
      },
      "arayuz_varsayilani": "fonksiyon_varsayilani ile aynı matris",
      "aciklama": "Vergi hariç tahsis ücreti tabanı üzerinden hesaplanan, kaynaklı ve düzenlenebilir ayrı BSMV oranıdır."
    },
    {
      "ad": "diger_masraf",
      "tip": "sayı veya TR ondalık metni",
      "birim": "TL",
      "zorunlu": false,
      "aralik": {
        "min": 0
      },
      "fonksiyon_varsayilani": 0,
      "arayuz_varsayilani": 0,
      "aciklama": "Ekspertiz, ipotek tesisi, hayat/DASK sigortası gibi peşin giderlerin toplamı."
    }
  ],
  "cikti_semasi": {
    "basarili": {
      "tip": "boolean"
    },
    "surum": {
      "tip": "string",
      "yalnizca": "başarılı yanıtta"
    },
    "para_birimi": {
      "tip": "string",
      "sabit": "TRY"
    },
    "hesaplama_birimi": {
      "tip": "string",
      "sabit": "kuruş (tam sayı)"
    },
    "girdi": {
      "tip": "object",
      "aciklama": "Motorun varsayılanları uyguladıktan sonra döndürdüğü normalize girdi. Anapara, diğer masraf ve TL birimli tahsis ücreti kuruşa yuvarlanır; yüzde birimli tahsis girdisi yüzde olarak korunur.",
      "alanlar": {
        "kredi_turu": {"tip": "string"},
        "konut_sahipligi": {"tip": ["string", "null"]},
        "anapara": {"tip": "number", "birim": "TL"},
        "faiz_orani": {"tip": "number", "birim": "% / ay"},
        "vade": {"tip": "integer", "birim": "ay"},
        "kkdf_orani": {"tip": "number", "birim": "%"},
        "bsmv_orani": {"tip": "number", "birim": "%"},
        "tahsis_ucreti": {"tip": "number", "birim": "girdide seçilen birim", "semantik": "vergi hariç taban"},
        "tahsis_ucreti_birimi": {"tip": "string"},
        "tahsis_ucreti_bsmv_orani": {"tip": "number", "birim": "%", "semantik": "tahsis_ucreti_tutari üzerinden uygulanan ayrı oran"},
        "diger_masraf": {"tip": "number", "birim": "TL"}
      }
    },
    "ozet": {
      "tip": "object",
      "alanlar": {
        "aylik_taksit": {"tip": "number", "birim": "TL", "aciklama": "Son ay dışındaki düzenli kuruş taksit."},
        "son_taksit": {"tip": "number", "birim": "TL"},
        "son_taksit_farki": {"tip": "number", "birim": "TL", "aciklama": "Son taksit eksi düzenli taksit; negatif olabilir."},
        "taksitler_toplami": {"tip": "number", "birim": "TL"},
        "nominal_faiz_toplami": {"tip": "number", "birim": "TL", "formul": "plan[].nominal_faiz toplamı"},
        "kkdf_toplami": {"tip": "number", "birim": "TL", "formul": "plan[].kkdf toplamı"},
        "bsmv_toplami": {"tip": "number", "birim": "TL", "formul": "plan[].bsmv toplamı"},
        "tahsis_ucreti_tutari": {"tip": "number", "birim": "TL", "aciklama": "Vergi hariç tahsis ücreti tabanının TL tutarı."},
        "tahsis_ucreti_bsmv": {"tip": "number", "birim": "TL", "formul": "kuruşa_half_up_yuvarla(tahsis_ucreti_tutari × tahsis_ucreti_bsmv_orani/100)"},
        "tahsis_ucreti_vergi_dahil": {"tip": "number", "birim": "TL", "formul": "tahsis_ucreti_tutari + tahsis_ucreti_bsmv"},
        "pesin_masraflar": {"tip": "number", "birim": "TL", "formul": "tahsis_ucreti_tutari + tahsis_ucreti_bsmv + diger_masraf"},
        "net_kullandirim": {"tip": "number", "birim": "TL", "formul": "anapara - pesin_masraflar"},
        "toplam_geri_odeme": {"tip": "number", "birim": "TL", "formul": "taksitler_toplami + pesin_masraflar"},
        "faiz_ve_vergiler_toplami": {"tip": "number", "birim": "TL", "formul": "nominal_faiz_toplami + kkdf_toplami + bsmv_toplami", "aciklama": "Nominal faiz ve üzerine binen KKDF/BSMV'nin toplamı; taksitler_toplami - anapara'ya eşittir ve peşin masraf içermez."},
        "faiz_vergileri_toplami": {"tip": "number", "birim": "TL", "formul": "kkdf_toplami + bsmv_toplami", "aciklama": "Yalnız faiz üzerinden alınan KKDF ve BSMV toplamı."},
        "toplam_faiz": {"tip": "number", "birim": "TL", "formul": "faiz_ve_vergiler_toplami", "aciklama": "2.0.0'da kullanımdan kalkmış (deprecated) birleşik alias; faiz_ve_vergiler_toplami ile aynı değer. Eski 'efektif faiz' anlamını korur."},
        "toplam_vergi": {"tip": "number", "birim": "TL", "formul": "kkdf_toplami + bsmv_toplami + tahsis_ucreti_bsmv"},
        "toplam_maliyet": {"tip": "number", "birim": "TL", "formul": "toplam_geri_odeme - anapara", "aciklama": "Faiz, faiz vergileri, tahsis ücreti tabanı, ücret BSMV'si ve diğer peşin masrafları içerir."},
        "anapara_toplami": {"tip": "number", "birim": "TL", "aciklama": "plan[].anapara toplamı; başlangıç anaparasına eşittir."},
        "nominal_aylik_oran": {"tip": "number", "birim": "% / ay"},
        "nominal_yillik_bilesik_oran": {"tip": "number", "birim": "% / yıl"},
        "efektif_aylik_oran": {"tip": "number", "birim": "% / ay"},
        "efektif_yillik_oran": {"tip": "number", "birim": "% / yıl"},
        "ymo": {"tip": ["number", "null"], "birim": "% / yıl", "aciklama": "Ürün/uygulama aralığı olan aylık IRR [0,1] içinde bulunamazsa null."},
        "ymo_adi": {"tip": "string", "aciklama": "İhtiyaç/taşıtta efektif yıllık faiz oranı (YMO), konutta yıllık maliyet oranı (YMO), ticaride yıllıklandırılmış nakit akışı IRR'si."},
        "ymo_aciklamasi": {"tip": "string", "aciklama": "Kredi türüne özgü mevzuat veya ticari matematik kapsamı."}
      }
    },
    "plan": {
      "tip": "array",
      "uzunluk": "vade",
      "alanlar": {
        "ay": {"tip": "integer", "birim": "ay"},
        "taksit": {"tip": "number", "birim": "TL"},
        "nominal_faiz": {"tip": "number", "birim": "TL", "formul": "half_up(kalan_anapara × nominal_oran)"},
        "kkdf": {"tip": "number", "birim": "TL", "formul": "half_up(nominal_faiz × kkdf_orani/100)"},
        "bsmv": {"tip": "number", "birim": "TL", "formul": "half_up(nominal_faiz × bsmv_orani/100)"},
        "faiz_ve_vergiler": {"tip": "number", "birim": "TL", "formul": "nominal_faiz + kkdf + bsmv"},
        "faiz": {"tip": "number", "birim": "TL", "aciklama": "2.0.0'da kullanımdan kalkmış (deprecated) alias; faiz_ve_vergiler ile aynı değer."},
        "anapara": {"tip": "number", "birim": "TL", "formul": "taksit - nominal_faiz - kkdf - bsmv"},
        "kalan_borc": {"tip": "number", "birim": "TL"}
      },
      "degismezler": [
        "plan son satırındaki kalan_borc 0.00'dır",
        "plan[].anapara toplamı başlangıç anaparasına eşittir",
        "her satırda kuruş bazında taksit = nominal_faiz + kkdf + bsmv + anapara"
      ]
    },
    "uyarilar": {
      "tip": "array",
      "alanlar": {
        "kod": {"tip": "string", "zorunlu": true},
        "alan": {"tip": "string", "zorunlu": false},
        "mesaj": {"tip": "string", "zorunlu": true},
        "karar_no": {"tip": "string", "zorunlu": false},
        "karar_tarihi": {"tip": "YYYY-MM-DD", "zorunlu": false},
        "kaynak_url": {"tip": "string", "zorunlu": false},
        "kredi_tutari_araligi": {"tip": "string", "zorunlu": false},
        "azami_vade_ay": {"tip": "integer", "birim": "ay", "zorunlu": false},
        "girilen_vade_ay": {"tip": "integer", "birim": "ay", "zorunlu": false},
        "kapsam": {"tip": "enum/string", "degerler": ["konut", "tasit"], "zorunlu": false},
        "eksik_girdiler": {"tip": "array", "oge_tipi": "string", "zorunlu": false},
        "turetilen_alanlar": {
          "tip": "array",
          "zorunlu": false,
          "oge_tipi": "object",
          "oge_alanlari": {
            "alan": {"tip": "string", "zorunlu": true},
            "formul": {"tip": "string", "zorunlu": true}
          }
        },
        "kaynaklar": {
          "tip": "array",
          "zorunlu": false,
          "oge_tipi": "object",
          "oge_alanlari": {
            "karar_no": {"tip": ["string", "null"], "zorunlu": true},
            "karar_tarihi": {"tip": ["YYYY-MM-DD", "null"], "zorunlu": true},
            "url": {"tip": "string", "zorunlu": true},
            "kapsam": {"tip": "string", "zorunlu": true},
            "dogruladigi": {"tip": "string", "zorunlu": true}
          }
        }
      },
      "kodlar": {
        "BDDK_11152_VADE_SINIRI_ASILDI": {
          "aciklama": "İhtiyaç kredisi genel vade sınırı aşıldı.",
          "zorunlu_alanlar": ["kod", "alan", "mesaj", "karar_no", "karar_tarihi", "kaynak_url", "kredi_tutari_araligi", "azami_vade_ay", "girilen_vade_ay"]
        },
        "UYGUNLUK_DENETLENMEDI": {
          "aciklama": "Taşıt veya konut uygunluğu için gerekli ham değer/nitelik girdileri yoktur; kredi_deger_orani ham girdi değil türetilen alandır.",
          "zorunlu_alanlar": ["kod", "alan", "mesaj", "kapsam", "eksik_girdiler", "turetilen_alanlar", "kaynaklar"]
        },
        "TAHSIS_UCRETI_TAVAN_UYARISI": {
          "aciklama": "Vergi hariç ücret tabanı binde beşi aşıyor.",
          "zorunlu_alanlar": ["kod", "alan", "mesaj", "kaynak_url"]
        },
        "SON_TAKSIT_YUVARLAMA_DUZELTMESI": {
          "aciklama": "Son taksit kuruş düzeltmesi içeriyor.",
          "zorunlu_alanlar": ["kod", "mesaj"]
        },
        "KURUS_NEDENIYLE_TAKSIT_AZALTILDI": {
          "aciklama": "Borcu vade öncesi kapatmamak için düzenli kuruş taksiti azaltıldı.",
          "zorunlu_alanlar": ["kod", "mesaj"]
        },
        "YMO_NEGATIF_ORAN_GEREKTIRIYOR": {
          "aciklama": "Pozitif IRR yok.",
          "zorunlu_alanlar": ["kod", "mesaj"]
        },
        "YMO_COZUM_ARALIGI_DISINDA": {
          "aciklama": "Kök ürün/uygulama aralığı [0,1] dışında.",
          "zorunlu_alanlar": ["kod", "mesaj"]
        }
      }
    },
    "hata_yaniti": {
      "tip": "object",
      "alanlar": {
        "basarili": {"tip": "boolean", "sabit": false},
        "hatalar": {
          "tip": "array",
          "alanlar": {
            "alan": {"tip": "string"},
            "kod": {"tip": "string"},
            "mesaj": {"tip": "string"}
          }
        }
      },
      "ornek": {
        "basarili": false,
        "hatalar": [
          {
            "alan": "vade",
            "kod": "VADE_ARALIK_DISI",
            "mesaj": "Vade 1 ile 480 arasında tam ay olmalıdır."
          }
        ]
      }
    }
  },
  "ornek_cagri": {
    "kredi_turu": "ihtiyac",
    "anapara": 100000,
    "faiz_orani": 2,
    "vade": 3,
    "kkdf_orani": 15,
    "bsmv_orani": 15,
    "tahsis_ucreti": 500,
    "tahsis_ucreti_birimi": "tl",
    "tahsis_ucreti_bsmv_orani": 15,
    "diger_masraf": 0
  },
  "ornek_yanit": {
    "basarili": true,
    "surum": "2.0.0",
    "para_birimi": "TRY",
    "hesaplama_birimi": "kuruş (tam sayı)",
    "girdi": {
      "kredi_turu": "ihtiyac",
      "konut_sahipligi": null,
      "anapara": 100000,
      "faiz_orani": 2,
      "vade": 3,
      "kkdf_orani": 15,
      "bsmv_orani": 15,
      "tahsis_ucreti": 500,
      "tahsis_ucreti_birimi": "tl",
      "tahsis_ucreti_bsmv_orani": 15,
      "diger_masraf": 0
    },
    "ozet": {
      "aylik_taksit": 35081.5,
      "son_taksit": 35081.5,
      "son_taksit_farki": 0,
      "taksitler_toplami": 105244.5,
      "nominal_faiz_toplami": 4034.22,
      "kkdf_toplami": 605.14,
      "bsmv_toplami": 605.14,
      "tahsis_ucreti_tutari": 500,
      "tahsis_ucreti_bsmv": 75,
      "tahsis_ucreti_vergi_dahil": 575,
      "pesin_masraflar": 575,
      "net_kullandirim": 99425,
      "toplam_geri_odeme": 105819.5,
      "faiz_ve_vergiler_toplami": 5244.5,
      "faiz_vergileri_toplami": 1210.28,
      "toplam_faiz": 5244.5,
      "toplam_vergi": 1285.28,
      "toplam_maliyet": 5819.5,
      "anapara_toplami": 100000,
      "nominal_aylik_oran": 2,
      "nominal_yillik_bilesik_oran": 26.8241794563,
      "efektif_aylik_oran": 2.6,
      "efektif_yillik_oran": 36.0718625074,
      "ymo": 40.9068669087,
      "ymo_adi": "Efektif yıllık faiz oranı (YMO)",
      "ymo_aciklamasi": "Tüketici Kredisi Sözleşmeleri Yönetmeliği m.14 ve Ek-1 kapsamındaki nakit akışı yaklaşımıdır."
    },
    "plan": [
      {"ay": 1, "taksit": 35081.5, "nominal_faiz": 2000, "kkdf": 300, "bsmv": 300, "faiz_ve_vergiler": 2600, "faiz": 2600, "anapara": 32481.5, "kalan_borc": 67518.5},
      {"ay": 2, "taksit": 35081.5, "nominal_faiz": 1350.37, "kkdf": 202.56, "bsmv": 202.56, "faiz_ve_vergiler": 1755.49, "faiz": 1755.49, "anapara": 33326.01, "kalan_borc": 34192.49},
      {"ay": 3, "taksit": 35081.5, "nominal_faiz": 683.85, "kkdf": 102.58, "bsmv": 102.58, "faiz_ve_vergiler": 889.01, "faiz": 889.01, "anapara": 34192.49, "kalan_borc": 0}
    ],
    "uyarilar": []
  },
  "formul_aciklamasi": [
    "Düzenli anüite taksidi brüt oranla, yani i_brüt = i_nominal × (1 + KKDF/100 + BSMV/100) ile hesaplanır. Ondalık i_brüt > 0 iken taksit = P × i_brüt × (1+i_brüt)^n / ((1+i_brüt)^n − 1); sayısal kararlılık için cebirsel eşdeğer P × i_brüt / (1 − (1+i_brüt)^−n) kullanılır. i_brüt = 0 iken taksit = P/n ayrı dalında hesaplanır.",
    "Brüt oran yalnızca düzenli taksidi belirler; ay içi bileşenler ayrı kuruşa yuvarlanır. Her ay için nominal_faiz_kuruş = half_up(kalan_anapara × i_nominal), kkdf_kuruş = half_up(nominal_faiz_kuruş × KKDF/100), bsmv_kuruş = half_up(nominal_faiz_kuruş × BSMV/100); anapara_kuruş = taksit_kuruş − nominal_faiz_kuruş − kkdf_kuruş − bsmv_kuruş. Böylece her satırda kuruş bazında taksit = nominal_faiz + kkdf + bsmv + anapara olur.",
    "Son ay anapara ödemesi kalan borca eşitlenir; son taksit = kalan anapara + o aya ait ayrı nominal faiz, KKDF ve BSMV bileşenleriyle kapatılır.",
    "Dönemsel KKDF ve BSMV kuruşları ayrı toplanır; birleşik toplamdan q/(1+q) geri ayrıştırması yapılmaz. nominal_faiz_toplami, kkdf_toplami ve bsmv_toplami ayrı alanlardır; faiz_ve_vergiler_toplami = nominal_faiz_toplami + kkdf_toplami + bsmv_toplami; faiz_vergileri_toplami = kkdf_toplami + bsmv_toplami; toplam_vergi = kkdf_toplami + bsmv_toplami + tahsis_ucreti_bsmv.",
    "Tahsis ücreti vergi hariç tabandır; tahsis_ucreti_bsmv = half_up(tahsis_ucreti_tutari × tahsis_ucreti_bsmv_orani/100). Binde beş tavanı yalnız vergi hariç tabanla karşılaştırılır.",
    "Maliyet oranı için t=0 net kullandırım P−(tahsis ücreti tabanı + ücret BSMV'si + diğer masraf), t=1..n ödemeler düzeltilmiş gerçek kuruş taksit dizisidir. Aylık IRR ürün/uygulama aralığı [0,1] içinde 1e-10 aralık hassasiyetli bisection ile bulunur ve ((1+r)^12−1)×100 ile yıllıklandırılır.",
    "Hesap çekirdeğinin dış referansı Tüketici Kredisi Sözleşmeleri Yönetmeliği m.4/k ve Ek-2'dir; Ek-2 örneği (50.000 TL, 36 ay, aylık %1, KKDF %15, BSMV %5) bu bileşen yöntemiyle birebir üretilebilir. Bankaların gün hesabı, tahsilat tarihi ve kurum içi yuvarlama yöntemi resmî Ek-2 yönteminden ayrıdır ve modellenmez."
  ],
  "kaynaklar": [
    {
      "baslik": "GİB — KKDF oranları",
      "url": "https://cdn.gib.gov.tr/api/gibportal-file/file/getFileResources?objectKey=arsiv%2Fyardim-kaynaklar%2Fyararli-bilgiler%2Fkkdf-oranlari.pdf",
      "dogruladigi": "Tüketici kredisinde KKDF %15 ve güncel diğer kredi oranları; olağan TL diğer kredilerde %0."
    },
    {
      "baslik": "2010/974 sayılı Bakanlar Kurulu Kararı",
      "url": "https://www.resmigazete.gov.tr/eskiler/2010/10/20101028-3.htm",
      "dogruladigi": "Ticari olmayan gerçek kişi tüketici kredilerinde KKDF %15."
    },
    {
      "baslik": "10094 sayılı Cumhurbaşkanı Kararı",
      "url": "https://www.resmigazete.gov.tr/eskiler/2025/07/20250718-10.pdf",
      "dogruladigi": "19.07.2025 sonrası diğer kredilerde döviz/altın %1, diğerleri %0 KKDF."
    },
    {
      "baslik": "7345 sayılı Cumhurbaşkanı Kararı",
      "url": "https://www.resmigazete.gov.tr/eskiler/2023/07/20230707-10.pdf",
      "dogruladigi": "İhtiyaç ve taşıt dahil tüketici kredisi işlemlerinde lehe alınan paralar için BSMV %15 varsayımı."
    },
    {
      "baslik": "98/11591 sayılı Bakanlar Kurulu Kararı",
      "url": "https://www.resmigazete.gov.tr/arsiv/23450.pdf",
      "dogruladigi": "Diğer banka ve sigorta muamelelerinde genel BSMV %5."
    },
    {
      "baslik": "7491 sayılı Kanun m. 6",
      "url": "https://www.resmigazete.gov.tr/eskiler/2023/12/20231228-10.htm",
      "dogruladigi": "Konut finansmanı BSMV istisnasının kredi tarihinde adına kayıtlı konut veya konut hissesi olmayan tüketici koşuluyla sınırlandırılması."
    },
    {
      "baslik": "GİB 05.11.2024 tarihli E-64597866-180-1562037 sayılı özelge",
      "url": "https://gib.gov.tr/mevzuat/kanun/445/ozelge/38314",
      "dogruladigi": "Nitelikli konut kredisinde KKDF kesilmemesi ve BSMV istisnasının konut sahipliği koşulu."
    },
    {
      "baslik": "GİB 11.11.2024 tarihli konut hissesi özelgesi",
      "url": "https://gib.gov.tr/mevzuat/kanun/445/ozelge/38313",
      "dogruladigi": "Mirasla edinilmiş küçük konut hisselerinin de BSMV istisnasındaki adına kayıtlı konut koşulunu etkilediği."
    },
    {
      "baslik": "TCMB Finansal Tüketicilerden Alınacak Ücretlere İlişkin 2020/7 Tebliğ, 13.01.2026 konsolide metin",
      "url": "https://tcmb.gov.tr/wps/wcm/connect/989f1997-5a78-4aa3-99f7-ae816978999d/2023-39%2Bsay%C4%B1l%C4%B1%2BFT%2BTebli%C4%9Fi-13%2BOcak%2B2026.pdf?CACHEID=ROOTWORKSPACE-989f1997-5a78-4aa3-99f7-ae816978999d-pKSwKYx&MOD=AJPERES",
      "dogruladigi": "Madde 4 ücreti vergi/fon/yasal giderden ayrı tanımlar; madde 10 finansal tüketicide vergi hariç kredi tahsis ücreti tabanını anaparanın binde 5'iyle sınırlar; kapsam ticari kredi değildir."
    },
    {
      "baslik": "6802 sayılı Gider Vergileri Kanunu m.28 ve m.31 — GİB açıklaması",
      "url": "https://www.gib.gov.tr/mevzuat/kanun/445/ozelge/38953",
      "dogruladigi": "Bankaların işlemleri dolayısıyla kendi lehlerine her ne adla olursa olsun aldığı paraların BSMV'ye tabi olması ve matrahın bu paralar olması; tahsis ücreti BSMV'sinin ayrı modellenmesinin vergi tabanı."
    },
    {
      "baslik": "Ticaret Bakanlığı — Tüketici Kredisi Sözleşmeleri Yönetmeliği (m.4/k ve Ek-2)",
      "url": "https://tuketici.ticaret.gov.tr/data/5e819a8e13b876a1b04c7a4a/T%C3%BCketici%20Kredisi%20S%C3%B6zle%C5%9Fmeleri%20Y%C3%B6netmeli%C4%9Fi.pdf",
      "dogruladigi": "m.4/k toplam maliyet tanımı ve Ek-2 hesap örneği hesap çekirdeğinin dış referansıdır: düzenli taksit brüt oranla belirlenir, ay içi nominal faiz/KKDF/BSMV ayrı kuruşa yuvarlanır. m.14 ve Ek-1 efektif yıllık faiz oranını düzenler. Erişim: 31.07.2026."
    },
    {
      "baslik": "Ticaret Bakanlığı — Konut Finansmanı Sözleşmeleri Yönetmeliği",
      "url": "https://tuketici.ticaret.gov.tr/data/5e819a8e13b876a1b04c7a4a/Konut%20Finansman%C4%B1%20S%C3%B6zle%C5%9Fmeleri%20Y%C3%B6netmeli%C4%9Fi.pdf",
      "dogruladigi": "Konut için m.16 ve Ek-1 yıllık maliyet oranını ayrı düzenler; Ek-1 faiz, ücret, vergi, harç ve benzeri yasal yükümlülükleri nakit akışına dahil eder."
    },
    {
      "baslik": "BDDK 13.02.2025 tarihli 11152 sayılı Kurul Kararı",
      "url": "https://www.bddk.gov.tr/Mevzuat/EkGetir/1210?ekId=281",
      "dogruladigi": "İhtiyaç kredisi genel vadesi: ≤125.000 TL 36 ay; >125.000 TL ve ≤250.000 TL 24 ay; >250.000 TL 12 ay."
    },
    {
      "baslik": "BDDK 29.01.2026 tarihli 11364 sayılı Kurul Kararı",
      "url": "https://www.bddk.gov.tr/Mevzuat/EkGetir/1210?ekId=283",
      "dogruladigi": "Konut kredi/değer uygunluğunda güncel azami kredi tutarının konut değeri ve enerji sınıfına göre belirlendiği; eski ilk/ikinci el ayrımının bulunmadığı ve 10656 kapsamındaki hususların yeni oranlarla uygulanmaya devam ettiği."
    },
    {
      "baslik": "BDDK 24.08.2023 tarihli 10656 sayılı Kurul Kararı",
      "url": "https://www.bddk.gov.tr/Mevzuat/EkGetir/1210?ekId=277",
      "dogruladigi": "Tüketici, eş veya 18 yaş altı çocukların malik olduğu en az bir konutta oran indirimi; köy/6360 ile mahalleye dönüşen yer, resmi yazı ve belirli hisseli tapu istisnaları."
    },
    {
      "baslik": "BDDK 15.02.2024 tarihli 10849 sayılı Kurul Kararı",
      "url": "https://www.bddk.gov.tr/Mevzuat/EkGetir/1210?ekId=278",
      "dogruladigi": "Tüketici, eş veya 18 yaş altı çocukların malik olduğu tek konut riskli yapı nedeniyle yıkılmışsa veya hakkında yıkım kararı varsa konut malikliği değerlendirmesinde dikkate alınmaması."
    },
    {
      "baslik": "BDDK tüketici kredi kararları sayfası",
      "url": "https://www.bddk.gov.tr/Mevzuat/Detay/1210",
      "dogruladigi": "Taşıtın niteliğine göre doğru kredi/değer ve vade karar dalının seçilmesi gereken genel karar dizini."
    },
    {
      "baslik": "BDDK 06.03.2025 tarihli 11158 sayılı Kurul Kararı",
      "url": "https://www.bddk.gov.tr/Mevzuat/EkGetir/1210?ekId=282",
      "dogruladigi": "Yalnız 5520 sayılı Kanun geçici m.12 kapsamındaki mükelleflerce üretilen sadece elektrik motorlu taşıtların vade ve kredi/değer karar dalı; bütün taşıtlar için genel kaynak değildir."
    }
  ],
  "kaynak_dogrulanmadi": []
}
