E-ticaret için Polonya KSeF e-faturalama: beş dakikalık özet

Diğer işletmelere KDV faturası kesen bir Polonya tüzel kişiliği işletiyorsan — yani toptan, B2B hizmet veya pazaryeri satışı yapan virtually her Sp. z o.o. — zaten KSeF perimeter'inin içindesin.

Bu özet operatörler için, avukatlar için değil. KSeF'in ne olduğunu, ticaret stack'inden ne istediğini ve en sık gördüğümüz üç entegrasyon hatasını ele alır.

KSeF gerçekte ne

KSeF (Krajowy System e-Faktur — Ulusal e-Fatura Sistemi), Polonya Maliye Bakanlığı tarafından işletilen merkezi e-faturalama platformu. Her B2B satış faturası bunun üzerinden yapılandırılmış XML formatında (FA(3) şeması) düzenlenmeli, bir KSeF referans numarası almalı ve o anda — alıcı çekip almasa bile — teslim edilmiş sayılmalı.

Ticaret için üç özellik önemli:

Fatura teslimini değiştirir. KSeF referans numarası fatura DEMEKTİR. PDF veya kağıt redundant olur.
Belge değil yapılandırılmış veri. Alıcının muhasebe sistemi XML'i doğrudan parse eder.
Sert deadline'ı var. Aktif KDV mükellefleri için zorunlu (~ €10M+ gelir eşiği Şubat 2026'dan itibaren; 2026 ileri tarihlerden itibaren daha geniş).

Ticaret stack'ine ne wire'lanmalı

Bir e-ticaret operasyonu için KSeF entegrasyonu dört sisteme dokunur:

1. Sipariş → Fatura üretimi

Bir Polonyalı müşteri siparişi ödendiğinde sistemin:

Alıcının işletme (NIP doğrulanmış) mı yoksa tüketici mi olduğunu tespit etmesi gerekir.
İşletme siparişleri için: FA(3) XML üret, imzala, KSeF API'sine gönder, referans numarası al.
Tüketici siparişleri için: geleneksel fiscal receipt (veya fiziksel varlığın varsa kasa fiskalna entegrasyonu).

2. Kimlik doğrulama

KSeF API'si şunlardan birini ister:

Nitelikli elektronik imza (kwalifikowany podpis elektroniczny) — akredite sağlayıcılarca verilir.
Güvenilir profil (profil zaufany) — tek seferlik kullanım için.
Tüzel kişiliğin vergi temsilcisi tarafından verilen API token — otomatize ticaret için en pratik olan.

İsteyeceğin yol API token. Şirketin KSeF hesabına bağlı, fatura kesimine scope'lanmış.

3. Referans numarası kalıcılığı

Her fatura, kaydedilmesi gereken benzersiz bir KSeF numarası alır:

Sipariş/fatura kayıtlarında saklanır.
Alıcıya gösterilir (onay e-postaları, müşteri portalı).
Gelecek düzeltme veya kredi notlarında orijinale referans olarak kullanılır.

4. Düzeltmeler ve iadeler

Bir KSeF faturası düzenlenemez. Düzeltmeler faktura korygująca ister — orijinal KSeF numarasına referans veren ayrı bir XML. İade akışın orijinali değiştirmek yerine bunları kesmeli.

Üç entegrasyon hatası

Bu hataları kendi listelerini hak edecek kadar gördük.

Hata 1: KSeF'i muhasebeci problemi olarak görmek

Faturaların muhasebeci tarafından sonradan kesiliyorsa, zaten kaybettin. Alıcı faturayı ödeme anında bekler, yedi gün sonra değil. KSeF akışını ilk günden sipariş webhook'una göm.

Hata 2: Faturaları client-side üretmek

Shopify ve diğer platformlarda "fatura üreten" app'ler var. Çoğu belge üretir — KSeF uyumlu XML değil, imzalı değil, gönderilmiş değil. Faturalama pipeline'ının gerçekten KSeF API'sini çağırıp referans numarasını sakladığını doğrula. Alıcının e-postasındaki PDF uyum kanıtı değil.

Hata 3: Düzeltme akışını ihmal etmek

Ekipleri yakalayan iade akışı. Müşteri ürün iade eder → sistemin bir iade keser → ama orijinal KSeF numarasına referans veren bir faktura korygująca kesiyor mu? Eğer değil, KDV kayıtların merkezi sistemle senkron değil. En sık görülen audit bulgusu bu.

Müşterilerimiz için ne wire'larız

Senavia-yürütülen operasyonlarda KSeF Parça 1 deliverable'ı:

Polonyalı vergi temsilcisiyle provision edilmiş API token.
Sipariş webhook → FA(3) XML üretimi → KSeF gönderimi → referans numarası kayıt.
Müşteri-yüzlü fatura görünümü KSeF referansı içerir.
İade webhook → otomatik kesilen ve saklanan faktura korygująca.
Shopify sipariş sayısı, KSeF fatura sayısı ve muhasebe export'u arasında aylık mutabakat.

Bir haftalık operasyonel mühendislik. Gösterişli değil, ama "uyuyoruz" ile "temiz audit'imiz var" arasındaki fark.

Bu özet bilgilendirme amaçlıdır; hukuki tavsiye değildir. KSeF kuralları değişir. Kendi durumun için spesifikleri bir Polonya vergi danışmanıyla doğrula. Kendi danışmanımıza seni tanıştırmak işten değil.