Description
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ı
Installation
- Eklentiyi kurun ve etkinleştirin
- WooCommerce > Faturatik > E-Arşiv Fatura sekmesine gidin
- Faturatik Panel’den aldığınız API anahtarını girin ve kaydedin
- Webhook bağlantısı otomatik kurulur; bağlantıyı « Bağlantıyı Test Et » butonu ile doğrulayın
- Otomatik gönderim tetikleyicisini yapılandırın
- Kademeli kargo için WooCommerce > Ayarlar > Kargo bölümünde bir bölge oluşturun ve « Kademeli Kargo » yöntemini ekleyin
FAQ
-
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.
Avis
Contributeurs/contributrices & développeurs/développeuses
« Faturatik E-Arşiv Fatura Entegrasyonu » est un logiciel libre. Les personnes suivantes ont contribué à cette extension.
ContributeursTraduisez « Faturatik E-Arşiv Fatura Entegrasyonu » dans votre langue.
Le développement vous intéresse ?
Parcourir le code, consulter le SVN dépôt, ou s’inscrire au journal de développement par RSS.
Journal des modifications
1.4.9
- Düzeltme: WordPress Dashboard Widget’taki fatura durumu kartında « Yenile » butonu, jQuery’nin sayfada enqueue edilmemesi nedeniyle bazı kurulumlarda tepkisiz kalabiliyordu; düzeltildi
1.4.8
- Yeni: Siparişteki ek ödemeler (fee kalemleri) artık ürün gibi faturaya dahil ediliyor; vergi sınıfı atanmışsa gerçek oran, atanmamışsa %20 KDV ile gönderiliyor
1.4.7
- Yeni: Fatura alanları (Müşteri Tipi, TC, VKN, Vergi Dairesi) için 3 modlu yönetim — « Varsayılan » Faturatik kendi alanlarını ekler; « Mevcut alanlara eşle » mevcut checkout alan anahtarlarınızla çalışır (
billing_companydoluysa kurumsal sayılır); « Devre dışı » alanları gizler ve API’ye vergi/TC bilgisi göndermez - Geliştirme: Ödeme Sayfası sekmesine « Fatura Alanları » kartı eklendi; mod seçimi ve alan eşleme tek ekranda yapılıyor
1.4.6
- Geliştirme: API isteğine
firstNamevelastNamealanları ayrı ayrı eklendi - Geliştirme: API isteğine
companyalanı eklendi - Geliştirme: Adres alanları düzenlendi —
address_2,postcodevecountryartık ayrı ayrı iletilmektedir - Düzeltme: API şemasında bulunmayan
customerTypealanı kaldırıldı - Düzeltme: Siparişte ülke kodu bulunmadığında il adı « TR34 » yerine « İstanbul » olarak doğru şekilde iletilmektedir
1.4.5
- Düzeltme: %0 KDV oranı tanımlanmış ürünlerde
taxRate: 0artık doğru şekilde API’ye iletilmektedir;array_filterkullanımı kaldırıldı
1.4.4
- Düzeltme: Ürün veya kargo kalemine vergi sınıfı atanmışsa
taxRatealanı artık her zaman gönderilmektedir; vergi oranı bilinçli olarak %0 tanımlanmışsataxRate: 0iletilir - Düzeltme: Ürüne hiç vergi sınıfı atanmamışsa
taxRatealanı gönderilmez; sunucu tarafında kullanıcı varsayılan oranı uygulanır
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‘tanadmin_footer‘a taşındı —position:fixedartı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
windowfonksiyonları veonclicknitelikleriyle 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
#255fe4olarak 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ılarakKDV-20,KDV-10,KDV-1,KDV-0formatı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
taxRatealanı ile gönderilmektedir - Düzeltme: KDV kaydı bulunmayan ürün/kargo kalemlerinde
taxRatealanı 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>etiketleriwp_add_inline_script()/wp_add_inline_style()ile değiştirildi - Düzeltme:
register_setting()çağrılarınasanitize_callbackeklendi (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