XML Entegrasyonu Nedir? Ürün XML'i, İçeri Alma ve Dışarı Verme, Alan Eşleştirme, Stok ve Fiyat Güncelleme Sıklığı, Hata Yönetimi, Güncelleme Gecikmesi Maliyeti Hesaplayıcısı ve XML Kontrol Listesi

Tedarikçinizin yüzlerce ürününü elle girmek, stok bittiğinde her satırı tek tek kapatmak ve aynı ürünü reklam platformlarına ayrıca yüklemek bir noktadan sonra işletmeyi yavaşlatır. Ürün verisi bir yerde değiştiğinde diğer yerlerin kendiliğinden güncellenmesi için sistemlerin birbiriyle aynı dilde konuşması gerekir. E-ticarette bu ortak dilin en yaygın olanı XML'dir.

Bu rehberde XML entegrasyonu baştan sona ele alınıyor: XML'in ne olduğu, ürün XML'inin nasıl göründüğü, verinin içeri alınması ve dışarı verilmesi arasındaki fark, alan eşleştirmenin nasıl yapıldığı, stok ve fiyat güncellemesinin ne sıklıkla çalışması gerektiği ve en sık görülen hatalar. Güncelleme gecikmesinin size maliyetini hesaplayan bir araç ile kendi XML kaynağınızı ve çıktınızı denetleyebileceğiniz bir kontrol listesi de var. Tedarikçi tarafını anlatan XML Tedarikçi Nedir? yazısıyla yöntemin iş modeli yanını ele alan Xml Bayiliği Nedir ve Nasıl Başlanır? yazısını tekrar etmeden, burada bağlantının kendisine, yani tekniğe ve işletmeye odaklanıyoruz.

XML Entegrasyonu Nedir?

XML entegrasyonu, ürün, stok, fiyat ya da sipariş gibi verilerin XML adı verilen yapılandırılmış bir dosya biçimiyle iki sistem arasında otomatik olarak aktarılmasıdır. Bir taraf veriyi XML olarak yayınlar, diğer taraf belirli aralıklarla bu dosyayı okuyup kendi kayıtlarına işler.

Yöntemin gücü, iki sistemin birbirini tanımak zorunda olmamasıdır. Kaynak sistem veriyi herkesin okuyabileceği bir bağlantıda sunar; okuyan sistem bu bağlantıya gider ve içeriği kendi alanlarına yerleştirir. Aktarımın yönüne göre iki ana kullanım vardır:

Aynı mağaza çoğu zaman iki yönü birlikte kullanır: tedarikçisinden ürün alır, kendi ürünlerini de reklam platformlarına verir. İki yönün mantığı aynıdır; farkı, kimin yayıncı ve kimin okuyucu olduğudur.

Okumanızı öneririzXML Tedarikçi Nedir?

XML Nedir ve Ürün XML'i Nasıl Görünür?

XML, verinin etiketlerle tanımlandığı bir biçimlendirme dilidir; her bilgi bir açılış ve bir kapanış etiketi arasında durur ve etiketler iç içe geçerek bir ağaç oluşturur. Ürün XML'i bu ağacın her dalında bir ürünü anlatır.

Aşağıdaki örnek temsili bir üründür; etiket adları kaynaktan kaynağa değişir ve her kaynak kendi yapısını belirler.

<?xml version="1.0" encoding="UTF-8"?>
<urunler>
  <urun>
    <stok_kodu>ORN-1001</stok_kodu>
    <barkod>8690000000012</barkod>
    <ad>Örnek Keten Gömlek</ad>
    <fiyat>1250.00</fiyat>
    <stok>14</stok>
    <kategori>Giyim &gt; Gömlek</kategori>
    <resim>https://www.ornek.com/img/gomlek-1.jpg</resim>
  </urun>
</urunler>

XML'in bu denli yaygın olmasının nedeni, insanın da makinenin de okuyabilmesidir. Bir dosyayı tarayıcıda açıp içine bakabilir, bir şeyin neden yanlış gittiğini gözle görebilirsiniz. Bu özellik, hata ayıklamayı diğer aktarım yöntemlerine göre kolaylaştırır. Ürün verisi gibi büyük listeler için sözlükte ayrıca XML feed kavramı da anlatılıyor.

XML Entegrasyonu Nasıl Çalışır?

XML entegrasyonu, okuyan sistemin kaynağın bağlantısına belirli aralıklarla gidip dosyayı indirmesi, içeriği ayrıştırması, alanları kendi karşılıklarıyla eşleştirmesi ve değişiklikleri kayıtlara yazmasıyla çalışır. Süreç her turda aynı sırayı izler.

1. Bağlantıya gider: Okuyucu, kaynağın verdiği XML adresine istek gönderir. Kaynak bazen yalnız belirli adreslerden gelen isteklere izin verir.
2. Dosyayı indirir: Büyük bir ürün listesi birkaç parçaya bölünmüş olabilir; okuyucu parçaları sırayla alır.
3. Ayrıştırır: Etiketler okunur, her ürün bir kayıt olarak ayrılır. Bozuk bir etiket bu adımda hata verir.
4. Eşleştirir: Kaynaktaki alanlar mağazadaki alanlarla ilişkilendirilir: stok kodu stok koduna, fiyat fiyata.
5. Karşılaştırır: Yeni gelen veri mevcut kayıtla kıyaslanır; yalnız değişen ürünler güncellenir, yeni ürünler eklenir, kaynaktan kalkanlar işaretlenir.
6. Yazar ve kaydeder: Değişiklikler mağazaya işlenir; kaç ürünün eklendiği, güncellendiği ve hata verdiği günlüğe yazılır.
7. Bekler: Bir sonraki tur zamanı gelene kadar sistem durur; sıklığı belirleyen ayardır.

Dışarı verme yönünde sıra tersine döner: mağaza kendi ürünlerini XML'e çevirir ve bir bağlantıda yayınlar; reklam ya da alışveriş platformu bu bağlantıyı kendi zamanlamasıyla okur. Burada kontrol sizdedir, çünkü hangi ürünlerin, hangi fiyatla ve hangi dilde yayınlanacağını siz belirlersiniz.

Tedarikçiden Ürün Alma (İçeri Alma) Nasıl Yapılır?

Tedarikçiden ürün almak için tedarikçinin XML bağlantısını mağazaya tanıtır, alanları eşleştirir ve güncelleme sıklığını belirlersiniz. Kurulum bir kez yapılır; sonrasında katalog ve stok kendiliğinden güncel kalır.

İçeri Almadan Önce Neye Bakılır?

Kaynak dosyanın kalitesi entegrasyonun kalitesini belirler. Bağlantıyı bağlamadan önce şu soruları cevaplayın:

• Güncelleme sıklığı: Kaynak veriyi ne sıklıkla yeniliyor? Siz dakikada bir okusanız bile kaynak günde bir yenileniyorsa taze veri alamazsınız.
• Alan bütünlüğü: Her üründe stok kodu, fiyat, stok ve görsel var mı? Boş gelen alanlar boş sayfa demektir.
• Tekil kimlik: Ürünleri birbirinden ayıran tek bir alan (stok kodu ya da barkod) var mı? Bu alan eşleştirmenin anahtarıdır.
• Varyantlar: Beden ve renk gibi seçenekler tek ürünün içinde mi, ayrı kayıt olarak mı geliyor?
• Kaynağın güvenilirliği: Bağlantı sık kesiliyor mu, dosya boyutu çok mu büyük?

Kaynağın tedarikçi olarak nasıl seçileceğini ve iş ilişkisinin nasıl kurulacağını XML Tedarikçi Nedir? yazısında bulabilirsiniz; stoksuz çalışan modelin genel mantığı için Stoksuz e-Ticaret Nedir? Stoksuz Satış Nasıl Yapılır? yazısı faydalıdır.

İlk İçeri Alma ile Sonraki Güncellemeler Aynı Şey Değildir

İlk aktarım kataloğu oluşturur: tüm ürünler, görseller ve açıklamalar mağazaya gelir. Sonraki turlar ise yalnız değişimi taşır: stok ve fiyat sık, açıklama ve görsel seyrek değişir. Bu ayrım önemlidir, çünkü her turda her şeyi yeniden yazmak hem yavaştır hem de elle yaptığınız düzeltmelerin üzerine yazabilir. Hangi alanların sürekli kaynaktan, hangilerinin yalnız ilk seferde alınacağını baştan belirleyin.

Ürünleri Reklam ve Alışveriş Platformlarına Dışarı Verme Nasıl Yapılır?

Dışarı verme, mağazadaki ürünlerin reklam ve alışveriş platformlarının istediği biçimde bir XML bağlantısı olarak yayınlanmasıdır. Platform bu bağlantıyı düzenli aralıklarla okuyup ürünlerinizi kendi vitrininde ve reklamlarında gösterir.

Her platformun beklediği alan adları ve zorunlu bilgiler ayrıdır. Bu yüzden dışarı verme çoğu zaman bir şablonla yapılır: şablon, mağazadaki alanların platformun beklediği etiketlere nasıl çevrileceğini belirler. Dikkat edilecekler şunlardır:

• Yalnız satılabilir ürünleri verin: Görseli ve stoğu olmayan ürün reklama çıkarsa ya hata alırsınız ya da tükenmiş ürüne reklam harcarsınız.
• Fiyatı platforma göre ayarlayın: Bazı platformlarda farklı fiyat politikası uygulanabilir; çıktıda fiyatı tutar ya da yüzde olarak artırıp azaltabilmek bu yüzden önemlidir.
• Dil ve para birimini seçin: Yurt dışı pazara yönelik reklamda ürünün ilgili dilde ve para biriminde gitmesi gerekir.
• Bağlantıyı koruyun: Çıktı adresi herkese açık olursa rakipler de ürün ve fiyat listenizi okuyabilir; mümkünse yalnız belirli adreslerden erişime izin verin.
• Dosyayı parçalayın: Çok büyük kataloglarda tek dosya yerine birkaç parça daha güvenli ve hızlı okunur.

Arama motorlarının ürün sayfalarını anlaması için kullanılan yapılandırılmış veri ise ayrı bir konudur; onu Yapılandırılmış Veri (Schema) Nedir? yazısında okuyabilirsiniz.

Okumanızı öneririzToplu Ürün Güncelleme Nasıl Yapılır?

XML'de Alan Eşleştirme Nasıl Yapılır?

Alan eşleştirme, kaynak XML'deki her etiketin mağazadaki hangi alana yazılacağının belirlenmesidir. Eşleştirme yanlışsa veri akar ama yanlış yere akar: fiyat stok alanına, barkod stok koduna yazılabilir.

Stok kodunu doğru yönetmek eşleştirmenin temelidir; stok kodlarının nasıl kurulması gerektiğini SKU Nedir? Stok Kodu (SKU) Nasıl Oluşturulur? yazısı anlatıyor. Kaynakta kategori ağacı sizinkinden farklıysa, her kaynak kategorisini kendi kategorinizle bir kez eşleştirmek sonraki turlarda sizi yeniden uğraştırmaz.

XML Güncelleme Sıklığı Ne Olmalı?

Güncelleme sıklığı, verinin ne kadar çabuk değiştiğine ve bu gecikmenin size ne kadara mal olduğuna göre belirlenir. Stok ve fiyat sık, açıklama ve görsel seyrek güncellenir; sıklık arttıkça yanlış satış ihtimali azalır.

Burada iki ayrı gecikme birbirine karışır. Birincisi okuma aralığıdır: sisteminiz XML'i kaç dakikada bir okuyor? İkincisi kaynağın kendi yenileme aralığıdır: tedarikçi dosyasını ne sıklıkla güncelliyor? Verinin ortalama yaşı, bu iki gecikmenin toplamına bağlıdır. Ne kadar sık okursanız okuyun, kaynak günde bir yenileniyorsa stok o kadar eski kalır.

Faprika'nın XML yönetiminde güncelleme süreleri ve birçok alan müşteri tarafından yönetilir; güncelleme günlük değil, dakikalarla yapılabilir. Dinamik XML Yönetimi eklentisinin tanıtımında da diğer firmalarda ortalama bir gün süren güncelleme süresinin Faprika'da müşteriye bırakıldığı ve dakikalara indirilebildiği belirtilir. Pazaryerleriyle stok eşitleme tarafı için Pazaryeri Stok Senkronizasyonu Nasıl Yapılır? rehberine bakabilirsiniz.

Okumanızı öneririzPazaryeri Stok Senkronizasyonu Nasıl Yapılır?

Güncelleme Gecikmesinin Maliyeti Nasıl Hesaplanır?

Gecikmenin maliyeti, veri bayatken alınan siparişlerin bir kısmının stoğu olmayan ürüne gelmesinden doğar: sipariş iptal edilir, müşteri kaybedilir, bazı kanallarda ceza ya da puan kaybı yaşanır. Aşağıdaki araç bunu kaba bir model üzerinden tahmin eder.

Model şöyle çalışır: günlük güncelleme sayısı turlar arasındaki aralığı verir; verinin ortalama yaşı bu aralığın yarısı ile gecikmenin toplamıdır; yaşın günün ne kadarını kapladığı, bayat veriyle sipariş alma payını gösterir; bu payın stok farkı oranıyla çarpımı tahmini hatalı sipariş sayısını verir. Değerler varsayımdır, kendi verinizle değiştirin.

Sonucu okurken iki şeyi akılda tutun. Birincisi, güncelleme sayısını iki katına çıkarmak verinin yaşını yarıya indirmez; çünkü gecikme sabit kalır. İkincisi, hesap yalnız doğrudan kaybı gösterir; müşterinin iptal edilen siparişten sonra mağazaya duyduğu güven kaybını rakamla ifade etmek zordur ama gerçektir. Gecikmeyi azaltmanın en etkili yolu çoğu zaman sıklığı değil, okuma ile yazma arasındaki bekleyişi kısaltmaktır.

XML Entegrasyonunda Hatalar Nasıl Yönetilir?

XML entegrasyonunda hata yönetimi, hatayı önceden önlemek, olduğunda hızlı fark etmek ve kimin neyi düzelteceğini bilmekten oluşur. Sessiz çalışan bir entegrasyon sorunsuz çalışan entegrasyon demek değildir; aktarım günlüğü düzenli okunmalıdır.

Üç katman birlikte çalışır: kaynak dosyayı denetleyen kurallar (zorunlu alan boş mu, fiyat sıfır mı), aktarım günlüğü (kaç ürün eklendi, güncellendi, hata verdi) ve uyarı (hata oranı eşiği aştığında haber veren mekanizma). Aşağıdaki tablo en sık karşılaşılan durumları özetler.

Özellikle boş dosya durumu tehlikelidir: kaynak bir arıza sırasında içi boş bir XML yayınlarsa, entegrasyon bunu “tüm ürünlerin stoğu bitti” diye yorumlayıp bütün kataloğu kapatabilir. Bunu önlemek için gelen kayıt sayısı önceki turdan keskin biçimde azalmışsa güncellemeyi uygulamayan bir eşik kullanın. Güvenlik stoku ise kaynakta görünen stoktan belirli bir miktarı mağazada saklı tutarak gecikmenin yol açtığı fazla satışı tamponlar.

XML Entegrasyonunda Sık Yapılan Hatalar

XML kurulumundaki hatalar çoğunlukla teknik değil, planlama kaynaklıdır. En sık görülenler şunlardır:

• Kaynağın güncelleme aralığını sormamak: Siz sık okusanız da kaynak seyrek yeniliyorsa gecikme kaçınılmazdır.
• Her şeyi her turda yazmak: Elle düzelttiğiniz metinler ve görseller sürekli üzerine yazılır.
• Eşleştirmeyi tek üründe denemeden tüm kataloğa uygulamak: Yanlış eşleşme binlerce kaydı bozabilir.
• Boş dosyaya karşı koruma koymamak: Tek bir arıza bütün kataloğu pasife alabilir.
• Güvenlik stoku bırakmamak: Stok sıfıra inene kadar satmak, gecikme olduğunda satılamayacak ürünü satmak demektir.
• Dışarı verilen çıktıda stoksuz ve görselsiz ürün bırakmak: Reklam tükenmiş ürüne gider ya da hata alınır.
• Çıktı adresini herkese açık bırakmak: Ürün ve fiyat listeniz kolayca kopyalanır.
• Günlüğü okumamak: Hata uzun süre fark edilmeden birikir.

Okumanızı öneririzStokta Olmayan Ürün Sayfası Ne Yapılmalı?

Faprika ile XML Entegrasyonu Nasıl Yapılır?

Faprika'da XML yönetimi iki parçadan oluşur: ürün aktarımı ve stok güncellemesi için kullanılan Dinamik XML Yönetimi ile panelden alınan ürün çıktısı. İkisinde de hedef aynıdır: güncelleme sürelerini ve alanları sizin yönetmeniz.

Dinamik XML Yönetimi eklentisi ürün aktarımını, stok güncellemeyi ve satış raporlarını dışa aktarmayı özelleştirilebilir XML yapılarıyla yönetmenizi sağlar. Alanların özelleştirilebilir olması, kaynağın yapısına uymanıza ve kendi tercihlerinizi belirlemenize imkân verir. Eklenti, süreci otomatik ve sürekli kılmak için tasarlanmıştır.

Panelden Ürün XML'i Nasıl Alınır?

Reklam ve alışveriş platformları için ürün çıktısı panelden birkaç adımda oluşturulur. Yönetici panelinde Katalog, Aktarım, Ürünleri Dışarı Aktar adımlarını izlersiniz. Ayrıntılı anlatım için Ürünleri Dışarı Aktarma eğitimine bakabilirsiniz.

Önce hangi ürünlerin dışarı verileceğini filtrelersiniz: resimli ürünler, ürün tipi, aktif ürünler, stok başlangıç miktarı ve kategori. Filtrelemeyi boş bırakırsanız tüm ürünler gönderilir. Ardından çıktı ayarlarını doldurursunuz:

Aktif kutusunu işaretleyip kaydettikten sonra çıktı bağlantılarına girer ve karşınıza çıkan XML bağlantısını kullanırsınız. Filtreleme zorunlu değildir; ancak reklam çıkacağınız ürünlerin görselleri ve stokları olması hata almamanızı ve stoğu olmayan ürüne reklam çıkmamasını sağlar.

Faprika'da Güncelleme Nasıl Yönetilir?

Faprika, XML güncellemelerinde süre ve alanları müşteriye bırakır. Bu, iki pratik sonuç doğurur: kampanya ya da yoğun satış döneminde sıklığı artırabilir, sakin dönemde azaltabilirsiniz; ve kaynaktaki alanları kendi mağaza yapınıza uygun eşleştirebilirsiniz. Eklenti ve diğer çözümlerin hangi pakette bulunduğu paketlere göre değişir; ayrıntılar için e-ticaret paketleri karşılaştırmasına bakabilirsiniz.

XML Entegrasyonu Kontrol Listesi

Bir XML kaynağını bağlamadan ya da bir çıktıyı yayınlamadan önce aşağıdaki listeden geçin. Her madde “evet” olduğunda akışınız sağlam bir temele oturmuş demektir.

Sıkça Sorulan Sorular

XML entegrasyonu nedir?

XML entegrasyonu, ürün, stok ve fiyat gibi verilerin XML biçimindeki bir dosya aracılığıyla iki sistem arasında otomatik aktarılmasıdır. Bir sistem veriyi XML bağlantısında yayınlar, diğeri belirli aralıklarla okuyup kendi kayıtlarına işler.

XML ile ürün içeri almak ile dışarı vermek arasındaki fark nedir?

İçeri almada dışarıdaki bir kaynağın ürün ve stok verisi mağazanıza okunur; tedarikçiden katalog kurmak için kullanılır. Dışarı vermede mağazanızdaki ürünler XML bağlantısı olarak yayınlanır; reklam ve alışveriş platformları bu bağlantıyı okur.

XML güncellemesi ne sıklıkla yapılmalı?

Stok ve fiyat en sık, açıklama ve görseller seyrek güncellenir. Sipariş hacmi yükseldikçe ve kaynak sık yenilendikçe sıklık artırılmalıdır. Faprika'da güncelleme süreleri müşteri tarafından yönetilir ve günlük değil dakikalarla yapılabilir.

XML'de alan eşleştirme neden önemlidir?

Eşleştirme kaynaktaki her bilginin mağazada doğru alana yazılmasını sağlar. Hatalı eşleştirmede fiyat stok alanına ya da barkod stok koduna yazılabilir. Bu yüzden eşleştirme önce tek üründe denenmeli, sonra tüm kataloğa uygulanmalıdır.

XML entegrasyonunda en sık hata nedir?

Bozuk karakter kodlaması, benzersiz olmayan stok kodu, yanlış alan eşleştirmesi, kaynağın boş dosya yayınlaması ve güncelleme gecikmesi en sık görülen hatalardır. Aktarım günlüğünü düzenli okumak ve boş dosyaya karşı koruma koymak bunların çoğunu önler.

Faprika'da ürünleri reklam platformları için XML olarak nasıl alırım?

Yönetici panelinde Katalog, Aktarım, Ürünleri Dışarı Aktar adımlarında ürünleri filtreler; çıktı adı, dosya tipi, şablon, dil, para birimi ve fiyat farkını ayarlar ve kaydettikten sonra çıktı bağlantısındaki XML adresini kullanırsınız. Reklam çıkacağınız ürünlerde görsel ve stok bulunması hata almamanızı sağlar.

İlginizi Çekebilecek Yazılar

• XML Tedarikçi Nedir?
• Toplu Ürün Güncelleme Nasıl Yapılır?
• Pazaryeri Stok Senkronizasyonu Nasıl Yapılır?
• Stok Takibi Nedir? Nasıl Yapılır?