WooCommerce satışlarında fatura süreci manuel kalırsa en sık yaşanan sorunlar şunlar: yanlış alıcı bilgisi, eksik vergi alanı, geciken fatura, iade/iptalde karışıklık. Entegrasyonun amacı basit: sipariş → otomatik fatura → müşteriye iletim → arşiv/raporlama düzeni.
Bu rehber “markadan bağımsız” hazırlanmıştır: hangi özel entegratör/eklenti olursa olsun mantık aynı.
Not: Bu içerik bilgilendirme amaçlıdır. e-Belge mevzuatı ve zorunluluklar değişebilir; nihai karar için muhasebeniz/entegratörünüz ve resmi kaynakları esas alın.
1) e-Fatura mı e-Arşiv mi? Hangisi ne zaman kesilir?
Genel kuralı GİB’in özetlerinde net görürsün:
- Alıcı e-Fatura kayıtlıysa: e-Fatura,
- Alıcı e-Fatura kayıtlı değilse / nihai tüketiciyse: e-Arşiv fatura.
Ayrıca GİB’in e-Arşiv infografiğinde, e-Arşiv Portalı üzerinden düzenleme ve bazı tutar/uygulama detayları da özetleniyor.
2) Entegrasyondan önce gerekli hazırlıklar
WooCommerce tarafında sorunsuz otomasyon için şunlar şart:
- Şirket bilgileri: Unvan, VKN/TCKN, vergi dairesi, adres, e-posta
- Müşteri alanları:
- B2C (bireysel): TCKN (gerekiyorsa), ad/soyad, adres
- B2B (kurumsal): VKN, unvan, vergi dairesi, adres
- KDV/vergiler: ürünlerde doğru vergi sınıfı, kargo vergi durumu
- Sipariş statüsü kararı: Fatura hangi aşamada kesilecek? (genelde “İşleniyor/Processing” veya “Tamamlandı/Completed”)
3) 3 farklı yol var: hangisi trafik/operasyon için en mantıklı?
Yol A) GİB Portal (manuel)
GİB tarafında e-Arşiv ve e-Fatura için elektronik başvuru ekranları var.
Bu yol küçük hacimde iş görür ama WooCommerce’de “otomatik” akış için genelde yetersiz kalır.
Yol B) Özel entegratör paneli (yarı otomatik)
Siparişleri dışa aktarır, entegratör paneline yükler, oradan kesersin.
Yol C) Özel entegratör + WooCommerce eklentisi (tam otomatik) ✅
Sipariş WooCommerce’te oluşur → eklenti API ile entegratöre gönderir → fatura otomatik oluşur.
4) WooCommerce’te e-Arşiv/e-Fatura için örnek eklenti çözümleri
WordPress.org’da bu iş için farklı entegrasyonlar var; örnek olarak:
- Eafatura Kargo & e-Arşiv/e-Fatura Entegrasyonu: WooCommerce’i Eafatura ile entegre ettiğini ve API anahtarı girilerek çalıştığını belirtiyor.
- Faturatik e-Arşiv Fatura Entegrasyonu: WooCommerce siparişlerini Faturatik sistemine otomatik iletip e-Arşiv faturası oluşturduğunu söylüyor.
- Yengec.co entegrasyonu: WooCommerce’te otomatik e-Fatura/e-Arşiv fatura oluşturma sunduğunu belirtiyor.
- POS Entegratör: WooCommerce siparişlerinden otomatik e-Fatura/e-Arşiv oluşturma ve farklı sistemlerle entegrasyon iddiası var.
Seçerken kontrol listesi (çok önemli):
- Son güncellenme tarihi + aktif kurulum + destek yanıtları
- WooCommerce yeni altyapılarıyla uyum (özellikle sipariş saklama mimarileri değiştikçe entegrasyonlar etkilenebiliyor)
- “B2B alanları” (VKN/Unvan/Vergi Dairesi) checkout’ta düzgün topluyor mu?
5) Kurulum adımları (markadan bağımsız standart)
Adım 1 — Entegratörden API anahtarı al
Seçtiğin hizmet, genelde panelden API Key/Token verir (bazıları test/live ayrımı yapar).
Adım 2 — Eklentiyi kur ve bağla
- WordPress → Eklentiler → Yeni Ekle → eklentiyi kur/etkinleştir
- Eklenti ayarlarında API Key/Token’ı gir → bağlantıyı test et
(Eafatura örneğinde API anahtarı girilerek kaydedildiği yazıyor.)
Adım 3 — Checkout alanlarını düzenle (B2C/B2B)
En çok hata burada olur. Şunlar net olmalı:
- “Bireysel / Kurumsal” seçimi
- Kurumsal seçilince: VKN + Unvan + Vergi Dairesi zorunlu
- Bireyselde: Ad/Soyad + adres zorunlu (TCKN gereksinimi iş modeline göre değişebilir)
Adım 4 — Fatura kesme tetikleyicisini seç
Genelde seçenekler:
- Sipariş “İşleniyor” olunca kes
- Sipariş “Tamamlandı” olunca kes
- Manuel “Fatura Oluştur” butonu + otomatik retry
Öneri: Dijital ürün yoksa çoğu mağaza “İşleniyor” aşamasında keser; iptal/iade akışını iyi kurgular.
Adım 5 — Test siparişi oluştur
- 1 bireysel test
- 1 kurumsal test (VKN’li)
- Kargo + indirim kuponu gibi kombinasyonla 1 test daha
Faturanın:
- doğru alıcı bilgisi
- doğru KDV
- doğru toplam
- doğru ürün kalemleri
ile oluştuğunu kontrol et.
Adım 6 — Müşteriye iletim yöntemi
e-Arşiv fatura, alıcının talebine göre kâğıt veya elektronik iletilebilir; satıcı nüshası elektronik ortamda muhafaza/ibraz edilir.
Pratikte çoğu entegratör e-posta ile PDF/UBL iletim seçenekleri sunar.
6) İptal / iade / tekrar kesim akışı
WooCommerce’de sık senaryolar:
- Sipariş iptal edildi → faturayı iptal et / iade faturası oluştur
- Kısmi iade → kısmi iade faturası/iadeye uygun belge
- Aynı siparişe iki kez fatura → “duplicate” kontrolü
Bu kısım entegratöre göre değişir; ama senin sitede içerik olarak çok aranan bir başlık: “WooCommerce iade/iptal faturası nasıl yönetilir?” (istersen bunu ayrı yazıya çevirelim).
7) En sık hatalar ve hızlı çözümler
1) “Fatura oluşmadı”
- Sipariş statüsü tetikleyiciyle eşleşmiyor → statüyü kontrol et
- API anahtarı geçersiz/limit → entegratör panelinden log bak
- Sunucu cron/timeout → yeniden deneme (retry) ve loglama aç
2) “Vergi/KDV yanlış”
- WooCommerce vergi ayarları ve ürün vergi sınıfları yanlış
- Kargo vergi durumu yanlış
3) “Kurumsal müşteri VKN/Unvan gelmiyor”
- Checkout’ta alanlar yok / zorunlu değil
- B2B seçeneği yoksa eklenti yanlış veri alır
4) “Müşteriye mail gitmiyor”
- WordPress’in mail altyapısı zayıf olabilir → WP Mail SMTP içerimizi kullan (sitede zaten var)
8) İç link önerisi (SEO + kullanıcı tutma)
Bu yazıdan şunlara link ver:
- WP Mail SMTP Kurulumu (2026)
- Cloudflare Ayarları (2026)
- WordPress Yedek Alma Rehberi (2026)
- WordPress Hata Kodları (2026)
SSS
WooCommerce’te e-Fatura/e-Arşiv entegrasyonu şart mı?
Zorunluluk durumun işletmene göre değişir; ama e-ticarette operasyon için otomasyon ciddi zaman kazandırır.
Hem e-Fatura hem e-Arşiv aynı anda olur mu?
Evet; alıcı e-Fatura kayıtlıysa e-Fatura, değilse e-Arşiv mantığıyla birlikte çalışır.
Hangi eklenti daha iyi?
Tek bir “en iyi” yok; destek/uyumluluk ve senin ihtiyaçların (B2B alanları, iptal/iade senaryoları, kargo entegrasyonu) belirler. (Yukarıdaki örnek eklenti sayfalarını inceleyerek başla.)