AB KDV Altyapısı

AB/AEA satışları için sınır ötesi KDV muamelesi: tedarik yeri tespiti, tevkifat (reverse charge), pazar yeri konumundaki tedarikçi (marketplace deemed-supplier) işlemleri, ülkelere göre oran referansı ve OSS/IOSS beyannameleri. Aşağıdaki tüm özellikler API önceliklidir; uç nokta başına yetki kapsamları (scopes) belirtilmiştir.

Oran referansı

POST /v1/reference/eu-vat-rates/list (reference:read) - countryCode ve date ile filtrelenebilen, AB-27'nin tamamı için yasal KDV oranları. Oran geçerlilik pencereleri 2024-01-01 tarihinden itibaren takip edilmektedir (EE için 2025-07'den itibaren %24, RO için 2025-08'den itibaren %21/%11, SK için 2025-01'den itibaren %23/%19, FI için 2026-01'den itibaren %13.5 ve LT için %12, CZ için 2024-01'den itibaren %12).

Kaynak: Avrupa Komisyonu "Taxes in Europe" veritabanı (TEDB, https://ec.europa.eu/taxation_customs/tedb/), erişim tarihi 2026-07-16; Litvanya'nın 2026 değişiklikleri VMI (https://www.vmi.lt/evmi/pvm-tarifai) üzerinden, Finlandiya'nın 2026 değişikliği vero.fi üzerinden teyit edilmiştir. Kapsam: Yalnızca ana kara/standart bölge oranları - bölgesel varyantlar (Avusturya Jungholz, Yunan adaları, Azorlar/Madeira, Fransa'nın denizaşırı toprakları ve Korsika) modellenmemiştir.

POST /v1/reference/vat-classifiers/list artık sınıflandırıcı başına bir countryCode döndürmektedir (mevcut i.SAF PVM* kodları LT'dir); POST /v1/reference/vat-classifiers/upsert (reference:write) ek ülkeler için sınıflandırıcı setlerini yükler; bu, gelecekteki ülke paketleri için veri yoludur.

İşlem Tespiti (Treatment Resolution)

POST /v1/reference/vat/resolve (reference:read) bir tedarik için "hangi KDV'yi tahsil etmeliyim?" sorusunu yanıtlar. Girdi: partnerId veya customerCountryCode (+ isteğe bağlı customerIsBusiness geçersiz kılma - aksi takdirde iş ortağının KDV kodundan çıkarılır), supplyType (goods | services | digital), date ve durum bayrakları: belowDistanceSalesThreshold, facilitatedByMarketplace (kabul edilen tedarikçi (deemed-supplier) platformu üzerinden satıyorsunuz), actingAsMarketplace (platform sizsiniz), sellerEstablishedInEu, importedConsignmentValueEur.

Konsey Direktifi (AB) 2025/516 (Dijital Çağda KDV - ViDA) ile eklenen kuralların girdileri:

• Mülkün bulunduğu veya taşımacılığın gerçekleştiği ülkeyi belirten serviceCountryCode ile birlikte serviceKind (short_term_accommodation | passenger_road_transport). Her ikisi de supplyType: "services" gerektirir.
• underlyingSupplierGaveVatNumber ve underlyingSupplierChargesVat: Ev sahibinin veya şoförün platforma tedarik ülkesinin KDV numarasını verip vermediği ve KDV'yi tahsil ettiğini beyan edip etmediği. Platformun sorumlu tedarikçi (deemed supplier) olmasını yalnızca bu ikisi birlikte engeller (md. 28a(1)).
• Müşteride monte edilen veya kurulan mallar için goodsKind (installed | energy_network) (md. 36) ve bir şebeke aracılığıyla sunulan gaz, elektrik, ısı veya soğutma için (md. 38, 39).
• Şirketin ülkesi olmadığında, malların satıldığı sırada bulunduğu veya taşınmasının başladığı ülke olan goodsLocationCountryCode.

Çıktı: scheme, vatCountryCode, reverseCharge, deemedSupplier, zeroRated, varış ülkesinin oran menüsü, yasal dayanak (Direktif 2006/112/AT maddesi) ve bilgilendirme notları (örneğin md. 138 muafiyetinin VIES'te geçerli bir müşteri KDV numarası gerektirdiğine dair bir hatırlatma).

Uygulanan kurallar:

Durum	Sonuç
Aynı ülke içi tedarik	domestic, yerel oranlar
AB içi B2B mal	intra_eu_b2b - KDV'siz md. 138 teslimi, müşteri KDV'yi kendisi beyan eder
AB içi B2B hizmet	reverse_charge - md. 44/196
AB içi B2C mal/dijital (10.000 EUR üzeri)	oss_union - varış yeri oranları, md. 33(a)/58
AB içi B2C (10.000 EUR altı - belowDistanceSalesThreshold)	Menşeyi baz alan domestic, md. 59c
AB içi B2C genel hizmetler	domestic, md. 45
AB dışına mal	export - KDV'siz md. 146(1)
AB dışına hizmet/dijital	out_of_scope (md. 44/59)
Sorumlu tedarikçi pazar yeri (facilitatedByMarketplace) üzerinden satış	marketplace_deemed - platforma yapılan KDV'siz md. 136a teslimi
İthal sevkiyat ≤ 150 EUR B2C	ioss - satış anında varış yeri KDV'si, md. 369l–369x; actingAsMarketplace durumunda sorumlu tedarikçi (md. 14a(1))
Muaf küçük işletme (şirket KDV mükellefi değil), yurtiçi tedarik	sme_exempt - KDV yok, md. 284(1)
Muaf küçük işletme, sınır ötesi AB B2C, sınır ötesi EX numarasına sahip	sme_exempt - md. 284(2); varış yeri eşiğinin ve 100.000 EUR Birlik cirosunun altında kalındığı sürece geçerlidir
Muaf küçük işletme, sınır ötesi AB B2C, EX numarası yok	Sınır ötesi EX numarasının muafiyet sağlayacağına dair bir notla birlikte oss_union/menşei korunur
1 Temmuz 2028'den itibaren, 30 geceye kadar konaklama veya karayolu yolcu taşımacılığına aracılık eden platform (actingAsMarketplace)	deemedSupplier: true, mülkün veya taşımacılığın yapıldığı yerde vergilendirilir (md. 28a, 47, 48): Başka bir ülkedeki tüketici için domestic, oss_union (md. 369b(c)) veya işletme için reverse_charge
1 Temmuz 2028'den itibaren, böyle bir platform üzerinden satış yapan ev sahibi veya şoför (facilitatedByMarketplace)	marketplace_deemed - platforma yapılan muaf teslim, md. 136b
1 Temmuz 2028'den öncesi veya ev sahibi/şoförün KDV numarasını verip KDV'yi tahsil ettiği durumlar	Tedarik yeri md. 47 veya 48'e göredir, sorumlu tedarikçi yoktur
Başka bir Üye Devlette bulunan malların oradaki bir tüketiciye satılması (1 Temmuz 2028'den itibaren)	oss_union, md. 369b(e); öncesinde o ülkede kayıt olunması gerektiğine dair bir notla birlikte o ülkede domestic
Aynı işlemin oradaki bir işletmeye yapılması	reverse_charge, md. 194
Başka bir Üye Devletten sevk edilen mallar	Tüketici için oss_union (md. 33(a)) veya işletme için intra_eu_b2b (tedarikin o ülkenin KDV kaydına ait olduğu notuyla birlikte)
Başka bir Üye Devletteki bir tüketici için monte edilen mallar	1 Temmuz 2028'den itibaren oss_union (md. 36, 369b(d)), öncesinde orada domestic
Başka bir Üye Devletteki tüketici için gaz, elektrik, ısı veya soğutma	1 Ocak 2027'den itibaren oss_union (md. 39, 369aa, ardından 369b(d)); işletme için reverse_charge (md. 195)

10.000 EUR eşiği (md. 59c) belowDistanceSalesThreshold olarak açıkça iletilebilir; atlandığında altyapı, defter verilerinden bu eşiği otomatik olarak takip eder (aşağıdaki eşik uç noktasına bakın) ve tespiti devam eden toplamlarla birlikte not düşer.

KOBİ muafiyeti (Direktif 2020/285, 2025'ten itibaren). Şirket kayıtlı bir KDV mükellefi olmadığında, çözümleyici (resolver) şirketi muafiyetten yararlanan küçük bir işletme olarak ele alır: yurtiçi tedarikler sme_exempt (KDV yok) olarak çözümlenir ve şirket sınır ötesi bir EX numarasına (smeExemptionNumber şirket profilinde) sahip olduğunda sınır ötesi AB B2C tedarikleri de sme_exempt olarak çözümlenir; aksi takdirde sınır ötesi şemayı öneren bir notla birlikte normal OSS/menşei muamelesi korunur. Uygunluk (varış yeri eşiğinin ve 100.000 EUR'luk Birlik geneli ciro sınırının altında kalmak) beyan sahibinin sorumluluğundadır; çözümleyici bunu notlarda işaretler. EX numarasını account/companies/update (smeExemptionNumber) aracılığıyla ayarlayın.

Faturalar

sales/invoices/create|update uç noktaları vatScheme (yukarıdaki şemalardan biri), vatCountryCode (tüketim Üye Devleti; oss_union/ioss için zorunludur ve AB olarak doğrulanır) ve deemedSupplier alanlarını kabul eder. E-ticaret siparişleri shipToCountryCode ve marketplace alanlarını kabul eder; orders/fulfill sevk edilen ülkeye göre muameleyi otomatik olarak çözer ve taslak faturayı damgalar (mallar ve aşılan bir uzaktan satış eşiği varsayar; düzenlemeden önce gerekirse taslakta ayarlama yapın).

Yeni fatura sayfasındaki KDV şeması alanı

Yeni fatura sayfasındaki "KDV şeması" (VAT scheme) alanı aşağıdaki seçenekleri sunar. Her satıra yazılan KDV %, faturanın tahsil ettiği oranı belirler. "KDV yok" (no VAT) işaretli bir seçeneğin seçilmesi her satırı %0 yapar (ve geri geçiş varsayılan oranı geri yükler). PDF, seçilen şema için yasal olarak zorunlu ibareyi basar. "Otomatik" (Automatic), kaydettiğinizde yukarıdaki çözümleyiciyi çağırır; iş ortağının ülkesini ve KDV numarasını ve seçtiğiniz "Tedarik türü"nü (mallar, hizmetler veya dijital hizmetler) kullanır; iş ortağının ülkesi veya KDV numarası yoksa kaydetme bir mesajla başarısız olur ve şemayı kendiniz seçersiniz.

Formdaki seçenek	Şema	Şu durumlarda kullanın:	Faturadaki KDV
Otomatik (iş ortağından ve tedarik türünden)	kayıtta çözümlenir	Şemanın iş ortağından ve tedarik türünden seçilmesini istiyorsanız	Çözümlenen şemaya göre ayarlanır; KDV'si olmayan şemalar için satırlar sıfırlanır
Yurtiçi	domestic	Alıcı sizinle aynı ülkedeyse	Ülkenizin oranları
AB içi B2B mal (%0, md. 138)	intra_eu_b2b	Başka bir AB ülkesindeki KDV mükellefi bir işletmeye sevk edilen mallar; alıcının KDV numarası VIES'te geçerli olmalıdır	KDV yok; PDF md. 138 muafiyetini belirtir
AB içi B2B hizmet (tevkifat)	reverse_charge	Başka bir AB ülkesindeki KDV mükellefi bir işletmeye verilen hizmetler	KDV yok; PDF "Tevkifat" (md. 196) basar
Birlik OSS (AB tüketicileri, varış yeri KDV'si)	oss_union	Başka bir AB ülkesindeki tüketicilere 10.000 EUR'luk Birlik geneli eşiği aşan mal veya dijital hizmetler; tüketim ülkesini gerektirir	Her satıra yazılan tüketim ülkesi oranı; üç aylık OSS beyannamesinde bildirilir
IOSS (150 EUR'ya kadar ithalat)	ioss	AB dışından bir AB tüketicisine ithal edilen mallar, sevkıyat ≤ 150 EUR; tüketim ülkesini gerektirir	Her satıra yazılan tüketim ülkesi oranı; aylık IOSS beyannamesinde bildirilir
Pazar yeri (sorumlu tedarikçi)	marketplace_deemed	Sorumlu tedarikçi olan bir platform üzerinden satış yapıyorsanız	Platforma yaptığınız teslimde KDV yok (md. 136a)
İhracat (%0 oranlı)	export	AB dışına sevk edilen mallar	KDV yok; PDF md. 146 muafiyetini belirtir
Kapsam dışı (AB dışındaki hizmetler)	out_of_scope	AB dışındaki bir müşteriye verilen hizmetler	KDV yok; PDF tedarikin AB KDV kapsamı dışında olduğunu belirtir (md. 44/59)
KOBİ muafiyetli (KDV mükellefi değil)	sme_exempt	Şirketiniz KDV mükellefi değil ve küçük işletme muafiyetini kullanıyor	KDV yok; PDF md. 284 muafiyetini belirtir

İki AB içi B2B seçeneği yalnızca ne tedarik edildiği konusunda farklılık gösterir. Mallar md. 138 muafiyeti kapsamındadır: alıcı topluluk içi edinim bildirir. Hizmetler md. 44/196 tevkifatı kapsamındadır: alıcı KDV'yi kendisi hesaplar. Her ikisi de KDV'siz bir fatura üretir, ancak PDF'e basılan ibare ve tutarın alıcının beyannamesinde düştüğü kutu farklıdır, bu nedenle seçim önemlidir.

OSS / IOSS Beyannameleri

POST /v1/declarations/eu/oss/compute (declarations:read) { year, quarter } - Komisyon Uygulama Tüzüğü (AB) 2020/194 Ek III uyarınca Birlik şeması üç aylık beyannamesi: tüketim Üye Devleti × oran türü (STANDARD/REDUCED) × matrah ve KDV içeren oran başına satırlar, mahsuplaştırılmış alacak dekontları ve toplamlar. Yalnızca vatScheme: "oss_union" değerine sahip onaylanmış belgeler dahildir. Uyarılar, varış yeri ve dönem için yasal olmayan oranları, atlanan sıfır oranlı satırları, vatCountryCode alanı olmayan belgeleri ve kimlik tespiti yapılan Üye Devlette vergilendirilen tedarikleri işaretler.

POST /v1/declarations/eu/ioss/compute { year, month } - vatScheme: "ioss" (ithal sevkiyatlar ≤ 150 EUR) için aylık bazda aynı yapı.

Her iki yanıt da bir corrections dizisi (ve correctionsTotal) taşır: Cari dönemde düzenlenen ancak daha önceki bir OSS/IOSS dönemine ait bir aslına (creditedInvoiceId aracılığıyla) bağlanan bir alacak dekontu, dönem satırlarından çıkarılır ve 2020/194 Ek III'ün gerektirdiği şekilde önceki dönem düzeltmesi olarak bildirilir; ülke, orijinal yıl, orijinal çeyrek (OSS) veya ay (IOSS) ve negatif KDV farkı. creditedInvoiceId alanı olmayan alacak dekontları cari döneme mahsup edilir ve bağlanabilmeleri için bir uyarı ile işaretlenir; üç yıldan eski düzeltmeler uyarılır (Tüzük 282/2011 md. 61).

AB'de yerleşik tüm şirketler tarafından kullanılabilir (LT ile sınırlı değildir).

Kendi Mallarının Sevkıyatı Beyannamesi

POST /v1/declarations/eu/own-goods-transfers/compute (declarations:read) { year, month } - kendi mallarının sevkıyatlarına yönelik özel şemanın aylık beyannamesi (Direktif 2006/112/AT md. 369xa-369xk, 1 Temmuz 2028'den itibaren), takip eden ayın sonuna kadar (dueDate) işletmenin yerleşik olduğu Üye Devlette verilir. Satırlar, malların gittiği her Üye Devlet ve sevk edildiği her Üye Devlet için, sevkıyatların maliyet bedeli üzerinden (md. 76) euro cinsinden değerini, ayın son gününün kuruyla (md. 369xh) dönüştürülmüş olarak verir. Bir sevkıyat, iki farklı Üye Devletteki depolar arasındaki bir stok sevkıyatıdır (POST /v1/inventory/stock/transfer); depo ülkesini /v1/inventory/warehouses/create veya /v1/inventory/warehouses/update uç noktalarında countryCode ile ayarlayın (bu alanın olmadığı bir depo şirketin ülkesindedir).

AB Dijital Raporlama

POST /v1/declarations/eu/digital-reporting/list (declarations:read) { fromDate, toDate } Direktif 2006/112/AT md. 262'nin 1 Temmuz 2030'dan itibaren tüm 27 Üye Devlette tek tek bildirilmesini zorunlu kıldığı her işlemi listeler:

• vatScheme alanı intra_eu_b2b (md. 262(1)(a)) veya reverse_charge (md. 262(1)(c)) olan düzenlenen satış faturaları ve alacak dekontları, faturanın düzenlendiği tarihte vadesi gelir;
• KDV'sini şirketin kendisinin hesapladığı satırlara sahip, başka bir Üye Devletteki bir tedarikçiden gelen kayıtlı alış faturaları (mallar için md. 262(1)(b), hizmetler için (d)), faturanın alınmasından 5 gün sonra vadesi gelir.

Her işlem md. 264 verilerini taşır: fatura tarihi ve numarası, tedarikçi ve müşteri KDV numaraları, satırlar, matrah, muafiyet referansı, alacak dekontu için düzeltilen faturanın numarası (md. 226(16)), tedarikçinin banka hesapları (md. 226(17)), edinimler için KDV oranı ve tutarı, rapor verilecek Üye Devlet (kullanılan KDV numarasını veren ülke, md. 262(2)), son tarih ve dosyada bulunmayan herhangi bir veri öğesini adlandıran missing alanı. Üye Devletler verileri EN 16931 e-fatura olarak kabul etmelidir (md. 263(3)); POST /v1/sales/invoices/peppol-xml her tedarik için bu dosyayı oluşturur. Md. 263(4)'ün ortak AB mesajı ve verileri göndermek için ulusal kanallar yayınlanmamıştır, bu nedenle Nordlet bunu göndermez.

Uzaktan Satış Eşiği

POST /v1/declarations/eu/distance-sales-threshold/get (declarations:read) { date? } - defter verilerinden md. 59c 10.000 EUR Birlik eşiğini takip eder: sınır ötesi B2C uzaktan satışlarının (OSS şeması faturaları artı şemasız sınır ötesi tüketici faturaları) cari ve önceki takvim yılı toplamları, şirketin hâlâ eşiğin altında olup olmadığı ve kalan boşluk. EUR dışı belgeler bir uyarı ile belge değerinde toplanır. KDV çözümleyicisi, belowDistanceSalesThreshold sağlanmadığında bunu otomatik olarak dikkate alır.

KOBİ Muafiyeti Eşikleri

POST /v1/declarations/eu/sme-thresholds/list Direktif (AB) 2020/285 kapsamındaki Üye Devlet bazında yurtiçi KDV muafiyeti eşiklerini döndürür (85.000 EUR ulusal sınır ve 100.000 EUR Birlik ciro sınırı dahildir). Rakamlar Komisyon'un KOBİ portalı ülke sayfalarından alınmıştır; ulusal bir sayfanın belirtilen bir rakam olmadan TEDB'ye yönlendirdiği durumlarda, giriş tahmin edilmek yerine null olur. Bazı eşikler ulusal para biriminde (DKK/HUF/RON) belirlenmiştir ve bazı ülkeler sektörel eşikler yayınlamaktadır (örneğin İrlanda: hizmetler 42.500 EUR, mallar 85.000 EUR).

POST /v1/declarations/eu/sme-threshold/get { date? } KDV mükellefi olmayan bir şirketin kendi ülkesinin eşiğine göre durumunu bildirir: cari takvim yılı cirosu ve önceki yılın cirosu (precedingTurnover), status (below / %80'de approaching / exceeded veya kayıtlı bir KDV mükellefi için not_applicable, eşik dosyada yoksa veya para birimi farklıysa unknown), kalan boşluk ve uyarılar. Karantina bildirimleri dahildir: eşiğin aşılması, muafiyetin cari yılın ve takip eden takvim yılının geri kalanı için kullanılamaz olarak işaretler ve bu yıl eşiğin altında olan ancak geçen yıl üstünde olan bir şirkete, muafiyetin ertesi yıla kadar yeniden başlatılamayacağı konusunda uyarıda bulunulur (her iki yıl da altında kalmalıdır - md. 284(2) mekaniği; Birlik ciro uç noktası 100.000 EUR sınırı için aynı uyarıyı taşır). Diğer Üye Devletlere sağlanan hizmetlerden ve buralardan yapılan mal/hizmet edinimlerinden kaynaklanan Litvanya'nın 14.000 EUR'luk sınırı gibi ulusal bir AB içi tetikleyiciye sahip ülkeler için yanıt, kendi durumu ve uyarısıyla birlikte bir intraEu dökümü (AB tedarikçilerinden edinmeler + sağlanan tevkifatlı hizmetler) içerir.

Sınır ötesi KOBİ şeması: Birlik cirosu ve üç aylık rapor

POST /v1/declarations/eu/union-turnover/get { date? } defter verilerinden sınır ötesi KOBİ şeması (md. 284(2)) için 100.000 EUR'luk "Birlik içinde ciro" sınırını takip eder; cari ve önceki takvim yılında AB içinde yapılan tedariklerin toplam değeri (ihracat ve kapsam dışı tedarikler hariçtir) - her iki yılın toplamını, status, boşluk ve uyarıları döndürür (KDV mükellefi için not_applicable).

POST /v1/declarations/eu/sme-cross-border-report/compute { year, quarter } şemadaki bir KOBİ'nin kendi Üye Devletine borçlu olduğu üç aylık raporu üretir (md. 284b): o çeyrekte her Üye Devlette yapılan tedariklerin toplam değeri, ülke başına bir satır (tedarik üye devleti = faturanın tüketim ülkesi, aksi takdirde iş ortağının ülkesi, aksi takdirde ev sahibi ülke) artı toplam. AB dışı tedarikler hariçtir.

Ulusal KDV Beyannamesi Paketleri

POST /v1/declarations/eu/vat-return/packs/list mevcut ülke paketlerini listeler; POST /v1/declarations/eu/vat-return/compute { countryCode, year, month, months? } ilgili ülke için kayıtlı pakete yönlendirir ve beyannameyi numaralandırılmış kutular ({ code, label, amount }) plus uyarılar, notlar ve resmi source olarak döndürür. Şirketin o ülkede kayıtlı olmasını gerektirir (aksi takdirde 422). Litvanya (FR0600), mevcut FR0600 oluşturucusunu sarmalayan ilk paket olarak gönderilir; resmi form şablonları doğrulandıkça ek ülkeler yalnızca veri içeren adaptörler olarak eklenir.

Eski POST /v1/reports/oss birleştirme görünümü (iş ortağı ülkesine dayalı, şema gerektirmeyen) sezgisel bir analitik görünüm olarak kalır; beyanname uç noktaları beyanname düzeyindeki yoldur. Her ikisi de Litvanya varsaymak yerine ana ülkeyi şirketten türetir.