XML Entegrasyonu Nasıl Yapılır? Tedarikçi XML'ini Pazaryerine Aktarma, Alan Eşleştirme, Fiyat ve Stok Kuralları Rehberi

Tedarikçiniz size bir bağlantı gönderdi: "XML adresimiz bu, ürünleri buradan çekebilirsiniz." Bağlantıyı açtığınızda binlerce satırlık, etiketlerle dolu bir dosya görürsünüz. İçinde yüzlerce ürünün adı, fiyatı, stoğu ve görseli var; ama bu ürünleri pazaryeri mağazanıza ya da e-ticaret sitenize nasıl taşıyacağınız, fiyatı nasıl belirleyeceğiniz ve stoğun nasıl güncel kalacağı belli değil. XML entegrasyonu nasıl yapılır sorusu, tedarikçiyle çalışan ya da bayilerine ürün veren her e-ticaret işletmesinin karşısına çıkar.

Bu rehberde XML entegrasyonunun ne olduğunu, XML almak ile XML vermek arasındaki farkı, bir ürün XML'inde hangi alanların bulunması gerektiğini, kategori ve özellik eşleştirmeyi, komisyon ve kâr dahil satış fiyatının nasıl hesaplandığını, stok kurallarını ve birden fazla tedarikçinin nasıl yönetildiğini sayılarla anlatıyoruz. Sonunda en sık yapılan hataları ve NetKasam ile XML sürecinin nasıl işlediğini bulacaksınız.

XML entegrasyonu nedir?

Kısaca: XML entegrasyonu, ürün bilgilerinin XML biçimindeki bir dosya ya da bağlantı üzerinden bir sistemden diğerine otomatik ve düzenli olarak aktarılmasıdır. Dosya belirli aralıklarla yenilenir; böylece fiyat ve stok değişiklikleri karşı tarafa kendiliğinden yansır.

XML (Genişletilebilir İşaretleme Dili), verileri etiketler içinde düzenli tutan bir metin biçimidir. Bir ürün XML'inde her ürün bir kayıt, her bilgi bir etikettir: ürün kodu, adı, fiyatı, stoğu, görsel adresleri. Bu düzen sayesinde hem insanlar hem yazılımlar dosyayı okuyabilir. Terimin kısa tanımı için XML nedir sözlük sayfasına bakabilirsiniz.

E-ticarette XML'in değeri, tek seferlik bir aktarım değil sürekli bir bağlantı olmasıdır. Tedarikçi fiyatı değiştirdiğinde ya da bir ürünün stoğu bittiğinde XML güncellenir; entegrasyon bu değişikliği okuyup mağazanıza taşır. Elle yapılan ürün yüklemesinin aksine, ürün sayısı arttıkça iş yükü artmaz.

XML almak ile XML vermek arasındaki fark nedir?

Kısaca: XML almak, bir tedarikçinin ya da kendi ERP'nizin ürünlerini XML üzerinden kendi mağazanıza çekmektir. XML vermek ise kendi ürünlerinizi XML olarak hazırlayıp bayilerinize ya da e-ticaret yapan müşterilerinize sunmaktır.

Bayilere ürün vererek kurulan iş modelinin ayrıntısı için XML bayilik nedir yazımıza göz atabilirsiniz. Bu rehber ağırlıklı olarak XML'i alıp satış kanallarına aktarma tarafını anlatıyor.

Bir ürün XML'inde hangi alanlar bulunmalı?

Kısaca: Her üründe en az ürün kodu, barkod, ürün adı, kategori, marka, fiyat, KDV oranı, stok ve görsel adresi bulunmalıdır. Varyantlı ürünlerde her varyantın kendi kodu, barkodu ve stoğu; kargo için de desi ya da ağırlık bilgisi gerekir.

Eksik alan, aktarımın ilk ve en sık hata kaynağıdır. Barkodu olmayan ürün çoğu pazaryerine yüklenemez; görseli açılmayan ürün reddedilir; KDV dahil mi hariç mi belli olmayan fiyat, bütün fiyat hesabını bozar. Entegrasyonu kurmadan önce tedarikçiden örnek XML isteyip bu tabloyla karşılaştırmak, sonradan çıkacak sorunların çoğunu baştan gösterir. Varyant yapısının ayrıntısı için pazaryerinde varyantlı ürün nasıl yönetilir yazımıza bakabilirsiniz.

XML entegrasyonu adım adım nasıl yapılır?

Kısaca: Tedarikçiden XML adresi alınır, alanlar kontrol edilir, kategori ve özellikler eşleştirilir, fiyat ve stok kuralları belirlenir, az sayıda ürünle test edilir ve ardından düzenli otomatik güncelleme açılır.

Adımlardan en çok atlanan, küçük testtir. Binlerce ürünü tek seferde aktarıp sonra fiyat hatası fark etmek, hatalı fiyatla gelen siparişleri iptal etmek zorunda kalmak demektir. Önce az sayıda ürünle denemek, hem alan eşleştirmesini hem de fiyat kuralını gerçek ürün sayfasında görmenizi sağlar.

Kategori ve özellik eşleştirme neden bu kadar önemli?

Kısaca: Her pazaryerinin kendi kategori ağacı ve kategoriye göre değişen zorunlu özellikleri vardır. Tedarikçinin "Erkek Giyim > Tişört" kategorisi, pazaryerindeki doğru kategoriye ve renk, beden, materyal gibi zorunlu alanlara bağlanmazsa ürün yüklenmez ya da yanlış yerde listelenir.

Tedarikçi XML'indeki kategori adları tedarikçinin kendi düzenidir; pazaryerinin ağacıyla birebir örtüşmez. Eşleştirme bu iki ağaç arasında bir köprüdür ve bir kez doğru kurulduğunda aynı kategorideki yeni ürünler de kendiliğinden doğru yere gider. Özellik eşleştirmesi ise daha ince bir iştir: Tedarikçinin "Lacivert" yazdığı rengi pazaryeri "Lacivert" olarak, "XL" bedenini "XL" olarak tanımalıdır. Yazım farkları (ör. "Laci", "lacivert", "LACİVERT") eşleştirme tablosunda tek değere bağlanır.

• Kategori eşleştirme: Tedarikçi kategorisi → satış kanalının en alt kategorisi.
• Özellik eşleştirme: Tedarikçinin özellik adları ve değerleri → kategorinin zorunlu özellik alanları.
• Marka eşleştirme: Tedarikçinin marka yazımı → pazaryerinde kayıtlı marka adı.

Kategori yapısını kendi sitenizde kurarken nelere dikkat edileceği için e-ticarette kategori yönetimi nasıl yapılır yazımızı okuyabilirsiniz.

XML fiyatına komisyon ve kâr nasıl eklenir?

Kısaca: Satış fiyatı, maliyetin üzerine yüzde ekleyerek değil, komisyon ve hedef kâr satış fiyatının içinden çıkacak şekilde hesaplanır: KDV hariç satış fiyatı = (alış fiyatı + kargo + paketleme) ÷ (1 − komisyon oranı − hedef kâr oranı).

XML'den gelen fiyat genellikle tedarikçinin size sattığı fiyattır. Bunun üzerine "yüzde 30 ekleyelim" demek yaygın ama yanlış bir yöntemdir; çünkü komisyon satış fiyatı üzerinden kesilir ve eklenen yüzde komisyonu ve kârı birlikte karşılamaya yetmeyebilir. Doğru yöntem, komisyon ve hedef kârı satış fiyatının birer payı olarak düşünmektir.

Bir örnekle bakalım. Tedarikçi XML'inde ürünün KDV hariç alış fiyatı 400 ₺. Gönderi başına kargo 45 ₺, paketleme 10 ₺. Satış kanalının komisyonu örnek olarak %20, hedeflenen net kâr satış fiyatının %15'i. Toplam maliyet 455 ₺'dir; satış fiyatı 455 ÷ (1 − 0,20 − 0,15) = 455 ÷ 0,65 = 700 ₺ (KDV hariç) olur:

Aynı ürüne "maliyetin üzerine %30 ekle" kuralı uygulansaydı satış fiyatı 455 × 1,30 = 591,5 ₺ olurdu; %20 komisyon (118,3 ₺) düşüldükten sonra kâr yalnız 18,2 ₺ kalırdı. Fark, yüzdenin neyin üzerine eklendiğinden kaynaklanır. Kâr marjı ile maliyete eklenen kâr oranı arasındaki farkın ayrıntısı için kâr marjı nasıl hesaplanır yazımıza bakabilirsiniz.

Komisyon oranı yükseldikçe aynı kârı korumak için gereken satış fiyatı hızla artar. Aşağıdaki grafik, aynı ürün ve aynı %15 hedef kâr için farklı komisyon oranlarında gereken KDV hariç satış fiyatını gösteriyor:

Bu yüzden farklı satış kanallarına aynı XML'den ürün gönderirken her kanala kendi komisyonuna göre ayrı fiyat kuralı tanımlamak gerekir. Tek fiyatla her kanala gitmek, bir kanalda fazla pahalı, diğerinde zararına satmak demektir.

XML'de stok ne sıklıkla güncellenmeli ve nasıl gönderilmeli?

Kısaca: Stok, satış hızına göre sık aralıklarla güncellenmeli ve tedarikçinin stoğu olduğu gibi değil, bir emniyet payı düşülerek gönderilmelidir. Tedarikçide son birkaç adet kalan ürün, satış kanalına sıfır stokla gönderilir.

XML entegrasyonunda en pahalı hata, tedarikçide bitmiş bir ürünü satmaktır. Sipariş iptal edilir, müşteri memnuniyeti düşer ve pazaryerlerinde iptal oranı satıcı performansını etkiler. Bunun iki sebebi vardır: XML'in seyrek güncellenmesi ve tedarikçinin aynı stoğu başka bayilerle de paylaşması.

Emniyet stoğunun nasıl hesaplandığı için emniyet stoğu nasıl hesaplanır yazımıza bakabilirsiniz.

Birden fazla tedarikçi XML'i nasıl yönetilir?

Kısaca: Ürünler barkodla eşleştirilir; aynı ürün birden fazla tedarikçide varsa stoğu olan ve maliyeti en düşük tedarikçi seçilir. Ürün kodları tedarikçiye göre ön ekle ayrılır ki farklı tedarikçilerin aynı kodu kullanması çakışma yaratmasın.

• Barkodla birleştirin. Aynı ürünün tek bir satış ilanı olmalı; iki tedarikçiden gelen aynı barkod iki ayrı ilan açmamalı.
• Kaynağı kurala bağlayın. Stoğu olan tedarikçiler arasından en düşük maliyetli olanın fiyatı ve stoğu kullanılır.
• Kodları ayırın. Tedarikçiye özgü ön ek (ör. "A-", "B-") ürün kodlarının çakışmasını önler.
• Siparişi doğru tedarikçiye yönlendirin. Siparişin hangi tedarikçinin stoğundan karşılanacağı kayıtta görünmeli.

XML entegrasyonunda en sık yapılan hatalar nelerdir?

1. Örnek XML'i incelemeden başlamak. Eksik barkod, boş görsel ya da belirsiz KDV alanı aktarımdan sonra fark edilir.
2. Fiyatın KDV dahil mi hariç mi olduğunu kontrol etmemek. Bu tek ayrım, tüm satış fiyatlarını %20 kaydırabilir.
3. Maliyete yüzde ekleyerek fiyatlamak. Komisyon satış fiyatından kesildiği için kâr beklenenden çok düşük çıkar.
4. Bütün kanallara tek fiyat göndermek. Komisyon oranları farklıysa bir kanalda zarar edersiniz.
5. Stoğu emniyet payı olmadan göndermek. Tedarikçide son kalan ürünler iptal edilen siparişlere dönüşür.
6. Kategori ve özellikleri eşleştirmeden aktarmak. Ürünler reddedilir ya da yanlış kategoride görünür.
7. Hata raporlarını izlememek. Yüklenemeyen ürünler sessizce satış dışında kalır.

NetKasam ile XML entegrasyonu nasıl yapılır?

NetKasam'da XML hem almak hem de vermek için kullanılır ve stok tek merkezden yönetilir:

• XML ürün beslemesi. Tedarikçinizin ya da ERP'nizin XML'i paketinize göre NetKasam'a bağlanır: Connect paketinde 1, Global Plus paketinde 3 XML ürün beslemesi bulunur. Ayrıntılar fiyatlar sayfasında.
• XML verme. NetKasam'da oluşturduğunuz ürünleri e-ticaret yapan müşterilerinizle paylaşmak için Excel'le uğraşmazsınız; dilediğiniz ürünleri ve kategorileri seçip XML oluşturur ve paylaşırsınız. XML ile tüm e-ticaret altyapılarına ürünlerinizi gönderebilirsiniz.
• Stok tek merkezde. Stok yönetimi ile ürünlerinizin stokları e-ticaret sitenize ve XML verdiğiniz diğer sitelere aktarılır; satış kanallarında oluşan siparişler stoğu NetKasam'da düşürür. Ayrıntı için entegrasyon stoğumu takip eder mi sorusuna bakabilirsiniz.
• Varyant görselleri. Her renge ayrı görsel yükleyerek XML ile satışta ürünlerinizi daha iyi sunarsınız.
• Pazaryerleri ve e-ticaret sitesi tek panelde. Pazaryeri entegrasyonu ve e-ticaret entegrasyonu ile siparişler tek ekranda toplanır, toplu faturalanır.

Sonuç: XML'i bağlamak kolay, doğru kurmak kazandırır

Bir XML adresini bağlamak birkaç dakika sürer; asıl iş, alanları ve kategorileri doğru eşleştirmek, fiyatı komisyon ve kârı içine alacak şekilde kurmak ve stoğu emniyet payıyla güncel tutmaktır. İlk adım olarak tedarikçinizden örnek XML'i isteyin, bu rehberdeki alan tablosuyla karşılaştırın ve en çok satacağınız 20 ürün için satış fiyatını formülle hesaplayın. Kuralları bu küçük grupta doğru kurduğunuzda, yüzlerce ürünü aynı güvenle yayına alabilirsiniz.