Entegrasyon

XML Entegrasyonu Nedir? Stok ve Fiyat Beslemesi

Kısa cevap: XML entegrasyonu, ürün, stok ve fiyat bilgisinin bir adreste duran dosya üzerinden karşı tarafa okutulmasıdır. Karşı taraf dosyayı belirli aralıklarla çeker. API ise tersidir: siz karşı tarafa istek gönderip kayıtları tek tek güncellersiniz.

Aşağıdaki limitler ve kurallar 20 Eylül 2026'da pazaryerlerinin kendi geliştirici dokümanlarından okundu. Limitler değişiyor; güncelini kanalın kendi geliştirici sayfasından kontrol edin.

Yazan: Faruk Keleş · Yayın: 20 Eylül 2026

XML entegrasyonu nedir?

XML entegrasyonunda ürün listeniz belirli bir adreste duran bir dosya olarak yayımlanır. Karşı taraf bu dosyayı kendi takvimine göre çeker ve içindeki stok, fiyat ve ürün bilgisini kendi tarafına işler. "Feed" sözcüğü de aynı yapıyı anlatır.

Her kanal aynı yolu sunmuyor. 20 Eylül 2026'da okunan resmi kaynaklara göre:

  • Trendyol'un geliştirici dokümanında XML ya da feed ile ürün aktarımı geçmiyor. Aktarım API ile ya da panelden Excel ile yapılıyor.
  • Hepsiburada'nın API portalında pazaryeri ailesi altında ayrı bir Ürün Feed başlığı var.
  • Çiçeksepeti panelden tek tek yükleme, Excel ile toplu yükleme ve API servisleri diye üç yol sayıyor.
  • n11'de panelden Excel ile stok, fiyat, teslimat süresi ve indirim fiyatı toplu güncellenebiliyor; API tarafı SOAP servisleri üzerinden çalışıyor.

Yani bir kanal feed kabul ediyor diye hepsinin kabul ettiğini varsaymayın. Kurulumdan önce her kanalın kendi geliştirici sayfasını okuyun.

XML ile API farkı nedir?

XML ya da feedAPI
YönKarşı taraf sizin dosyanızı çekerSiz karşı tarafa istek gönderirsiniz
GecikmeÇekme aralığı kadarİstek anında
Tekil güncellemeDosyanın tamamı yenilenirTek barkodun stoğu ya da fiyatı güncellenir
Sipariş ve iadeÜrün beslemesi içindirOkunan kaynakların üçünde de (Trendyol, Hepsiburada, n11) sipariş, iade ve fatura servisleri API tarafında
SınırDosya boyutu ve çekme sıklığıDakikada istek ve istek başına kayıt limitleri

İkisi birbirini dışlamıyor. Bir kurulumda ürün ve içerik dosyayla taşınırken, sık değişen stok ve fiyat alanları ile sipariş akışı API üzerinden yürütülebilir.

Güncelleme sıklığı ve istek limitleri ne kadar?

Trendyol'un servis limitleri sayfası 25 Ağustos 2026'da güncellenmiş ve yeni yapı 14 Eylül 2026'dan itibaren geçerli. Limitler tekil uç nokta değil, servis grubu bazında ortak uygulanıyor.

Servis grubuDakikada istek (seviyeye göre)
Ürün okuma1.000 / 1.250 / 1.500 / 1.750 / 2.000
Ürün yazma: yaratma, güncelleme, silme200 / 300 / 400 / 500 / 600
Stok ve fiyat yazma350 / 500 / 1.000 / 1.500 / 2.000
  • Seviyeler listeleme limitine bağlı: 50.000, 75.000, 150.000, 500.000 ürün ve limitsiz.
  • Fiyat güncellemede ayrıca barkod bazlı dakikada 30 istek sınırı var; aşılırsa toplu işlem sonuç servisinde hata dönüyor.
  • Stok ve fiyat güncelleme servisinde tek istekte en fazla 1.000 SKU gönderiliyor.
  • Genel sınır: aynı uç noktaya 10 saniyede en fazla 50 istek; 51. istek 429 alıyor.
  • 14 Eylül 2026 öncesindeki eski yapıda stok ve fiyat güncellemede limit yoktu. Eski kuruluma göre yazılmış bir besleme yeni yapıda limite takılabilir.

n11'in resmi API dokümanında tek istekte en fazla 100 stok değeri güncellenebiliyor. Aynı ürünü iki ayrı 100'lük partide güncellerseniz "Ürün, 60 saniye güncellenemez" hatası alınıyor. Stok çakışmasını önlemek için istekte bir sürüm alanı taşınıyor; sürüm uyuşmazsa işlem yapılmıyor. Bazı servislerde günlük 3 istek gibi sert sınırlar var. Belgenin değişiklik kaydı en son 2020 kayıtlarını taşıyor, bu yüzden güncelliğini n11'in kendi kaynağından teyit edin.

Hepsiburada, Amazon ve Çiçeksepeti için sayısal istek limitleri 20 Eylül 2026'da kamuya açık kaynaklarda bulunamadı.

Tek kaynak ilkesi nedir?

Tek kaynak ilkesi, stok, fiyat ve ürün bilgisinin tek bir yerde tutulması ve bütün kanalların oradan beslenmesidir. Kanallardan birinde panelden elle yapılan bir düzeltme kaynağa da yazılmazsa, bir sonraki beslemede geri alınır.

İlkeyi zorunlu kılan bir ayrıntı daha var: bazı alanlar onaydan sonra değişmiyor. Trendyol'da barkod, kategori ve model kodu ürün onaylandıktan sonra panelden değiştirilemiyor. Bu alanlar kaynağınızda baştan doğru olmalı.

Stok doğruluğu performans ölçütlerine de giriyor. Trendyol'un Satıcı Puanı metrikleri arasında Tedarik Edememe Oranı ve İhlal Puanı bulunuyor; kargoya verilmemiş ürünü "Gönderildi" işaretlemek ihlal sebepleri arasında sayılıyor.

Sık yapılan hatalar neler?

  • Fazla satış: aynı stok iki kanalda açık tutulur, besleme arası gecikmede ürün iki kez satılır. Besleme sıklığını satış hızınıza göre ayarlamanızı ve hızlı dönen ürünlerde emniyet stoğu bırakmanızı öneriyoruz.
  • Fiyat kayması: kampanya fiyatı panelden elle girilir ama kaynağa yazılmaz; bir sonraki besleme fiyatı eski değerine döndürür. Trendyol'da ayrıca satış fiyatı piyasa fiyatından yüksek olamıyor.
  • Limit aşımı: Trendyol'da barkod bazlı dakikada 30 istek sınırına takılmak ya da aynı uç noktaya 10 saniyede 50'den fazla istek göndermek. n11'de 100'lük partiden sonra aynı ürünü 60 saniye içinde tekrar güncellemeye çalışmak.
  • Kimlik doğrulama hatası: Trendyol'da User-Agent alanı boş bırakılan istek 403 alıyor. Alan biçimi "Satıcı Id - {Entegrasyon Firması İsmi}" ya da kendi yazılımınızsa "Satıcı Id - SelfIntegration". Entegrasyon bilgilerini yalnız yönetici rolündeki kullanıcı görebiliyor.
  • Sürüm geçişini kaçırmak: Trendyol geliştirici portalında V1 servislerinden V2'ye geçiş için 15 Ekim 2026 tarihi veriliyor.
  • Görsel adresi hatası: Trendyol'da görsel bağlantısı https ile başlamalı ve doğrudan görsel dosyasına gitmeli. Biçim JPEG, JPG ya da PNG; dosya en fazla 10 MB; çözünürlük en az 860 çarpı 574, en fazla 2000 çarpı 2000 piksel.

XML entegrasyonu nasıl yapılır?

  1. Kaynak listenizi çıkarın: barkod, model kodu, kategori, öznitelikler, görsel adresleri, fiyat, stok, KDV oranı.
  2. Hedef kanalın hangi yolu kabul ettiğine bakın: API, feed ya da Excel.
  3. Kategori ağacını indirip kendi kategorilerinizi eşleyin, zorunlu öznitelikleri doldurun.
  4. Güncelleme sıklığını istek limitlerine göre belirleyin; stok ve fiyat için ayrı, ürün içeriği için ayrı takvim kurun.
  5. Birkaç ürünle test edin. Onaydan sonra değişmeyen alanları yayına almadan önce doğrulayın.
  6. Hata günlüğü tutun: reddedilen kayıtları, limit hatalarını ve başarısız beslemeleri göreceğiniz bir ekran olsun.

Kurulum ve danışmanlık ücretimiz teklifte kalem kalem yazılır; ayrıntı e-ticaret danışmanlığı sayfasında.

Sıkça sorulan sorular

XML entegrasyonu nedir?

Ürün, stok ve fiyat bilgisinin bir adreste duran dosya olarak yayımlanması ve karşı tarafın bu dosyayı belirli aralıklarla çekmesidir. API'den farkı yönüdür: feed'de karşı taraf çeker, API'de siz istek gönderirsiniz.

XML entegrasyonu nasıl yapılır?

Önce ürün verisini tek kaynakta toplarsınız, sonra hedef kanalın hangi yolu kabul ettiğine bakarsınız, kategori ağacını eşler ve zorunlu öznitelikleri doldurursunuz, güncelleme sıklığını istek limitlerine göre belirleyip birkaç ürünle test edersiniz.

Trendyol XML entegrasyonu var mı?

Trendyol'un resmi geliştirici dokümanında XML ya da feed ile ürün aktarımı geçmiyor; aktarım API ile ya da panelden Excel ile yapılıyor. Hepsiburada'nın portalında ise ayrı bir Ürün Feed başlığı var.

Stok ne sıklıkla güncellenmeli?

Satış hızınıza ve kanalın limitine göre. Trendyol'un 14 Eylül 2026'dan geçerli yapısında stok ve fiyat yazma seviyeye göre dakikada 350 ile 2.000 istek arasında, fiyat güncellemede ayrıca barkod bazlı dakikada 30 istek sınırı var.

Tek seferde kaç ürün gönderilebilir?

Trendyol'un stok ve fiyat güncelleme servisinde tek istekte en fazla 1.000 SKU gönderiliyor. n11'in resmi API dokümanında tek istekte en fazla 100 stok değeri güncellenebiliyor.

Fazla satış nasıl önlenir?

Stok tek kaynakta tutulur, bütün kanallar oradan beslenir, besleme sıklığı satış hızına göre ayarlanır ve hızlı dönen ürünlerde emniyet stoğu bırakılır. Panelden elle yapılan düzeltmeler kaynağa da yazılmazsa bir sonraki beslemede geri alınır.

Mağazanızı birlikte kuralım.

Ürün gamınızı, kanallarınızı ve operasyonu ücretsiz keşif görüşmesinde konuşalım.