Faturatik E-Arşiv Fatura Entegrasyonu

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

  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

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

26 février 2026
Sitemizde aktif olarak kullanıyoruz ve fatura süreçlerimizi ciddi anlamda kolaylaştırdı. Siparişlerin otomatik olarak e-Arşiv faturaya dönüşmesi sayesinde manuel işlem ihtiyacı ortadan kalktı ve operasyonel yükümüz azaldı. Kurulumu kolay ve günlük kullanımda sorunsuz çalışıyor
Lire l’avis

Contributeurs/contributrices & développeurs/développeuses

« Faturatik E-Arşiv Fatura Entegrasyonu » est un logiciel libre. Les personnes suivantes ont contribué à cette extension.

Contributeurs

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_company doluysa 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 firstName ve lastName alanları ayrı ayrı eklendi
  • Geliştirme: API isteğine company alanı eklendi
  • Geliştirme: Adres alanları düzenlendi — address_2, postcode ve country artık ayrı ayrı iletilmektedir
  • Düzeltme: API şemasında bulunmayan customerType alanı 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: 0 artık doğru şekilde API’ye iletilmektedir; array_filter kullanımı kaldırıldı

1.4.4

  • Düzeltme: Ürün veya kargo kalemine vergi sınıfı atanmışsa taxRate alanı artık her zaman gönderilmektedir; vergi oranı bilinçli olarak %0 tanımlanmışsa taxRate: 0 iletilir
  • Düzeltme: Ürüne hiç vergi sınıfı atanmamışsa taxRate alanı 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‘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