WD Fatura Bilgileri — Bireysel / Kurumsal
Wordpress & WooCommerce için bireysel kurumsal fatura eklentisi
by Oblifex · github.com/webdanismani/wd-fatura-bilgileri · website
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/webdanismani/wd-fatura-bilgileri/archive/refs/heads/main.zip
WooCommerce ödeme sayfasında bireysel / kurumsal fatura bilgisi seçimi.
TC kimlik no, firma ünvanı, vergi dairesi ve VKN — algoritmik doğrulama, e-Fatura mükellefi seçeneği, KVKK maskeleme. Ücretsiz ve açık kaynak.
⬇️ Son sürümü indir (ZIP) · Kurulum · Özellikler · SSS · oblifex.com
[!TIP] Bu eklenti Oblifex tarafından ücretsiz sunulur. Eklenti WordPress'e kurulduğunda yeni sürümleri kendisi bulur: GitHub'da yayınlanan her sürüm, WordPress › Eklentiler ekranında normal bir güncelleme gibi görünür ve tek tıkla kurulur.
✨ Özellik isteği Eklentide görmek istediğiniz her şeyi oblifex.com/ozellik-istegi üzerinden iletin. Öncelikli olarak değerlendirilir. 🛟 Destek Kurulum, tema ve uyumluluk soruları: oblifex.com/destek 🔄 Güncellemeler Otomatik. Elle denetlemek için Eklentiler ekranındaki Güncellemeleri denetle bağlantısını kullanın. 🧩 Özel geliştirme e-Fatura / muhasebe entegrasyonu ve mağazanıza özel çözümler için oblifex.com
Neden?
Türkiye'de fatura kesebilmek için müşteriden TC kimlik no ya da firma ünvanı + vergi dairesi + VKN almak zorunludur. Bu eklenti bu bilgileri ödeme sırasında doğru ve eksiksiz toplar: resmi kontrol hanesi algoritmalarıyla anında doğrular, 1.047 vergi dairesi arasından aranabilir seçim sunar, siparişe, e-postalara ve yönetim ekranlarına işler.
Özellikler
Bireysel fatura
- TC kimlik numarası: gizli · isteğe bağlı · zorunlu · belirli sipariş tutarının üzerinde zorunlu
- Resmi algoritma ile anlık doğrulama (istemci + sunucu)
- "TC kimlik numaram yok" seçeneği (yabancı uyruklu →
11111111111)
Kurumsal fatura
- Firma ünvanı (WooCommerce
billing_companyalanına yazılır) - 1.047 vergi dairesi ve malmüdürlüğü arasından aranabilir seçim; müşterinin ilindeki daireler üstte
- 10 haneli VKN veya şahıs şirketleri için 11 haneli TCKN — otomatik tanıma ve doğrulama
- e-Fatura mükellefi seçeneği
Mağaza tarafı
- Sipariş ekranında doğrulama durumlu fatura kutusu ve düzenlenebilir alanlar
- Sipariş listesinde Bireysel / Kurumsal ve e-Fatura sütunu
- Kurumsal siparişlerde fatura adresine VKN ve vergi dairesi satırı
- Sipariş e-postaları ve sipariş detay sayfasında fatura bilgileri
- e-Fatura / muhasebe eklentileri için ek meta anahtarları tanımlama
- KVKK: müşteriye giden içerikte TCKN maskeleme; WordPress kişisel veri dışa aktarma ve silme desteği
- Hesabım › Fatura adresi desteği · HPOS uyumlu
- Mobilde alttan açılan seçim paneli
- WD Türkiye Adres ile aynı tasarım dili — birlikte kullanıldığında tek parça görünür
Kurulum
Seçenek 1 — ZIP (önerilen)
- Son sürümü indirin.
- WordPress › Eklentiler › Yeni Ekle › Eklenti Yükle ile ZIP'i yükleyip etkinleştirin.
- WooCommerce › Fatura Bilgileri sayfasından ayarları yapın.
- Ödeme sayfanız blok tabanlıysa Uyumluluk sekmesinden klasik yapıya dönüştürün.
Seçenek 2 — git
cd wp-content/plugins
git clone https://github.com/oblifex/wd-fatura-bilgileri.git
Güncellemeler her iki kurulumda da WordPress panelinden gelir. Deponun
maindalı geliştirme sürümüdür; kararlı sürümler için Releases sayfasına bakın.
Gereksinimler
| En az | |
|---|---|
| WordPress | 6.0 |
| WooCommerce | 7.0 (HPOS destekli) |
| PHP | 7.4 |
| Ödeme sayfası | Klasik [woocommerce_checkout] — blok sayfa tek tıkla dönüştürülür |
Ayarlar
WooCommerce › Fatura Bilgileri altında altı sekme:
| Sekme | İçerik |
|---|---|
| Genel | Etkinleştirme, varsayılan fatura tipi, fatura özeti, adrese VKN satırı, e-posta tablosu, sipariş listesi sütunu |
| Bireysel | TCKN modu (gizli / isteğe bağlı / zorunlu / tutar eşiği), "TCKN yok" seçeneği |
| Kurumsal | Ünvan, vergi dairesi ve VKN zorunlulukları, e-Fatura mükellefi seçeneği |
| Görünüm | Açık/koyu/otomatik tema, vurgu rengi, köşe |
| Uyumluluk & KVKK | Ödeme sayfası yapısı, HPOS, TCKN maskeleme, ek meta anahtarları |
| Araçlar | Hızlı TCKN / VKN doğrulayıcı, veri sürümü |
Sipariş meta anahtarları
_billing_wdfb_tip bireysel | kurumsal
_billing_wdfb_tc TC kimlik no (bireysel)
_billing_wdfb_vkn VKN veya şahıs şirketi TCKN (kurumsal)
_billing_wdfb_vd Vergi dairesi adı
_billing_wdfb_vd_kod Vergi dairesi kodu (GİB)
_billing_wdfb_efatura 1 | 0
Firma ünvanı WooCommerce'in standart billing_company alanındadır. Ayarlardan e-Fatura / muhasebe eklentilerinizin beklediği ek anahtarlar tanımlayabilirsiniz.
SSS
Numaralar gerçekten var mı diye kontrol ediliyor mu?Hayır. Numaralar resmi kontrol hanesi algoritmasıyla doğrulanır; bu, yanlış yazılan numaraların büyük çoğunluğunu yakalar ancak numaranın bir kişiye/şirkete ait olduğunu garanti etmez.
e-Fatura eklentim farklı meta anahtarları bekliyor.Uyumluluk & KVKK sekmesinde her alan için ek anahtar tanımlayabilirsiniz; sipariş kaydedilirken aynı değer o anahtarlara da yazılır. Entegrasyonunuz listede yoksa özellik isteği açın.
TC kimlik no e-postalarda görünüyor mu?Müşteriye giden e-postalarda ve sipariş detay sayfasında maskelenir (123••••••45); yönetici e-postaları ve sipariş ekranı tam değeri gösterir. Uyumluluk & KVKK sekmesinden kapatılabilir.
Eklenti, Update URI başlığı sayesinde bu deponun Releases sayfasını 12 saatte bir denetler ve yeni sürümü WordPress'in standart güncelleme akışına ekler. Eklentiler ekranındaki Güncellemeleri denetle bağlantısı denetimi hemen yapar. wordpress.org ile hiçbir bağlantısı yoktur.
Veri kaynakları
- kursattaner/2024-turkey-list-of-tax-offices — GİB vergi dairesi listesi, Nisan 2024, GPL-3.0
Katkı
Hata bildirimi ve PR'lar için CONTRIBUTING.md. Güvenlik açıkları için SECURITY.md. Değişiklikler: CHANGELOG.md.
Lisans
WordPress & WooCommerce için ücretsiz eklentiler, özel geliştirme ve destek — oblifex.com