Elinizde 4.000 ürünlük bir katalog olduğunu düşünün. Her birinin fiyatı haftada birkaç kez değişiyor, stokları gün içinde iniyor, çıkıyor. Bunları tek tek panele girmek bir yana, sadece güncel tutmak bile tam zamanlı bir iş. XML entegrasyonu tam olarak bu yükü ortadan kaldırmak için var: ürün bilgilerinin bir kaynaktan sizin mağazanıza düzenli ve otomatik biçimde akmasını sağlıyor.
Kulağa teknik gelebilir ama mantığı oldukça sade. Bir tarafta ürün verisini yayınlayan bir dosya, diğer tarafta o dosyayı okuyup kendi sistemine uygun hale getiren bir mağaza var. Aradaki işin büyük kısmı "hangi bilgi nereye gidecek" sorusunu doğru cevaplamaktan ibaret.
Aşağıda önce temeli, sonra işleyişin parçalarını, ardından kurulum adımlarını ve en çok karşılaştığımız hataları ele alıyoruz. Amaç, işin sonunda kendi feed'inize bakıp neyin nerede durduğunu rahatça okuyabilmeniz.
XML Entegrasyonu Nedir ve Neden Bu Kadar Yaygın?
XML, verileri etiketler arasında düzenli biçimde saklayan bir dosya formatı. İnsan da okuyabiliyor, yazılım da. E-ticarette bu format genellikle bir tedarikçinin, toptancının ya da üreticinin ürün listesini dışarıya açmak için kullanılıyor. Size bir bağlantı veriliyor; o bağlantıyı açtığınızda yüzlerce, bazen on binlerce ürünün kodu, adı, fiyatı, stoğu ve görsel adresleri karşınıza çıkıyor.
Entegrasyon kısmı ise bu dosyanın sizin mağazanız tarafından belirli aralıklarla okunması, içindeki bilgilerin sizin ürün yapınıza çevrilmesi ve değişikliklerin otomatik olarak işlenmesi demek. Yeni bir ürün eklendiyse mağazada açılıyor, stok sıfırlandıysa satışa kapanıyor, fiyat değiştiyse sizin belirlediğiniz kurallarla yeniden hesaplanıyor.
Yaygın olmasının sebebi basit: neredeyse her sistem XML okuyabiliyor. API kadar esnek olmasa da kurulumu hızlı, maliyeti düşük ve tarafların özel bir yazılım geliştirmesine gerek bırakmıyor. Küçük bir butikten büyük bir toptancıya kadar herkesin ortak dil olarak kullanabildiği bir köprü.
Bir Ürün Feed'i Neye Benziyor?
Teoriyi bir kenara bırakıp gerçek bir örneğe bakalım. Aşağıdaki parça, tipik bir tedarikçi dosyasındaki tek bir ürünü gösteriyor:
<urunler>
<urun>
<stok_kodu>TRM-4471-BYZ</stok_kodu>
<barkod>8690000123456</barkod>
<urun_adi>Çelik Termos 750 ml Beyaz</urun_adi>
<kategori>Ev & Yaşam > Mutfak > Termos</kategori>
<marka>Örnek Marka</marka>
<alis_fiyati>289.90</alis_fiyati>
<kdv>20</kdv>
<stok>37</stok>
<desi>2</desi>
<resim1>https://ornek-tedarikci.com/img/trm4471-1.jpg</resim1>
<resim2>https://ornek-tedarikci.com/img/trm4471-2.jpg</resim2>
<aciklama><![CDATA[<p>Paslanmaz çelik gövde, 12 saat sıcak tutma.</p>]]></aciklama>
</urun>
</urunler>Burada dikkat etmeniz gereken birkaç ayrıntı var. Fiyat "alis_fiyati" olarak gelmiş, yani satış fiyatı değil. KDV ayrı bir alanda. Kategori tek satırda, ">" işaretiyle hiyerarşik yazılmış. Açıklama HTML içeriyor ve CDATA bloğuna sarılmış. Her tedarikçi bu alanları farklı adlandırır; biri "stok_kodu" der, öteki "sku", bir başkası "urun_kod". İşte eşleştirme adımı bu yüzden işin kalbi.
E-Ticaret XML Entegrasyonu Nasıl Çalışır?
İşleyişi dört parçada düşünmek kolaylık sağlıyor. Hepsi birbirine bağlı ama her birinin ayrı ayarı var.
Alan eşleştirme (mapping)
Mağazanızın bir ürün için beklediği alanlar bellidir: ürün adı, stok kodu, barkod, fiyat, stok adedi, görseller, açıklama, marka, varyant bilgisi. Alan eşleştirme, tedarikçi dosyasındaki her etiketin sizdeki hangi alana karşılık geldiğini tanımlamak demek. Yukarıdaki örnekte "urun_adi" sizin "ürün başlığı" alanınıza, "stok" sizin "stok adedi" alanınıza bağlanır.
Basit gibi görünse de küçük kararlar büyük fark yaratıyor. Hangi alanı benzersiz anahtar olarak kullanacaksınız? Stok kodu mu, barkod mu? Bu seçim, sonraki her güncellemede ürünün doğru kayıtla eşleşip eşleşmeyeceğini belirliyor. Varyantlı ürünlerde (beden, renk) ana ürün ile alt ürünün nasıl ilişkilendirileceği de bu adımda netleşmeli.
Kategori eşleştirme
Tedarikçinin kategori ağacı neredeyse hiçbir zaman sizinkiyle birebir örtüşmez. Onun "Ev & Yaşam > Mutfak > Termos" dediği yer sizde "Mutfak Gereçleri > Matara ve Termoslar" olabilir. Kategori eşleştirmede tedarikçinin her kategori yolunu kendi kategorinize bağlarsınız. Eşleşmeyen kategorilerdeki ürünleri ya içeri almazsınız ya da kontrol için bekleyen bir alana düşürürsünüz.
Bu adımı aceleye getirmek, mağazanızın menüsünü birkaç gün içinde dağınık bir depoya çevirir. Arama motoru açısından da kategori sayfalarınızın tutarlı kalması önemli.
Fiyat ve stok güncelleme sıklığı
Ürünler bir kez içeri alındıktan sonra asıl iş başlar: güncel kalmak. Çoğu sistem fiyat ve stok bilgisini ürün açıklaması ya da görsellerden daha sık çeker. Hızlı dönen ürünlerde 15-30 dakikalık aralıklar makul. Daha durağan kataloglarda birkaç saatte bir yeterli olabilir.
Burada sınırı tedarikçi de belirler. Dosyasını saatte bir güncelleyen bir kaynağı beş dakikada bir okumak size bir şey kazandırmaz, üstelik sunucusunu gereksiz yere yorar. Önce kaynağın ne sıklıkla yenilendiğini öğrenin, aralığınızı ona göre ayarlayın.
Kâr marjı kuralları
Feed'den gelen fiyat genellikle alış fiyatıdır. Satış fiyatını oluşturmak için kurallar tanımlarsınız. En basiti sabit yüzdelik: alış fiyatının üzerine %35 ekle gibi. Ama tek bir oran çoğu zaman yetmez. Ucuz ürünlerde kargo maliyeti marjı eritir, pahalı ürünlerde ise yüksek oran rekabeti öldürür.
| Alış fiyatı aralığı | Örnek kural | Neden |
|---|---|---|
| 0 – 150 TL | %60 + 25 TL sabit | Kargo ve paketleme payı |
| 150 – 750 TL | %35 | Dengeli marj |
| 750 TL üzeri | %20 | Fiyat rekabeti |
Buna KDV'nin dahil olup olmadığını, yuvarlama tercihinizi (örneğin ,90 ile bitirme) ve kategori bazlı istisnaları da ekleyebilirsiniz. Kuralları bir kez doğru kurduğunuzda fiyat değişiklikleri sizin müdahaleniz olmadan tutarlı biçimde yansır.
XML Entegrasyonu Nasıl Yapılır? Adım Adım Kurulum
Teknik altyapınız ne olursa olsun süreç benzer bir sırayı izler. Şöyle ilerlemenizi öneririz:
- Kaynağı inceleyin. Tedarikçinin verdiği bağlantıyı tarayıcıda açın. Kaç ürün var, hangi alanlar dolu, görseller açılıyor mu, karakterler bozuk mu? Beş on ürüne gözle bakmak sonradan saatler kazandırır.
- Benzersiz anahtarı seçin. Stok kodu ya da barkoddan hangisinin her üründe dolu ve tekil olduğunu kontrol edin.
- Alanları eşleştirin. Zorunlu alanlardan başlayın, sonra isteğe bağlı olanları ekleyin.
- Kategorileri bağlayın. Önce ürün sayısı en yüksek kategorileri halledin; küçük kategoriler sonra gelebilir.
- Fiyat kurallarını tanımlayın. Birkaç ürün üzerinden elle hesaplayıp sistemin çıkardığı sonuçla karşılaştırın.
- Küçük bir test aktarımı yapın. Tüm kataloğu tek seferde açmak yerine 20-50 ürünle deneyin, ürün sayfalarını tek tek kontrol edin.
- Güncelleme zamanlamasını kurun ve izleyin. İlk birkaç gün kayıtları takip edin; hatalı ya da atlanan ürünleri not alın.
Bu sıralama, özellikle ilk kez XML aktarımı yapanların en sık düştüğü tuzağı engeller: her şeyi aynı anda açıp sonra yüzlerce hatalı ürünü geri toplamak.
En Sık Yapılan Hatalar ve Nasıl Önlenir?
Sahada en çok karşılaştığımız sorunlar aslında birkaç başlık altında toplanıyor.
Benzersiz anahtarı yanlış seçmek. Bir tedarikçi barkodu bazı ürünlerde boş bırakıyorsa ve siz barkodu anahtar yaptıysanız, sistem bu ürünleri her güncellemede yeni ürün sanıp tekrar tekrar oluşturabilir. Bir sabah mağazanızda aynı termostan on iki tane görmek hiç hoş değil.
Stok sıfırlandığında ne olacağını tanımlamamak. Feed'den kalkan bir ürün sizde açık kalırsa, tedarikçide olmayan bir ürünü satmış olursunuz. Kaynakta görünmeyen ürünleri otomatik olarak pasife alan bir kural mutlaka olmalı.
Fiyatı KDV açısından kontrol etmemek. Alış fiyatı KDV hariç geliyor, siz dahil sanıyorsanız her satışta yüzde yirmi zarar edebilirsiniz. İlk kurulumda bunu tek bir ürün üzerinden elle doğrulayın.
Açıklamaları olduğu gibi almak. Tedarikçinin metni, aynı dosyayı kullanan onlarca mağazada birebir yayınlanıyor. Arama motorları kopya içeriği sevmez. En azından çok satan ürünlerde başlık ve açıklamayı kendinize göre düzenleyin; düzenlediğiniz alanların bir sonraki güncellemede üzerine yazılmaması için de bu alanları kilitleyin.
Görsel bağlantılarına güvenmek. Görseller tedarikçinin sunucusundan çekiliyorsa ve o sunucu yavaşlarsa ya da adresler değişirse sitenizde kırık resimler belirir. Görselleri kendi sunucunuza indirmek daha güvenli.
Karakter kodlamasını gözden kaçırmak. "Çelik" kelimesi sitenizde "Çelik" diye görünüyorsa dosya ile sisteminiz farklı kodlamalar kullanıyor demektir. Bu genellikle UTF-8 ayarıyla çözülür, ama fark edilmeden yüzlerce ürün yayına girerse temizliği zahmetli olur. Test aktarımında Türkçe karakterli birkaç ürünü özellikle kontrol edin.
Kurup unutmak. XML entegrasyonu bir kez kurulan ama hiç izlenmeyen bir sistem olmamalı. Tedarikçiler zaman zaman alan adlarını değiştirir, yeni kategoriler ekler ya da dosyanın adresini taşır. Haftada bir hata kayıtlarına göz atmak, sorunu müşteriniz fark etmeden yakalamanızı sağlar.
Sıkça Sorulan Sorular
XML ile API entegrasyonu arasındaki fark nedir?
XML genellikle belirli aralıklarla okunan hazır bir dosyadır; API ise anlık soru-cevap şeklinde çalışır ve sipariş iletme gibi çift yönlü işlemlere daha uygundur. Ürün kataloğu aktarmak için XML çoğu durumda yeterli ve daha hızlı kurulur.
Birden fazla XML kaynağını aynı mağazaya bağlayabilir miyim?
Evet. Her kaynak için ayrı eşleştirme ve fiyat kuralı tanımlamanız gerekir. Aynı ürün iki kaynakta da varsa hangisinin öncelikli olacağını önceden belirlemek işinizi kolaylaştırır.
Güncelleme sırasında ürünlerimde yaptığım düzenlemeler silinir mi?
Sisteminize bağlı. İyi bir entegrasyon, hangi alanların her seferinde güncelleneceğini (fiyat, stok) ve hangilerinin bir kez alınıp sonra dokunulmayacağını (başlık, açıklama) seçmenize izin verir.
Teknik bilgim yoksa XML entegrasyonunu kendim kurabilir miyim?
Arayüzü hazır bir altyapı kullanıyorsanız büyük ölçüde evet. Kod yazmanız gerekmez; asıl emek, eşleştirmeleri ve fiyat kurallarını dikkatle tanımlamaktır.
Feed'inizi bir kez doğru kurduğunuzda katalog yönetimi gündelik bir uğraş olmaktan çıkar, size de satışa ve müşteriye ayıracak zaman kalır. Kaynağı tanımak, anahtarı doğru seçmek ve küçük bir testle başlamak sorunların çoğunu daha ortaya çıkmadan çözer. Kurulum sırasında takıldığınız bir yer olursa, Entegrenzo'nun XML aktarım araçları alan ve kategori eşleştirme ile fiyat kurallarını tek panelden yönetmenize yardımcı olabilir.
