XML entegrasyonu, e-ticarette özellikle ürün, stok ve fiyat bilgisini farklı sistemler arasında düzenli olarak taşımak için kullanılan pratik bir yöntemdir. Tedarikçiniz size binlerce ürünün yer aldığı bir XML dosyası verir; e-ticaret siteniz bu dosyayı belirli aralıklarla okur, ürünleri eşleştirir, stokları günceller ve fiyat değişikliklerini sisteme işler. Doğru kurulduğunda manuel Excel yükleme ihtiyacını ciddi şekilde azaltır.
Fakat XML entegrasyonu her sorunu çözen sihirli bir yapı değildir. XML dosyasının alanları düzensizse, stok bilgisi güncel değilse, ürün görselleri eksikse veya fiyat kuralları baştan yazılmadıysa otomasyon yanlış ürünü yayına alabilir, stokta olmayan ürünü satabilir ya da kârsız fiyat oluşturabilir. Bu yüzden XML entegrasyonu teknik bir veri aktarımı kadar, iş kuralı planlamasıdır.
XML entegrasyonu nedir?
XML, veriyi etiketler içinde saklayan ve sistemler arasında paylaşılabilir hale getiren bir işaretleme formatıdır. MDN Web Docs, XML'in HTML'e benzediğini ancak önceden tanımlı etiketlerle sınırlı olmadığını; ihtiyaçlara göre özel etiketler tanımlanabildiğini ve standart sözdizimi sayesinde farklı sistemler tarafından ayrıştırılabildiğini açıklar MDN Web Docs. E-ticarette bu esneklik, ürün verilerini düzenli bir dosya yapısında taşımayı kolaylaştırır.
Bir XML dosyasında her ürün genellikle ayrı bir ürün etiketi içinde yer alır. Bu ürünün stok kodu, adı, açıklaması, fiyatı, para birimi, stok adedi, kategori bilgisi, marka, barkod ve görsel URL'leri ayrı alanlar olarak bulunabilir. E-ticaret sistemi bu alanları kendi ürün modeline eşleyerek kayıt oluşturur veya var olan ürünleri günceller.
E-ticaret entegrasyon hizmeti kapsamında XML genellikle tedarikçi ürün aktarımı, stok/fiyat güncelleme, Google Merchant Center ürün feed'i, pazaryeri ürün aktarımı veya bayilere ürün listesi sağlama amacıyla kullanılır. Önemli olan, XML'in yalnızca dosya formatı olduğunu unutmamaktır; doğru sonuç için eşleştirme, doğrulama ve hata yönetimi gerekir.
XML dosyasında hangi alanlar bulunur?
Her tedarikçinin XML yapısı farklı olabilir. Bir tedarikçi `sku` alanı kullanırken başka biri `stok_kodu`, `model_kodu` veya `productCode` alanı kullanabilir. Aynı şekilde fiyat, KDV, indirimli fiyat, kategori ve görsel alanları da farklı isimlerle gelebilir. Bu yüzden XML entegrasyonunun ilk adımı alanları okumak değil, alanların ne anlama geldiğini netleştirmektir.
Aşağıdaki örnek, gerçek bir tedarikçi dosyası değildir; e-ticaret XML entegrasyonunda sık görülen alanları göstermek için sadeleştirilmiş örnek bir ürün kaydıdır:
<product>
<sku>AYK-1001-SIYAH-42</sku>
<name>Siyah Deri Sneaker 42</name>
<brand>Ornek Marka</brand>
<barcode>8690000000012</barcode>
<category>Ayakkabı > Erkek Sneaker</category>
<price currency="TRY">1299.90</price>
<stock>18</stock>
<image>https://cdn.example.com/ayk-1001.jpg</image>
</product>
Bu örnekte en kritik alan `sku`, yani stok kodudur. Çünkü sistem her gün aynı XML'i okuduğunda hangi ürünün yeni, hangisinin güncellenecek ürün olduğunu bu benzersiz kodla anlar. Stok kodu değişirse sistem aynı ürünü yeni ürün gibi açabilir; bu da SEO, stok ve sipariş yönetimi açısından sorun yaratır.
XML entegrasyonu ne zaman kullanılmalı?
XML entegrasyonu özellikle ürün sayısı yüksek, veri güncellemesi sık ve manuel işlem riski fazla olan e-ticaret yapılarında anlamlıdır. 50 ürünlü bir butik mağazada manuel ürün yönetimi yeterli olabilir. Ancak 5.000 ürünlü bir tedarikçi kataloğu, her gün değişen stoklar ve saatlik fiyat güncellemeleri varsa XML entegrasyonu ciddi ihtiyaç haline gelir.
| Senaryo | XML gerekli mi? | Neden? |
|---|---|---|
| Tek tedarikçiden binlerce ürün alınıyor | Evet | Ürün, stok ve fiyatı manuel yönetmek zorlaşır |
| Stoklar günde birkaç kez değişiyor | Evet | Stokta olmayan ürün satışı riski artar |
| Fiyatlar döviz kuruna göre güncelleniyor | Evet | Manuel fiyat güncelleme hata ve gecikme yaratır |
| Ürün sayısı az, fiyatlar sabit | Şart değil | Basit yönetim paneli yeterli olabilir |
| Pazaryerlerine düzenli ürün aktarımı yapılacak | Genellikle evet | Ürün verisinin standart ve güncel olması gerekir |
| Canlı sipariş, ödeme ve kargo yönetimi gerekiyor | XML tek başına yetmeyebilir | API veya ERP entegrasyonu gerekebilir |
Örneğin yedek parça satan bir işletme düşünelim. Tedarikçinin XML'inde 12.000 ürün, her ürün için stok adedi, tedarik süresi ve alış fiyatı var. Bu işletme fiyatlara yüzde 25 kâr ekleyip, stok 3'ün altına düşünce ürünü satıştan kaldırmak istiyor. Bu kural XML entegrasyonunda net yazılırsa sistem her gün aynı mantıkla çalışır.
XML ile API entegrasyonu arasındaki fark nedir?
XML entegrasyonu çoğunlukla dosya bazlı ve periyodik çalışır. Sistem belirli saatte XML dosyasını indirir, okur ve değişiklikleri işler. API entegrasyonu ise genellikle daha canlı ve olay bazlıdır; sistemler doğrudan istek gönderip yanıt alabilir. Bu nedenle XML daha çok katalog, fiyat ve stok aktarımı için; API ise sipariş, ödeme, kargo ve gerçek zamanlı işlemler için tercih edilir.
API entegrasyon hizmeti gereken durumlarda XML'i zorlamak işleri yavaşlatabilir. Örneğin müşteri sipariş verdiğinde tedarikçiye anında sipariş açılması, kargo barkodu alınması veya ödeme durumunun saniyeler içinde doğrulanması gerekiyorsa API daha doğru çözümdür. XML ise tedarikçinin güncel ürün kataloğunu düzenli çekmek için hâlâ pratik olabilir.
| Kriter | XML entegrasyonu | API entegrasyonu |
|---|---|---|
| Çalışma şekli | Dosya okunur, periyodik güncellenir | Sistemler anlık istek/yanıt ile konuşur |
| Uygun kullanım | Ürün, stok, fiyat, kategori aktarımı | Sipariş, ödeme, kargo, müşteri, canlı stok |
| Güncellik | Dakikalık, saatlik veya günlük olabilir | Daha gerçek zamanlı çalışabilir |
| Kurulum karmaşıklığı | Basit yapılarda daha hızlı başlar | Yetkilendirme, endpoint ve hata yönetimi ister |
| Hata kontrolü | Dosya ve alan doğrulaması gerekir | Yanıt kodu, log ve yeniden deneme gerekir |
Pratikte birçok e-ticaret projesi hibrit çalışır. Tedarikçi ürün kataloğu XML ile çekilir; sipariş, fatura veya kargo hareketleri API ile yönetilir. Bu ayrım baştan yapılırsa sistem hem hızlı kurulabilir hem de gereksiz karmaşıklıktan kaçınır.
Stok ve fiyat güncellemede nelere dikkat edilmeli?
XML entegrasyonlarında en kritik konu stok ve fiyat güncellemesidir. Tedarikçi XML'inde gelen stok adedi doğrudan satışa açılacak mı, yoksa güvenli stok payı düşülecek mi? Fiyat üzerine kâr marjı eklenecek mi? KDV dahil mi, hariç mi? Döviz kuru hangi kaynaktan alınacak? Bu sorular yanıtlanmadan XML'i otomatik çalıştırmak risklidir.
Stok takip yazılımı ile XML entegrasyonu birlikte düşünülmelidir. Örneğin tedarikçide 2 adet görünen ürün, sizin sitenizde satışa açılmayabilir; çünkü aynı ürün pazaryerlerinde de satılıyordur ve stok hızla tükenebilir. Bu durumda "tedarikçi stok adedi 5'in altındaysa satışa kapat" gibi güvenli stok kuralı uygulanabilir.
Fiyat tarafında da benzer kurallar gerekir:
- Alış fiyatı mı, satış fiyatı mı geliyor?
- Fiyat KDV dahil mi, hariç mi?
- Dövizli fiyatlarda kur hangi saat aralığında güncellenecek?
- Minimum kâr marjı veya taban fiyat var mı?
- İndirimli fiyat varsa normal fiyatla ilişkisi kontrol ediliyor mu?
- Fiyat aniden yüzde 50 düşerse otomatik yayına alınacak mı, onaya mı düşecek?
Örneğin tedarikçi XML'inde bir ürünün alış fiyatı 800 TL, stok adedi 12 ve KDV hariç geliyor olabilir. İşletme bu ürüne yüzde 30 kâr ekleyip KDV dahil satış fiyatı hesaplamak istiyorsa formül net olmalıdır. Aksi halde aynı XML verisi farklı ekipler tarafından farklı yorumlanır.
Pazaryeri ve reklam feed'lerinde XML nasıl kullanılır?
XML yalnızca tedarikçiden ürün çekmek için kullanılmaz; e-ticaret sitesindeki ürünleri başka platformlara aktarmak için de kullanılır. Pazaryerleri, fiyat karşılaştırma siteleri, Google Merchant Center veya reklam sistemleri ürün verisini belirli formatta görmek isteyebilir. Bu durumda site, dışarıya kendi XML ürün feed'ini üretir.
Google Merchant Center ürün veri spesifikasyonu; ürün bilgilerinin metin feed'i, XML feed veya API yoluyla eklenebileceğini ve doğru biçimlendirilmiş ürün verisinin reklamlar ile ücretsiz listelemeler için kritik olduğunu açıklar Google Merchant Center Help. Aynı doküman, eksik veya yanlış ürün verisinin ürünlerin reddedilmesine ya da yanlış gösterilmesine yol açabileceğini belirtir.
Pazaryeri entegrasyonu tarafında XML feed kullanılırken her platformun alan beklentileri ayrı değerlendirilmelidir. Bir platform `brand` isterken başka biri `manufacturer`, biri `sale_price`, diğeri `discounted_price` kullanabilir. Bu yüzden tek bir iç ürün veri modeli kurup, her hedef kanal için ayrı dışa aktarma şablonu oluşturmak daha sağlıklıdır.
XML entegrasyonunda hata yönetimi nasıl olmalı?
XML entegrasyonu canlıya alındıktan sonra en önemli ihtiyaç hata görünürlüğüdür. Dosya indirilemedi mi, XML bozuk mu, 500 ürünün görsel URL'i açılmıyor mu, fiyat alanı boş mu, kategori eşleşmedi mi, aynı stok kodu iki kez mi geldi? Bu sorular panelde görünmezse otomasyon sessizce hata üretir.
Google Manufacturer Center planlı çekim dokümanı, feed URL'inin doğrudan feed dosyasına işaret etmesi gerektiğini ve HTML sayfasına yönlendirilirse feed işlemenin başarısız olacağını belirtir Google Manufacturer Center Help. Bu basit uyarı e-ticaret XML entegrasyonları için de geçerlidir: sistemin okuduğu kaynak gerçekten beklenen dosya mı, yoksa giriş sayfası, hata sayfası veya boş yanıt mı?
Yönetim paneli geliştirme sürecinde XML entegrasyonu için şu kayıtlar tutulmalıdır:
- Son başarılı XML okuma zamanı.
- Dosyada bulunan toplam ürün sayısı.
- Yeni eklenen, güncellenen ve pasife alınan ürün sayısı.
- Hatalı ürün kayıtları ve hata nedeni.
- Boş fiyat, eksik stok, geçersiz görsel, kategori eşleşmeme kayıtları.
- Fiyat/stok güvenlik kuralına takılan ürünler.
- Manuel onay bekleyen kritik değişiklikler.
Örneğin sistem gece 03:00'te XML'i okudu ve 8.000 üründen 640 tanesinde kategori eşleşmedi. Bu durumda entegrasyon tamamen durdurulabilir veya sadece hatasız ürünler işlenip sorunlu ürünler onaya düşürülebilir. Hangi davranışın seçileceği işletmenin risk toleransına göre belirlenmelidir.
XML entegrasyonu SEO'yu nasıl etkiler?
XML entegrasyonu yanlış kurgulanırsa SEO tarafında sorun çıkarabilir. Tedarikçiden gelen aynı ürün açıklaması yüzlerce sitede kullanılıyorsa kopya içerik riski oluşur. Ürün URL'leri her gün değişiyorsa Google aynı ürünü takip etmekte zorlanır. Stokta olmayan ürünler kontrolsüz kaldırılıyorsa kategori sayfaları zayıflayabilir.
Teknik SEO danışmanlığı açısından XML entegrasyonunda şu kararlar önemlidir: ürün URL'i kalıcı mı, ürün pasife düşünce 404 mü olacak yoksa stokta yok mesajı mı gösterilecek, tedarikçi açıklaması özgünleştirilecek mi, varyantlar tek ürün altında mı yönetilecek, ürün görselleri optimize edilecek mi? XML verisi SEO uyumlu hale getirilmeden doğrudan yayına alınmamalıdır.
Google yerel ürün feed'i dokümanı, doğru ürün ve fiyat bilgisinin kullanıcıların ürüne güvenmesine yardımcı olduğunu; feed'in düzenli güncellenmesi gerektiğini açıklar Google Merchant Center Help. Bu prensip SEO ve kullanıcı deneyimi için de geçerlidir: kullanıcı arama sonucundan ürüne geldiğinde fiyat, stok ve sayfa bilgisi tutarlı olmalıdır.
Ne zaman XML yerine daha gelişmiş entegrasyon gerekir?
XML entegrasyonu katalog verisi için çok kullanışlıdır; fakat işletme büyüdükçe bazı noktalarda yetersiz kalabilir. Eğer siparişlerin ERP'ye anlık düşmesi, muhasebe faturalarının otomatik kesilmesi, depolar arası stok hareketlerinin canlı izlenmesi veya pazaryeri siparişlerinin tek panelde toplanması gerekiyorsa XML tek başına doğru araç olmayabilir.
Bu aşamada API entegrasyonu, ERP bağlantısı veya özel ara katman gerekebilir. XML dosyası belirli aralıklarla "fotoğraf" verir; API ise sistemler arasında daha canlı konuşma sağlar. Özellikle sipariş, ödeme, iade ve kargo gibi olay bazlı süreçlerde API yaklaşımı daha güvenlidir.
Başlamadan önce XML entegrasyonu kontrol listesi
XML entegrasyonuna başlamadan önce tedarikçi dosyasını birkaç gün üst üste incelemek faydalıdır. Alanlar tutarlı mı, stoklar gerçekten güncelleniyor mu, fiyat biçimi değişiyor mu, ürün kodları sabit mi? Bu denetim yapılmadan canlı otomasyona geçmek pahalı hatalar doğurabilir.
- XML dosyasındaki ürün kodunun benzersiz ve değişmez olduğundan emin olun.
- Fiyatın KDV dahil/hariç, para birimi ve indirimli fiyat mantığını netleştirin.
- Stok güvenlik payı ve satışa kapatma eşiği belirleyin.
- Kategori eşleştirme tablosu oluşturun.
- Görsel URL'lerinin açılıp açılmadığını test edin.
- Eksik açıklama, boş marka, hatalı barkod gibi alanlar için doğrulama kuralı yazın.
- Fiyat anomalisinde otomatik güncelleme yerine onay mekanizması kurun.
- XML okuma sıklığını işletmenin stok ve fiyat değişim hızına göre belirleyin.
- Hata logları ve son başarılı çalışma bilgisini panelde görünür yapın.
- XML'den gelen ürün açıklamalarını SEO ve kullanıcı deneyimi açısından iyileştirin.
Sonuç: XML entegrasyonu veri disipliniyle değer üretir
E-ticarette XML entegrasyonu, ürün kataloğu büyük olan ve stok/fiyat bilgisi sık değişen işletmeler için güçlü bir otomasyon aracıdır. Tedarikçi ürünlerini içeri almak, fiyatları güncellemek, stokları senkronize etmek veya dış platformlara ürün feed'i üretmek için pratik ve yaygın bir yöntemdir. Ancak başarısı XML dosyasının varlığına değil, alan eşleştirme, iş kuralları, hata kontrolü ve veri kalitesine bağlıdır.
Webioo, XML entegrasyonlarını yalnızca dosya okuma işlemi olarak değil; ürün veri modeli, fiyat kuralı, stok güvenliği, pazaryeri aktarımı, yönetim paneli ve SEO etkisiyle birlikte planlar. Böylece entegrasyon, manuel işi azaltırken yeni hatalar üretmeyen sürdürülebilir bir yapıya dönüşür.
Sıkça Sorulan Sorular
E-ticarette XML entegrasyonu nedir?
E-ticarette XML entegrasyonu, tedarikçi, pazaryeri, ERP veya reklam sistemlerinden gelen ürün, stok, fiyat, kategori ve görsel verilerinin XML dosyası üzerinden e-ticaret sitesine aktarılmasıdır. Sistem XML dosyasını belirli aralıklarla okur, alanları kendi ürün yapısıyla eşleştirir ve gerekli güncellemeleri yapar.
XML entegrasyonu ne zaman gerekir?
Ürün sayısı yüksekse, stok ve fiyatlar sık değişiyorsa, tedarikçi kataloğu düzenli güncelleniyorsa veya manuel Excel yüklemeleri hata yaratıyorsa XML entegrasyonu gerekir. Az ürünlü, fiyatları sabit ve nadiren güncellenen mağazalarda ise basit yönetim paneli yeterli olabilir.
XML entegrasyonu ile API entegrasyonu arasındaki fark nedir?
XML entegrasyonu genellikle dosya bazlı ve periyodik çalışır; ürün, stok ve fiyat aktarımı için uygundur. API entegrasyonu ise sistemlerin anlık istek ve yanıtlarla konuşmasını sağlar; sipariş, ödeme, kargo, iade ve canlı stok gibi süreçlerde daha uygundur. Birçok projede XML ve API birlikte kullanılır.
Tedarikçi XML'i doğrudan siteye aktarılabilir mi?
Teknik olarak aktarılabilir, ancak doğrudan yayına almak çoğu zaman risklidir. Önce ürün kodu, fiyat, KDV, stok, kategori, marka, barkod, görsel ve açıklama alanları doğrulanmalıdır. Eksik veya hatalı ürünler onaya düşürülmeli, kritik fiyat değişiklikleri otomatik yayına alınmadan kontrol edilmelidir.
XML entegrasyonu stok hatalarını tamamen önler mi?
Hayır. XML entegrasyonu stok bilgisini otomatik güncelleyebilir ama stok verisinin ne kadar güncel olduğu tedarikçi dosyasına ve okuma sıklığına bağlıdır. Stok hatalarını azaltmak için güvenli stok payı, satışa kapatma eşiği, sık güncelleme ve hata logları kullanılmalıdır.
XML entegrasyonu SEO'yu etkiler mi?
Evet, dolaylı olarak etkileyebilir. XML ile gelen ürün açıklamaları kopya ve zayıfsa, ürün URL'leri değişiyorsa veya stokta olmayan ürünler yanlış yönetiliyorsa SEO sorunları oluşabilir. Ürün açıklamaları, kalıcı URL yapısı, görsel optimizasyonu ve yapılandırılmış ürün verisi XML entegrasyonuyla birlikte planlanmalıdır.
