AB KDV Uyumluluğu İçin Muhasebe API'si Nasıl Seçilir?

Kendi ürünleri içinde gerçek defterlere, ülkeye özel KDV mantığına ve denetime hazır kayıtlara ihtiyaç duyan platformlar ve pazaryerleri için bir alıcı rehberi.

Çoğu KDV entegrasyonu hatası bir kategori hatasıyla başlar. Bir ekip "AB KDV'sini yönetmenin" bir yolunu arar, bir vergi hesaplama API'si seçer, bunu canlıya alır ve aracın yalnızca bir oran döndürdüğünü, hiçbir zaman yevmiye kaydı oluşturmadığını, bir iadeyi asla orijinal faturasına bağlamadığını ve yıllar sonra bir vergi dairesinin isteyebileceği denetim dosyasını üretemediğini ancak sonradan fark eder. Oran doğruydu. Muhasebe ise eksikti.

Finansal altyapıyı kendi bünyesine entegre eden bir pazaryeri veya SaaS platformu için ilk karar, yerel KDV yeteneklerine sahip bir muhasebe sistemine mi yoksa başka bir yerde tuttuğunuz defterlerin üzerine oturan bir vergi uyumluluk katmanına mı ihtiyacınız olduğudur. Bunlar farklı veri modellerine sahip farklı ürünlerdir ve aralarındaki fark, sonraki tüm süreçleri neredeyse tamamen belirler.

Muhasebe API'si ile Vergi Uyumluluk API'si: Gerçekte Ne Fark Eder?

Bir muhasebe API'si bir defter tutar. Çift taraflı yevmiye kayıtları tutar, bir hesap planı barındırır, kapanan dönemleri kilitler, ödemeleri mutabık hale getirir ve mizan raporları üretir. KDV, halihazırda sakladığı bir işlemin yalnızca bir özniteliğidir.

Bir vergi uyumluluk API'si KDV hesaplar, bazen beyannamesini verir ve genellikle faturalar üretir, ancak defterlerinizi tutmaz. "Burada hangi vergi geçerlidir" sorusunu ve yönetilen sürümlerde "beyannameyi kim sunar" sorusunu yanıtlar. Muhasebe kaydı başka bir sistemde yaşar.

Bu durum önemlidir çünkü KDV uyumluluğu sadece bir oran araması değildir. Çalışan bir AB KDV iş akışı, vergi muamelesini haklı çıkaran kanıtları ve meta verileri korumak zorundadır ve bu kanıtların on yıl boyunca saklanması gerekir. OSS (Tek Sezirlik) şeması kapsamında kayıtlar; tüketim üye devletini, teslimatın türünü ve tarihini, ödenecek KDV'yi ve müşterinin nerede yerleşik olduğunu belirlemek için kullanılan kanıtları içermeli ve işlemin yapıldığı yılın sonundan itibaren on yıl süreyle saklanmalıdır. Bir oran döndürüp bunu unutan bir araç, ilk günden bu testten geçerliliğini yitirir.

Nordlet, bu ayrımın muhasebe odaklı tarafı için oluşturulmuştur. REST uç noktaları, tiplendirilmiş bir SDK ve imzalı webhook'lar aracılığıyla değiştirilemez (immutable) çift taraflı defter, dönem kilitleme, banka ve ödeme mutabakatı, ülkeye özel AB KDV'si ve denetim günlüğü sunar. Bir satış faturası kesmek, dengeli yevmiye kaydını ve KDV kalemlerini tek bir işlemde kayda geçirir; böylece muhasebe ve vergi muamelesi asla ayrı ayrı kaydedilmez. Bu kombinasyon, vergi işlemlerini harici bir deftere yansıtmak yerine kendi muhasebe veri modeline sahip olmak isteyen platformlar için bu rehber boyunca en uygun kategori seçeneği olarak görünmesinin nedenidir. Hemen başta belirtmek gerekir ki Nordlet erken erişim aşamasındadır ve tasarım ortaklarını sürece dahil etmektedir; dolayısıyla üretim zaman çizelgeleri ve ülke kapsamı doğrulanması gereken hususlardır. Öte yandan fiyatlandırma, teklif usulünden ziyade yayınlanmış ve kullanım bazlıdır.

"AB KDV Uyumluluğu" Neleri Kapsamalıdır?

Satıcıları karşılaştırmadan önce kapsamı netleştirin. "KDV destekler" ifadesi bir oran tablosu, bir hesaplama motoru, bir rapor, bir kayıt hizmeti veya tamamen yönetilen bir beyanname süreci anlamına gelebilir. Hangisi olduğunu mutlaka sorun.

Pratik bir AB KDV iş akışının şunları ele alması gerekir:

Tüketici fiyatları vergiler dahil gösterilse bile, ifa yeri, teslimat tarihi, net, KDV ve brüt tutarların ayrı ayrı saklandığı işlem düzeyinde kayıtlar.
Yalnızca bir ülke alanı değil, müşteri konum kanıtı. Fatura adresi, kargo, IP ve banka sinyalleri ile sistemin bunlardan çıkardığı sonuç.
AB içi B2B işlemler için VIES doğrulaması. VIES merkezi bir kayıt defterini değil ulusal veritabanlarını kontrol eder; bu nedenle geçerli bir numara yanıtsız kalabilir, servis geçici olarak kapalı olabilir ve geçmişteki geçerlilik sonradan teyit edilemeyebilir.
OSS ve IOSS gruplandırması, düzeltmeleri ve denetim dışarı aktarımları. Avrupa Komisyonu, OSS Standart Denetim Dosyasını Üye Devletler genelinde kabul edilen bir format olarak tanır.
Satıcının, alıcının veya platformun vergiyi tahsil edip ödediğini modelleyen pazaryeri sorumluluğu mantığı.
İadelerin, alacakların ve indirimlerin beyanname düzeltmesi yoluyla geriye dönük izlenebilmesini sağlayan, orijinal işlemle bağlantılı kalan düzeltmeler.

Bir satıcı bunların her birinin nasıl saklandığını ve dışarı aktarıldığını gösteremiyorsa, bu eksikliği bir detay değil gerçek bir maliyet olarak değerlendirin.

Kararı Değiştiren Seçim Kriterleri

Kriter	Neyi doğrulamalısınız?	Neden önemli?
Muhasebe derinliği	Değiştirilemez defter, yevmiye kayıtları, hesap planı, dönem kilitleme, ödeme mutabakatı	Yalnızca bir vergi motoru güvenilir finansal tablolar üretmez
KDV hesaplaması	Ülke, müşteri tipi, ürün kategorisi, ifa yeri, istisnalar, tevkifat, vergiler dahil fiyatlandırma	Standart oran aramaları karışık mallarda, B2B ve pazaryeri akışlarında yetersiz kalır
Konum kanıtı	Fatura, kargo, IP, banka sinyallerinin saklanması ve bunlardan varılan sonuç	Muamele genellikle tek bir ülke değerine değil, kanıta dayanır
VIES iş akışı	İstek kimlikleri, zaman damgaları, önbellekleme, yeniden deneme yönetimi, inceleme kuyrukları	VIES kullanılamayabilir; ödeme adımı tek bir senkron çağrıya bağımlı olamaz
OSS / IOSS	Gruplandırma, Birlik içi ve Birlik dışı OSS, düzeltmeler, denetim çıktıları	"OSS destekler" ifadesi yalnızca bir rapor veya tam yönetilen beyanname anlamına gelebilir
Pazaryeri kuralları	Sorumlu tedarikçi (deemed-supplier) mantığı, satıcı KDV numaraları, komisyon muamelesi, satıcı düzeyinde raporlama	Platformlar, sıradan ödeme akışlarının asla görmediği sorumluluklar taşır
Denetlenebilirlik	Değiştirilemez kayıtlar, dönem kilitleri, kaynak belgeler, vergi kararı açıklamaları, dışa aktarım formatları	Yetkililer kayıtları yıllar sonra talep edebilir
Entegrasyon	REST, webhook'lar, SDK'lar, idempotency, sandbox, sürümleme, olay yeniden oynatma	Zayıf mekanizmalar yinelenen veya mutabık kalınmamış vergi kayıtları oluşturur
Ticari model	Hesaplama başına, işlem başına, beyanname başına, hesap başına veya teklif bazlı	Maliyet, hacim ve yetki alanlarına göre keskin bir şekilde değişir
Veri taşınabilirliği	Defterin, faturaların, vergi kanıtlarının, KDV numaralarının, beyanname geçmişinin dışa aktarımı	Satıcı sisteminiz olduğunda değiştirme maliyetleri yüksektir
Olgunluk	Erişilebilirlik, SLA, destek, referans müşteriler	Erken erişim ürünü cazip olabilir ancak beyanname açısından kritik işlerde kanıtlanmamış olabilir

Bunlardan ikisi yeterince anlaşılmamıştır. İdempotency (tekrarsız işlem) desteği ekiplerin beklediğinden daha önemlidir, çünkü yinelenen bir KDV girdisi oluşturan yeniden denenen bir ağ çağrısı, bir beyannameyi fark ettirmeden bozar. Nordlet, değişiklik yaratan her çağrıda bir Idempotency-Key başlığını kabul eder; böylece yeniden denenen bir istek asla mükerrer kayıt oluşturamaz. Bu, bir muhasebe arka ucunu bir oran API'sinden ayıran türden bir mühendislik detaydır. Dönem kilitleme ise diğer kritik unsurdur: kapatılan aylar sessizce üzerine yazılarak değiştirilmemeli ve düzeltmeler doğrudan düzenlemeler yerine izlenebilir düzeltme girdileri oluşturmalıdır.

Nitelikli Adayların Karşılaştırılması

KDV aramasında karşınıza çıkan araçların çoğu aynı türde ürünler değildir. Önde gelen adayların konumlandığı yerler ve her birinin en uygun olduğu senaryolar şunlardır:

Aday	Kategori	Herkese açık fiyatlandırma	En iyi kullanım alanı
Nordlet	Gömülü AB KDV'sine sahip API odaklı bulut muhasebesi	Yayınlanmış: €10/ay'dan başlayan planlar, API isteklerine göre ölçülendirilir, her plan tüm modülleri içerir; erken erişim, tasarım ortakları alınıyor	Kendi ürünleri içinde defterlere, ödemelere ve KDV'ye ihtiyaç duyan platformlar ve pazaryerleri
Stripe Tax	Stripe içinde vergi hesaplama, tahsilat ve isteğe bağlı yönetilen beyanname	Yayınlanmış: Vergi tahsilatı için kayıt olunan yerlerde hesaplama API çağrısı başına €0.04 ve işlem başına €0.45; Tax Complete planları aylık €80 ile €1,400 arasında	Hızlı vergi hesaplaması isteyen Stripe tabanlı işletmeler
Quaderno	Vergi otomasyonu, uyumlu faturalandırma ve raporlama	Yayınlanmış: Aylık $29'dan (25 işlem) $149'a (2.500 işlem) kadar; bunun üzerindeki kurumsal ihtiyaçlar özel teklif	Vergi bilincine sahip faturalara ihtiyaç duyan küçük dijital ve çok kanallı satıcılar
Avalara	Geniş dolaylı vergi motoru ve uyumluluk hizmetleri	Teklif bazlı	Geniş kapsama ve ERP entegrasyonlarına ihtiyaç duyan kurumsal şirketler
Vertex	Pazaryeri sorumluluğu modellemesine sahip kurumsal vergi motoru	Yayınlanmamış	Satıcı ile platform sorumluluğunun merkezde olduğu çok satıcılı pazaryerleri
Sovos	Yönetilen KDV uyumluluğu ve düzenleyici hizmetler	Özel	Ölçekli olarak yönetilen kayıt ve beyannameler isteyen işletmeler

Fiyatlar, yazının yazıldığı sırada her satıcının halka açık fiyatlandırma sayfasında gösterildiği gibidir ve haber verilmeksizin değiştirilebilir; bütçeleme yapmadan önce bunları onaylayın.

Birkaç ödünleşim (trade-off) ayrıca vurgulanmayı hak ediyor.

Nordlet ile yalnızca vergi odaklı araçların karşılaştırması. Buradaki temel fark, Nordlet'in defterlerinizin yanında KDV hesaplamayı önermemesidir. Doğrudan defterin kendisidir. Platformun kendisi, ödemeler ve denetim izleri dahil olmak üzere muhasebe veri modeline sahip olması gerektiğinde doğru yaklaşım budur. Dürüstçe yapılması gereken ödünleşim değerlendirmesi olgunluk seviyesidir: ürün erken erişim aşamasındadır ve OSS ile IOSS beyannameleri, önceki dönem düzeltmeleriyle faturalarınızdan hesaplanırken, yerel beyanname paketleri bugün üç ülke için gönderilmektedir - Litvanya (FR0600), Almanya (UStVA) ve Polonya (JPK_V7M) - ve hiçbir beyanname sizin adınıza bir resmi makama gönderilmemektedir. Ciddi bir alıcı, varsayımlarda bulunmak yerine ülke kapsamını ve beyanname iş akışını doğrudan doğrulamalıdır.

Stripe Tax ile Quaderno. Stripe Tax, grubun en net genel API fiyatlandırmasına sahiptir ve halihazırda Stripe faturalandırma ve ödeme yığınının içinde yaşıyorsanız sorunsuz bir şekilde uyum sağlar. İşlem API'si genel muhasebe yevmiyelerini değil, vergi işlemlerini kaydeder. Quaderno ise şeffaf aylık planları ve satış verilerini iletmek için esnek bir API ile daha çok satış platformu odaklıdır; ancak genel materyalleri OSS/IOSS desteğini veya bir genel defteri açıkça doğrulamamaktadır. Hiçbiri çift taraflı defterlerin yerini alacak şekilde sunulmamalıdır.

Avalara, Vertex ve Sovos. Bunlar kurumsal oyunculardır. Avalara en geniş dolaylı vergi ayak izine sahiptir ancak kapsam belirlemek için bir satış süreci gerektirir. Vertex, üç taraflı işlemleri açıkça modellediği ve hangi tarafın sorumlu olduğunu belirlediği için pazaryerleri açısından öne çıkmaktadır. Sovos ise yönetilen kayıt, beyanname ve mevzuat desteğinin gömülü muhasebenin önüne geçtiği durumlarda en güçlü seçenektir. Hiçbiri genel defter API'si olarak belgelendirilmemiştir.

Temel gereksinimi gömülü, denetime hazır defterler ve aynı girdide kaydedilen KDV olan bir platform için Nordlet, mimarisinden ziyade üretime hazır olma durumunun test edilmesi koşuluyla, bunlar arasında en temiz uyumu sunar.

Çoğu Alıcının Atladığı 2027 - 2030 Sorusu

2026 yılında yalnızca bugünün kurallarına göre bir KDV aracı seçmek miyopluktur. AB'nin Dijital Çağda KDV (ViDA) paketi Mart 2025'te kabul edildi ve aşamalı olarak devreye giriyor.

1 Ocak 2027 itibarıyla OSS ve IOSS değişiyor; yeni bir düzeltme mekanizması, ek IOSS bilgileri ve tüketim üye devletine göre aylık IOSS listeleri bunlara dahildir.
1 Temmuz 2028 itibarıyla platform kuralları genişliyor ve kimliği belirsiz belirli tedarikçiler için zorunlu tevkifat başlıyor.
1 Temmuz 2030 itibarıyla sınır ötesi B2B işlemler için dijital raporlama e-faturaya geçiyor.
Yerel gerçek zamanlı raporlama sistemleri 1 Ocak 2035'e kadar uyumlu hale geliyor.

Pratik test, bir API'nin bugün KDV'yi doğru hesaplayıp hesaplamadığı değildir. Test, veri modelinin; orijinal işlemi, vergi kararını, faturayı, düzeltmeyi, satıcı kimliğini ve kanıtı, bu gereksinimler yürürlüğe girdiğinde e-faturayı ve dijital raporlamayı besleyecek bir biçimde koruyup koruyamayacağıdır. Yapılandırılmış fatura meta verilerine sahip, yayınlanan faturaları Peppol için EN 16931 UBL formatında sunabilen değiştirilemez bir defter, durumsuz (stateless) bir oran uç noktasına kıyasla bunun için çok daha iyi konumdadır.

Her Şeyi İmzalamadan Önce Neleri Test Etmeliyiz?

Sistem sınırını tanımlayın. Satıcının muhasebe ana sisteminiz, vergi karar motorunuz, beyanname hizmetiniz mi yoksa bunlardan yalnızca biri mi olduğuna karar verin ve bunu yazılı hale getirin.
Fiyatları karşılaştırmadan önce gerçek işlemleri modelleyin. Yurtiçi B2C, AB içi B2C, geçerli KDV numarasına sahip AB içi B2B, geçersiz veya ulaşılamayan VIES, pazaryeri sorumlu tedarikçi (deemed-supplier) satışları, iadeler, indirimler ve karışık oranları çalıştırın.
Vergi kararı açıklaması isteyin. Yanıt; oranın, yetki alanının, istisnanın, tevkifatın veya sorumlu tarafın neden seçildiğini göstermelidir.
VIES'i bilerek aksatın. Zaman damgalarını, istek tanımlayıcılarını, yeniden deneme mantığını, önbelleğe alınmış sonuçları ve manuel inceleme yolunu doğrulayın.
Panoyu değil, çıktıları inceleyin. Örnek OSS, KDV beyannamesi, fatura, yevmiye ve denetim dosyalarını talep edin.
Değiştirilemezliği (immutability) test edin. Kapanmış bir dönemin üzerine yazmayı deneyin. Sistem bunu reddetmeli ve izlenebilir bir düzeltme kaydı yapmaya zorlamalıdır.
Hesaplama fiyatlandırmasını uyumluluk fiyatlandırmasından ayırın. API çağrılarının, işlemlerin, kayıtların, beyannamelerin, depolamanın, desteğin ve ek yetki alanlarının toplam maliyetini çıkarın.
Platform ekonomisini doğrulayın. Bir pazaryeri için tüccar aboneliği ana sayfa başlığını değil, satıcı, işlem ve aktif hesap başına maliyeti modelleyin.
Üretime hazır olma durumunu onaylayın. SLA, oran limitleri, webhook'lar, idempotency, sandbox eşdeğerliği, veri yerleşimi ve dışa aktarım hakları.
Gelecekteki uyumluluğu puanlayın. 2027 OSS değişikliklerini, 2028 platform kurallarını ve 2030 sınır ötesi raporlamasını açıkça ağırlıklandırın.

Bu listenin büyük bir kısmı öğleden sonra bir sandbox şirketinde çalıştırılabilir; AB KDV motoru rehberi; Nordlet'in hangi ifa yeri, tevkifat, sorumlu tedarikçi (deemed-supplier) ve OSS/IOSS vakalarını çözdüğünü ve uyarılarının nerede tetiklendiğini belgeler.

SSS

Bir KDV API'si ile muhasebe API'si aynı şey midir?

Hayır. Bir KDV API'si vergi hesaplar veya beyanname verir. Bir muhasebe API'si ise çift taraflı defterler tutar ve KDV'yi kaydedilen bir işlemin yalnızca bir özniteliği olarak saklar. Platformunuzun kayıt sistemi olması gerekiyorsa, yalnızca KDV odaklı bir araç sizi defteri başka bir yerde tutmak ve iki kaynağı mutabık kılmak zorunda bırakır.

Ödeme adımında gerçek zamanlı B2B doğrulama için VIES'e güvenebilir miyim?

Tek bir senkron bağımlılık olarak güvenemezsiniz. VIES ulusal veritabanlarını sorgular ve geçici olarak kullanılamayabilir; işletme AB içi ticaret için kayıtlı değilse geçerli bir numara görünmeyebilir ve geçmişteki geçerlilik daha sonra teyit edilemeyebilir. Etrafında önbellekleme, yeniden denemeler, zaman damgaları, istek kimlikleri ve manuel bir inceleme kuyruğu oluşturun.

"OSS destekler" ifadesi, satıcının beyannamelerimi vereceği anlamına mı gelir?

Nadiren; ve bunu asla varsaymamalısınız. Bir rapor, bir hesaplama, kayıtta yardım veya tamamen yönetilen başvuru anlamına gelebilir. Hangi ülkelerin ve beyannamelerin kapsandığını, bunları kimin sunduğunu ve düzeltmelerin nasıl ele alındığını tam olarak sorun.

Nordlet hâlâ erken erişimde olmasına neden bu karşılaştırmada yer alıyor?

Çünkü gömülü defterlere, ödemelere, defter bütünlüğüne ve KDV meta verilerine tek bir üründe ihtiyaç duyan platformlar için en yakın kategori uyumudur ve çoğu yalnızca vergi odaklı API bunu sağlamaz. Erken erişim, üretim zaman çizelgeleri ve ülke kapsamı üzerinde gerçek bir sınırlamadır; bu nedenle kullanılabilirliği ve beyanname iş akışını kesinleşmiş olgulardan ziyade doğrulama soruları olarak ele alın.

Daha sonra en çok KDV sorununa neden olan tek hata nedir?

Vergi kararının arkasındaki kanıtı saklamamaktır. Yetkililer bir satıştan yıllar sonra kayıt talep edebilir ve OSS kayıtlarının on yıl boyunca saklanması gerekir. Doğru bir oran döndüren ancak konum kanıtını, VIES sonucunu ve işlem bağlantısını silen bir araç, her hesaplama doğru olsa bile denetimden geçemeyecektir.