XML entegrasyonu, ürün listelerinizi bir dosya üzerinden otomatik olarak alıp kataloğunuza yazan veri köprüsüdür. Tedarikçiniz stok ve fiyat bilgisini XML adresinde yayınlar, sizin paneliniz bu adresi belirli aralıklarla okur ve değişenleri mağazanıza işler. Elle Excel indirip yüklemeye göre farkı şudur: kimse bir şey yapmadan, veri kendi kendine güncel kalır.
2026 itibarıyla XML hâlâ Türkiye e-ticaretinde en yaygın veri alışveriş biçimi. Sebebi basit — neredeyse her tedarikçi, her altyapı ve her pazaryeri bir XML çıktısı üretebiliyor. Bu yazıda XML entegrasyonunun nasıl kurulduğunu, hangi alanların eşleştirilmesi gerektiğini ve hangi noktalarda yanlış gittiğini anlatıyoruz.
XML Entegrasyonu Nasıl Çalışır?
Akış üç adımdan oluşur ve her adımda ayrı bir şey ters gidebilir.
- Okuma: Panel, tedarikçinin verdiği adrese bağlanır ve dosyayı indirir. Adres parola korumalıysa kimlik bilgisi de burada tanımlanır.
- Eşleştirme: Dosyadaki etiketler (sku, stok, fiyat) sizin katalog alanlarınıza bağlanır. Bu adım bir kez yapılır, sonra tekrarlanmaz.
- Yazma: Değişen kayıtlar kataloğa işlenir. Yeni ürün açılır, biten ürünün stoğu sıfırlanır, fiyat farkı varsa güncellenir.
Alan Eşleştirme: İşin Can Damarı
XML entegrasyonunda en çok zaman alan ve en çok hata üreten adım alan eşleştirmedir. Tedarikçinin <fiyat> dediğine siz alış fiyatı diyorsanız, eşleştirme yanlış yapıldığında ürünler maliyetine satışa çıkar. Aşağıdaki tablo en sık karşılaşılan alanları ve nelere dikkat edilmesi gerektiğini özetliyor.
| XML alanı | Katalog karşılığı | Dikkat edilecek nokta |
|---|---|---|
sku / stokKodu | Stok kodu | Benzersiz olmalı; tekrar eden kod eski ürünü ezer |
barkod | Barkod | Pazaryerleri çoğu kategoride zorunlu tutar |
fiyat | Satış fiyatı | KDV dahil mi hariç mi — tedarikçiye sorun |
stok | Stok adedi | Negatif ya da boş gelen değer sıfır sayılmalı |
resim | Görsel | Birden çok görsel varsa ayraç karakteri netleşmeli |
kategori | Kategori | Pazaryeri kategorisine ayrıca eşlenmesi gerekir |
Ne Sıklıkla Güncellenmeli?
Hızlı satan üründe stok güncelliği kritik, yavaş satanlarda değil. Genel yaklaşım: stok ve fiyat için saatlik, yeni ürün açılışı için günlük. Çok büyük dosyalarda (on binlerce satır) her saat tam okuma gereksiz yük getirir; bu durumda yalnız değişenleri işleyen bir akış tercih edilir.
XML Entegrasyonu ile Pazaryeri Entegrasyonu Aynı Şey mi?
Hayır, karıştırılıyor. XML tek yönlüdür: tedarikçiden size veri gelir. Pazaryeri entegrasyonu ise çift yönlüdür — siz pazaryerine ürün gönderirsiniz, pazaryeri size sipariş gönderir. Çoğu satıcı ikisini birlikte kullanır: XML ile tedarikçiden katalog alır, entegrasyonla pazaryerlerine yayar. Ayrıntı için pazaryeri entegrasyonu nedir yazımıza bakabilirsiniz.
XML Entegrasyonunda Sık Yapılan Hatalar
- Emniyet stoğu bırakmamak. Tedarikçide 1 adet kalan ürünü satışa açık tutarsanız aynı anda gelen iki sipariş iptale döner. Eşik değeri belirleyin.
- Görsel adreslerini kontrol etmemek. Kırık görsel bağlantısı pazaryerinde ürünü onaydan geçirmez.
- Kategori eşleşmesini sonraya bırakmak. Kategori yanlışsa ürün yanlış komisyon dilimine düşer. Kategori eşleştirme rehberimiz bu konuyu ayrıntılı anlatıyor.
- Tek seferlik kurulum sanmak. Tedarikçi XML yapısını değiştirdiğinde eşleştirme bozulur; hata raporunu düzenli okuyun.
Sık Sorulan Sorular
XML entegrasyonu için teknik bilgi gerekir mi?
Alan eşleştirmeyi panel üzerinden yapıyorsanız kod yazmanız gerekmez. Tedarikçinin dosya yapısı çok sıra dışıysa bir kereliğine destek almanız gerekebilir.
Kaç tedarikçi XML'i bağlanabilir?
Teknik bir üst sınır yoktur; pratikte her kaynağın ayrı eşleştirme ve stok kuralı olduğu için kaynak sayısı arttıkça yönetim yükü artar.
Aynı ürün iki tedarikçide varsa ne olur?
Stok kodu aynıysa ikinci kaynak birinciyi ezer. Bu durumda öncelik kuralı tanımlanmalı ya da kaynak bazlı stok kodu öneki kullanılmalıdır.
XML yerine API kullanmak daha mı iyi?
Tedarikçi API sunuyorsa evet — anlık ve çift yönlü çalışır. Ama XML her yerde var, API her yerde yok.
Özet
XML entegrasyonu, katalog büyüdükçe elle yönetilemeyen stok ve fiyat işini otomatiğe bağlar. Kurulumda iki şeye zaman ayırın: alan eşleştirmesi ve kategori eşleşmesi. Bu ikisi doğruysa geri kalanı kendiliğinden yürür. Ürünlerinizi pazaryerlerine de taşımak istiyorsanız entegrasyon listemize göz atın; fiyat kurgunuzu netleştirmek için satış fiyatı hesaplama aracını kullanabilirsiniz.
XML Entegrasyonu Kurmadan Önce Sorulacak Beş Soru
Tedarikçiyle konuşmadan kurulum başlatmak, sonradan baştan yapmak demek. Şu beş soruyu önceden sorun.
Dosya ne sıklıkla güncelleniyor?
Tedarikçi günde bir kez güncelliyorsa, sizin saatlik okumanız hiçbir şey kazandırmaz — yalnız gereksiz yük olur. Okuma sıklığınızı kaynağın güncellenme sıklığına eşitleyin.
Fiyat KDV dahil mi?
Tek cümlelik bu soru, yanlış cevaplandığında tüm kataloğu yanlış fiyata düşürür. Yazılı olarak teyit alın ve kurulum sonrası birkaç ürünü elle doğrulayın.
Stok gerçek mi, "var/yok" mu?
Bazı tedarikçiler adet yerine yalnız "stokta var" bilgisi verir. Bu durumda emniyet stoğu mantığı kurulamaz; satışa açacağınız adedi kendiniz sabitlemeniz gerekir.
Ürün çıkınca satırı siliniyor mu?
Bazı dosyalarda biten ürün satırı tamamen kaldırılır. Panel bunu "değişmedi" sanarsa ürün satışta kalır. Kaynakta olmayan ürünün stoğunu sıfırlayan bir kural tanımlayın.
Görseller kalıcı adreste mi?
Geçici adreste yayınlanan görseller bir süre sonra kırılır ve ürün pazaryerinde onaydan düşer.
