WooCommerce E-Fatura Entegrasyonu Nasıl Yapılır? (2026 Rehberi)

WooCommerce e-fatura entegrasyonu, online mağazanızda oluşturulan siparişlerin e-fatura veya e-arşiv faturası olarak GİB mevzuatına uygun şekilde otomatik gönderilmesini sağlayan sistem bütünüdür.

• GİB onaylı özel entegratörler, e-fatura gönderimini API üzerinden gerçekleştirir.
• E-arşiv faturası, e-faturadan farklı olarak alıcıya elektronik veya kâğıt ortamda iletilebilir.
• Türkiye'de faturanın mal veya hizmet teslimini izleyen yedi gün içinde düzenlenmesi gerekir.
• WooCommerce e-fatura eklentileri, sipariş durumunu fatura kesme tetikleyicisi olarak kullanır.

Daha fazlası için WooCommerce Trendyol entegrasyonu rehberi sayfamıza göz atabilirsiniz.

WooCommerce E-Fatura Entegrasyonu Nedir ve Neden Gereklidir?

WooCommerce e-fatura entegrasyonu, mağazanızda tamamlanan her siparişin faturasını GİB mevzuatına uygun olarak otomatik şekilde oluşturan ve ileten bir sistem bütünüdür.

WooCommerce, dünya genelinde en yaygın kullanılan e-ticaret altyapılarından biridir. Fatura süreçleri ise Türkiye'de Gelir İdaresi Başkanlığı tarafından düzenlenmektedir. E-fatura entegrasyonu, bu iki tarafı buluşturan yapıdır. Böylece satış sonrası fatura kesme işlemi manuel uğraş olmadan gerçekleşir.

Türkiye'de e-fatura zorunluluğu, ciro sınırını aşan işletmeler için geçerlidir. 2026 itibarıyla sınırlar güncellenmiş olsa da e-faturaya geçmek sadece zorunluluk değil, operasyonel bir avantajdır. Otomatik fatura kesimi, muhasebe hatalarını azaltır ve zaman kazandırır. Bu nedenle birçok küçük işletme de gönüllü olarak sisteme geçmektedir.

Manuel fatura kesme sürecinde sipariş, kargo ve muhasebe kayıtlarının eşleşmesi gerekir. E-fatura entegrasyonu bu eşleşmeyi otomatik yapar. Sipariş tamamlandığında fatura oluşturulur, GİB'e bildirilir ve müşteriye iletilir. Bu da müşteri deneyimini iyileştirir ve tahsilat sürecini hızlandırır.

E-Fatura Entegrasyonu İçin Hangi Gereksinimler Gerekir?

E-fatura entegrasyonu için öncelikle GİB'e kayıt, mali mühür veya e-imza, WooCommerce uyumlu bir e-fatura eklentisi ve GİB onaylı bir özel entegratör hesabı gereklidir.

E-fatura entegrasyonu için öncelikle GİB e-fatura sistemine kayıt olmanız gerekir. Başvuru, Gelir İdaresi Başkanlığı üzerinden yapılır. Başvuru sonrası size özel entegratör veya doğrudan entegrasyon yöntemi sunulur. Çoğu işletme, teknik işlemleri ve yasal yükümlülükleri azalttığı için özel entegratörü tercih eder.

Mali mühür ya da e-imza, e-fatura göndermek için gereken güvenlik unsurlarıdır. Özel entegratör kullanıldığında bu mühür entegratör tarafında tutulur. Sizin ek donanım almanız gerekmez. Ancak doğrudan entegrasyonda mali mühür temini zorunludur. Bu da ek maliyet anlamına gelir.

Teknik tarafta barındırma hizmetinizin SSL sertifikasına sahip olması gerekir. Ayrıca mağazanızın güncel bir PHP sürümüyle çalışması beklenir. E-fatura eklentileri API üzerinden çalıştığı için sunucunuzun uzak adreslere erişim izni olmalıdır. Bu gereksinimleri barındırma sağlayıcınızla doğrulamanız önemlidir.

Eklenti seçimi de gereksinimler arasındadır. Türkiye pazarında e-fatura eklentisi sunan çeşitli firmalar vardır. Bu eklentiler; sipariş listesi, fatura önizleme ve otomatik gönderim gibi özellikler sunar. WooCommerce altyapınızla uyumlu ve aktif olarak desteklenen bir eklenti seçmelisiniz.

WooCommerce E-Fatura Entegrasyonu Adım Adım Nasıl Yapılır?

WooCommerce e-fatura entegrasyonu; özel entegratörden alınan API bilgilerinin eklentiye tanıtılması, fatura senaryolarının belirlenmesi, testlerin yapılması ve canlı sisteme geçilmesi aşamalarından oluşur.

İlk adım, GİB onaylı bir özel entegratörden hesap açmaktır. Entegratörler; kullanıcı adı, şifre ve API anahtarı gibi bilgileri size iletir. Bu bilgiler mağazanız ile entegratör sistemi arasında kimlik doğrulaması yapar. Ayrıca entegratörün test ortamına da erişim sağlarsınız. Hesap açarken e-fatura mı yoksa e-arşiv mi kullanacağınızı belirlemeniz gerekir.

İkinci adım, WooCommerce eklentisini kurup API bilgilerini girmektir. Eklenti ayarları bölümünde entegratörün verdiği bilgiler ilgili alanlara yazılır. Burada test ortamı ile prodüksiyon ortamı ayarlarını karıştırmamak önemlidir. Yanlış ortam seçimi, faturaların gerçek sistemden değil test sisteminden geçmesine neden olur.

Üçüncü adım, fatura senaryosunu doğru yapılandırmaktır. B2B satışlarda e-fatura, B2C satışlarda ise e-arşiv faturası kullanılır. Aynı mağazada iki senaryo birlikte çalışabilir. Müşterinin vergi numarası olup olmamasına göre sistem otomatik seçim yapabilir. Bu kuralın doğru tanımlanması yasal uyumluluk için şarttır.

Dördüncü adım, test ortamında birkaç deneme faturası kesmektir. Test faturaları, entegratörün test ekranından görüntülenebilir. Ayrıca iade ve düzeltme faturalarını da denemeniz önerilir. Böylece canlıya geçmeden önce süreçteki aksaklıkları tespit edersiniz. Bu testler hata maliyetlerini ciddi şekilde düşürür.

Beşinci adım, entegratörün onayıyla canlı sisteme geçmektir. Eklenti ayarındaki ortam seçimi prodüksiyona çevrilir ve ilk gerçek fatura kesilir. Bu aşamada birkaç siparişi gözlemleyerek her şeyin doğru çalıştığını doğrulayın. Sorunsuz görünüyorsa entegrasyonu tamamlanmış sayabilirsiniz.

E-Fatura Entegrasyonunda Dikkat Edilmesi Gerekenler Nelerdir?

E-fatura entegrasyonunda doğru senaryo seçimi, iade ve düzeltme faturalarının yapılandırılması ve e-arşiv kayıtlarının yasal süre boyunca saklanması büyük önem taşır.

Faturanın hangi senaryoyla kesileceğini doğru belirlemek en kritik konulardan biridir. Kurumsal müşteriye e-arşiv faturası kesilirse sistem hata dönebilir veya ceza söz konusu olabilir. Eklentinizin otomatik senaryo belirleme desteğini etkinleştirmeniz önerilir. Böylece müşteri bilgilerine göre doğru fatura tipi seçilir.

İade ve düzeltme faturaları da entegrasyon kapsamında düşünülmelidir. WooCommerce üzerinden yapılan iadelerde sistem iade faturasını otomatik oluşturmalıdır. Bu işlem manuel yapılırsa dönem kapanışlarında eşleşme sorunları yaşanır. İade faturaları orijinal faturaya referans vererek kesilmelidir.

Vergilendirme anı ve fatura kesme süresi Türk mevzuatında açıkça belirlenmiştir. Faturanın, mal veya hizmet teslimini izleyen yedi gün içinde düzenlenmesi gerekir. E-fatura sistemlerinde bu süre genellikle dakikalara iner. Otomasyon sayesinde gecikme cezası riski neredeyse ortadan kalkar.

E-arşiv faturalarının saklanma zorunluluğu on yıldır. Bu kayıtların bulutta ya da güvenli bir sunucuda yedeklenmesi gerekir. Ayrıca e-fatura mükellefleri için yıllık berat dosyalarının GİB'e iletilmesi de yükümlülükler arasındadır. Entegratörünüz bu süreci genellikle otomatik yürütür.

E-Fatura Entegrasyonunda Sık Karşılaşılan Hatalar ve Çözümleri

Sık karşılaşılan hatalar; eksik API bilgisi, yanlış senaryo seçimi, müşteri bilgisi eksikliği ve test yapılmadan canlıya geçmek olarak öne çıkar.

En sık görülen hata, API bilgilerinin eksik ya da hatalı girilmesidir. Bu durumda eklenti entegratöre bağlanamaz ve faturalar kuyrukta bekler. Ayarları kontrol ederken boşluk ve karakter hatalarına dikkat edin. Ayrıca şifre değişikliği yapıldıysa eklenti ayarlarını güncelleyin.

Yanlış senaryo seçimi de yaygın bir sorundur. Özellikle e-fatura kapsamına giren bir müşteriye e-arşiv gönderilirse GİB tarafında uyumsuzluk oluşur. Bu durumu önlemek için sistemin vergi kimlik numarasını otomatik algılaması gerekir. Eklentinin bu özelliği destekleyip desteklemediğini kontrol edin.

Müşteri bilgilerinin eksik olması da fatura gönderimini engeller. E-fatura için vergi kimlik numarası zorunludur. WooCommerce mağazanızda bu alanı zorunlu hale getirin. Böylece müşteri bilgileri tam girilmeden sipariş tamamlanamaz.

Bazı işletmeler test yapmadan canlıya geçer ve sonrasında fatura kayıpları yaşar. Oysa test ortamında yapılan birkaç deneme, sürecin sağlıklı olduğunu gösterir. Canlıya geçiş sonrası faturalarda hata görürseniz entegratörün teknik destek hattına başvurun. Sorunun çözümü genellikle eklenti ayarlarında yapılır.

WpAsis profesyonel destek hizmeti ürününü inceleyebilirsiniz.