WooCommerce Otomatik Fatura ve E-Arşiv Entegrasyonu Nasıl Yapılır?

WooCommerce mağazasında sipariş sayısı arttıkça her sipariş için fatura bilgilerini elle kopyalamak hem zaman kaybına hem de hataya yol açabilir. WooCommerce e-Arşiv entegrasyonu veya e-Fatura bağlantısı, sipariş verilerinin uygun bir belge düzenleme sistemine aktarılmasını ve süreçlerin kontrollü yürütülmesini kolaylaştırabilir. Ancak faturalandırma yalnızca ‘Sipariş tamamlandı’ durumunda PDF üretmekten ibaret değildir. Müşterinin e-Belge durumunun, vergi bilgilerinin, ürün vergilerinin, iptal-iade akışlarının ve güncel mevzuatın birlikte ele alınması gerekir.

e-Fatura ve e-Arşiv Fatura arasındaki fark

Türkiye’de e-Fatura ve e-Arşiv Fatura farklı elektronik belge uygulamalarıdır. Hangi belgenin düzenlenmesi gerektiği mükellefin ve alıcının durumuna, işlemin niteliğine ve yürürlükteki düzenlemelere bağlıdır. WooCommerce müşterisinin kurumsal veya bireysel olması tek başına her durumda belge türünü otomatik belirlemeye yetmeyebilir. İşletmenin e-Belgeye geçiş yükümlülüğü, izinleri ve istisnaları muhasebeci ya da mali müşavirle netleştirilmelidir. Gelir İdaresi Başkanlığı e-Belge portalı güncel düzenlemeleri takip etmek için başlangıç noktasıdır. Entegrasyonu hukuki karar verici değil, belirlenmiş kuralları uygulayan teknik araç olarak düşünmek gerekir.

Özel entegratör seçimi nasıl yapılır?

e-Belge işlemleri için işletmenin kullanabileceği yöntemler ve özel entegratör seçenekleri GİB düzenlemelerine tabidir. Bir WooCommerce eklentisinin varlığı, o yazılımı sunan firmanın tek başına yetkili e-Belge hizmet sağlayıcısı olduğu anlamına gelmez. Kullanılacak bağlantının hangi resmî sistem veya yetkili özel entegratör üzerinden işlem yaptığını kontrol edin. Entegratörün API belgeleri, test ortamı, hata kodları, saklama ve veri güvenliği koşulları önemlidir. Belgelerin müşteriye iletilmesi, iptal veya itiraz işlemleri ve raporlama sorumlulukları sözleşmede açık olmalıdır. Hizmet maliyeti kadar teknik destek ve belge yönetimi de karşılaştırılmalıdır.

WooCommerce sipariş alanları hangi bilgileri taşımalı?

Fatura için kullanılacak müşteri adı veya unvanı, adres, ülke, vergi bilgisi, sipariş kalemleri, vergiler, indirim ve kargo tutarları doğru alanlarda tutulmalıdır. Bireysel ve kurumsal müşteri senaryolarında zorunlu bilgilerin hangi aşamada alınacağı belirlenmelidir. Her müşteriden gereksiz kişisel bilgi istemek doğru değildir; veri minimizasyonu ilkesi gözetilmelidir. WooCommerce üzerindeki özel alanlar, tema veya ödeme eklentisinin sürümüne göre farklı davranabilir. Entegrasyon testlerinde bu alanların API’ye eksiksiz ve doğru biçimde aktarıldığı doğrulanmalıdır. Faturada yer alması gereken bilgiler için mali müşavir görüşü alınmalıdır.

Fatura hangi sipariş durumunda oluşturulmalı?

Bir siparişin WooCommerce üzerinde ‘beklemede’, ‘işleniyor’ veya ‘tamamlandı’ olması işletmenin gerçek sevkiyat ve ödeme süreciyle aynı anlama gelmeyebilir. Kapıda ödeme, havale, sanal POS ve abonelik işlemleri farklı senaryolar oluşturur. Faturanın hangi hukuki zamanda düzenleneceği ayrı belirlenmeli, teknik otomasyon buna göre kurgulanmalıdır. Siparişe yalnızca ilk kez uygun duruma geçtiğinde belge oluşturulmasını sağlayan bir kimlik veya işlem kaydı tutulmalıdır. Aynı web kancasının iki kez tetiklenmesi yüzünden çift fatura oluşmaması kritik bir gereksinimdir. Başarısız işlemler tekrar denenebilir fakat daha önce üretilmiş belge yeniden oluşturulmamalıdır.

Ürün, KDV, kargo ve indirim eşleştirmeleri

Ürün satırlarının fiyatı, miktarı, vergi oranı ve indirimleri WooCommerce siparişindeki hesaplamalarla tutarlı olmalıdır. Kargo bedeli, hediye çeki, kupon ve ürün iadeleri belge toplamını etkileyebilir. Bir eklentinin her siparişi otomatik olarak aynı vergi kuralıyla faturalandırması yanlış sonuçlar doğurabilir. Ürün gruplarındaki farklı vergisel uygulamalar ve istisnalar mali müşavir tarafından tanımlanmalıdır. Entegrasyon testi sırasında toplam tutar, vergiler ve para birimi karşılaştırılmalı; yuvarlama farkları belgelendirilmelidir. Stok ve sipariş senkronizasyonu rehberimiz, sipariş verisini tek bir kaynaktan tutarlı yönetmenin önemini açıklar.

İptal, iade ve kısmi iade süreçleri

Sipariş faturalandıktan sonra müşteri ürün iadesi yapabilir veya tek bir siparişteki ürünlerden yalnızca birini geri gönderebilir. WooCommerce’deki ‘iade edildi’ işaretinin elektronik belgenin iptal edildiği veya mevzuata uygun düzeltmenin tamamlandığı anlamına gelmediği unutulmamalıdır. Belgenin durumuna ve alıcı tipine bağlı farklı süreçler olabilir. Eklenti bu iş akışlarını açıkça desteklemeli veya yetkili kullanıcıya manuel işlem yolu sunmalıdır. Kısmi iadede stok, ödeme iadesi ve fatura düzeltmesi aynı tarihte gerçekleşmeyebilir. İşletme kayıtlarında bu üç sürecin birbiriyle tutarlı olması gerekir.

PDF gönderimi ile resmî belge üretimi aynı değildir

Müşteriye e-postayla bir PDF göndermek, tek başına geçerli bir e-Fatura veya e-Arşiv Fatura düzenlendiğini kanıtlamaz. Belgenin ilgili sistemde doğru biçimde oluşturulması, gerekli doğrulama ve iletim işlemlerinin tamamlanması önemlidir. Eklentinin müşteriye gönderdiği dosya, resmî belge kaydıyla ilişkilendirilmeli; belge numarası ve durum bilgisi WooCommerce siparişinde izlenebilmelidir. Hatalı oluşan belgeler için kullanıcıya yalnızca ‘gönderildi’ mesajı vermek yerine anlaşılır hata durumu sunulmalıdır. GİB’in e-Arşiv teknik kılavuzu, belge yapısı açısından başvurulabilecek resmî kaynaklardan biridir.

API güvenliği ve kişisel veri koruması

Entegratörün API anahtarı herkese açık tema dosyasına veya tarayıcıda görülebilen JavaScript içine yazılmamalıdır. Sunucudan sunucuya güvenli bağlantı, yetki sınırlaması ve denetlenebilir işlem kayıtları tercih edilmelidir. Web kancaları doğrulanmalı; dış sistemden gelen her sipariş güncellemesi sorgusuz kabul edilmemelidir. Müşteri adresi, telefon numarası ve vergi bilgileri gibi veriler yalnızca gerekli amaçlarla ve uygun yetkilerle işlenmelidir. Günlük dosyalarına tam kişisel veri veya kimlik doğrulama anahtarlarını yazmak güvenlik riski oluşturur. Özel web yazılımı çalışmalarında sistem entegrasyonlarını güvenlik ve sürdürülebilirlik açısından birlikte değerlendiriyoruz.

Canlı kullanımdan önce test senaryoları

Bireysel alıcı, kurumsal alıcı, kuponlu sipariş, farklı KDV oranı, kargo bedeli, kapıda ödeme, iptal ve kısmi iade gibi örnekler test ortamında denenmelidir. Ödeme bildirimi iki kez geldiğinde faturanın tekrarlanmadığı doğrulanmalıdır. Entegratör geçici olarak yanıt vermediğinde sipariş kaydı kaybolmamalı, işlem kuyruğa alınabilmeli ve yetkili kullanıcıya durum gösterilmelidir. Fatura numarası, belge türü ve toplamlar muhasebe kayıtlarıyla karşılaştırılmalıdır. Eklenti veya WooCommerce güncellemesi sonrası aynı kritik senaryolar yeniden test edilmelidir. Böylece otomasyon, elle fatura kesmeye kıyasla yeni bir hata kaynağına dönüşmez.

Sonuç

WooCommerce faturalandırma otomasyonunda temel başarı ölçütü, tek tıklamayla belge oluşturmak değil, doğru belgeyi doğru zamanda ve tekrar üretmeden düzenleyebilmektir. Entegratör bağlantısı, vergi kuralları, sipariş durumu, iade süreçleri ve kişisel veri güvenliği aynı iş akışında tasarlanmalıdır. Mevzuatın değişebileceği unutulmamalı; yürürlükteki yükümlülükler mali müşavir ve güncel GİB kaynaklarından doğrulanmalıdır.