Shopify e-Fatura ve e-Arşiv Entegrasyonu: Türkiye için Tam Kılavuz (2026)

Türkiye'de Shopify mağazası açan her satıcının er ya da geç karşılaştığı en önemli soru şudur: "Siparişlerim için e-Fatura veya e-Arşiv nasıl keseceğim?" Gelir İdaresi Başkanlığı'nın (GİB) zorunlu kıldığı bu sistem, yabancı kaynaklı bir platform olan Shopify'ın varsayılan olarak desteklemediği bir alan. Ancak doğru kurgu, doğru entegratör seçimi ve doğru otomasyon ile bu süreci hem yasal hem de operasyonel olarak kusursuz hale getirmek mümkün.

Bu rehberde, bir Shopify mağazasında e-Fatura ve e-Arşiv entegrasyonunu sıfırdan nasıl kuracağınızı, hangi entegratörlerin mevcut olduğunu, KDV oranlarını nasıl yöneteceğinizi ve en yaygın hataları nasıl önleyeceğinizi adım adım göreceksiniz. Yazı sonunda, Türkiye mevzuatına tam uyumlu bir Shopify mağazası için kontrol listesi de bulacaksınız.

e-Fatura ve e-Arşiv Nedir? Farkları Nelerdir?

Türkiye'de elektronik belge uygulamaları 2014 yılından itibaren kademeli olarak zorunlu hale getirilmiştir. Shopify satıcılarının bilmesi gereken iki temel belge türü vardır:

e-Fatura

e-Fatura, mükelleften mükellefe (B2B) düzenlenen elektronik faturadır. Yani alıcı da satıcı da e-Fatura mükellefi ise, aralarındaki işlem mutlaka e-Fatura ile belgelenmelidir. GİB üzerinden gönderilir ve alıcının e-Fatura portalına düşer.

e-Arşiv Fatura

e-Arşiv, mükellef olmayan kişilere (B2C — nihai tüketici) veya e-Fatura mükellefi olmayan işletmelere düzenlenen faturadır. Shopify mağazalarının büyük çoğunluğu için kesilmesi gereken belge türü budur. Müşteriye e-posta veya SMS ile gönderilebilir.

Hangi Belgeyi Ne Zaman Kesmelisiniz?

• Alıcı e-Fatura mükellefi ise: e-Fatura kesilir (GİB üzerinden)
• Alıcı nihai tüketici ise: e-Arşiv fatura kesilir
• Alıcı yurt dışında ise: e-Arşiv ihracat faturası düzenlenir

Shopify ile e-Fatura Entegrasyonunun Zorlukları

Shopify, küresel bir platform olduğu için Türkiye'nin yerel vergi mevzuatına özel bir çözüm sunmaz. Bu durum, Türk satıcılar için birkaç önemli zorluk yaratır:

1. Yerel entegratör zorunluluğu: Shopify doğrudan GİB sistemine bağlanamaz. Araya bir "özel entegratör" girmesi gerekir.
2. KDV hesaplama farkları: Shopify'ın yerleşik vergi motoru Türk KDV oranlarını doğru hesaplamayabilir.
3. Otomatik fatura akışı: Her siparişte manuel fatura kesmek ölçeklenemez. Otomasyon şart.
4. Fatura iptali ve iade: Siparişin iptal edilmesi veya iade gelmesi durumunda fatura akışı da senkronize edilmelidir.
5. TCKN/VKN doğrulaması: Müşterinin vergi numarası çeşidine göre doğru belge tipi seçilmelidir.

Özel Entegratör Nedir ve Hangisini Seçmelisiniz?

Özel entegratörler, GİB ile Shopify mağazanız arasında köprü görevi gören yetkili servis sağlayıcılardır. Türkiye'de en çok tercih edilen entegratörler şunlardır:

Popüler e-Fatura Entegratörleri

• Nilvera: Modern API, Shopify dostu dokümantasyon, makul fiyatlandırma
• Logo e-Fatura: Kurumsal müşteriler için güçlü altyapı, Logo muhasebe programlarıyla entegre
• Mikro e-Çözümler: Küçük ve orta ölçekli işletmeler için pratik çözüm
• Uyumsoft: Geniş özellik seti, çoklu belge tipi desteği
• İzibiz: Kullanıcı dostu arayüz, hızlı kurulum
• Foriba (QNB): Bankacılık destekli güvenilir altyapı

Entegratör Seçerken Dikkat Edilecekler

• REST API desteği (Shopify webhook'ları ile uyumlu olmalı)
• Aylık belge limitleri ve aşım ücretleri
• İade ve iptal faturası desteği
• İhracat faturası (döviz cinsinden) desteği
• Müşteri destek kalitesi ve dokümantasyon
• Muhasebe programınızla entegrasyon (Logo, Mikro, Netsis vb.)

Shopify ile e-Fatura Entegrasyon Yöntemleri

Yöntem 1: Hazır Shopify App Kullanmak

Shopify App Store'da Türkiye için geliştirilmiş e-Fatura uygulamaları mevcuttur. Bu yöntem, teknik bilgi gerektirmeyen en hızlı çözümdür. Uygulamayı kurduğunuzda, entegratör hesabınızı bağlarsınız ve siparişler otomatik olarak faturaya dönüşür.

Avantajları: Hızlı kurulum, teknik bilgi gerektirmez, güncelleme otomatik.

Dezavantajları: Aylık sabit ücret, özelleştirme sınırlı, çoklu mağaza senaryolarında yetersiz kalabilir.

Yöntem 2: Özel Webhook Entegrasyonu

Daha fazla kontrol isteyen işletmeler için özel geliştirme yapılabilir. Shopify'ın orders/paid webhook'u tetiklendiğinde, bir middleware sunucusu siparişi alır, entegratör API'ına uygun formata çevirir ve fatura kesme isteğini gönderir.

Avantajları: Tam kontrol, özel iş kuralları, birden fazla mağaza tek merkezden yönetilebilir.

Dezavantajları: Geliştirme maliyeti, bakım gereksinimi.

Yöntem 3: Shopify Flow + API Kombinasyonu

Shopify Plus kullanıcıları için Shopify Flow, sipariş olaylarını yakalayıp HTTP request tetikleyebilir. Bu yöntem, hazır app ile özel geliştirme arasında denge kurar.

Türkiye KDV Oranlarını Shopify'da Doğru Yapılandırma

Türkiye'de 2026 itibarıyla geçerli KDV oranları şunlardır: %1, %10 ve %20. Shopify'da her ürün için doğru KDV oranını atamak kritik öneme sahiptir.

Adım Adım KDV Kurulumu

1. Shopify Admin → Settings → Taxes and duties bölümüne gidin
2. Türkiye'yi vergi bölgesi olarak ekleyin
3. Varsayılan KDV oranını %20 olarak tanımlayın
4. %1 ve %10 oranı için tax override koleksiyonları oluşturun
5. Gıda, ilaç, kitap gibi indirimli KDV'li ürünleri ilgili koleksiyonlara ekleyin
6. İhracat satışları için zero-rated (KDV muaf) bölge tanımlayın

Yaygın Hata: Vergi Fiyata Dahil mi Değil mi?

Türkiye'de yasal olarak ürün fiyatları KDV dahil gösterilmelidir. Shopify'da bu ayar "All prices include tax" olarak işaretlenmelidir. Bu ayarı yapmadan sitenizi yayınlarsanız, hem tüketici hakları mevzuatına aykırı davranmış hem de fatura tutarlarınız yanlış hesaplanmış olur.

Otomatik Fatura Akışı Nasıl Kurulur?

Hedef, bir siparişin tamamlanmasından saniyeler sonra faturanın otomatik olarak kesilmesi ve müşteriye iletilmesidir. İdeal akış şöyle olmalıdır:

1. Sipariş oluşturulur: Müşteri ödemeyi tamamlar, Shopify siparişi "paid" durumuna geçer
2. Webhook tetiklenir: orders/paid olayı entegratör sistemine iletilir
3. Fatura tipi belirlenir: TCKN/VKN kontrolü yapılır, e-Fatura veya e-Arşiv seçilir
4. GİB'e gönderilir: Entegratör belgeyi GİB sistemine iletir
5. Müşteriye e-posta: Fatura PDF'i müşteriye otomatik iletilir
6. Shopify'a not düşülür: Sipariş not alanına fatura numarası eklenir

İade ve İptal Senaryoları

e-Fatura ve e-Arşiv sisteminde bir fatura kesildikten sonra silinemez — sadece iade faturası ile ters kayıt oluşturulabilir. Shopify'da bir sipariş iade edildiğinde:

• Tam iade: Orijinal faturanın tamamını kapatan iade faturası kesilir
• Kısmi iade: Sadece iade edilen tutar için düzenleme faturası kesilir
• Sipariş iptali (ödeme öncesi): Henüz fatura kesilmediyse işlem yok, kesildiyse iade faturası gerekir

Yaygın Hatalar ve Çözümleri

Hata 1: Yanlış Belge Tipi

Müşterinin e-Fatura mükellefi olup olmadığı kontrol edilmeden e-Arşiv kesilirse, belge geçersiz sayılır. Çözüm: Entegratörünüzün TCKN/VKN doğrulama API'ını kullanın.

Hata 2: KDV Dahil/Hariç Karışıklığı

Shopify'da fiyatlar KDV hariç girilip "include tax" seçildiğinde, fatura tutarı ile sipariş tutarı eşleşmeyebilir. Çözüm: Fiyatları baştan KDV dahil girin.

Hata 3: İhracat Faturası Eksik

Yurt dışı siparişlerde iç piyasa e-Arşiv formatı kullanılırsa, hem gümrük hem de vergi açısından sorun çıkar. Çözüm: İhracat siparişleri için ayrı bir akış kurun.

Hata 4: Aylık Belge Limitinin Aşılması

Entegratörler genellikle belirli bir aylık belge limiti ile gelir. Hızlı büyüyen mağazalarda bu limit dolunca sistem fatura kesemez. Çözüm: Büyüme hızınıza göre paketi yukarı çevirin.

e-Fatura Uyumlu Shopify Mağazası Kontrol Listesi

• ✅ GİB e-Fatura veya e-Arşiv mükellefiyet başvurusu tamamlandı
• ✅ Özel entegratör seçildi ve sözleşme imzalandı
• ✅ Shopify'da Türkiye KDV oranları doğru yapılandırıldı (%1, %10, %20)
• ✅ Ürün fiyatları KDV dahil olarak ayarlandı
• ✅ Checkout'ta TCKN/VKN alanı eklendi
• ✅ Webhook veya hazır app ile otomatik fatura akışı kuruldu
• ✅ İade/iptal senaryoları için iade faturası akışı hazır
• ✅ İhracat siparişleri için ayrı süreç tanımlandı
• ✅ Muhasebe programı (Logo, Mikro vb.) ile entegrasyon yapıldı
• ✅ Aylık belge limitleri kontrol edildi
• ✅ Müşterilere fatura PDF'i otomatik iletiliyor

Profesyonel Kurulum Neden Önemli?

e-Fatura ve e-Arşiv entegrasyonu, ilk bakışta "bir uygulama yüklersin olur" gibi görünse de, gerçekte iş süreçlerinizin tam kalbinde yer alan kritik bir sistemdir. Yanlış kurulmuş bir fatura akışı, vergi cezaları, müşteri memnuniyetsizliği, operasyonel tıkanıklık ve en kötüsü marka itibar kaybı olarak geri döner.

34Devs olarak İzmir, İstanbul ve Türkiye'nin her yerinden Shopify mağazalarına kurumsal düzeyde e-Fatura entegrasyonu kuruyoruz. Özel entegratör seçiminden webhook geliştirmeye, muhasebe sistemi köprüsünden ihracat süreçlerine kadar uçtan uca tüm akışı sizin için tasarlıyoruz. İzmir Shopify ajansımızla ücretsiz danışmanlık görüşmesi için iletişime geçebilirsiniz.

Sıkça Sorulan Sorular

Shopify doğrudan e-Fatura kesebilir mi?

Hayır. Shopify, Türkiye mevzuatına özel bir e-Fatura altyapısı sunmaz. Mutlaka bir özel entegratör aracılığıyla GİB sistemine bağlanmanız gerekir.

e-Arşiv mi, e-Fatura mı kesmeliyim?

Alıcınız e-Fatura mükellefi ise e-Fatura, nihai tüketici (gerçek kişi) veya mükellef olmayan işletme ise e-Arşiv kesmelisiniz. Bu ayrım TCKN ve VKN kontrolü ile otomatikleştirilebilir.

Yurt dışı siparişlerinde hangi fatura kesilir?

Yurt dışına yapılan satışlarda e-Arşiv ihracat faturası düzenlenir. Bu fatura KDV'den muaftır (sıfır oranlı) ve döviz cinsinden kesilebilir.

Entegratör ücreti aylık ne kadardır?

Entegratör ücretleri aylık 250 TL ile 2.500 TL arasında değişir. Fiyat; belge hacmi, özellik seti ve muhasebe programı entegrasyonuna göre belirlenir.

İade yapıldığında fatura ne olur?

Kesilmiş bir fatura silinemez. İade veya iptal durumunda, orijinal faturayı dengeleyen bir iade faturası (ters kayıt) düzenlenir. Otomatik entegrasyonlar bunu siparişin iade olayıyla tetikleyerek yapar.

Shopify'da KDV dahil fiyat nasıl gösterilir?

Shopify Admin → Settings → Taxes and duties bölümünden "All prices include tax" seçeneğini işaretlemelisiniz. Türkiye'de yasal olarak fiyatlar KDV dahil gösterilmek zorundadır.

Shopify Plus e-Fatura için farklı bir avantaj sağlar mı?

Evet. Shopify Plus kullanıcıları Shopify Flow ile özel otomasyonlar kurabilir, Scripts ile checkout'ta TCKN/VKN validasyonu yapabilir ve çoklu mağaza yapısında fatura akışını merkezi olarak yönetebilir.