WooCommerce nedir?
WooCommerce, WordPress üzerine kurulan açık kaynaklı bir e-ticaret platformudur. Türkiye’de küçük butikten büyük markaya kadar binlerce işletme mağazasını WooCommerce ile yönetiyor — esnek tema yapısı, geniş eklenti ekosistemi ve veri sahipliği avantajları ile. Bir pazaryerinin aksine müşteriyle doğrudan siz ilişki kurarsınız: sipariş, ödeme ve müşteri verisi kendi sitenizde toplanır. Bu, faturalama tarafında önemli bir farktır — sipariş verisine bir dış API’den değil, doğrudan kendi WordPress kurulumunuzdan ulaşırsınız.
Bir-Fatura nedir?
Bir-Fatura, GİB özel entegratörü olarak çalışan bir e-fatura/e-arşiv kesim platformudur. Uygun maliyeti ve sade arayüzüyle özellikle küçük ve orta ölçekli e-ticaret işletmeleri arasında yaygın. Dikkat edilmesi gereken nokta: Bir-Fatura bir muhasebe yazılımı değil, fatura kesim katmanıdır — yani siparişinizin faturasını GİB’e doğrudan iletme yetkisine sahip bir entegratördür. Cari hesap, stok veya gelişmiş raporlama yerine, hızlı ve düşük maliyetli e-fatura/e-arşiv kesimine odaklanır.
Neden WooCommerce ve Bir-Fatura entegre edilmeli?
Türkiye’de e-ticaret yapan bir işletme için e-fatura/e-arşiv kesimi yasal zorunluluktur. WooCommerce’in kendi muhasebe modülü ise Türkiye mevzuatına uymaz. Mağazanız büyüdükçe her siparişi tek tek Bir-Fatura paneline girmek hem zaman kaybı hem hata kaynağı olur. Doğru kurulmuş bir entegrasyon şunları sağlar:
- Otomatik fatura kesimi: WooCommerce’e düşen sipariş, Bir-Fatura üzerinden otomatik e-fatura veya e-arşiv olarak kesilir.
- Doğru fatura türü: Bireysel müşteriye e-arşiv, VKN giren kurumsal müşteriye e-fatura — sistem ayrımı kendisi yapar.
- Doğru KDV uygulaması: Ürün kategorileriniz Bir-Fatura KDV oranlarıyla eşleşir, manuel düzeltmeye gerek kalmaz.
- Bireysel/kurumsal ayrımı: Checkout’ta seçim yapılır, fatura doğru türde kesilir.
- GİB uyumu: Bir-Fatura GİB entegratörü olduğu için fatura kesimi doğrudan GİB’e iletilir, manuel beyan derdi kalmaz.
Manuel akışta bir kişinin tam zamanlı işi olan fatura takibi, otomatik akışta kendiliğinden yürür.
WooCommerce Bir-Fatura entegrasyonu nasıl yapılır?
Önce iyi haber: Bir-Fatura’nın WooCommerce için bir eklentisi var. Yani bu kombinasyonda araya ayrı bir orchestration platformu veya custom köprü kurma zorunluluğu çoğu senaryoda yok — sipariş verisi pazaryerinde olduğu gibi bir dış API’den çekilmez, doğrudan kendi WooCommerce kurulumunuzdan eklenti aracılığıyla Bir-Fatura’ya gider. Ama eklentiyi WordPress’e kurmak işin sadece görünen kısmı. Zeisoft olarak entegrasyonu uçtan uca şöyle kuruyoruz:
- Mevcut süreci inceliyoruz: Sipariş hacminiz, ödeme tipleriniz ve fatura kurallarınız belirleniyor.
- Eklentiyi kuruyoruz: Bir-Fatura WooCommerce eklentisini WordPress’e kurup API erişimini açıyor, tema/eklenti çakışmalarını çözüyoruz.
- Fatura kurallarını tanımlıyoruz: Müşteri tipi ayrımı (e-arşiv/e-fatura), KDV haritalaması ve fatura tetikleme statüsü Bir-Fatura tarafında kurgulanıyor.
- Limit yönetimini kuruyoruz: Bir-Fatura’nın istek kapasitesine takılmamak için kuyruk ve otomatik yeniden deneme mekanizması ekliyoruz.
- Test ediyoruz: Gerçek 5-10 sipariş üzerinde — bireysel, kurumsal, iade — fatura kesimini doğruluyoruz.
- Bakım veriyoruz: Eklenti sürümü, Bir-Fatura tarafı ve WordPress core güncellemelerini takip etmek bakım anlaşmasıyla bizde kalır.
Bir-Fatura aboneliği sizin tarafınızda kalır; biz eklenti kurulumu, yapılandırma, bakım ve desteği üstleniyoruz.
Sıkça karşılaşılan sorunlar
WooCommerce-Bir-Fatura akışında sahada en sık gördüğümüz dört sorun ve nasıl önlediğimiz:
- Eklenti var diye kurallar atlanıyor. Eklenti hazır olduğu için “kurdum, çalışıyor” sanılıyor; oysa müşteri tipi ayrımı veya KDV haritalaması yapılmadan kesilen faturalar yanlış çıkıyor. Çözüm: eklentiyi kurmadan önce fatura kurallarını netleştirip test ortamında doğrulamak.
- Yoğun dönemde fatura kaybı. Bir-Fatura’nın istek limitine 11.11 gibi günlerde takılınca bazı siparişlerin faturası kesilmiyor. Çözüm: siparişleri kuyruğa alıp kontrollü aralıklarla göndermek ve geçici hatalarda otomatik yeniden deneme kurmak.
- Bireysel/kurumsal karışıklığı. Checkout’ta ayrım yapılmadığında bireysel müşteri için VKN alanına TC yazılıyor, e-fatura yerine e-arşiv gerekiyor. Çözüm: checkout form’una koşullu bireysel/kurumsal alanı eklemek.
- İade sonrası fatura aktif kalması. WooCommerce’de sipariş iade/iptal edildiğinde Bir-Fatura’da fatura iptal edilmezse KDV beyanı yanlış görünür. Çözüm: kurulumda iade akışını tanımlayıp iade faturası kesim kuralını kurmak.
Dördü de kurulumda doğru tasarımla önlenebilir; sonradan düzeltmek katbekat iş yükü yaratır.