E-Fatura ve E-Arşiv Entegrasyonu E-Ticaret Sitenizde Nasıl Çalışır?
Siparişten faturaya otomatik akış: e-Fatura ile e-Arşiv farkı, özel entegratörün rolü ve e-ticaret sitesine entegrasyonun adımları.

E-fatura entegrasyonu, e-ticaret sitenizde oluşan her siparişin faturasının elle uğraşmadan, otomatik olarak düzenlenip müşteriye iletilmesini sağlar. Türkiye'de internet üzerinden satış yapan işletmeler belirli hasılat eşiklerini aştığında e-Fatura ve e-Arşiv fatura sistemine geçmek zorundadır; eşiğin altında olanlar için de otomatik fatura, zaman ve hata açısından büyük kolaylıktır. Bu yazıda e-Fatura ile e-Arşiv arasındaki farkı, özel entegratörün rolünü ve bir e-ticaret sitesinde siparişten faturaya uzanan akışın nasıl kurulduğunu anlatıyoruz. Mevzuat ve eşik tutarları değişebildiği için vergi tarafındaki kararları mutlaka mali müşavirinizle birlikte vermenizi öneriyoruz.
Temel kavramlar
- e-Fatura: İki e-Fatura mükellefi arasında, Gelir İdaresi Başkanlığı (GİB) altyapısı üzerinden düzenlenen elektronik faturadır. Kurumsal müşteriye satış yapıyorsanız ve alıcı e-Fatura mükellefiyse bu tür düzenlenir.
- e-Arşiv fatura: e-Fatura mükellefi olmayan alıcılara, yani çoğunlukla nihai tüketicilere düzenlenen elektronik faturadır. Müşteriye e-posta ile veya bağlantı üzerinden iletilir.
- Özel entegratör: GİB'den izinli, mükellefler adına bu belgeleri düzenleyen, ileten ve yasal süre boyunca saklayan hizmet sağlayıcısıdır. E-ticaret sitesi faturayı bu firmanın API'si üzerinden keser.
- GİB e-Arşiv Portal: Mükelleflerin ücretsiz kullanabildiği, faturanın elle girildiği web arayüzüdür. Düşük hacimde yeterli olabilir ama otomatik entegrasyon için tasarlanmamıştır.
Kimler için zorunlu?
İnternet üzerinden mal veya hizmet satan mükellefler için e-Fatura ve e-Arşiv'e geçiş zorunluluğu, brüt satış hasılatına bağlı eşiklerle belirlenir ve bu eşikler yıllara göre güncellenmiştir. Ayrıca e-Fatura mükellefi olmayan alıcılara belirli tutarın üzerinde düzenlenen faturalar için de e-Arşiv zorunluluğu bulunur. Bu yazıda tutar vermiyoruz, çünkü rakamlar sık değişiyor. Yapmanız gereken, mevcut yıl cironuzu ve tahmini büyümenizi mali müşavirinizle birlikte değerlendirmek ve geçiş tarihini önceden planlamaktır. Zorunluluk başladığında hazırlıksız yakalanmak, siparişlerin faturasız kalmasına veya cezai risklere yol açabilir.
Siparişten faturaya otomatik akış
İyi kurulmuş bir entegrasyonda süreç şöyle ilerler:
- Sipariş ve ödeme onayı: Müşteri siparişi verir, ödeme sanal POS üzerinden onaylanır.
- Alıcı türünün belirlenmesi: Müşteri bireysel mi, kurumsal mı? Kurumsal alıcı vergi numarası ve vergi dairesi bilgisini ödeme sırasında girer.
- Mükellefiyet sorgusu: Sistem, entegratör üzerinden vergi numarasını sorgular. Alıcı e-Fatura mükellefiyse e-Fatura, değilse e-Arşiv fatura düzenlenir.
- Faturanın oluşturulması: Ürün, miktar, fiyat, KDV oranı, kargo bedeli ve varsa indirim bilgileri entegratöre gönderilir.
- İletim: e-Arşiv fatura müşteriye e-posta ile, e-Fatura ise GİB sistemi üzerinden alıcıya iletilir. Fatura bağlantısı sipariş detay sayfasında da gösterilebilir.
- Muhasebe aktarımı: Kesilen faturalar muhasebe yazılımınıza veya mali müşavirinize düzenli olarak aktarılır.
Faturanın ne zaman kesileceği de bir karardır. Bazı işletmeler ödeme onayında, bazıları ürün kargoya verildiğinde fatura keser. Hangisinin işinize uygun olduğunu stok ve iade oranınıza göre mali müşavirinizle belirleyin.
Yeni başlayanlar için portal mı, entegratör mü?
Günde birkaç siparişle başlayan bir mağaza için GİB e-Arşiv Portal üzerinden faturaları elle kesmek ilk aşamada idare edebilir. Ancak bu yöntemde her siparişin bilgileri tek tek portala girilir, fatura PDF'i indirilir ve müşteriye ayrıca gönderilir. Sipariş sayısı arttıkça bu iş hem saatler alır hem de tutar, ürün adı veya alıcı bilgisinde hata riskini büyütür. Pratik bir yaklaşım şudur:
- Siteyi baştan entegratöre bağlanabilecek şekilde kurun, fatura alanlarını (bireysel/kurumsal, vergi numarası, fatura adresi) ödeme sayfasına ekleyin.
- İlk dönemde portalla ilerliyorsanız, sipariş sayısı veya zorunluluk eşiği yaklaştığında entegratöre geçişi planlayın.
- Geçişi sezon öncesine denk getirin. Yoğun dönemin ortasında fatura altyapısı değiştirmek risklidir.
Müşteri tarafında fatura deneyimi
Faturanın müşteriye nasıl ulaştığı da en az kesilmesi kadar önemlidir. Sipariş onay e-postasına fatura bağlantısının eklenmesi, müşteri hesabında "faturalarım" bölümünün bulunması ve kurumsal alıcılara fatura bilgilerini bir kez kaydedip sonraki siparişlerde otomatik doldurma imkânı, destek taleplerini ve fatura düzeltme isteklerini belirgin şekilde azaltır.
Entegratör seçerken sorulacaklar
| Soru | Neden önemli? |
|---|---|
| Sitemin altyapısı için hazır modül veya iyi belgelenmiş API var mı? | Entegrasyon süresini ve maliyetini belirler. |
| Fiyatlandırma kontör, paket veya yıllık lisans mı? | Sipariş hacminize göre toplam maliyet değişir. |
| Mükellefiyet sorgusu API'de var mı? | e-Fatura ve e-Arşiv ayrımı otomatik yapılabilsin. |
| İptal ve iade belgelerini destekliyor mu? | İade süreçleri elle uğraşmadan yürüsün. |
| e-İrsaliye gibi ek belgeleri sunuyor mu? | İleride ihtiyaç doğarsa aynı altyapıyla devam edilir. |
| Test ortamı sağlıyor mu? | Canlıya almadan önce gerçek fatura kesmeden deneme yapılır. |
| Saklama ve erişim nasıl? | Faturalar yasal süre boyunca saklanmalı ve gerektiğinde erişilebilmeli. |
Fiyatlar ve paket içerikleri sağlayıcıya göre değişir; güncel teklifi doğrudan entegratörden alın.
Adım adım kurulum
- Mali müşavirinizle mükellefiyet durumunuzu ve geçiş tarihinizi netleştirin.
- İki veya üç özel entegratörden teklif ve teknik doküman isteyin.
- Entegratörle sözleşme yapın, gerekli başvuru ve yetkilendirme adımlarını tamamlayın.
- Sitenizde ürünlerin KDV oranlarını, kargo bedelinin faturadaki gösterimini ve indirim kurallarını kontrol edin.
- Ödeme sayfasına bireysel ve kurumsal fatura seçeneğini ekleyin.
- Test ortamında farklı senaryoları deneyin: bireysel sipariş, kurumsal sipariş, indirimli sipariş, iade.
- Canlıya alın ve ilk haftalarda kesilen faturaları mali müşavirinizle birlikte kontrol edin.
Sık yapılan hatalar
- Ürünlerde yanlış KDV oranı tanımlamak. Hata tüm faturalara yayılır.
- Kurumsal müşteri için vergi numarası alanını ödeme sayfasına eklememek.
- Kargo bedelini veya indirimi faturaya yansıtmamak, sipariş tutarı ile fatura tutarının tutmaması.
- İade ve iptal akışını entegrasyon kapsamı dışında bırakmak.
- Zorunluluk başlayana kadar beklemek ve geçişi son haftaya sıkıştırmak.
Antalya'dan bir örnek senaryo
Antalya'da hem yerel müşteriye hem de turistlere ürün satan bir işletme düşünün. Yerel bireysel müşteriler için e-Arşiv, otel veya restoran gibi kurumsal alıcılar için e-Fatura kesilmesi gerekebilir. Yurt dışına gönderilen siparişlerde ise fatura türü ve gümrük süreci ayrıca ele alınmalıdır. Tüm bu senaryoların sipariş sırasında girilen bilgilere göre otomatik ayrılması, sezonun yoğun aylarında muhasebe yükünü ciddi biçimde azaltır.
Kargo ve ödeme ile birlikte düşünün
Fatura entegrasyonu, ödeme ve kargo ile aynı sipariş akışının parçasıdır. Ödeme tarafını sanal POS karşılaştırması, gönderi tarafını kargo entegrasyonu yazımızda anlattık.
E-ticaret hizmetimiz kapsamında seçtiğiniz entegratörle fatura akışını kuruyor, test ediyor ve canlıya alıyoruz.
Sık sorulan sorular
e-Fatura ile e-Arşiv fatura arasındaki fark nedir?
e-Fatura, iki e-Fatura mükellefi arasında GİB altyapısı üzerinden düzenlenir. e-Arşiv fatura ise e-Fatura mükellefi olmayan alıcılara, örneğin nihai tüketicilere, elektronik ortamda düzenlenir ve genellikle e-posta ile iletilir.
E-ticaret yapanlar e-Arşiv'e geçmek zorunda mı?
İnternet üzerinden satış yapan mükellefler için belirli hasılat eşikleri aşıldığında e-Fatura ve e-Arşiv'e geçiş zorunludur. Eşik tutarlar yıllara göre güncellendiği için kendi durumunuzu mali müşavirinizle teyit edin.
Özel entegratör nedir?
Özel entegratör, GİB'den izin almış ve mükellefler adına e-Fatura, e-Arşiv gibi belgeleri düzenleyip ileten, saklayan hizmet sağlayıcısıdır. E-ticaret sitesi, faturayı otomatik kesmek için entegratörün API'sine bağlanır.
GİB e-Arşiv Portal ile e-ticaret faturası kesilebilir mi?
Düşük sipariş hacminde portal üzerinden elle fatura kesmek mümkündür. Ancak portal otomatik entegrasyona uygun değildir; sipariş sayısı arttıkça özel entegratör kullanmak zaman ve hata açısından daha verimlidir.
Alıcının e-Fatura mükellefi olup olmadığı nasıl anlaşılır?
Entegratörler, vergi numarasıyla mükellefiyet sorgusu yapmayı sağlar. Kurumsal alıcı vergi numarası girdiğinde sistem otomatik sorgular ve faturayı e-Fatura veya e-Arşiv olarak düzenler.
İade olan siparişte fatura ne olur?
İade ve iptal senaryolarının nasıl belgeleneceği fatura türüne ve alıcıya göre değişir. Bu kuralları mali müşavirinizle belirleyin; entegratörlerin çoğu iptal ve iade belgelerini destekler, site de bu akışa göre ayarlanır.


