XML Ürün Fiyatları Yanlış Geliyor: KDV, Kur ve Kâr Marjı Ayarları

XML ürün fiyatları neden yanlış gelir?

XML entegrasyonu kaynaktaki alanı olduğu gibi kopyalamak yerine çoğu zaman fiyatı dönüştürür. Kaynak para birimi, KDV durumu, kâr marjı, indirim oranı, komisyon payı ve yuvarlama kuralı birlikte çalışır. Bu adımlardan biri yanlış sırada uygulanırsa küçük fark değil, yüzde 20–50 seviyesinde fiyat hatası oluşabilir.

İlk yapılacak işlem, tek bir ürünün XML’deki ham değerini, entegrasyon hesaplama kaydını ve siteye yazılan son fiyatı yan yana koymaktır. Toplu kataloğu tekrar çekmek sorunun kaynağını göstermez.

Doğru fiyat alanını eşleyin

Tedarikçi XML’inde price, sale_price, buyingPrice, listPrice veya benzer birden fazla alan bulunabilir. Alan adları standart değildir. price bazı kaynaklarda alış fiyatı, bazılarında satış fiyatı olabilir.

• Alış fiyatı hangi alan?
• Liste fiyatı hangi alan?
• İndirimli satış fiyatı hangi alan?
• Fiyat KDV dahil mi hariç mi?
• Para birimi ürün bazında mı dosya genelinde mi?
• Varyantın kendi fiyat alanı var mı?

Alan anlamı tedarikçinin teknik dokümanı veya örnek ürün karşılaştırmasıyla doğrulanmadan otomatik eşleme yapılmamalıdır.

KDV dahil ve KDV hariç fiyatı ayırın

En yaygın hata, KDV dahil kaynağa tekrar KDV eklenmesidir. Kaynak fiyat 1.000 TL ve KDV dahilse, sistem bu tutarı KDV hariç kabul edip yüzde 20 eklediğinde ürün 1.200 TL’ye çıkar. Ardından kâr marjı uygulanırsa fark daha da büyür.

Döviz kuru kaynak ve zamanını belirleyin

USD veya EUR fiyatlı XML’de hangi kurun kullanılacağı açık olmalıdır: tedarikçi kuru, merkez bankası kuru, banka satış kuru veya işletmenin sabit kuru. Kur güncelleme zamanı ile ürün fiyat güncelleme zamanı ayrılırsa aynı ürün farklı çalışmalarda farklı sonuç verebilir.

Kur bilgisi alınamadığında son başarılı kurun mu kullanılacağı, fiyat güncellemesinin mi duracağı veya ürünün satışa mı kapatılacağı tanımlanmalıdır. Sessizce 1,00 kur kullanmak ciddi fiyat hatası oluşturur.

Kâr marjı ile fiyat artışı aynı şey değildir

“Alış fiyatına yüzde 30 ekle” ifadesi genellikle maliyet üzerine yüzde 30 artış anlamına gelir. Gerçek brüt kâr marjı yüzde 30 hedefleniyorsa formül farklıdır. Bu ayrım teklif ve kural ekranında açıkça yazılmalıdır.

İki yöntem aynı sonucu vermez. Yönetim ekranında “ekleme oranı” ile “hedef marj” ayrı seçenekler olarak gösterilmelidir.

Liste fiyatı ve indirimli fiyatı karıştırmayın

XML’de liste fiyatı 1.500 TL, kampanyalı fiyat 1.200 TL olabilir. Entegrasyon yanlış alanı alış fiyatı olarak kullanırsa kâr marjını zaten perakende fiyatın üzerine ekler. Tersi durumda indirimli fiyatı liste fiyatına yazmak sitede indirim görünümünü bozar.

Liste fiyatı, satış fiyatı ve maliyet ayrı saklanmalıdır. Kampanya bitiş tarihi varsa süre dolduğunda hangi değere dönüleceği de belirlenmelidir.

Ondalık ayırıcı ve yuvarlama sorunları

1.299,90 biçimi Türkçe gösterimdir; bazı parser’lar bunu 1,29990 veya 129990 olarak okuyabilir. XML’den gelen değer normalize edilmeden sayıya çevrilmemelidir. Binlik ayırıcı, ondalık ayırıcı ve para birimi simgesi temizlenmelidir.

Yuvarlama kuralı hesaplamanın sonunda uygulanmalıdır. Her adımda iki haneye yuvarlamak özellikle kur ve marj kombinasyonlarında birikimli fark oluşturur. “99,90’a tamamla”, “bir üst 5 TL’ye yuvarla” gibi ticari kurallar da ayrı tanımlanmalıdır.

Varyant fiyatları ana ürün fiyatıyla ezilmemeli

Renk veya beden varyantlarının fiyatları farklı olabilir. XML parser yalnızca ana ürün fiyatını okuyup bütün varyantlara uygularsa büyük beden, farklı hacim veya paket seçeneklerinin fiyatı yanlış olur. Varyant alanında fiyat yoksa ana ürüne geri düşme kuralı açıkça tanımlanmalıdır.

XML fiyat hataları neden–çözüm tablosu

Örnek fiyat hesaplama sıraları

KDV hariç TL maliyete yüzde 30 artış

maliyet = 1.000,00 TL
kâr ekleme = %30
KDV = %20

ara fiyat = 1.000 × 1,30 = 1.300 TL
satış fiyatı = 1.300 × 1,20 = 1.560 TL

KDV dahil dövizli satış fiyatına yüzde 15 artış

kaynak fiyat = 100 USD (KDV dahil)
kur = 36,50 TL
artış = %15

TL fiyat = 100 × 36,50 = 3.650 TL
satış fiyatı = 3.650 × 1,15 = 4.197,50 TL
KDV tekrar eklenmez.

Hangi durumda teknik destek gerekir?

• Tedarikçi XML yapısı sık değişiyorsa
• Birden fazla fiyat ve para birimi alanı varsa
• Kategori veya marka bazında farklı kâr kuralları uygulanacaksa
• Kur alınamadığında ürünler hatalı fiyatla yayına çıkıyorsa
• Varyant, liste fiyatı ve indirimli fiyat eşlemeleri bozuksa
• Eski hatalı fiyatların pazaryerlerine de yayıldığı durumlarda

Sık sorulan sorular

XML fiyatı elle düzeltince neden yeniden bozulur?

Periyodik XML görevi kaynaktaki veya hesaplanan değeri tekrar yazar. Kural düzeltilmeden manuel fiyat kalıcı olmaz.

Kâr marjı KDV’den önce mi sonra mı uygulanır?

İşletmenin fiyat politikasına göre tanımlanır; ancak kaynak fiyatın KDV durumu bilinmeden doğru sıra seçilemez.

Kur güncellemesi başarısızsa ürün fiyatı güncellenmeli mi?

Güvenli yaklaşım, son başarılı kur ve zamanını açıkça göstermek veya güncellemeyi durdurup uyarı üretmektir. Sessiz varsayılan kur kullanılmamalıdır.