Pazaryeri Katalog Yönetimi: Barkod, Varyant ve Buybox Hatalarını Baştan Önlemek

Son güncelleme: 10 Eylül 2026Mevzuat, ücret tarifeleri ve platform politikaları değişir. Bu rehber düzenli olarak gözden geçirilir.

Bu yazı Pazaryeri Satıcılığı Rehberi rehberinin bir parçasıdır.

Pazaryeri operasyonunda geri alınamayan hatalar, çoğunlukla ilk ürün girişinde yapılıyor. Yanlış bir fiyat düzeltilir, yanlış bir görsel değiştirilir; ama yanlış bir barkodla açılmış ve onaylanmış bir ürün, Trendyol’un kendi ifadesiyle artık düzeltilemez: “Onaylanan ürünler için barkodlar güncellenememektedir. Barkod güncellemek isterseniz doğru barkod ile yeni ürün oluşturmanız gerekmektedir.”

Bu tür kuralları önceden bilmek, sonradan temizlemekten kat kat ucuza geliyor. Aşağıda katalog kurulumunun geri dönüşü olmayan noktalarını, buybox’ı belirleyen resmî faktörleri ve stok senkronizasyonunun teknik sınırlarını sırayla çıkarıyorum. Rakamlar Ağustos 2026 itibarıyla platformların kendi dokümantasyonundan; en sonda yakın vadede değişecek olanı ayrıca işaretliyorum.

Barkod: en pahalı ilk karar

Trendyol’da barkod zorunlu — “Barkod bilgisi olmadan ürünlerinizi oluşturamazsınız.” Sistem sizin için barkod üretmiyor. Teknik sınırlar:

• 1–50 karakter. Yasak özel karakterler: ? / & % + ^ ' * _
• Boşluklar birleştirilir. Barkod içindeki boşluklar sistem tarafından siliniyor ve stok/fiyat güncellemelerinizi birleştirilmiş biçime göre göndermeniz gerekiyor. Excel’den kopyalanan sondaki görünmez boşluk, entegrasyonda “ürün bulunamadı” hatasının en sık sebebi.
• Kısıtlanmış markalarda yalnızca global barkod (EAN/UPC/GTIN) kabul ediliyor; kendi ürettiğiniz kod reddedilir.
• API dokümanı ile satıcı bilgi merkezi arasında karakter kuralında bir çelişki var (biri yasak karakter listesi veriyor, diğeri “yalnızca nokta, tire ve alt tire” diyor). Böyle bir durumda en kısıtlayıcı olana uyun — sadece harf, rakam ve tire kullanmak her iki dokümanı da geçer.

İki davranışsal kural daha var ve ikisi de stratejik:

Barkodunuz herkese açık. Trendyol’un SSS’si net: “Kendi barkodumla eklediğim ürünü başka satıcılar satabilir mi? Evet.” Katalogdan ekle özelliğiyle sizin açtığınız ürün sayfasında başkaları da listelenebilir. Yani ürün sayfasını siz kurup içeriğini siz yazdığınızda, oraya gelen trafiği rakiplerinizle paylaşma ihtimaliniz baştan var. Bu, kendi markanız için marka tescili ve buybox koruması meselesini teknik bir konudan ticari bir konuya çeviriyor.

Çoklanan ürün ihlal sayılıyor. “Barkod Kayıtlı” hatası aldığınızda doğru refleks farklı bir barkodla yeni ürün açmak değil — bu 2 puanlık ihlal ve ürün kapatma anlamına geliyor. Doğrusu “Trendyol Katalogundan Ekle” ile mevcut ürüne dâhil olmak.

Tekillik kuralı

Trendyol’un katalog tekillik tanımı şu kombinasyona bakıyor: kategori + model kodu + marka + renk (veya muadili ayrıştırıcı özellik) + varyantlayan özellik (beden/ebat). Bu beşlinin aynı olduğu iki barkod olamıyor. Ret mesajında çakıştığınız barkod “Referans Barkod” olarak bildiriliyor — bu bilgiyi çöpe atmayın, katalogda kimin üstüne düştüğünüzü söylüyor.

Varyant yapısı: slicer ve varianter ayrımı

Varyantlama productMainId üzerinden yapılıyor. Aynı ana ürün koduna sahip kayıtlarda attributes dışındaki tüm alanlar özdeş olmalı — biri farklıysa ret alırsınız.

İki farklı varyant tipi var ve karıştırıldığında ürün sayfası yapınız bozulur:

• Slicer (renk, hafıza gibi): ürünü farklı sayfalarda gösterir. Bir kategoride birden fazla slicer olabilir.
• Varianter (beden gibi): tek sayfada seçenek olarak görünür. Kategori başına en fazla bir varianter.

Bir de sessiz bir limit: ürün başına en fazla 100 varyant. Ama bu limit katalogdaki mevcut varyant sayısı ile eklemek istediğinizin toplamı üzerinden hesaplanıyor ve aşıldığında Trendyol’un kendi örneğiyle: 60 mevcut + 45 yeni = 105 → eklediğiniz 45 varyantın hepsi reddedilir. Kısmi kabul yok. Çok bedenli, çok renkli katalogda toplu yükleme yapmadan önce mevcut varyant sayısını saymak zorunlu.

İçerik ve görsel kuralları

Ret sebeplerinin büyük kısmı burada birikiyor. Resmî sınırlar:

• Ürün adı: marka adı hariç 3–200 karakter. (API dokümanı bir yerde 100 karakter diyor — çelişki var, 100’ün altında kalmak iki dokümanı da geçer.)
• Model kodu: 1–40 karakter, içinde URL veya e-posta olamaz.
• Açıklama: HTML alanı 30.000 karakter; ret dokümanında ayrıca 4.000 karakterlik bir açıklama sınırı geçiyor. İki farklı alan olması muhtemel; 4.000’in altında kalmak güvenli taraf.
• Görsel: en fazla 8 adet; https:// zorunlu; JPEG/JPG/PNG/WEBP; 1 KB – 10 MB; minimum 860×574 px, maksimum 2000×2000 px. API dokümanı ideal olarak 1200×1800 px, 96 dpi öneriyor.
• Görsel linki doğrudan görsele gitmeli; Google Drive ve Dropbox linkleri kabul edilmiyor; link içinde boşluk veya Türkçe karakter olmamalı.

Buradaki en teknik ve en çok zaman kaybettiren madde şu: Trendyol görselleri kendi IP adreslerinden çekiyor. Dokümantasyonda listelenen adresler 89.32.128.66, 89.32.128.54-55, 89.40.131.40-41, 89.40.131.76-77. CDN’iniz veya güvenlik duvarınız bot trafiğini filtreliyorsa görselleriniz “erişilemedi” diye reddedilir ve hata mesajı size görselin bozuk olduğunu düşündürür. Görsel reddi alıyorsanız bakılacak ilk yer sunucu logları.

İçerik tarafında iki yasak da net: açıklamada kişisel iletişim bilgisi, dış site linki ve kendi satış/iade koşulu beyanı bulunamıyor (“Yanıltıcı Beyan” ret koduna giriyor). Ayrıca marka sahibi kısıtlaması var: ürün bilgileri “sadece Trendyol katalogundaki marka sahibi, yetkilisi veya üreticisi tarafından” güncellenebiliyor. Yani başkasının markasını satıyorsanız ürün sayfasının içeriğine müdahale edemezsiniz — bu, içerik kalitesini rekabet avantajı yapamayacağınız anlamına gelir; kalan silahlar fiyat, teslimat ve puan.

Buybox: resmî faktörler ve resmî olmayan yorumlar

Trendyol buybox’ı hesaplarken kullandığı metrikleri altı kalem hâlinde yayımlıyor: ürünün fiyatı, satıcı puanı, hızlı teslimat seçeneği, kargo bedava seçeneği, üründeki diğer kampanyalar (kampanyanın indirim derinliği önemli) ve operasyon statüsü. Ağırlıkların sayısal değerleri yayımlanmıyor, ama iki cümle sıralamayı ele veriyor:

“Buybox için en önemli faktör ürünün satış fiyatının diğer satıcılara göre daha uygun olmasıdır.”

“Bu statü KIRMIZI olduğunda satıcı, buybox sıralamasına dâhil edilmez, TURUNCU olduğunda ise en alt sıraya düşürülür.”

İkinci cümle çok önemli: operasyon statünüz kırmızıysa fiyatınızı ne yaparsanız yapın buybox yarışının dışındasınız. Yani fiyat kırmak, operasyonel sorunu çözmeden hiçbir işe yaramaz — sadece marjınızı yer. Fiyat rekabetine girmeden önce statünüzün rengine bakmak, bu yazının en pratik tek çıkarımı.

Buybox’a dâhil olabilme şartı: marka tarafı

Fiyat ve performansın önünde bir kapı daha var. Buybox’a dâhil olmak için ürünün Türk Patent ve Marka Kurumu nezdindeki marka sahibinden veya yetkili bir satıcıdan tedarik edilmiş olması gerekiyor; ürün ait olduğu marka ile girilmeli.

Bunun diğer yüzü, kendi markası olanlar için güçlü bir araç: Ürün > Belge ve Tescil İşlemleri > İhlal Bildirimleri altından “Satıcı Bazlı Marka İhlal Bildirimi” oluşturulduğunda, Trendyol’un ifadesiyle “satıcıların ürünleri satışa kapatılır ve gerekli belgeleri iletene kadar açılmaz.” Markanızı tescil ettirmek, pazaryerinde yalnızca hukuki bir işlem değil; doğrudan operasyonel bir kaldıraç.

Hepsiburada ve Amazon.com.tr tarafı

Hepsiburada’nın buybox kriterleri için kamuya açık resmî dokümantasyon yok. API tarafında bir “Buybox Sıralama Sorgulama” ucu ve “Stok & Fiyat & Buybox Yönetimi” başlıklı bir doküman kategorisi var, ama kazananın nasıl belirlendiği yayımlanmamış. İnternette dolaşan kriter listeleri üçüncü taraf kaynaklı; bunları operasyon kuralı yapmayın.

Amazon.com.tr’de karşılığı “Öne Çıkan Teklif”. Resmî tanım: “Öne Çıkan Teklif olmaya uygun olabilmek için satıcı performans istatistikleri ve sipariş hacmi koşullarını sağlamanız gerekir.” Amazon’un global dokümantasyonu bu konuda daha açık ve iki maddesi Türkiye’de de yaygın bir yanlışı düzeltiyor: Amazon’un kendi ifadesine göre müşteri yorumları ve yıldız puanları öne çıkan teklif seçiminde dikkate alınmıyor, ve her şey eşitse FBA ile FBM eşit olasılıkla öne çıkıyor. Yani “FBA’ya geçmeden buybox alınmaz” cümlesi Amazon’un kendi dokümantasyonuyla çelişiyor.

Stok senkronizasyonu: sessiz teknik sınırlar

Trendyol’un stok ve fiyat güncelleme servisinde üç kural entegrasyon mimarisini belirliyor:

• İstek başına en fazla 1.000 SKU.
• Ürün başına en fazla 20.000 adet stok.
• Aynı istek gövdesi 15 dakika içinde tekrar gönderilemez — sistem hata döndürüyor.

Üçüncü madde, “her 5 dakikada tüm katalogu gönder” mantığıyla kurulmuş naif entegrasyonların neden sessizce hata verdiğini açıklıyor. Doğru mimari, değişmeyeni göndermeyen bir fark (delta) mekanizması. Ayrıca işlemler eşzamanlı değil: sonuç getBatchRequestResult ile takip edilmeli — göndermek “oldu” demek değil.

14 Eylül 2026: limit modeli değişiyor

Bu, önümüzdeki dönemin en somut teknik riski. Bugün Trendyol’un stok ve fiyat güncelleme servisinde limit yok. 14 Eylül 2026’dan itibaren limitler endpoint bazlı değil servis grubu bazlı olacak ve ürün adedi kademesine göre değişecek. Yayımlanan tabloya göre 50.000 ürün kademesinde:

• Inventory & Price Write: 350 istek/dakika (bugün limitsiz)
• Product Integration Write: 200 istek/dakika
• Product Integration Read: 1.000 istek/dakika

Trendyol’un kendi örneği durumu net anlatıyor: bir dakika içinde 50 ürün oluşturma + 100 güncelleme + 50 silme = 200 istek → o dakika için yazma kotası bitiyor. Kademeler yukarı çıkıyor (75K, 150K, 500K, limitsiz), ama küçük ve orta ölçekli satıcı için pratik sonuç şu: tek tek SKU gönderen entegrasyonlar Eylül ortasından sonra duvara çarpacak. Yapılacak iş belli — 1.000 SKU’luk paketleme (batch) ve kuyruk mekanizması. Entegratörünüze bu soruyu şimdi sorun; Eylül’de sormak geç olur.

Overselling: iki taraflı ceza

Tedarik edememe oranı hem satıcı puanını hem kapama riskini besliyor. Trendyol’un resmî önerileri sıkıcı ama işliyor: fiziki stoku doğrulayın, güvenli stok eşiği belirleyin, tedarik edilemeyecek ürünleri derhal kaldırın, stoku ancak kalite kontrolden sonra güncelleyin, entegrasyon kullanıyorsanız sağlayıcınızla koordineli çalışın.

Buna bir madde eklemek gerek: tek ürünün birden fazla kanalda satıldığı durumda güvenli stok eşiği kanal sayısına göre ölçeklenmeli. Üç pazaryerinde satılan 5 adetlik bir ürün, senkronizasyon gecikmesi ne kadar kısa olursa olsun aşırı satış riski taşır. Son birkaç adedi kanallara bölmek yerine tek kanalda tutmak, çoğu mağazada daha az sorun üretiyor.

Kurulum sırası

1. Barkod politikanızı yazın. Kendi ürettiğiniz kodlarda sadece harf-rakam-tire; kısıtlı markalarda global barkod. Bir kez yazın, herkes ona uysun — barkod düzeltilemiyor.
2. Mevcut varyant sayınızı sayın ve 100 limitini kontrol edin. Sonra toplu yükleme yapın.
3. Görsel altyapınızı test edin. Trendyol IP’lerinin görsellerinize erişebildiğini doğrulayın, boyut ve dosya sınırlarını yükleme öncesi otomatik kontrol eden bir adım koyun.
4. Operasyon statünüzün rengine bakın. Kırmızı veya turuncuysa fiyat çalışmasını erteleyin; buybox’a fiyatla giremezsiniz.
5. Kendi markanız varsa tescil ve ihlal bildirimi mekanizmasını kurun.
6. Entegrasyonunuzu 14 Eylül 2026 limitlerine hazırlayın: batch + kuyruk + getBatchRequestResult takibi + tam katalog yeniden gönderme düğmesi.

Kapanış

Katalog yönetiminde kazanç, doğru şeyi yapmaktan çok yanlış şeyi geri alınamaz hâle gelmeden önce fark etmekten geliyor. Barkod, varyant yapısı ve marka eşleştirmesi bu kategoride: onay sonrası düzeltilemiyor ya da yeni ürün açmayı gerektiriyor, ki bu da geçmiş yorumlarınızı ve satış geçmişinizi sıfırlıyor.

Buna karşılık fiyat, stok ve teslimat süresi her gün değiştirilebilir. Zamanınızı bu ikinci gruba harcamak istiyorsanız, birinci grubu bir kere düzgün kurmanız gerekiyor.

Sık sorulan sorular

Barkod hatası neden bu kadar pahalı?

Çünkü sonuçları zincirleme ilerler: yanlış barkod önce ürünün başka bir listelemeye iliştirilmesine, sonra yanlış ürünün gönderilmesine, oradan iadeye ve nihayetinde satıcı puanı düşüşüne yol açar. Baştan doğru kurmak, sonradan düzeltmekten kat kat ucuzdur.

Varyantları tek listelemede mi toplamalıyım?

Evet, aynı ürünün renk ve beden varyantları tek bir üründe toplandığında hem yorumlar birikir hem dönüşüm artar. Ayrı listelemeler yorum gücünü böler ve stok yönetimini zorlaştırır. Ancak varyant eşleştirmesi yanlışsa bu avantaj hızla dezavantaja döner.

Buybox’ı nasıl kazanırım?

Buybox yalnızca fiyatla belirlenmez. Fiyat, stok durumu, termin süresi, kargo performansı ve satıcı puanı birlikte hesaplanır. Fiyatı düşürmeden önce teslimat süresi ve puan tarafında iyileştirilecek bir şey olup olmadığına bakmak genellikle daha kârlıdır.

Ürün görselleri için standart ne?

Her platformun kendi kuralı var, ancak ortak beklenti şu: beyaz zeminde net ana görsel, ürünü gerçek boyut algısıyla gösteren en az bir kullanım görseli ve varyantların gerçek rengini yansıtan ayrı görseller. Gerçeği yansıtmayan görsel, iadenin en yaygın sebebidir.

Kaç ürünle başlamalıyım?

Az sayıda üründe doğru kurulmuş bir katalog, yüzlerce üründe hatalı kurulmuş bir katalogdan daha hızlı kâr eder. Operasyon oturana kadar dar bir ürün grubuyla ilerleyin; toplu yükleme hatalarını düzeltmek tek tek kurmaktan uzun sürer.

İlgili okumalar

• Pazaryeri Satıcı Puanı Nasıl Hesaplanır? — katalog hatalarının puana etkisi
• Pazaryeri Kâr Marjı Hesaplayıcı — iade maliyetinin marja etkisini görmek için
• Küçük E-Ticarette Yapay Zekâ Otomasyonu — ürün açıklamalarını şablonlaştırmak için
• pazaryerinde gerçek kâr marjı hesaplama
• yapay zekâ aramasında görünür olmak
• Pazaryeri Satıcılığı Rehberi — konunun tamamını sırayla ele alan rehber

Kaynaklar ve resmî bağlantılar

• Trendyol — Tekil Ürün Oluştur ile Ürün Yükleme — Model kodu, varyant ve barkod kuralları; onay sonrası değiştirilemeyen alanlar
• Trendyol — Ürün Girişinde Barkod SSS — “Barkod kayıtlı” hatası ve çoklanan ürün ihlali
• Trendyol — Buybox’a Dahil Olabilme Kuralları — Buybox’a dahil olabilmek için marka ve yetki koşulları
• Trendyol — Buybox’ı Etkileyen Metrikler — Buybox sıralamasını belirleyen resmî faktörler
• Trendyol Entegrasyon Dokümantasyonu — Servis Limitleri — Entegrasyon servis limitleri ve 14 Eylül 2026’da geçerli olan kotalar
• Hepsiburada API Portal — Hepsiburada katalog, stok, fiyat ve buybox servisleri

Mevzuat, ücret tarifeleri ve platform politikaları değişebilir. Bu yazıdaki bilgiler yayın tarihindeki duruma göre hazırlanmıştır; işlem yapmadan önce yukarıdaki resmî kaynaklardan güncel durumu teyit edin.

Yazar hakkında

Toros Panos

E-ticaret ve pazaryeri operasyonu üzerine çalışıyorum. Bu sitede Trendyol, Hepsiburada ve Amazon operasyonu, birim ekonomi hesabı, mikro ihracat ve no-code otomasyon konularında; platformların resmî dokümantasyonuna ve güncel mevzuata dayanan uygulamalı rehberler yayımlıyorum.

Danışmanlık . Tüm yazıları . LinkedIn