E-Fatura Entegrasyonu 2026: E-Ticaret Sitenize ve Yazılımınıza Nasıl Bağlanır?

2026'da e-fatura kapsamı genişliyor ve birçok KOBİ ilk kez "faturayı nereden keseceğiz?" sorusuyla karşılaşıyor. Asıl mesele mükellef olmak değil; günde onlarca sipariş alan bir işletmede faturayı her seferinde portala girip elle kesmek sürdürülebilir değil. Burada devreye e-fatura entegrasyonu giriyor: sipariş sitenize, pazaryerine ya da bayi portalınıza düştüğünde fatura kendiliğinden oluşuyor.

Bu yazıda önce 1 Temmuz 2026 geçişini kısaca özetliyoruz. Sonra asıl konuya geçiyoruz: faturayı e-ticaret sitenize, pazaryeri siparişlerinize, CRM'inize veya bayi portalınıza nasıl bağlayacağınızı, hangi modelin size uyduğunu ve nelere dikkat etmeniz gerektiğini anlatıyoruz.

Mevzuat konusunda bir not: Aşağıdaki tarih ve tutarlar yayımlanmış düzenlemelere dayanıyor ancak Gelir İdaresi zaman zaman değişiklik yapıyor. Karar vermeden önce mali müşavirinizle ve resmî kaynaklardan güncel durumu mutlaka teyit edin.

2026 e-fatura zorunluluğu: kısa özet

Güncel düzenlemeye göre 2025 hesap dönemi brüt satış hasılatı 3 milyon TL ve üzerinde olan mükelleflerin 1 Temmuz 2026 itibarıyla e-fatura uygulamasına geçmesi bekleniyor. İnternet üzerinden mal veya hizmet satan, yani e-ticaret yapan işletmeler için eşik daha düşük: brüt satış hasılatı 500 bin TL ve üzerinde olanlar da aynı tarihte kapsama giriyor.

Pratikte bunun anlamı şu: Küçük ölçekli bir online mağazanız olsa bile, siteniz ya da pazaryeri mağazanız üzerinden satış yapıyorsanız eşiği aşma ihtimaliniz yüksek. Eşiği sonraki yıllarda aşan işletmeler için de genellikle izleyen yılın belirli bir tarihine kadar geçiş süresi tanınıyor.

E-fatura ile e-arşiv fatura farkı ve kimler zorunlu?

İki kavram sık karıştırılıyor, oysa ayrım basit: Faturayı kime kestiğinize bakın.

• E-fatura: Alıcı da e-fatura mükellefiyse kullanılır. Fatura, GİB sistemi üzerinden doğrudan alıcının e-fatura kutusuna düşer. Tipik örnek: bayinize ya da kurumsal müşterinize kestiğiniz fatura.
• E-arşiv fatura: Alıcı e-fatura mükellefi değilse, özellikle bireysel müşterilerde kullanılır. Fatura elektronik ortamda oluşturulur, müşteriye e-posta veya SMS ile iletilir, GİB'e raporlanır.

E-ticaret sitenizde müşterilerin büyük kısmı bireysel olduğu için en çok e-arşiv kesersiniz. Ama aynı sitede şirket adına alışveriş yapan bir müşteri de olabilir. İyi kurulmuş bir e-arşiv fatura entegrasyonu, alıcının vergi numarasını sorgulayıp e-fatura mükellefi mi değil mi kendisi anlar ve doğru belge türünü seçer. Bu kontrolü elle yapmak, hata yapmanın en kolay yoludur.

E-fatura mükellefi olan işletmeler e-arşiv uygulamasına da geçmekle yükümlüdür. Yani 2026'da kapsama giriyorsanız iki tarafı birlikte planlamalısınız. E-ticaret sitelerinin diğer yasal yükümlülükleri için e-ticaret sitesi yasal zorunlulukları yazımıza da göz atabilirsiniz.

E-fatura entegrasyonu için 4 bağlantı modeli

Faturayı sisteme bağlamanın dört temel yolu var. Hangisinin size uygun olduğu sipariş hacminize ve kullandığınız yazılıma bağlı.

1. GİB e-Arşiv Portal (ücretsiz, elle)

Gelir İdaresi'nin portalından faturayı tek tek elle kesersiniz. Maliyeti yoktur ama otomasyon da yoktur. Ayda birkaç fatura kesen işletmeler için yeterli olabilir; günlük sipariş alan bir e-ticaret sitesi için pratik değildir.

2. Özel entegratör API'si

GİB'den izinli özel entegratörlerin sunduğu API'ler üzerinden yazılımınız faturayı doğrudan oluşturur ve gönderir. E-fatura API entegrasyonu en esnek yöntemdir; özel yazılım, CRM ve bayi portalı bağlantılarının neredeyse tamamı bu yolla yapılır.

3. Hazır altyapı eklentisi

ikas, Ticimax, IdeaSoft, WooCommerce gibi altyapılarda belirli entegratörlerle çalışan hazır modüller bulunur. API anahtarını girip birkaç ayar yaparak çalışmaya başlarsınız.

4. Özel geliştirme

Hazır eklentinin karşılamadığı kurallar varsa (bayiye özel iskonto, kısmi sevkiyat, farklı depolardan çıkış, döviz faturası gibi) entegratör API'si üzerine size özel bir katman yazılır.

Özel entegratör seçimi: nelere bakmalısınız?

Entegratör, faturanızın teknik taşıyıcısıdır. Yanlış seçim, aylar sonra fark edilen ve değiştirmesi zahmetli bir sorundur. Özel entegratör seçimi yaparken şu soruları sorun:

1. Kullandığınız altyapıyla hazır entegrasyonu var mı? Altyapınızın uygulama mağazasında listelenen entegratörler kurulumu ciddi şekilde kısaltır.
2. API dokümantasyonu açık ve güncel mi? Özel yazılım bağlayacaksanız bir test ortamı (sandbox) sunup sunmadığını sorun.
3. Kontör modeli nasıl? Belge başı mı, yıllık paket mi? Kullanılmayan kontör sonraki yıla devrediyor mu?
4. Hangi belgeleri kapsıyor? E-fatura ve e-arşivin yanında ileride e-irsaliye, e-müstahsil veya e-SMM gerekebilir. Hepsini aynı yerde toplamak işinizi kolaylaştırır.
5. Destek kanalı ne kadar ulaşılabilir? Fatura gönderilemediğinde telefonla birine ulaşabilmek önemlidir.
6. Arşivleme ve çıkış koşulları: Ayrılmak isterseniz geçmiş faturalarınızı toplu olarak alabiliyor musunuz?

Kontör maliyetleri hakkında

Entegratörler genellikle kontör (belge başına kredi) veya yıllık paket mantığıyla fiyatlandırır. Bir faturanın birden fazla kontör harcayabildiği durumlar olabilir, sözleşmede bunu netleştirin. Gösterge olarak, düşük hacimli işletmeler için yıllık paketler birkaç bin TL seviyesinden başlayabilir; yüksek hacimde belge başı maliyet düşer. Bu tamamen kaba bir göstergedir, kesin fiyat değildir; entegratör, paket ve kampanyaya göre ciddi farklar oluşur. Teklif alırken kurulum ücreti, yıllık lisans ve ek modülleri ayrı ayrı sorun.

Altyapıya göre kurulum adımları: ikas, Ticimax, WooCommerce

Hazır altyapılarda e-ticaret e-fatura entegrasyonu birbirine benzer bir akışla ilerler. Menü adları değişse de mantık aynıdır.

ikas ve Ticimax gibi SaaS altyapılarda

1. Altyapının uygulama veya entegrasyon mağazasında desteklenen entegratörleri listeleyin.
2. Seçtiğiniz entegratörle sözleşme yapın, e-fatura ve e-arşiv başvurunuzu tamamlayın.
3. Entegratörden aldığınız kullanıcı bilgisi veya API anahtarını panele girin.
4. Fatura seri önekini, şablonu, logo ve banka bilgilerini tanımlayın.
5. Faturanın hangi anda kesileceğini seçin: sipariş onayında mı, kargoya verildiğinde mi?
6. KDV oranlarının ürün bazında doğru tanımlı olduğunu kontrol edin.
7. Test siparişiyle bir bireysel, bir kurumsal fatura deneyin.

WooCommerce'te

WooCommerce açık kaynak olduğu için seçenek fazla, kalite farkı da fazla. Entegratörün resmî eklentisini tercih edin; tanınmayan üçüncü taraf eklentilerde güncelleme sonrası bozulma riski yüksektir. Kurumsal müşteriler için ödeme sayfasına vergi numarası ve vergi dairesi alanı ekleyin; bu alan olmadan e-fatura mükellefi sorgusu yapılamaz. Eklenti güncellemelerini önce test ortamında denemek, canlı sitede faturaların durmasını önler.

Pazaryeri siparişleri

Trendyol, Hepsiburada gibi pazaryerlerinden gelen siparişlerin faturası da sizin sorumluluğunuzdadır. Siparişleri tek panelde toplayan bir yapınız varsa faturayı oradan kesip faturayı pazaryerine geri yüklemek en temiz yoldur. Bu konuyu pazaryeri entegrasyonu yazımızda ayrıntılı ele aldık.

Özel yazılım, CRM ve bayi portalına e-fatura API entegrasyonu

Satışınız sitede değil de bir teklif sisteminde, CRM'de veya bayi portalında gerçekleşiyorsa hazır eklenti işe yaramaz. Burada entegratörün API'siyle doğrudan konuşan bir modül gerekir. Tipik akış şöyledir:

1. Tetikleyici belirlenir: Teklif onaylandığında mı, sipariş sevk edildiğinde mi fatura kesilecek?
2. Veri eşleştirilir: Cari kart, vergi numarası, ürün kodu, birim, KDV oranı ve iskontolar entegratörün beklediği formata (UBL-TR) dönüştürülür.
3. Mükellef sorgusu: Alıcının e-fatura mükellefi olup olmadığı sorgulanır, belge türü otomatik seçilir.
4. Gönderim ve durum takibi: Fatura gönderilir, entegratörden gelen durum (başarılı, hatalı, alıcı reddetti) sisteme yazılır.
5. Hata kuyruğu: Gönderilemeyen faturalar bir listede toplanır ve sorumlu kişiye bildirim gider.

Bayi portallarında sık görülen ihtiyaçlar kısmi sevkiyat, bayiye özel fiyat listesi ve toplu dönem sonu faturasıdır. Bunlar hazır eklentilerin genellikle kapsamadığı kurallardır. Portal tarafını merak ediyorsanız B2B bayi portalı yazımız iyi bir başlangıç olur. Müşteri ve teklif verinizi zaten bir CRM'de tutuyorsanız faturayı da oradan tetiklemek, aynı bilgiyi iki kez girmenizi engeller; temelleri için CRM nedir yazısına bakabilirsiniz.

İyi bir entegrasyonun ölçüsü, faturanın kesilmesi değil; kesilemediğinde bunu kimin, ne zaman fark ettiğidir.

Sık yapılan hatalar ve cezalar

Entegrasyon kurulduktan sonra sorunlar genellikle aynı yerlerden çıkar:

• Yanlış belge türü: E-fatura mükellefine e-arşiv kesmek veya tersi. Mükellef sorgusu otomatik değilse bu hata kaçınılmazdır.
• KDV oranı hataları: Ürün kartında eski oran kalması, kargo bedelinin yanlış oranla faturalanması.
• Fatura zamanlaması: Faturanın yasal süresi içinde düzenlenmemesi. Sevkiyat geciktiğinde faturanın da beklemede kalması bu riski doğurur.
• İade süreçlerinin unutulması: İade faturası veya iptal akışının tanımlanmaması, muhasebede tutarsızlık yaratır.
• Numara çakışmaları: Hem portal hem entegrasyon üzerinden aynı seriyle fatura kesmek.
• Kontör takibinin yapılmaması: Kampanya günü kontör bitip siparişlerin faturasız kalması.

Cezalar tarafında, e-belge düzenleme zorunluluğuna uymamak Vergi Usul Kanunu kapsamında özel usulsüzlük cezası gerektirebilir. Ceza tutarları her yıl yeniden değerleme oranıyla güncellendiği için burada rakam vermiyoruz; geçerli tutarları mali müşavirinize veya GİB'in güncel duyurularına danışın. Önemli olan şu: Zorunlu olduğunuz halde kâğıt fatura düzenlemek, belgenin hiç düzenlenmemiş sayılmasına yol açabilir.

E-fatura entegrasyonu maliyeti ve süresi

Maliyet iki kalemden oluşur: entegratöre ödenen kontör veya lisans bedeli ve bağlantıyı kurmanın emeği.

Bu tablo yalnızca kaba bir yönlendirmedir, kesin fiyat değildir. Gerçek maliyeti belirleyen şeyler; kaç satış kanalınız olduğu, iade ve kısmi sevkiyat kuralları, döviz faturası ihtiyacı ve mevcut yazılımınızın veri yapısının ne kadar düzenli olduğudur. Ürün kartlarında KDV ve birim bilgisi tutarsızsa, entegrasyondan önce veri temizliği yapmak gerekir ve bu da süreye eklenir.

Fietto Creative olarak e-ticaret ve bayi portalı projelerinde fatura bağlantısını genellikle projenin baştan bir parçası olarak ele alıyoruz; sonradan eklemek, sipariş akışını yeniden düşünmeyi gerektirebiliyor. Sitenizi kuruyor ya da yeniliyorsanız e-ticaret sitesi planlamasına faturayı da dahil edin. Mevcut teklif, sipariş veya bayi sisteminize bağlantı gerekiyorsa işletmeye özel yazılım tarafında ihtiyacınızı birlikte netleştirebiliriz.

Geçiş için kısa kontrol listesi

• 2025 brüt satış hasılatınızı mali müşavirinizle kontrol edin, kapsamda olup olmadığınızı netleştirin.
• Faturayı hangi sistemlerden keseceğinizi listeleyin: site, pazaryeri, CRM, bayi portalı.
• Altyapınızla uyumlu en az iki entegratörden teklif alın.
• Ödeme sayfasına vergi numarası ve vergi dairesi alanını ekleyin.
• Ürün kartlarında KDV oranlarını ve birimleri gözden geçirin.
• Bireysel, kurumsal, iade ve iptal senaryolarını test edin.
• Hata bildirimlerini ve kontör uyarısını kimin takip edeceğini belirleyin.

Bu adımları geçiş tarihinden önce tamamlarsanız 1 Temmuz 2026 sizin için takvimde sıradan bir gün olur. Hangi modelin size uyduğundan emin değilseniz bizimle iletişime geçin, mevcut sisteminize bakıp en sade yolu birlikte belirleyelim.

Sık sorulan sorular