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 feed | API | |
|---|---|---|
| Yön | Karşı taraf sizin dosyanızı çeker | Siz karşı tarafa istek gönderirsiniz |
| Gecikme | Çekme aralığı kadar | İstek anında |
| Tekil güncelleme | Dosyanın tamamı yenilenir | Tek barkodun stoğu ya da fiyatı güncellenir |
| Sipariş ve iade | Ürün beslemesi içindir | Okunan kaynakların üçünde de (Trendyol, Hepsiburada, n11) sipariş, iade ve fatura servisleri API tarafında |
| Sınır | Dosya 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 grubu | Dakikada istek (seviyeye göre) |
|---|---|
| Ürün okuma | 1.000 / 1.250 / 1.500 / 1.750 / 2.000 |
| Ürün yazma: yaratma, güncelleme, silme | 200 / 300 / 400 / 500 / 600 |
| Stok ve fiyat yazma | 350 / 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?
- Kaynak listenizi çıkarın: barkod, model kodu, kategori, öznitelikler, görsel adresleri, fiyat, stok, KDV oranı.
- Hedef kanalın hangi yolu kabul ettiğine bakın: API, feed ya da Excel.
- Kategori ağacını indirip kendi kategorilerinizi eşleyin, zorunlu öznitelikleri doldurun.
- 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.
- Birkaç ürünle test edin. Onaydan sonra değişmeyen alanları yayına almadan önce doğrulayın.
- 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?
XML entegrasyonu nasıl yapılır?
Trendyol XML entegrasyonu var mı?
Stok ne sıklıkla güncellenmeli?
Tek seferde kaç ürün gönderilebilir?
Fazla satış nasıl önlenir?
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.