WooCommerce KDV ayarları, yalnızca vergi oranı satırı eklemekten oluşmaz. Ürün fiyatını vergi dahil mi hariç mi girdiğiniz, verginin hangi adrese göre hesaplandığı, ürünün vergi sınıfı, kargo vergisi ve mağazada fiyatın nasıl gösterildiği aynı sonucu etkiler. Bu rehber, teknik yapılandırmayı test edilebilir bir sırayla ele alır.
Önemli: Bu içerik WooCommerce yazılımının nasıl yapılandırıldığını açıklar; vergi veya muhasebe danışmanlığı değildir. Uygulanacak oranı, istisnayı, tevkifatı ve belge düzenini mali müşavirinizle ve güncel resmî mevzuatla doğrulayın. WooCommerce’in kendi belgesi de hangi verginin ne zaman alınacağı konusunda vergi uzmanına danışılmasını önerir.
Önce fiyat ve vergi karar tablosunu hazırlayın
Yönetim panelinde ayar değiştirmeden önce şu kararları yazılı hale getirin:
- Ürün fiyatları yönetimde KDV dahil mi, hariç mi girilecek?
- Vergi müşterinin teslimat adresine, fatura adresine ya da mağaza adresine göre mi hesaplanacak?
- Hangi ürün grupları farklı vergi sınıfı kullanacak?
- Kargo ve ek ücretlerde hangi sınıf uygulanacak?
- Katalog, sepet, ödeme ve faturada fiyatlar nasıl gösterilecek?
Bu kararlar net değilse aynı ürün katalogda, sepette ve faturada farklı görünebilir. Ürün bilgisinin genel yapısını WooCommerce ürün sayfası SEO ayarları ile birlikte kontrol edin; görünür fiyat ve yapılandırılmış veri birbiriyle çelişmemelidir.
WooCommerce vergi ayarlarını etkinleştirin
- WooCommerce → Ayarlar → Genel ekranına gidin.
- Vergi oranları ve hesaplamaları seçeneğini etkinleştirin.
- Değişiklikleri kaydedin; ardından Vergi sekmesini açın.
Menü adları kullanılan WooCommerce sürümü ve yönetim diliyle küçük farklılık gösterebilir. Güncel seçeneklerin anlamını WooCommerce’in resmî vergi ayarları belgesinden doğrulayın.
Fiyatları vergi dahil mi hariç mi gireceğinizi seçin
Vergi dahil fiyat girme seçilirse ürün düzenleyicisindeki fiyat müşterinin ödeyeceği vergi dahil taban fiyatı temsil eder ve WooCommerce vergi payını geriye doğru hesaplar. Vergi hariç fiyat girme seçilirse vergi, ürün fiyatının üzerine hesaplanır. Bu mağaza genelinde önemli bir karardır; mevcut ürünler varken ayarı değiştirmek ürün fiyatlarını kendiliğinden dönüştürmez.
Ayarı değiştirmeden önce ürünleri dışa aktarın, bir staging kopyasında örnek ürünlerle sonucu hesaplayın ve muhasebe sistemindeki fiyat kaynağının dahil/hariç biçimini doğrulayın. Özellikle CSV veya ERP entegrasyonu, WooCommerce’in beklediği fiyat biçiminden farklı değer gönderirse toplamlar yanlış olur.
Verginin hangi adrese göre hesaplanacağını belirleyin
WooCommerce; müşteri teslimat adresi, müşteri fatura adresi veya mağaza ana adresini hesaplama temeli olarak kullanabilir. Doğru seçenek satış modelinize ve geçerli mevzuata bağlıdır. Adrese göre oran değişiyorsa müşteri adresi girilmeden kesin vergi hesaplanamayabilir; bu nedenle ilk ziyarette görünen fiyat ile ödeme ekranındaki kesin toplamın nasıl sunulacağını test edin.
Mağaza adresi, satış ve kargo ülkeleri ile varsayılan müşteri konumu da eşleşmelidir. Yanlış mağaza ülkesi ya da posta kodu, beklenmeyen vergi ve kargo sonucu üretebilir. Kargo sonucunda da sapma varsa WooCommerce kargo ücreti yanlış hesaplama rehberindeki bölge eşleşmesini ayrıca kontrol edin.
Vergi sınıflarını ürün gruplarına göre kurun
WooCommerce’te “Standart”, “İndirimli” veya oluşturduğunuz başka sınıflar oran değildir; oran satırlarını gruplayan teknik sınıflardır. Önce mali müşavirinizden ürün ve hizmetlerin hangi sınıfa girmesi gerektiğini alın. Ardından her sınıfın altındaki ülke, bölge, posta kodu, oran, öncelik, bileşik ve kargo alanlarını yapılandırın.
Ürün düzenleyicisinde Vergi durumu ile Vergi sınıfı farklı alanlardır. “Vergilendirilebilir” seçilen ürüne uygun sınıf atanmalıdır. Dijital veya fiziksel olmasına bakarak otomatik oran varsaymayın; ürünün gerçek hukuki niteliğini doğrulayın. Güncel Türkiye oranlarını doğrudan makaleden kopyalamak yerine Gelir İdaresi Başkanlığı kaynakları ve mali müşavir onayıyla kontrol edin.
Vergi oranı satırlarını doğru eşleştirin
Bir oran satırı genellikle ülke kodu, bölge, posta kodu, şehir, oran, vergi adı, öncelik, bileşik vergi ve kargoya uygulanma alanlarından oluşur. Joker karakterleri gereğinden geniş kullanmak, oranı hedeflenmeyen adreslere uygulayabilir. Aynı adrese birden fazla satır uyuyorsa öncelik ve bileşik ayarının sonucu değişebilir.
- Ülke kodunu WooCommerce’in beklediği iki harfli biçimde girin.
- Şehir veya posta kodu kuralı kullanıyorsanız farklı yazım biçimleriyle test yapın.
- Aynı konuma uyan iki satırın öncelik değerlerini bilinçli belirleyin.
- Bileşik vergi seçeneğini yalnız gerçek vergi kuralınız gerektiriyorsa kullanın.
- Kargoya uygulanma kutusunu kargo vergi kararınızla eşleştirin.
Çok sayıda oran satırı ekleyecekseniz önce yönetim panelinde tek bir doğru satır oluşturup dışa aktarın. Oluşan CSV dosyasını şablon olarak kullanmak, sütun adları ve biçim hatalarını azaltır.
Kargo vergisi ve sepet ücretlerini ayrı test edin
Kargo vergi sınıfı, sepet ürünlerinden türetilebilir veya belirli bir sınıfa sabitlenebilir. Sepette farklı vergi sınıflarına ait ürünler bulunduğunda beklenen davranışı mali müşavirinizle netleştirin. Ücretsiz kargo, sabit ücret, yerel teslimat ve kupon senaryolarını ayrı ayrı test edin.
Ödeme yönteminin eklediği hizmet bedeli veya özel sepet ücreti de vergiye tabi olabilir. Bu ücret özel kodla ekleniyorsa vergi durumu ve sınıfı açıkça belirtilmelidir. Sepet toplamı ile ilgili kullanılabilirlik kontrollerini WooCommerce sepet optimizasyonu rehberiyle birlikte yapın.
Katalog ve ödeme ekranındaki vergi gösterimini eşleştirin
Mağaza fiyatlarını ve sepet/ödeme fiyatlarını vergi dahil ya da hariç gösterebilirsiniz. WooCommerce belgesi, fiyatların sisteme giriş biçimi ile katalog ve ödeme gösteriminin karışık ayarlanmasının yuvarlama farkları oluşturabileceğini belirtir. Müşterinin gördüğü etiket, ürün sayfası, sepet satırı, ara toplam, kargo ve genel toplam aynı mantığı izlemelidir.
Fiyat son eki kullanıyorsanız metnin gerçekten gösterilen rakamı doğru tanımladığından emin olun. Varyasyonlu ürünlerde son ek, varyasyon seçilmeden önce her zaman görünmeyebilir; farklı varyasyonları mobil ve masaüstünde test edin.
Yuvarlama farklarını teşhis edin
Satır bazında yuvarlama ile ara toplam düzeyinde yuvarlama farklı sonuç üretebilir. Kuruş farkı gördüğünüzde oranı değiştirmek yerine önce şu zinciri kaydedin: ürünün ham fiyatı, miktarı, vergi sınıfı, indirim, kargo, satır vergisi ve genel toplam. Fiyat giriş biçimi ile katalog ve ödeme gösteriminin üçünde de dahil/hariç tercihinin tutarlı olup olmadığını kontrol edin.
Para birimi ondalık sayısı, fiyat girilen dış sistem ve fatura entegrasyonunun yuvarlama yöntemi de fark oluşturabilir. WooCommerce toplamı doğru, e-belge farklıysa WooCommerce e-Arşiv entegrasyonu tarafındaki satır ve toplam hesaplarını karşılaştırın.
Test siparişi matrisi oluşturun
Canlıya almadan önce küçük bir test ürün grubu hazırlayın. Gerçek oranları ve beklenen toplamları mali müşavir onaylı bir tabloya yazın. Her testte ekran görüntüsü yerine ham hesap kalemlerini de kaydedin.
| Test | Değişken | Kontrol |
|---|---|---|
| Tek ürün | Standart sınıf | Ürün, sepet ve ödeme toplamı |
| Farklı sınıflar | İki ürün | Her satırın doğru sınıfı |
| Adres değişimi | Fatura/teslimat | Doğru oran satırının eşleşmesi |
| Kargo | Ücretli/ücretsiz | Kargo vergisi ve genel toplam |
| Kupon | Sabit/yüzde | İndirim sonrası vergi dağılımı |
| İade | Tam/kısmi | Vergi ve belge toplamının geri alınması |
Sık yapılan KDV ayarı hataları
- Vergi dahil girilen fiyatı hariç fiyatmış gibi yeniden vergilendirmek.
- Ürüne yanlış vergi sınıfı atamak veya sınıfı boş bırakmak.
- Hesaplama adresi ile oran tablosundaki ülke/bölge kuralını eşleştirmemek.
- Katalog ve ödeme gösterimini farklı dahil/hariç biçimlerde kurmak.
- Kargo ve özel sepet ücretlerinin vergi durumunu test etmemek.
- Önbellek nedeniyle eski fiyat ve toplamları yeni ayar sanmak.
- Güncel olmayan bir makaledeki oranları doğrudan canlı mağazaya girmek.
Sık sorulan sorular
WooCommerce KDV oranını otomatik belirler mi?
Çekirdek WooCommerce, tanımladığınız vergi sınıfı ve oran tablolarına göre hesaplama yapar. Otomatik vergi hizmetleri farklı olabilir; ülke desteği, veri kaynağı ve sorumluluk kapsamı ayrıca doğrulanmalıdır.
Fiyatları KDV dahil mi hariç mi girmeliyim?
Bu karar muhasebe ve satış modelinize bağlıdır. Seçtiğiniz biçim ürün kaynağı, katalog gösterimi, ödeme ekranı ve e-belge entegrasyonunda tutarlı olmalıdır.
Vergi sekmesi neden görünmüyor?
WooCommerce genel ayarlarında vergi oranları ve hesaplamaları etkin değilse Vergi sekmesi görünmez. Seçeneği açıp ayarları kaydettikten sonra sayfayı yeniden yükleyin.
Sepette KDV neden ürün sayfasından farklı?
Müşteri adresi, kupon, kargo, fiyat gösterim tercihi veya yuvarlama sonucu değiştirebilir. Aynı ürün için ham fiyat, vergi sınıfı ve eşleşen oran satırını sepet kalemleriyle karşılaştırın.
Kargo ücretine KDV nasıl uygulanır?
Kargo vergi sınıfı mağaza ayarından ve oran satırındaki kargo seçeneğinden etkilenir. Hangi sınıfın uygulanması gerektiğini mali müşavirinizle doğrulayıp farklı sepet sınıflarıyla test edin.
Sonuç
Doğru WooCommerce KDV ayarı, oran satırından önce fiyat giriş biçimini ve hesaplama adresini netleştirmeyi gerektirir. Vergi sınıfı, kargo, gösterim ve yuvarlama ayarlarını aynı test siparişi üzerinde izleyin. Mevzuat kararını mali müşavirden, teknik davranışı ise canlıya alınmadan önce staging testinden doğrulayın.
