XML Entegrasyonu Nedir, Nasıl Yapılır? Kapsamlı Rehber

XML entegrasyonu, ürün bilgilerinizin (başlık, açıklama, fiyat, stok, görsel, kategori, barkod) tek bir XML dosyası üzerinden pazaryerlerine otomatik ve periyodik olarak aktarılması sistemidir. Kaynak XML çoğunlukla tedarikçinizden gelir; entegrasyon aracı bu dosyayı düzenli aralıklarla okur, alanları her pazaryerinin istediği formata eşler ve stok/fiyat değişikliklerini Trendyol, Hepsiburada, N11, Pazarama, Amazon ve İdefix gibi kanallara yansıtır. Pratik sonucu şudur: binlerce ürünü dakikalar içinde yükler, tedarikçide biten ürün mağazanızda otomatik kapanır, tedarikçi zam yaptığında sizin fiyatınız da güncellenir — yani stok dışı satış cezası ve zararına satış riskleri ortadan kalkar. Manuel ürün girişi 50-100 ürüne kadar idare eder; onun ötesinde XML entegrasyonu bir tercih değil zorunluluktur. Bu rehberde XML dosyasının yapısını, entegrasyonun adım adım kurulumunu, alan eşleştirme (mapping) inceliklerini, senkronizasyon periyodu seçimini ve en sık yapılan hataları anlatıyoruz.

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

XML (eXtensible Markup Language), ürün verisini makinelerin okuyabileceği etiketli bir yapıda taşıyan dosya formatıdır. Tipik bir ürün kaydında şu alanlar bulunur: ürün adı, açıklama, marka, kategori, barkod/stok kodu, satış fiyatı, stok adedi ve görsel URL'leri. Entegrasyon şu döngüyle çalışır:

1. Entegrasyon aracı, tedarikçinin XML adresini belirli aralıklarla (örn. saatlik) okur.
2. Yeni ürünler pazaryeri formatına dönüştürülüp mağazanıza eklenir.
3. Mevcut ürünlerde stok ve fiyat farkları tespit edilip güncellenir.
4. Kaynakta kaldırılan/stoksuz ürünler mağazanızda satışa kapatılır.

Bu döngü kurulduktan sonra insan müdahalesi gerektirmez; sizin işiniz kural koymak (kâr marjı, fiyat kuralları) ve sonucu izlemektir.

XML Entegrasyonunun Somut Faydaları

• Hız: Binlerce ürün tek seferde yüklenir; manuel giriş günler sürerken XML dakikalar alır.
• Stok güvenliği: Tedarikçide biten ürün otomatik kapanır; stok dışı satış cezası riski biter.
• Fiyat güvenliği: Kaynak fiyat artınca satış fiyatınız kurala göre güncellenir; zararına satış önlenir.
• Hata azalması: Elle veri girişinden kaynaklanan yanlış fiyat/stok hataları ortadan kalkar.
• Çok kanallı tutarlılık: Aynı kaynak birden fazla pazaryerini beslediğinde tüm kanallarda veri tutarlı kalır.

Adım Adım XML Entegrasyonu Kurulumu

1. Kaynak XML'i edinin: Tedarikçinizden XML adresi (URL) isteyin. Kendi ürünlerinizi satıyorsanız kataloğunuzdan XML üreten bir yapı kurabilirsiniz.
2. XML kalitesini kontrol edin: Güncellenme sıklığı, barkod alanının doluluğu, görsel kalitesi ve kategori bilgisinin tutarlılığı entegrasyonun kalitesini belirler. Bayat veya eksik XML, sonraki her adımı sabote eder.
3. Alan eşleştirmesi (mapping) yapın: Kaynaktaki kategori/marka/özellik alanlarını her pazaryerinin kendi taksonomisine eşleyin. Bu, kurulumun en emek isteyen adımıdır; yanlış kategori eşlemesi ürünün filtrelerde görünmemesine yol açar (bkz. doğru kategori ve özellik seçimi).
4. Fiyat kuralları tanımlayın: Kaynak fiyatın üzerine kâr marjı, komisyon ve kargo payı ekleyen kurallar kurun. Kesintileri hesaba katmadan sabit yüzde koymak en sık zarar nedenidir; kanal bazlı gerçek maliyeti komisyon hesaplama aracıyla çıkarın.
5. Senkronizasyon periyodunu ayarlayın: Stok/fiyat için sık (örn. saatlik), tam katalog taraması için daha seyrek periyot yaygın pratiktir.
6. Test edin ve doğrulayın: Küçük bir ürün grubuyla başlayın; stok düşüşünün, fiyat değişiminin ve ürün kapanmasının kanala yansıdığını fiilen doğrulayın, sonra tüm kataloğu açın.

Alan Eşleştirmede Kritik Noktalar

• Barkod/stok kodu: Ürünün kanallar arasında eşleşmesini sağlayan kimliktir; boş veya uydurma barkod, mükerrer ürün ve eşleşme hatası üretir.
• Kategori eşlemesi: Her pazaryerinin kategori ağacı farklıdır; "en yakın" değil "doğru" kategoriyi seçin.
• Zorunlu özellikler: Bazı kategorilerde renk, beden, garanti gibi alanlar zorunludur; eksikse ürün onaylanmaz.
• Görsel kuralları: Pazaryerlerinin çözünürlük ve fon kuralları vardır; kaynak görseller kurala uymuyorsa ürün reddedilebilir.
• Açıklama temizliği: Kaynaktaki HTML artıkları, yasaklı kelimeler ve rakip site adları temizlenmelidir.

Kaç Pazaryerine Tek XML ile Bağlanabilirsiniz?

Tek kaynak XML, iyi bir entegrasyon aracıyla tüm kanallarınızı besleyebilir: aynı katalog Trendyol, Hepsiburada, N11, Pazarama, Amazon ve İdefix'e ayrı ayrı formatlanarak dağıtılır. Bu kurgunun en kritik kazanımı stok tutarlılığıdır — bir kanalda satılan ürünün stoğu tüm kanallarda düşer. Çok kanallı yapının stratejisi için çoklu pazaryeri yönetimi rehberine, stok mimarisi için çok kanallı envanter senkronizasyonu yazısına bakın.

XML Entegrasyonu Kârlılıkla Nasıl Bağlanır?

Entegrasyonun gözden kaçan boyutu şudur: XML yalnızca operasyonu değil, kâr disiplinini de otomatikleştirmenin altyapısıdır. Kaynak XML'deki alış fiyatı, sizin maliyet verinizdir; bu veri sisteme doğru aktığında her satışın gerçek kârı otomatik hesaplanabilir hale gelir. Bu yüzden fiyat kuralı kurarken iki katmanlı düşünün: (1) satış fiyatı kuralı — maliyet üzerine komisyon, kargo ve hedef marjı koyan formül; (2) kâr doğrulama katmanı — satış gerçekleştikten sonra hakedişteki gerçek kesintilerle planlanan kârı karşılaştıran rapor. İkinci katman olmadan birinci katmanın doğruluğunu asla bilemezsiniz: komisyon oranı değişmiş, desi farklı ölçülmüş veya tedarikçi fiyatı satış anı ile senkron arasında artmış olabilir. Trendmetrik bu iki katmanı birlikte sunar; XML'den gelen maliyet verisi, sipariş bazlı net kâr raporuna otomatik bağlanır (yöntem: net kâr analizi rehberi).

XML mi, Excel mi, API mi?

Toplu ürün yönetiminde üç yöntem karşılaştırıldığında her birinin doğru kullanım alanı netleşir:

Kriter	XML	Excel	API
Güncelleme şekli	Otomatik, periyodik	Manuel, dosya yükleme	Gerçek zamanlı
Teknik gereksinim	Düşük (araçla)	Yok	Yazılım geliştirme gerekir
Uygun senaryo	Tedarikçi kataloğu, sürekli senkron	Tek seferlik toplu işlem	Kendi yazılımını yazan büyük operasyonlar
Stok güvenliği	Yüksek (otomatik)	Düşük (insan unutur)	En yüksek
Maliyet	Araç aboneliği	Ücretsiz ama emek-yoğun	Geliştirme + bakım maliyeti

Pratikte çoğu satıcı için doğru cevap XML'dir: Excel'in otomasyonsuzluğu ölçekte sürdürülemez, API ise kendi yazılım ekibi olmayanlar için erişilemezdir. İyi bir entegrasyon aracı zaten arka planda pazaryerlerinin API'lerini kullanır — siz XML bağlarsınız, araç API konuşur.

Tipik XML Alan Sözlüğü

Tedarikçi XML'lerinde alan adları değişse de taşınan bilgi standarttır. En kritik alanlar ve dikkat noktaları:

Alan	Taşıdığı bilgi	Dikkat noktası
barcode / gtin	Ürün kimliği (EAN/GTIN)	Boşsa kanal eşleşmesi çalışmaz
stock_code / sku	Tedarikçi stok kodu	Varyant ayrımında kullanılır
price / list_price	Alış/liste fiyatı	KDV dahil mi hariç mi — mutlaka doğrulayın
quantity / stock	Stok adedi	Güncellenme sıklığı kritik
category_path	Kaynak kategori ağacı	Pazaryeri kategorisine eşlenmeli
images	Görsel URL'leri	Çözünürlük/fon kurallarına uygunluk
variants	Renk/beden varyantları	Varyant yapısı platformlara farklı eşlenir

Yeni bir tedarikçi XML'i bağlamadan önce bu alanların doluluk oranını kontrol etmek, sonradan yaşanacak eşleşme sorunlarının çoğunu baştan önler. Fiyat alanının KDV durumu özellikle sinsi bir hata kaynağıdır: KDV hariç fiyatı dahil sanarak kural kurarsanız tüm katalogda zararına satış riski doğar (KDV hesaplayıcı ile doğrulayın).

En Sık Yapılan XML Entegrasyon Hataları

• Bayat XML ile çalışmak: Kaynak günde bir güncelleniyorsa saatlik senkron bile sizi kurtarmaz; tedarikçi seçiminde XML tazeliğini sorgulayın.
• Kesintisiz sabit marj: Komisyon ve kargo farkını hesaba katmadan tüm kanallara aynı yüzdeyi uygulamak bazı kanallarda zarar ettirir.
• Kategori eşlemesini otomatiğe bırakmak: Otomatik öneriler başlangıçtır, kontrol edilmeden yayına alınmamalıdır.
• Test etmeden tüm kataloğu açmak: Hatalı mapping binlerce üründe aynı anda sorun üretir.
• Kârlılığı izlememek: Entegrasyon operasyonu çözer ama hangi ürünün kazandırdığını söylemez; net kâr analizi ayrıca kurulmalıdır.

Pazaryeri Bazlı Entegrasyon Notları

Aynı kaynak XML her pazaryerine dağıtılabilir, ancak her platformun kendine özgü gereksinimleri vardır:

• Trendyol: Barkod ve marka onayı süreçleri titizdir; kategori bazlı zorunlu özellikler (renk, beden, cinsiyet) doldurulmadan ürün onaylanmaz. Marka/orijinallik kurallarına dikkat edin (ihlal puanı rehberi).
• Hepsiburada: Katalog eşleşmesi barkod merkezlidir; mevcut ürün kartına bağlanan listelemelerde içerik kontrolü kart sahibindedir.
• N11: Kategori ağacı diğerlerinden farklı kırılımlara sahiptir; birebir eşleşme yoksa en yakın değil en doğru dalı seçin.
• Amazon: ASIN/katalog sistemi nedeniyle barkod (EAN/GTIN) kalitesi en kritik platformdur; hatalı barkod yanlış ürün sayfasına bağlanmanıza yol açabilir.
• Pazarama ve İdefix: Görece esnek giriş; İdefix'te kitaplar için ISBN zorunludur.

Bu farklar nedeniyle "bir kez eşle, her yere bas" yaklaşımı yerine kanal başına eşleme kontrolü yapın; iyi bir entegrasyon aracı bu farkları sizin için soyutlar ama ilk kurulum kontrolü yine sizindir.

Birden Fazla XML Kaynağıyla Çalışmak

Kataloğunuz büyüdükçe tek tedarikçiye bağlı kalmak hem stok hem pazarlık gücü açısından risklidir; olgun operasyonlar birden fazla XML kaynağını birlikte yönetir. Bu kurulumda üç kurala dikkat edin: Barkod çakışması — aynı ürün iki kaynakta da varsa hangi kaynağın öncelikli olduğunu (genellikle daha ucuz veya daha hızlı kargolayan) kural olarak tanımlayın; fiyat tutarlılığı — kaynaklar arası maliyet farkı, aynı ürünü farklı fiyatlarla yayınlamanıza yol açmamalı; kaynak bazlı izleme — hangi kaynağın ürünlerinin daha çok iptal/iade ürettiğini ayrı ayrı raporlayın, sorunlu kaynağı veriyle tespit edin. Çok kaynaklı yapı, tek tedarikçideki stok kesintisinde kataloğunuzun tamamen kapanmasını da önler; kritik kategorilerde yedek kaynak bulundurmak dropshipping ve stoklu modelin ikisinde de iyi pratiktir.

Sorun Giderme: Senkron Çalışmıyor Gibi Görünüyorsa

• Ürün güncellenmiyor: Önce kaynak XML'de o ürünün gerçekten değişip değişmediğine bakın; sorun çoğunlukla sizin senkronunuzda değil kaynağın tazeliğindedir.
• Ürün reddedildi: Pazaryerinin hata mesajını okuyun — eksik zorunlu özellik, görsel kuralı veya marka yetkisi en yaygın üç nedendir.
• Fiyat yanlış yansıyor: Kaynak fiyatın KDV durumunu ve fiyat kuralınızın işlem sırasını (önce marj mı, önce komisyon payı mı) kontrol edin.
• Stok sıfırlanmıyor: Kaynakta ürün silinmiş olabilir; aracınızın "kaynaktan kaybolan ürünü kapat" davranışının açık olduğundan emin olun.
• Mükerrer ürün oluştu: Barkod değişmiş veya boş demektir; kimlik alanı tutarlılığını tedarikçiyle netleştirin.

Doğru Entegrasyon Aracı Nasıl Seçilir?

Araç seçerken şunlara bakın: desteklenen pazaryeri sayısı, senkronizasyon sıklığı, fiyat kuralı esnekliği, kategori eşleme kolaylığı ve kârlılık raporlaması. Trendmetrik, XML kaynaklarınızı tüm büyük Türk pazaryerlerine bağlar; stok-fiyat senkronizasyonunu otomatikleştirir ve aynı panelde her ürünün komisyon, kargo ve kesintiler sonrası gerçek net kârını gösterir. Böylece operasyon ve kârlılık tek yerden yönetilir. Piyasadaki entegrasyon programlarını tarafsız karşılaştırmak için pazaryeri entegrasyon programları karşılaştırmamıza göz atın.

Kapanış olarak süreci özetleyelim: kaliteli bir kaynak XML edinin, alan eşleştirmesini titizlikle yapın, fiyat kurallarını kanal bazlı kurun, küçük pilotla test edin ve senkronizasyonu doğruladıktan sonra tüm kataloğu açın. Bu beş adımı doğru sırayla uygulayan satıcı için XML entegrasyonu, e-ticaret operasyonunun en yüksek getirili otomasyon yatırımıdır: bir kez kurulur, her gün kazandırır. Ertelemeyin: manuel yönetimle geçen her hafta, hem zaman maliyeti hem sessiz fiyat/stok hataları olarak faturalanır. Bugün kaynak XML'inizi kontrol ederek başlayın; kurulumun en zor kısmı ilk adımı atmaktır.