Türkiye

Kataloğun bir parçası. Aynı anahtar, zarf ve faturalandırma diğer tüm uçları da kapsar.

Kıdem, İhbar ve Yıllık İzin · Tebligat Süre Hesabı · KDV ve Tevkifat

Bu sayfadaki her ucu hesap açmadan deneyebilirsiniz.
Deterministik uçlar önbellekten tek haneli milisaniyede yanıtlar.
Her yanıt bir fiş taşır: harcanan kredi, önbellek durumu, süre.

Bu sayfada ücretsiz dene → anahtar gerektiğinde Ödemeye geç · API erişimi.

Ücretsiz dene Ödemeye geç · API erişimi Şemayı oku

POST/v1/tr/labor

İstek

{
  "startDate": "2025-08-01",
  "endDate": "2026-08-01",
  "monthlyGross": 33030
}

henüz istek gönderilmedi

Yanıt

Çalıştır’a bas — ücretsiz dene, anahtar gerekmez.

3uç nokta

1API ailesi

3deterministik uç

—ortanca yanıt

Neden var

Düşman girdi için tasarlandı

Türkçe adres "Cd." de olur "Cad." da "Caddesi" de; daire numarası bina numarasına yapışık gelir. Genel ayrıştırıcılar yarısını sessizce düşürür. Bu, yerleştiremediğini size söyler.

Her kural kaynağını taşır

Sağlama hesapları yayımlanmış algoritmalara uyar (TCKN/VKN, IBAN mod-97); kıdem tavanı, asgari ücret ve KDV tevkifat oranı gibi tarihli tablolar dayandığı mevzuatı ve geçerlilik tarihini gösterir. Doğrulanamayan bir sonuçta yanıt tahmin yürütmez, bunu açıkça söyler — yapısal olarak geçerli bir numara hiçbir zaman sicil kaydı gibi sunulmaz.

Yalnız yapılan işe ödersiniz

Tekrarlanan girdi önbellekten gelir, sıfır kredi yakar. Bir yanıt kendi şemasına uymazsa çağrı otomatik iade edilir.

Uç noktalarparametreleri görmek ve canlı çağırmak için satırı açın

Türkiye3

/v1/tr/labor Kıdem, İhbar ve Yıllık İzin deterministik 1 kredi

Hizmet süreleri ve giydirilmiş brütten kıdem, ihbar ve yıllık izin hakkını hesaplar; o güne ait tavan ve asgari ücret tablosunu kullanır.

Bordro ve İK araçları her Ocak ve Temmuz'da kıdem tavanı, SGK tavanı, asgari ücret kovalıyor. Bu uç, yasal formülü (4857 md. 17 ve 53, mülga 1475 md. 14) o tablolara uygular. Tavan aylık ücrete uygulanır, toplama değil. Kıdemden yalnız damga (binde 7,59) kesilir; gelir vergisi yok. İhbar vergiye tabidir — brütü döneriz, kümülatif matrahı bilemediğimiz için kesintiyi uydurmayız. Söylemediği şey: bu işçinin kıdeme hak kazanıp kazanmadığı. O, feshin sebebine bağlı. Sayıyı "alacağı" diye yazmak, duruşmada kaybettirir.

Parametreler

startDate*	string	Employment start date (YYYY-MM-DD).
endDate*	string	Termination date (YYYY-MM-DD). Inclusive of this day.
monthlyGross*	number	Gross monthly wage the severance is based on (giydirilmiş brüt).
asOf	string	Rate table date. Defaults to endDate.
age	integer	Employee age at termination — affects annual-leave entitlement (under 18 or 50+).
unusedLeaveDays	number	Unused annual-leave days, if you also want the unused-leave gross.

POST/v1/tr/labor

İstek

{
  "startDate": "2025-08-01",
  "endDate": "2026-08-01",
  "monthlyGross": 33030
}

henüz istek gönderilmedi

Yanıt

Çalıştır’a bas — ücretsiz dene, anahtar gerekmez.

/v1/tr/tebligat-clock Tebligat Süre Hesabı deterministik 1 kredi

Bir tebligatın hüküm (ulaşmış sayılma) tarihini ve HMK'ya göre tatil kayması uygulanmış son günü, olayın gerçekte olduğu tarihten hesaplar.

7201 sayılı Kanun, süre saatini "zarftaki tarih" değil ayrı bir olaya bağlar — elektronik tebligatta UETS gönderim, okunma VE ulaşma tarihlerinin üçünü de gösterir; saati yalnız ulaşma tarihi başlatır (md. 7/a: adrese ulaştıktan 5 takvim günü sonra tebliğ edilmiş sayılır, açılmış olsun olmasın). HMK bunun üstüne iki kural daha ekler: tebliğ günü sürenin kendisine dahil değildir (md. 92 — süre ertesi gün başlar) ve hesaplanan son gün hafta sonuna ya da tam gün resmî/dinî tatile denk gelirse ilk iş gününe kayar (md. 93); arife (yarım gün) kaydırmaz. Söylemediği şey: tebligatın kendisinin usulüne uygun olup olmadığı, ya da sizin dosyanızdaki `periodType`in (itiraz, temyiz, cevap…) kaç gün olduğu — bu sayı kanuna göre değişir, tahmin etmeyiz; `periodDays`i siz verirsiniz. Şimdilik yalnız "hmk" kanun ailesi kapsanıyor.

Parametreler

type*	"electronic" \| "physical" \| "vekil" \| "ilanen" \| "last_known_address"	Notification method. Determines which event `basisDate` refers to and whether the deemed-received date is same-day or shifted.
lawFamily*	"hmk"	Body of procedural law the period is computed under. Only "hmk" (Code of Civil Procedure) is supported so far.
basisDate*	string	The date `basisLabel` describes for this type — for "electronic" this is the date UETS reports the message as reached, not sent or read.
periodDays*	integer	Length of the statutory or judicial period, in days, counted from `periodStart`.
periodType	string	Free-text label for the period (e.g. "itiraz", "temyiz"), echoed back only — not mapped to a day count.
ilanenDeemedDays	integer	Only valid with type "ilanen": number of days the competent authority set for the notice to become deemed received (TK 31), 7-15, default 7. Not the number of days for the underlying period.
hasAttorney	boolean	Whether the addressee has a registered attorney of record. When true and `type` is not "vekil", a TK 11 warning is added noting that service should have gone to the attorney.
subjectToJudicialRecess	boolean	Whether this matter is subject to the judicial recess (adli tatil, HMK 104) instead of being exempt. Only affects the result when `lawFamily` is "hmk" and the computed last day falls in the 20 July - 31 August window.

POST/v1/tr/tebligat-clock

İstek

{
  "type": "electronic",
  "lawFamily": "hmk",
  "basisDate": "2026-03-16",
  "periodDays": 7,
  "periodType": "itiraz"
}

henüz istek gönderilmedi

Yanıt

Çalıştır’a bas — ücretsiz dene, anahtar gerekmez.

/v1/tr/vat KDV ve Tevkifat deterministik 1 kredi

Tutarı matrah, KDV ve isteğe bağlı tevkifata ayırır: satıcıya ödenecek, tevkif edilen KDV.

Fatura satırı ve ödeme ekranı için KDV dahil/hariç; tevkifat varsa alıcının satıcıya ödeyeceği ile vergi dairesine yatıracağı ayrılır. Oranlar %0, %1, %10, %20. Tevkifat KDV'nin kesri (2/10–10/10) veya GİB listesindeki bir kod. 2026 eşiği (KDV dahil 12.000 ₺) tutarla karşılaştırılır ama `applies` daima null: tevkifatın gerçekten doğması iki tarafın mükellefiyetine bağlı, o burada yok. Kesir vermek hukuki görüş değildir.

Parametreler

amount*	number	The amount to tax. See amountIncludesVat.
amountIncludesVat	boolean	If true, `amount` is the gross (KDV dahil); if false, it is the net/matrah. varsayılan false
rate	number \| number \| number \| number	VAT rate in percent. 0, 1, 10 or 20. varsayılan 20
withholding	string	Withholding fraction such as "5/10", or a code from the list (reklam, tasima, hurda, isgucu…).

POST/v1/tr/vat

İstek

{
  "amount": 1000,
  "rate": 20
}

henüz istek gönderilmedi

Yanıt

Çalıştır’a bas — ücretsiz dene, anahtar gerekmez.

Fiyatlandırmatek anahtar tüm uçları kapsar

Bu sayfada ücretsiz dene → anahtar gerektiğinde Ödemeye geç · API erişimi.

Ödemeye geç · API erişimi Tüm planlar →

Kredi çağrı başına düşer, önbellekten gelen yanıt ücretsizdir. Anahtarsız istekler IP başına dar bir demo kotasıyla çalışır; kaydolmadan değerlendirebilirsiniz.

API anahtarı ödeme onaylanır onaylanmaz e-postayla gelir. Plan yükseltmede anahtar DEĞİŞMEZ, entegrasyonunuz kırılmaz.

Ödemeden önce entegrasyonu bitirmek ister misiniz?

Yapay zekâ asistanından kullanaynı katalog, MCP aracı olarak

Her uç aynı zamanda Model Context Protocol üzerinden yayınlanıyor — iş verisi ve ses/çağrı-ops ajan araçları (çağrı arşivi arama · vaat · maskeleme · fısıltı) tek yüzeyde. Claude, ChatGPT ya da kendi ajanınız doğrudan çağırır: aynı şema, aynı ölçüm, sessizken $0, ara kod yok.

Şu an 43 araç. Yeni uçlar kendiliğinden görünür; sizin tarafınızda güncellenecek bir şey yok.

claude_desktop_config.json

{
  "mcpServers": {
    "temsor": {
      "url": "https://api.temsor.com/mcp",
      "headers": { "x-api-key": "fk_live_…" }
    }
  }
}

Hızlı başlangıç

Resmî istemci: npm install temsor-api · npmjs.com/package/temsor-api

Node.js

import Client from "temsor-api";

const api = new Client({ apiKey: KEY });
const r = await api.trLabor({"startDate":"2025-08-01","endDate":"2026-08-01","monthlyGross":33030});
console.log(r, r.$meta);

cURL

curl -s https://api.temsor.com/v1/tr/labor \
  -H "content-type: application/json" \
  -H "x-api-key: fk_live_…" \
  -d '{"startDate":"2025-08-01","endDate":"2026-08-01","monthlyGross":33030}'

JavaScript

const res = await fetch("https://api.temsor.com/v1/tr/labor", {
  method: "POST",
  headers: { "content-type": "application/json", "x-api-key": KEY },
  body: JSON.stringify({"startDate":"2025-08-01","endDate":"2026-08-01","monthlyGross":33030})
});
const { data } = await res.json();

Python

import httpx
r = httpx.post("https://api.temsor.com/v1/tr/labor",
    headers={"x-api-key": KEY},
    json={"startDate":"2025-08-01","endDate":"2026-08-01","monthlyGross":33030})
data = r.json()["data"]