Ürün gönderme rehberinde varyantlı ürünlerin ekstra bir kuralı olduğunu kısaca görmüştük: varyant özellikleri kategorinin istediği ekseni tam olarak karşılamalı. Bu yazıda o kuralı ve varyantlı ürün göndermenin tüm püf noktalarını detaylıca anlatıyorum. Çünkü Türkiyemin, varyant tarafında diğer pazaryerlerine göre belirgin şekilde daha katı.
Varyantlı ürün gönderirken anlaşılması gereken tek şey var: Türkiyemin bir kategoride hangi varyant eksenlerini istiyorsa, ürününüzün varyantları o eksenlerin tamamına sahip olmalı. Eksik veya fazla — ikisi de reddedilir.
Varyant Ekseni Nedir?
Önce kavramı netleştirelim. Varyant ekseni, varyantları birbirinden ayıran özelliktir. Tipik örnekler:
- Renk ekseni → Kırmızı, Mavi, Siyah...
- Beden ekseni → S, M, L, XL...
- Boyut ekseni → 30 cm, 40 cm, 50 cm...
Bir ürünün varyantları bu eksenlerin kombinasyonlarıdır. Örneğin "Renk + Beden" ekseni olan bir tişörtün varyantları: Kırmızı-S, Kırmızı-M, Mavi-S, Mavi-M gibi.
Türkiyemin her kategoride hangi eksenlerin kullanılması gerektiğini kategori şemasında belirler. Önemli olan: ürününüz bu şemayla birebir uyuşmak zorunda.
SetEquals Kuralı: Eksik De Fazla Da Red
İşte Türkiyemin'in en sıkı kuralı. Kategori şeması "Renk + Beden" istiyorsa:
| Varyant kümeniz | Sonuç |
|---|---|
| Renk + Beden | ✅ Kabul |
| Sadece Renk (Beden yok) | ❌ Red — eksik eksen |
Yani "kategori zorunlu kısmı istiyor, gerisini kendim ekleyeyim" mantığı çalışmaz. Türkiyemin bu kuralda isRequired'a bakmaz — şemadaki tüm varyant eksenlerinin ürününüzde tam olması gerekir.
Fazla eksen konusunda iyi haber: Ventegre, kategorinin istemediği eksenleri otomatik olarak payload'a sokmaz. Yani ürününüzde "Renk + Beden + Boyut" tanımlıysa ve kategori sadece "Renk + Beden" istiyorsa, Ventegre "Boyut"u göndermeden ürünü iletir. Bu yüzden pratikte "fazla eksen" hatası görmezsiniz; başınızı ağrıtacak tek şey eksik eksendir.
Neden bu kadar katı? Türkiyemin katalog yapısı her varyantı belli eksen kombinasyonlarına göre dizinliyor. Fazla/eksik eksen, filtreme ve arama sonuçlarını bozar. Bu yüzden kapıyı geçtikten sonra bile ürün onay ekranında takılabilir — Ventegre bu yüzden eksikliği gönderimden önce yakalar.
Varyantsız Ürünler Tek Varyant Sayılır
İlginç bir kural: Türkiyemin her ürünü varyant-bazlı işler. Yani varyantsız bir ürününüz varsa (tek beden, tek renk), Türkiyemin bunu otomatik olarak tek varyantlı bir ürün olarak kabul eder.
Bu durumda varyant ekseni kuralı hâlâ geçerlidir: kategori "Renk" ekseni istiyorsa ve sizin varyantsız ürününüzde Renk özelliği yoksa, ürün yine reddedilir. Varyantsız ürünlerde eksen değeri ürünün kendi özelliklerinden okunur — yani ürün düzenleme sayfasındaki özelliklere renk/beden girerseniz bu otomatik karşılanır.
Doğru Seviye Kuralı
Türkiyemin her özelliğin doğru seviyede olmasını ister:
- Varyant ekseni (Renk, Beden) → varyant seviyesinde olmalı
- Ürün özelliği (Marka, Cinsiyet, Materyal) → ürün seviyesinde olmalı
Yani bir varyant ekseni olan "Renk"i yanlışlıkla ürün seviyesine yazarsanız Türkiyemin reddeder. Ventegre bunu otomatik ayırır; ama kendi listenizde eksen ataması yaparken bu hiyerarşiyi aklınızda tutun.
Görsel Kuralı: Varyant Başına 10
Türkiyemin varyant başına en fazla 10 görsel kabul eder. Ürün geneli için değil, her varyant için ayrı ayrı.
- Bir varyantta 15 görsel varsa → HTTP 400
images_limit_exceededhatası - Bu hata tüm gönderim batch'ini düşürür — yani 50 varyantlı bir ürün gönderiyorsanız ve sadece bir varyantta 15 görsel varsa, hiçbiri gitmez
Ventegre bu sınırı otomatik uygular (varyant başına ilk 10 görseli alır) ama yine de varyant görsellerinizi makul tutmanız iyi bir pratik.
Enum vs Serbest Metin Ekseni
Varyant eksenleri ikiye ayrılır ve eksik davranışları farklıdır:
Enum ekseni (liste dışı değer kabul etmez — örn. Renk, Beden):
- Değer yoksa → körlemesine ilk değer atanmaz (siyah ürüne "Beyaz" yazılmaz)
- Push bloke edilir, kullanıcı gerçek değeri girer
Serbest metin ekseni (elle yazılabilir — örn. Desen, Özellik):
- Değer yoksa → otomatik "Belirtilmemiş" yazılır ve push'a engel olmaz
- İsterseniz sonradan gerçek değeri girip güncellersiniz
İpucu: Bir eksen için değer girip girmediğinizi Ventegre ürün düzenleme ekranında görebilirsiniz. Eksik enum ekseni kırmızı uyarıyla listelenir.
Değer Katalogda Yoksa Ne Olur?
Bazen ürününüze "GriMelanj" renk değeri girmişsinizdir ama Türkiyemin'in kataloğunda aynı değer "Gri Melanj" (boşluklu) yazılıdır. Ventegre bunu otomatik eşler:
- Büyük/küçük harf farkı → eşleşir
- Türkçe karakter (i/ı, ö/ö) → eşleşir
- Boşluk farkı ("GriMelanj" ↔ "Gri Melanj") → eşleşir
- Ayrıca Ventegre, Trendyol'dan gelen değerleri Türkiyemin karşılığına çevirir (örn. "G (Yeni Enerji Sınıfı)" → "G")
Ama gerçekten katalogda olmayan bir değer verdiyseniz (örn. "Mor-Beyaz Çizgili" ama kategoride sadece tek renk kabul ediliyor), bu eksen eksik sayılır ve push bloke edilir. Çözüm: kategorinin kabul ettiği değerlerden birini seçmek.
Hangi Hataları Alırsınız?
Varyantlı ürün gönderirken karşılaşabileceğiniz tipik hatalar:
| Hata | Anlamı | Çözüm |
|---|---|---|
| Eksik varyant ekseni (Renk/Beden gibi) | Kategori şemasındaki bir ekseni göndermediniz | Ürüne ilgili ekseni ekleyin |
images_limit_exceeded | Bir varyantta 10'dan fazla görsel | Varyant görsellerini azaltın (Ventegre otomatik kırpabilir) |
attribute_value_xor_violated | Bir özelliğe hem valueId hem value gitmiş | Teknik hata — Ventegre bunu otomatik doğru gönderir, görürseniz destek bildirin |
stock_invalid | Negatif stok gönderilmiş | Stoku 0 veya pozitif yapın (Ventegre otomatik 0'a kırpar) |
| Değer katalogda yok | Verdiğiniz değer Türkiyemin listesinde değil | Kategorinin kabul ettiği değerlerden seçin |
Tüm bu hatalar Ürünler sayfasında ürünü genişletip "Detay ↗" butonuna basınca görülür. Ayrıca İzleme & Operasyon → Hata Merkezi sayfasında toplu görebilirsiniz.
Sıkça Sorulan Sorular
Yine de her varyant için Beden değeri girmeniz gerekir. Tek beden satıyorsanız tüm varyantlara aynı bedeni verebilirsiniz (örn. hepsi "Standart"). Türkiyemin eksik ekseni kabul etmez; ama aynı değeri tekrar etmek sorun değil.
Varyantsız ürünler Türkiyemin'de tek varyant sayılır. Kategori "Renk" ekseni istiyorsa, ürünün özelliklerine Renk girin. Varyantsız ürünlerde eksen değeri ürün özelliklerinden okunur.
Pratikte hayır. Ventegre ürününüzde fazladan eksen tanımlı olsa bile, kategorinin istemediğini tespit edip payload'a sokmadan gönderir. Yani başınızı ağrıtacak tek şey eksik eksendir; fazlasını Ventegre kendisi halleder.
Ventegre gönderim sırasında o varyantın görsellerini otomatik olarak ilk 10'a kırpar. Yani ürün gitmesini engellemez; ama son 2 görsel gitmez. Tüm görselleri gönderebilmek için varyant başına 10 görseli geçmeyin.
Türkiyemin kataloğunda "Lacivert" yerine "Mavi" alt değeri olabilir veya farklı bir yazım kullanılıyor olabilir. Ventegre büyük/küçük harf ve Türkçe karakter farkını otomatik eşler; ama gerçekten farklı bir değerse, kategorinin kabul ettiği listeden en yakın olanı seçmeniz gerekir.
Evet, Türkiyemin negatif stoğu reddeder ve tüm batch düşer. Ventegre bunu otomatik olarak 0'a kırpar, yani size hata ulaşmaz; ama iade/oversell düzeltmesi sonrası stoku elle negatif gördüyseniz 0 yapın.
Hayır. Türkiyemin kategori şeması tek bir eksen seti belirler. Ürününüzün kategorisinde hangisi tanımlıysa onunla gitmeniz gerekir. İki farklı eksen seti istiyorsanız ürünü iki kategoriye ayırmak yerine kategoriyi değiştirmeyi düşünün.
Ürünü düzenleme sayfasında Varyantlar sekmesine gidin. Orada varyantları ve eksenlerini tanımlarsınız. Eksen adlarını (Renk, Beden) ve her varyant için değerleri girersiniz. Kategori şemasına göre Ventegre hangi eksenlerin zorunlu olduğunu gösterir.
Varyantlı ürün göndermek aslında tek bir kurala dayanıyor: kategorinin istediği eksen setiyle ürününüzün eksen seti birebir aynı olmalı. Bunu sağladığınızda gerisini Ventegre halleder — görsel sınırını, seviye ayrımını, değer eşleşmesini, negatif stok kırpmayı otomatik uygular. Asıl dikkat etmeniz gereken, ürününüzü doğru kategoriye yerleştirip o kategorinin beklediği eksenleri tam girmek.
Varyant tarafında takıldığınız bir yer olursa Ürünler sayfasındaki "Detay ↗" butonuna bakın; Türkiyemin'in döndürdüğü hata mesajı Türkçe ve net gelir. Çözülmezse Ventegre destek ekibiyle iletişime geçin.