Vergi Hesaplama API
KDV, tevkifat, stopaj, damga vergisi ve maaş hesabı; her yanıtta o tarihte yürürlükteki kural ve dayanağı.
Vergi kuralları sürümlüdür: her oran ve tutar yürürlük başlangıcı, bitişi ve Resmî Gazete dayanağıyla tutulur. Hesap uçlarına tarih gönderirseniz o gün geçerli kuralla hesaplanır (ör. 2025'te değişen beyanname damga vergisi tutarları); yanıttaki surum alanı hangi kuralın kullanıldığını gösterir. /v1/vergi/kurallar tüm sürümleri listeler.
/v1/vergi/kdv KDV hariç ve dahil tutarlar arasında çevirir, tevkifat kodu verilirse kısmi tevkifatı (4/10, 9/10…) fatura sınırıyla birlikte uygular. /v1/vergi/stopaj GVK 94 kesintisini brütten nete ya da netten brüte hesaplar. /v1/vergi/damga nispi kağıtta azami tutarı, maktu kağıtta güncel tutarı verir. /v1/vergi/maas sabit brütle 12 aylık bordroyu (SGK tavanı, kümülatif vergi dilimi, asgari ücret istisnası, engellilik indirimi) çıkarır.
Hızlı başlangıç
Anahtarınızı X-API-Key başlığında gönderin (ücretsiz anahtar al).
Anahtarı tarayıcı koduna koymayın; sunucunuzdan çağırıp sonucu önbelleğe alın.
<?php
$ch = curl_init('https://api.veriapi.pro/v1/vergi/kdv?tutar=100000&oran=20&tevkifat=yapim');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 10,
CURLOPT_HTTPHEADER => ['X-API-Key: va_ANAHTARINIZ'],
]);
$yanit = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($yanit['veri']);
const yanit = await fetch("https://api.veriapi.pro/v1/vergi/kdv?tutar=100000&oran=20&tevkifat=yapim", {
headers: { "X-API-Key": "va_ANAHTARINIZ" },
});
const { veri, kaynak } = await yanit.json();
console.log(veri);
import requests
r = requests.get("https://api.veriapi.pro/v1/vergi/kdv?tutar=100000&oran=20&tevkifat=yapim",
headers={"X-API-Key": "va_ANAHTARINIZ"}, timeout=10)
print(r.json()["veri"])
curl -H "X-API-Key: va_ANAHTARINIZ" \ "https://api.veriapi.pro/v1/vergi/kdv?tutar=100000&oran=20&tevkifat=yapim"
Örnek yanıt
GET https://api.veriapi.pro/v1/vergi/kdv?tutar=100000&oran=20&tevkifat=yapim — gerçek veriyle; listeler kısaltıldı.
{
"veri": {
"tarih": "2026-11-02",
"oran": 20.0,
"kdv_dahil_girildi": false,
"matrah": 100000.0,
"kdv": 20000.0,
"toplam": 120000.0,
"surum": {
"baslangic": "2023-07-10",
"bitis": null,
"dayanak": "7346 sayılı Cumhurbaşkanı Kararı, Resmî Gazete 07.07.2023"
},
"tevkifat": {
"kod": "yapim",
"ad": "Yapım işleri ve birlikte ifa edilen mühendislik-mimarlık, etüt-proje",
"oran": "4/10",
"tevkif_edilen_kdv": 8000.0,
"saticiya_odenecek_kdv": 12000.0,
"saticiya_odenecek_toplam": 112000.0,
"sinir_alti": false,
"sinir_kdv_dahil": 12000.0,
"surum": {
"baslangic": "2026-01-01",
"bitis": null,
"dayanak": "KDV Genel Uygulama Tebliği I/C-2.1.3 (oranlar: GİB kısmi tevkifat tablosu); sınır: VUK 232 fatura düzenleme sınırı, 588 Sıra No VUK Genel Tebliği, Resmî Gaze…"
}
}
},
"kaynak": [
{
"kod": "mevzuat",
"ad": "Resmî Gazete / mevzuat",
"lisans": "FSEK m.31 (yayımlanmış mevzuat)",
"atif": "Kaynak: Resmî Gazete'de yayımlanan mevzuat (2429 sayılı Kanun, Gelir Vergisi Genel Tebliği, Asgari Ücret Tespit Komisyonu kararı vb.)",
"url": "https://www.resmigazete.gov.tr/"
},
{
"kod": "hesap",
"ad": "VeriApi.Pro hesaplaması",
"lisans": "VeriApi.Pro",
"atif": "VeriApi.Pro tarafından hesaplanmıştır",
"url": null
}
],
"guncelleme": null,
"bayat": false
}
Uçlar ve parametreler
GET /v1/vergi/kurallar
ücretsiz pakette
1 birim
Sürümlü vergi kuralları (yürürlük tarihi ve dayanağıyla)
GET /v1/vergi/kdv
ücretli paket
1 birim
KDV hesabı (dahil ↔ hariç) ve kısmi tevkifat
| Parametre | Tür | Açıklama |
|---|---|---|
| tutar* | sayı | |
| oran | sayı | varsayılan: 20 |
| dahil | evet/hayır | Tutar KDV dahil mi varsayılan: False |
| tevkifat | metin | Tevkifat kalemi kodu (/v1/vergi/kdv/tevkifat) |
| tarih | metin | Hesap tarihi (YYYY-AA-GG); o gün yürürlükteki kural kullanılır. Varsayılan bugün |
GET /v1/vergi/kdv/oranlar
ücretsiz pakette
1 birim
Tarihte geçerli KDV oranları
| Parametre | Tür | Açıklama |
|---|---|---|
| tarih | metin | Hesap tarihi (YYYY-AA-GG); o gün yürürlükteki kural kullanılır. Varsayılan bugün |
GET /v1/vergi/kdv/tevkifat
ücretsiz pakette
1 birim
KDV kısmi tevkifat kalemleri ve sınır
| Parametre | Tür | Açıklama |
|---|---|---|
| tarih | metin | Hesap tarihi (YYYY-AA-GG); o gün yürürlükteki kural kullanılır. Varsayılan bugün |
GET /v1/vergi/stopaj
ücretli paket
1 birim
Stopaj (GVK 94): brütten nete, netten brüte
| Parametre | Tür | Açıklama |
|---|---|---|
| tutar* | sayı | |
| tur* | metin | Kalem kodu (/v1/vergi/stopaj/oranlar) |
| net | evet/hayır | Tutar net mi (brüte iblağ) varsayılan: False |
| tarih | metin | Hesap tarihi (YYYY-AA-GG); o gün yürürlükteki kural kullanılır. Varsayılan bugün |
GET /v1/vergi/stopaj/oranlar
ücretsiz pakette
1 birim
Stopaj oranları
| Parametre | Tür | Açıklama |
|---|---|---|
| tarih | metin | Hesap tarihi (YYYY-AA-GG); o gün yürürlükteki kural kullanılır. Varsayılan bugün |
GET /v1/vergi/damga
ücretli paket
1 birim
Damga vergisi (nispi, azami tutar, maktu)
| Parametre | Tür | Açıklama |
|---|---|---|
| tur* | metin | Kağıt türü kodu (/v1/vergi/damga/oranlar) |
| tutar | sayı | Nispi kağıtta kağıttaki tutar |
| nusha | tam sayı | varsayılan: 1 |
| tarih | metin | Hesap tarihi (YYYY-AA-GG); o gün yürürlükteki kural kullanılır. Varsayılan bugün |
GET /v1/vergi/damga/oranlar
ücretsiz pakette
1 birim
Damga vergisi oranları ve maktu tutarlar
| Parametre | Tür | Açıklama |
|---|---|---|
| tarih | metin | Hesap tarihi (YYYY-AA-GG); o gün yürürlükteki kural kullanılır. Varsayılan bugün |
GET /v1/vergi/gelir
ücretsiz pakette
1 birim
Gelir vergisi tarifesi; matrah verilirse vergi
| Parametre | Tür | Açıklama |
|---|---|---|
| matrah | sayı | Yıllık vergi matrahı (TL) |
| tur | metin | varsayılan: ucret |
| yil | tam sayı |
GET /v1/vergi/mtv
ücretli paket
1 birim
Motorlu Taşıtlar Vergisi (/v1/hesapla/mtv ile aynı hesap)
| Parametre | Tür | Açıklama |
|---|---|---|
| silindir | tam sayı | |
| yas* | tam sayı | |
| deger | sayı | |
| tescil | metin | varsayılan: 2018_sonrasi |
| tur | metin | varsayılan: otomobil |
| guc | sayı | |
| yil | tam sayı |
GET /v1/vergi/maas
ücretli paket
2 birim
Brütten nete maaş (12 ay bordro) / netten brüte
| Parametre | Tür | Açıklama |
|---|---|---|
| brut | sayı | Aylık brüt ücret |
| net | sayı | İstenen aylık net (brüt hesaplanır) |
| ay | tam sayı | Netten brüte: hangi ayın neti (kümülatif matrah) varsayılan: 1 |
| yil | tam sayı | |
| engelli | tam sayı | Engellilik derecesi (indirim) |
Konum alan uçlarda konum (slug), il + ilce (ad, slug ya da plaka) ya da enlem + boylam kullanılabilir.
Tüm parametreler: OpenAPI belgesi.
Nerelerde kullanılır?
- ✓Ön muhasebe ve e-fatura yazılımları
- ✓Bordro ve İK uygulamaları
- ✓Haber sitelerinde hesaplama araçları
- ✓Serbest meslek ve kira makbuzu hesapları
Kaynak ve lisans
- Resmî Gazete / mevzuat · FSEK m.31 (yayımlanmış mevzuat) · kaynak
Atıf: Kaynak: Resmî Gazete'de yayımlanan mevzuat (2429 sayılı Kanun, Gelir Vergisi Genel Tebliği, Asgari Ücret Tespit Komisyonu kararı vb.)
Her yanıtın kaynak alanı bu bilgiyi taşır; veriyi gösterdiğiniz yerde atıf metnini yazın.
Sık sorulan sorular
Mevzuat değişince ne olur?
Yeni oran yeni bir sürüm olarak eklenir; eski sürüm silinmez, geçmiş tarihli hesaplar eski kuralla yapılmaya devam eder.
Hangi uçlar ücretsiz?
Kural ve oran listeleri ile gelir vergisi tarifesi tüm paketlerde; KDV, stopaj, damga, MTV ve maaş hesaplayıcıları Başlangıç ve üstü paketlerde.
Hesaplar resmî mi?
Hayır, bilgilendirme amaçlıdır; özel durumlar (istisnalar, teşvikler, önceki işveren matrahı) için mali müşavirinize danışın.
Bu sayfa şu aramalar için de: kdv hesaplama api · tevkifat hesaplama api · stopaj hesaplama api · damga vergisi hesaplama api · brütten nete maaş api · vergi api