Faturatik E-Arşiv Fatura Entegrasyonu

Türkiye’de WooCommerce ile satış yapıyorsanız her gün aynı döngüyle karşılaşıyorsunuzdur: sipariş geliyor, faturalamak için panele giriyorsunuz, kargoyu ayarlıyorsunuz, vergi sınıflarını tek tek düzenliyorsunuz. Faturatik eklentisi bu döngüyü kırıyor.

Asıl amacımız e-Arşiv fatura. Sipariş oluştuğu anda Faturatik’e iletiliyor, faturanız otomatik oluşturuluyor, durum webhook ile sitenize geri dönüyor. Siz sadece sipariş almaya odaklanıyorsunuz.

Bununla birlikte Türkiye’ye özgü WooCommerce eksikliklerini de tamamlıyoruz: kademeli kargo fiyatlandırması müşterileri daha fazla harcamaya teşvik ediyor, il/ilçe seçici adres hatalarını ortadan kaldırıyor, doğru KDV oranları vergi uyumunuzu garanti altına alıyor.

📄 E-Arşiv Fatura Otomasyonu

• Otomatik Gönderim – Siparişin hangi durumda (ödeme tamamlandı, işlemde, kargoya verildi…) Faturatik’e iletileceğini siz seçin
• Manuel Gönderim – Sipariş detayından tek tıkla fatura oluşturun
• Toplu Gönderim – Birden fazla siparişi aynı anda gönderin, zaman kazanın
• Fatura Durum Takibi – Sipariş listesinde ve detay sayfasında fatura durumunu anlık görün
• WordPress Dashboard Widget – Fatura oluşturulacak, imza bekleyen, hatalı ve tamamlanan sipariş sayılarını WordPress yönetim panelinde görün; tek tıkla Faturatik’e yönlenin
• Müşteri Fatura Alanları – Ödeme sayfasında Vergi No ve Vergi Dairesi; fatura bilgisi e-postada ve Hesabım’da müşterilere gösterilir
• Webhook Entegrasyonu – API anahtarı kaydedilince webhook bağlantısı otomatik kurulur; fatura durumu Faturatik’te değiştiğinde siteniz anında güncellenir
• Otomatik Tekrar Deneme – Bağlantı hatası durumunda sistem 3 kez (5 dk, 30 dk, 1 saat) kendi kendine tekrar dener
• WooCommerce HPOS Uyumlu – Yüksek performanslı sipariş depolama mimarisini tam destekler

🚚 Kademeli Kargo — Sipariş Ortalamasını Artırın

Müşteriler “biraz daha eklesem kargo bedava” düşüncesiyle sepetlerine ürün ekler. Kademeli kargo bu psikolojiyi sistematik hâle getirir.

• Kademeli Fiyatlandırma – Sepet tutarı arttıkça kargo ücreti otomatik düşer; istediğiniz kadar kademe tanımlayın
• Ücretsiz Kargo Eşiği – Belirlediğiniz tutarın üzerindeki siparişlerde kargo sıfırlanır
• İlerleme Bildirimi – Sepet ve ödeme sayfasında müşteri “Ücretsiz kargo için 45 ₺ daha ekle!” mesajını ve dolu bir ilerleme çubuğunu görür
• Kademe İpucu – “38 ₺ daha ekle, kargo 9,90 ₺ olsun!” gibi bir sonraki avantajlı kademe gösterilir
• KDV Uyumu – Kargo fiyatları KDV dahil veya hariç girilebilir; WooCommerce vergi motoruyla tam uyumlu çalışır
• Renk Özelleştirme – Bildirim ve ilerleme çubuğu renkleri marka renklerinizle eşleştirilebilir

🧮 Türkiye KDV Yönetimi

WooCommerce kurulu geldiğinde Türkiye’ye uygun vergi sınıfları tanımlı değildir. Bunu tek tıkla çözüyoruz.

• Hızlı Kurulum – %20, %10, %1 ve %0 KDV sınıfları ve Türkiye oranları otomatik oluşturulur
• Toplu KDV Atama – Kategori seçin, vergi sınıfı seçin; tüm ürünler otomatik güncellenir
• KDV Raporu – Mağazadaki ürünlerin KDV dağılımı tek ekranda, filtre gerekmez

📍 İl/İlçe Seçici

Müşteriler adres girerken il ve ilçeyi serbest metin yazarsa yanlış yazmalar, eksik bilgiler ve kargo sorunları kaçınılmaz olur.

• Ödeme ve adres sayfalarına Türkiye il/ilçe açılır menüleri eklenir
• İlçe listesi seçilen ile göre dinamik olarak yüklenir; hatalı adres girişi mümkün olmaz
• Fatura adres bilgisi de doğru biçimde Faturatik’e iletilir

✏️ Checkout Form Düzenleyici

Ödeme sayfasındaki tüm alanları kod yazmadan yönetin.

• Sürükle-Bırak Sıralama – Alan sırası tek bir ekranda, anında değişir
• Aktif/Pasif Toggle – İstemediğiniz alanı gizleyin, WooCommerce varsayılanı bozulmaz
• Zorunlu/Opsiyonel – Her alan için ayrı zorunluluk ayarı
• Etiket & Placeholder Düzenleme – Müşteriye gösterilen metni sitenizin diline uyarlayın
• Genişlik Seçimi – Tam / Sol yarım / Sağ yarım; iki sütunlu yerleşimi dilediğiniz gibi kurun
• Billing, Teslimat Adresi ve Ek Bilgiler bölümlerini destekler

⚙️ Tek Çatı Altında Yönetim

• Birleşik Panel – WooCommerce > Faturatik menüsünde tüm modüller sekme sekme; farklı ayar sayfaları arası gezinmenize gerek yok
• Ödeme Sayfası Ayarları – “Farklı adrese gönder” ve sözleşme onayı varsayılanlarını yapılandırın
• Form Düzenleyici – Checkout alanlarını sırala, gizle ve özelleştir

Gereksinimler

• WordPress 6.0 veya üzeri
• WooCommerce 8.0 veya üzeri
• PHP 8.0 veya üzeri
• Aktif bir Faturatik hesabı

1. Eklentiyi kurun ve etkinleştirin
2. WooCommerce > Faturatik > E-Arşiv Fatura sekmesine gidin
3. Faturatik Panel’den aldığınız API anahtarını girin ve kaydedin
4. Webhook bağlantısı otomatik kurulur; bağlantıyı “Bağlantıyı Test Et” butonu ile doğrulayın
5. Otomatik gönderim tetikleyicisini yapılandırın
6. Kademeli kargo için WooCommerce > Ayarlar > Kargo bölümünde bir bölge oluşturun ve “Kademeli Kargo” yöntemini ekleyin

API anahtarını nereden alabilirim?

API anahtarınızı Faturatik Panel üzerinden oluşturabilirsiniz.

Hangi fatura türleri destekleniyor?

E-Fatura ve E-Arşiv Fatura desteklenmektedir. Fatura türü, Faturatik Panel ayarlarınıza göre otomatik belirlenir.

Webhook nasıl çalışır?

1.2.0 sürümünden itibaren webhook bağlantısı otomatik kurulmaktadır. API anahtarını kaydedip “Kaydet” butonuna bastığınızda eklenti, Webhook URL ve Gizli Anahtar bilgisini Faturatik’e otomatik olarak gönderir. Herhangi bir nedenle otomatik kayıt başarısız olursa ayarlar sayfasında bir uyarı görünür; bu durumda Webhook URL ve Secret bilgisini Faturatik Panel’e manuel olarak ekleyebilirsiniz.

Sipariş gönderimi başarısız olursa ne olur?

Başarısız gönderimler otomatik olarak tekrar denenir. En fazla 3 kez (5 dakika, 30 dakika ve 1 saat aralıklarla) deneme yapılır.

Kademeli Kargo birden fazla bölgede kullanılabilir mi?

Evet. Her kargo bölgesine ayrı bir “Kademeli Kargo” yöntemi ekleyebilir, bölge başına farklı kademeler ve eşikler tanımlayabilirsiniz.

Eski WooCommerce > Ayarlar > Faturatik adresi çalışıyor mu?

1.1.0 ile birlikte bu URL otomatik olarak WooCommerce > Faturatik > E-Arşiv Fatura adresine yönlendirilmektedir.

1.4.2

• Düzeltme: “Yenilikleri Gör” modalı WooCommerce Siparişler, Ürünler ve diğer alt sayfalarında açılmıyordu; modal HTML admin_notices‘tan admin_footer‘a taşındı — position:fixed artık WooCommerce’in transform container’larından bağımsız, doğrudan <body> altında render ediliyor

1.4.1

• Düzeltme: Kademeli Kargo — “Kural Ekle” ve “Sil” butonları çalışmıyordu; admin script kaydı kargo yöntemi constructor’ından modül boot fonksiyonuna taşındı
• Düzeltme: Kademeli Kargo — kademe verileri hidden input’a artık her değişiklikte yazılıyor (ekle/sil/input), WooCommerce AJAX kaydında veri kaybı olmaz
• Düzeltme: Güncelleme bildirimi — “Yenilikleri Gör” butonu bazı admin sayfalarında çalışmıyordu; global window fonksiyonları ve onclick nitelikleriyle yeniden yazıldı
• Geliştirme: Kademeli Kargo admin arayüzü plugin birincil renk ve kart stiline uyumlu hâle getirildi

1.4.0

• Geliştirme: Eklenti genelinde birincil renk #255fe4 olarak standardize edildi; tüm admin arayüzleri (sekmeler, butonlar, ikonlar, badge’ler, progress bar) aynı renk sistemini kullanıyor
• Geliştirme: Paylaşılan admin stilleri faturatik-admin.css‘e taşındı; tüm sekmeler bu dosyayı otomatik yüklüyor — kart, badge, progress bar ve başlık bileşenleri artık merkezi olarak yönetiliyor
• Geliştirme: Tüm admin JavaScript dosyaları WordPress standardı (function($){ 'use strict'; $(function(){ ... }); })(jQuery) yapısına geçirildi
• Geliştirme: Kargo kademesi ekle/sil butonları event delegation ile yeniden yazıldı; WooCommerce Backbone.js dinamik form yüklemesinde de doğru çalışıyor

1.3.9

• Düzeltme: Güncelleme bildirimi modalı — “Yenilikleri Gör” butonu çalışmıyordu; script artık DOM hazır olduktan sonra çalışacak şekilde düzeltildi

1.3.8

• Geliştirme: KDV vergi sınıfı etiketleri güncellendi — % karakteri kaldırılarak KDV-20, KDV-10, KDV-1, KDV-0 formatına geçildi; slug uyumsuzluğu riski ortadan kalktı
• Geliştirme: Güncelleme bildirimi — Ödeme Form Düzenleyici özelliği özellikler listesine ve “Diğer Özellikler” bölümüne eklendi

1.3.4

• Düzeltme: Sipariş webhook gönderiminde ürün ve kargo fiyatları artık KDV hariç birim fiyat olarak iletilmektedir
• Düzeltme: KDV oranı artık KDV hariç tutar üzerinden hesaplanarak taxRate alanı ile gönderilmektedir
• Düzeltme: KDV kaydı bulunmayan ürün/kargo kalemlerinde taxRate alanı gönderilmemektedir; sunucu tarafında kullanıcı varsayılan oranı uygulanır

1.3.3

• Düzeltme: WordPress.org plugin incelemesi gereksinimleri — tüm inline <script> ve <style> etiketleri wp_add_inline_script() / wp_add_inline_style() ile değiştirildi
• Düzeltme: register_setting() çağrılarına sanitize_callback eklendi (faturatik_ship_diff, faturatik_terms_def)
• Düzeltme: Hatalı text domain ('woocommerce' → 'e-arsiv-fatura-enteragrasyonu') düzeltildi
• Güncelleme: WordPress 6.9 uyumluluğu onaylandı (Tested up to: 6.9)

1.3.2

• Geliştirme: Form Düzenleyici ayrı sekme olmaktan çıktı; “Ödeme Sayfası” sekmesi altına taşındı
• Geliştirme: Form Düzenleyici kartına açıklama metni eklendi
• Geliştirme: Ödeme Sayfası sekmesi UI tasarım sistemiyle (wc-kdv-card) tam uyumlu hale getirildi
• Geliştirme: Form Düzenleyici CSS sıfırdan yeniden yazıldı; tüm plugin genelinde renk ve bileşen tutarlılığı sağlandı

1.3.1

• Düzeltme: Form Düzenleyici — pasif yapılan alanlar checkout’ta yine de görünüyordu (config’de olup disabled olan alanlar “yeni alan” sanılıp yeniden ekleniyordu)
• Düzeltme: Form Düzenleyici — alan sıralaması yansımıyordu; WooCommerce filtreyi uyguladıktan sonra priority’ye göre yeniden sıralar, buna karşın priority değerleri artık config sırasına göre yeniden atanıyor

1.3.0

• Yeni: Checkout Form Düzenleyici — WooCommerce > Faturatik > Form Düzenleyici sekmesiyle ödeme sayfasındaki tüm alanları (Billing, Teslimat, Ek Bilgiler) sürükle-bırak ile sırala, aktif/pasif, zorunlu/opsiyonel, etiket, placeholder ve genişlik ayarları

1.2.0

• Yeni: WordPress Dashboard Widget — Yönetim paneli ana ekranında fatura durumu özeti; fatura oluşturulacak, imza bekleyen, hatalı ve tamamlanan sipariş sayıları tek bakışta görülür
• Yeni: Siparişler sayfası bildirimi — WooCommerce > Siparişler ekranında bekleyen fatura veya imza işlemi varsa ince bilgi bandı gösterilir
• Yeni: Otomatik webhook kaydı — API anahtarı kaydedilince Webhook URL ve Secret Faturatik’e otomatik iletilir; Manuel kurulum adımı ortadan kalkar
• Geliştirme: Fatura istatistikleri 15 dakika önbelleklenir; HPOS ve legacy sipariş depolama her ikisi desteklenir

1.1.1

• Geliştirme: Ödeme sayfasındaki “Müşteri Tipi” alanı tek satır toggle/pill buton grubuna dönüştürüldü
• Geliştirme: Kademeli Kargo ilerleme bildirimi mesajları yönetim ekranından özelleştirilebilir hale getirildi; {kalan}, {hedef}, {kademe_kalan}, {kademe_ucret} değişkenleri desteklenmektedir

1.1.0

• Yeni: Kademeli Kargo modülü — sepet tutarına göre otomatik inen kargo fiyatlandırması
• Yeni: Sepet ve ödeme sayfasında ücretsiz kargo ilerleme bildirimi ve kademe ipucu
• Yeni: Birleşik Faturatik yönetim sayfası — WooCommerce > Faturatik altında tüm modüller tek menüde
• Değişiklik: E-Arşiv Fatura ayarları WC Ayarlar sekmesinden Faturatik > E-Arşiv Fatura sekmesine taşındı
• Değişiklik: Eklentiler sayfasındaki “Ayarlar” bağlantısı yeni adrese güncellendi
• Uyumluluk: Eski WC Ayarlar > Faturatik URL’i otomatik yönlendiriliyor

1.0.1

• Düzeltme: İl bilgisinin kod (TR34 – 34) yerine doğrudan il adı olarak gönderilmesi sağlandı

1.0.0

• İlk sürüm
• Otomatik ve manuel fatura oluşturma
• Toplu gönderim desteği
• Webhook entegrasyonu
• Tekrar deneme sistemi
• Ödeme sayfası fatura alanları (Vergi No / Vergi Dairesi)
• Hesabım > Faturalarım sayfası
• E-posta ile fatura bilgisi gönderimi
• WooCommerce HPOS desteği