XML entegrasyonu nedir, nasıl yapılır? Tedarikçi ürün ve stok verisini siteye almak

XML entegrasyonu nedir, nasıl yapılır? Tedarikçi XML’inden ürün, fiyat ve stok verisini e-ticaret sitenize alma adımları, güncelleme sıklığı ve hata durumları.

FUFerhat UğurluYazSis EkibiYayın: 23 Kasım 20266 dk okuma
Kısaca

XML entegrasyonu, tedarikçinin ya da başka bir sistemin XML biçimindeki ürün, fiyat ve stok dosyasının düzenli olarak okunup e-ticaret sitesine veya ERP’ye aktarılmasıdır. Dosyadaki alanlar sizin ürün kodunuzla eşleştirilir, fiyat ve yayın kuralları uygulanır, hatalı veya beklenmedik veri durdurulur. Güncelleme sıklığı ürünün satış hızına ve tedarikçinin dosyayı yenileme düzenine göre belirlenir.

Tedarikçinizin sitesinde her sabah güncellenen bir ürün dosyası var. Bir çalışanınız bu dosyayı indirip kendi ürün tablonuzla karşılaştırıyor, değişen fiyatları ve biten ürünleri sitenize elle giriyor. Dosyada binlerce satır olunca bu iş ya aksıyor ya da hata içeriyor: biten ürün satışta kalıyor, fiyatı değişen ürün eski fiyatla satılıyor. Çözüm, dosyayı insan yerine bir kuralın okumasıdır; e-ticarette buna XML entegrasyonu denir. Bu yazı XML entegrasyonunun ne olduğunu, nasıl yapıldığını ve stok güncellemesinin ne sıklıkla yapılması gerektiğine nasıl karar verildiğini anlatıyor.

XML entegrasyonu, tedarikçinin ya da başka bir sistemin XML biçimindeki ürün, fiyat ve stok dosyasının düzenli olarak okunup e-ticaret sitesine veya ERP’ye aktarılmasını sağlayan veri bağlantısıdır. XML, bilgiyi etiketlerle düzenleyen bir dosya biçimidir; böylece iki farklı sistem aynı dosyayı aynı şekilde okuyabilir.

XML dosyası ne içerir ve nasıl eşleştirilir?

Dosyanın yapısı tedarikçiden tedarikçiye değişir; ancak çoğu dosyada benzer alanlar bulunur. Eşleştirme sırasında her alanın kendi riski vardır:

Dosyadaki alanNe işe yarar?Eşleştirmede dikkat edilecek nokta
Ürün kodu veya barkodÜrünü tek bir kimlikle tanımlarTedarikçinin kodu sizin kodunuzdan farklıdır; bir eşleştirme anahtarı seçmeden ilerlenmez.
Ürün adı ve açıklamaVitrin metni olarak kullanılırAynı metin tedarikçinin diğer müşterilerinde de vardır; kendi sitenize özgü içerik gerekebilir.
KategoriÜrünü tedarikçinin ağacında konumlandırırTedarikçinin kategori adları sizin kategorilerinizle bire bir örtüşmez.
Fiyat ve para birimiAlış fiyatını ve birimini verirSatış fiyatı bir kuralla hesaplanır; kur varsa güncellemesi ayrıca düşünülür.
StokTedarikçideki adedi bildirirSıfır ile “bilgi yok” aynı şey değildir; boş alan stok yok anlamına gelmeyebilir.
Görsel bağlantısıÜrün fotoğrafının adresini taşırBağlantı bir gün çalışmayabilir; görselin sizde saklanıp saklanmayacağı belirlenmelidir.
Teknik özelliklerFiltre ve karşılaştırmayı beslerBirimler tutarlı olmalı; aynı özellik farklı yazılmışsa filtre dağılır.

XML entegrasyonu nasıl yapılır?

  1. Erişimi alın: dosyanın adresini, varsa erişim bilgisini ve tedarikçinin dosyayı hangi düzende yenilediğini öğrenin.
  2. Alanları haritalayın: dosyadaki her alanın sitedeki hangi alana gideceğini bir tabloya yazın.
  3. Eşleştirme anahtarını seçin: barkod mu, tedarikçi kodu mu, üretici parça numarası mı? Anahtar tek ve benzersiz olmalıdır.
  4. Fiyat kuralını tanımlayın: alış fiyatına kâr marjı, kur ve yuvarlama nasıl uygulanacak?
  5. Yayın kuralını belirleyin: dosyada yeni görülen ürün doğrudan mı yayına çıkacak, yoksa onay mı bekleyecek?
  6. Zamanlamayı kurun: dosya ne sıklıkla okunacak, hangi saatlerde?
  7. Hata kaydı ve uyarı ekleyin: okunamayan dosya, boş alan ve beklenmedik değişim için kim, nasıl haberdar olacak?

Fiyat kuralı nasıl yazılır?

Satış fiyatı, dosyadaki alış fiyatından bir kuralla türetilir: alış fiyatı, kâr marjı, gerekiyorsa kur dönüşümü ve yuvarlama sırasıyla uygulanır. Marj tüm ürünlerde aynı olmak zorunda değildir; kategori ya da marka bazında farklı kurallar tanımlanabilir. Önemli olan kuralın yazılı olması ve sıralamasının bilinmesidir. Kur değişince fiyatların yeniden hesaplanıp hesaplanmayacağı da baştan karara bağlanmalıdır.

İlk okumada neler kontrol edilir?

  • Dosyadaki ürün sayısı ile sitede oluşan ürün sayısı birbirini tutuyor mu?
  • Rastgele seçilen ürünlerde fiyat, stok ve kategori dosyadaki veriyle uyuşuyor mu?
  • Eşleşmeyen ve atlanan ürünlerin listesi görülebiliyor mu?
  • Aynı ürün iki kez oluştu mu, görseller açılıyor mu?

Tedarikçi XML’inden stok güncellemesi ne sıklıkla yapılmalı?

Tek doğru sıklık yoktur; karar dört şeye bağlıdır: ürünün ne kadar hızlı satıldığı, tedarikçinin dosyayı ne kadar sık yenilediği, aynı stokun kaç kanalda satıldığı ve yanlış stoğun size maliyeti. Tedarikçinin dosyasını yenilemediği bir sıklıkta okumak yeni bilgi getirmez; tedarikçinin koyduğu istek sınırlarına da uymak gerekir.

DurumGüncelleme ihtiyacıNot
Hızlı satılan veya sınırlı adetli ürünSıkÇift satış riski yüksektir; kritik seviyenin altındaki ürün için koruma payı düşünün.
Yavaş satılan, geniş stoklu ürünDaha seyrekFiyat değişimi stoktan daha önemli olabilir.
Kampanya veya yoğun dönemSıklaştırılırDönem bitince eski düzene dönmek için kural planlayın.
Aynı ürün birden fazla kanalda satılıyorKanal sayısıyla birlikte düşünülürTek stok kaynağı belirleyin; kanallar o kaynaktan beslensin.

Fiyat ve stok aynı dosyada olsa da aynı sıklıkta güncellenmek zorunda değildir. Stok sık, fiyat daha seyrek okunabilir; hangisinin neden gerektiği satış verisine bakılarak belirlenir.

Tedarikçi dosyası bozulursa ne olur?

Her entegrasyon bir gün bozuk veri alır. Tasarım, bunun siteye yansımasını engelleyen kurallardan oluşur:

  • Dosya okunamıyorsa son doğru veri korunur, site boş stokla yayına çıkmaz.
  • Bir ürün dosyadan kaybolduysa “kaldırıldı” mı, “stok sıfır” mı sayılacağı baştan karara bağlanır.
  • Fiyat beklenmedik büyüklükte değiştiyse güncelleme durdurulur ve onay beklenir.
  • Boş veya anlamsız alanlar mevcut veriyi ezmez.
  • Her okuma kaydedilir; kaç ürün güncellendi, kaçı hata verdi görülebilir.

Yeni ürün ve varyant davranışı da ayrıca ele alınmalıdır. Dosyaya yeni bir ürün eklendiğinde kataloğa otomatik girmesi, kontrol edilmesi için taslakta beklemesi ya da hiç alınmaması mümkündür. Bir ürünün bedenleri veya renkleri dosyada ayrı satırlar halinde geliyorsa bunların tek ürünün varyantları olarak birleştirilmesi gerekir; aksi halde vitrin aynı ürünle dolar.

XML entegrasyonu veren firmalar nasıl karşılaştırılır?

Firma adı sıralamak yerine, hangi sorulara cevap verdiklerine bakın:

  • Birden fazla tedarikçiyi ve farklı dosya yapılarını destekliyorlar mı?
  • Alan eşleştirme ve fiyat kuralı ayarlarını size sunuyorlar mı, yoksa her değişiklik için talep mi açmanız gerekiyor?
  • Hatalı dosya, boş alan ve beklenmedik değişim için uyarı ve durdurma kuralları var mı?
  • Okuma kayıtlarını görebiliyor musunuz?
  • Aynı veri ERP, e-ticaret sitesi ve pazaryerlerine birlikte aktarılabiliyor mu?
  • Verinize ve ayarlarınıza hangi koşulla sahip oluyorsunuz?

Excel ve elle güncelleme nerede yeterli, nerede kırılır?

Az sayıda ürün ve nadir değişen fiyat için, tedarikçinin dosyasını açıp tablodan güncellemek yeterlidir. Ürün sayısı yüzlerle ifade edilmeye başlayınca bu iş bir kişiye bağımlı hale gelir, tatilde ya da hastalıkta durur. Güncelleme gecikince site biten ürünü satar ya da eski fiyatı gösterir; müşteri hizmetleri bunu iptal ve özür yazısıyla telafi eder. XML entegrasyonu bu tekrar eden işi bir kurala devreder ve insanı istisnalara bırakır.

E-ticaret XML entegrasyonu: YazSis Akıllı E-Ticaret’te XML, API ve webhook

YazSis Akıllı E-Ticaret, tedarikçi XML’i, API ve webhook altyapısını entegrasyon katmanında sunar. Hangi tedarikçi dosyasının hangi alanlarla, hangi yönde ve hangi sıklıkla okunacağı projenin entegrasyon adımında, ürün yapınız ve fiyat kurallarınız çıkarıldıktan sonra belirlenir. Veri akışının genel ilkeleri, entegrasyon sayfasında anlattığımız yaklaşıma dayanır: her alan için tek kaynak, akışın yönü ve hata senaryoları, kayıt ve tekrar deneme, görünür entegrasyon sağlığı.

Katalogdaki ürün içeriği ve SEO metni için yapay zekâ desteği de pakette yer alır; bu, aynı tedarikçi metnini birden fazla sitede yinelemek yerine kendi sitenize özgü içerik hazırlamaya yardımcı olabilir.

Tedarikçi verisini kendi ürün yapınıza göre kurmak için Akıllı E-Ticaret sayfasındaki kurulum modeline bakabilirsiniz.

Sık sorulanlar

XML entegrasyonu nedir?

Tedarikçinin ya da başka bir sistemin XML biçimindeki ürün, fiyat ve stok dosyasının düzenli olarak okunup e-ticaret sitesine veya ERP’ye aktarılmasını sağlayan veri bağlantısıdır.

XML entegrasyonu nasıl yapılır?

Dosya adresi ve erişim bilgisi alınır, dosyadaki alanlar sitedeki alanlarla eşleştirilir, eşleştirme anahtarı ve fiyat kuralı belirlenir, yayın kuralı ve zamanlama kurulur, hata kaydı ve uyarılar eklenir. Kapsam, tedarikçi ve ürün yapısına göre proje analizinde çıkarılır.

XML entegrasyonu veren firmalar arasında nasıl seçim yapılır?

Firmanın alan eşleştirme ve fiyat kuralı esnekliğine, hata ve uyarı kurallarına, okuma kayıtlarına, birden fazla tedarikçiyi desteklemesine ve verinize sahip olma koşullarına bakın. Bir sıralama yerine kendi ihtiyaç listenizle her teklifi aynı sorularla değerlendirin.

Tedarikçi XML’inden stok güncellemesi ne sıklıkla yapılmalı?

Ürünün satış hızına, tedarikçinin dosyayı yenileme düzenine, stokun kaç kanalda satıldığına ve yanlış stok maliyetine göre belirlenir. Hızlı satılan ürünlerde sık, yavaş satılan ürünlerde daha seyrek güncelleme yeterli olabilir.

XML ile API arasındaki fark nedir?

XML bir dosya biçimidir ve genellikle belirli aralıklarla okunur. API ise sistemlerin birbirine doğrudan soru sorduğu bir kanaldır; sipariş çekme veya stok güncelleme gibi iki yönlü işlemler için daha uygundur. Birçok proje ikisini birlikte kullanır.

FU
Ferhat Uğurlu · YazSis Ekibi

YazSis ekibiyle birlikte kurumsal yazılım, yapay zekâ ve dijital dönüşüm ürünleri geliştiriyor.