Trendyol'da stok kodu, satıcının ürüne kendi sisteminde verdiği iç koddur; Trendyol'un entegrasyon belgesinde stockCode adıyla geçer ve zorunlu değildir. Barkod ise her ilanın, varyantlı üründe her beden ve rengin ayrı kimliğidir. Trendyol, ilanın stok ve fiyat güncellemesini her zaman barkoda göre yapar.
Üç kod, üç ayrı iş
Trendyol'a ürün açarken üç kod alanı karşınıza çıkar ve adları birbirine yakındır. Trendyol'un ürün aktarma belgesine göre görevleri şöyle:
| Alan | Belgedeki adı | Ne işe yarar | Zorunlu mu |
|---|---|---|---|
| Barkod | barcode | İlanın, varyantta her beden ve rengin kimliği; stok ve fiyat güncellemesi buna göre | Evet |
| Model kodu | productMainId | Aynı ürünün varyantlarını bir arada toplar | Evet |
| Stok kodu | stockCode | Satıcının kendi sistemindeki ürün kodu | Hayır |
Kısacası Trendyol ilanı barkoddan tanır, varyantları model koduyla gruplar, stok kodunu ise sizin için saklar. Karışıklığın çoğu, bu üç alana aynı değerin ya da yanlış alana yanlış değerin yazılmasından çıkar.
Stok kodu nerede işe yarar?
Stok kodu Trendyol için zorunlu olmadığı halde boş bırakılmamalıdır. Sebebi siparişte ortaya çıkar: Trendyol siparişinin her satırı ürünün barkoduyla birlikte stok kodunu da taşır; entegrasyon belgesinde bu alan sipariş paketinde merchantSku adıyla geçer. Depodaki toplama listesinde, muhasebe programında ve kendi kataloğunuzda ürünü bu kodla tanırsınız.
Pratik kural: Trendyol'daki stok kodunu, ürünün kendi programınızdaki koduyla aynı yazın. Böylece Trendyol panelinden indirdiğiniz bir sipariş listesini kendi kataloğunuzla tek sütundan eşleştirebilirsiniz ve barkodun eşleşmediği bir satırda ikinci bir anahtar elinizde olur.
Barkod: Trendyol'un ilanı tanıdığı kod
Trendyol'un belgesi barkod alanı için birkaç kural koyuyor: en çok 40 karakter; özel karakter olarak yalnız nokta, tire ve alt çizgi; barkodun ortasındaki boşluk birleştirilerek alınır. Stok ve fiyat güncellemesinin, Trendyol'un içeri aldığı bu barkoda göre yapılması gerekir.
Bu kuralın sonucu basittir: barkod ilan açılırken nasıl yazıldıysa entegrasyonda da birebir öyle gönderilmelidir. En sık sorun Excel'de çıkar. Barkod sütunu sayı olarak biçimlenmişse Excel baştaki sıfırı siler ve on üç haneli bir barkod on iki haneye iner; uzun barkodlar bilimsel gösterime döner. Barkod sütununu her zaman metin olarak biçimlendirin.
Bir kural daha: ilan açıldıktan sonra barkodu sabit tutun. Barkodu değiştirmek ilanın kimliğini değiştirmek demektir; stok ve fiyat gönderimi, sipariş eşleştirmesi ve depodaki okutma aynı numaraya bağlıdır.
Model kodu varyantları nasıl bir arada tutar?
Model kodu, satıcı panelinde “Model Kodu” adıyla görünen ana ürün kodudur. Trendyol varyantları bu koda göre gruplar: aynı modelin bütün bedenleri ve renkleri aynı model koduyla gönderilir, yalnız beden ve renk gibi özellikleri farklılaşır. Bir bedene başka bir model kodu yazılırsa o beden aynı ürünün seçeneği olarak değil, ayrı bir ürün olarak görünür.
Model kodu stok ve fiyat gönderiminde kullanılmaz. BayiData'nın Trendyol'a gönderdiği her satırda barkod, miktar ve fiyat vardır; model kodu ilan açılırken bir kez belirlenir ve sonrasında Trendyol tarafında kalır.
Varyantlı üründe barkod: beden ve renk
Bir tişörtün üç bedeni ve iki rengi varsa Trendyol'da altı ayrı satır, altı ayrı barkod vardır; altısı da aynı model kodunu taşır. Trendyol belgesine göre renk gibi özellikler ürünü ayrı ürün sayfalarında açar, beden gibi özellikler aynı sayfada seçenek olarak durur. İkisinde de barkod varyant başınadır. Aşağıdaki tablo bir örnektir:
| Varyant (örnek) | Model kodu | Stok kodu | Barkod |
|---|---|---|---|
| Siyah, S | TS-2041 | TS-2041-SYH-S | 2000000000015 |
| Siyah, M | TS-2041 | TS-2041-SYH-M | 2000000000022 |
| Beyaz, S | TS-2041 | TS-2041-BYZ-S | 2000000000039 |
BayiData'da varyantlı ürün aynı mantıkla tutulur. Model, kendisi satılmayan bir üst karttır; her beden-renk kendi kodu, kendi barkodu ve kendi stoğuyla ayrı bir üründür. Aynı barkod firmada iki ürüne yazılamaz; iki varyanta yanlışlıkla aynı barkodu vermek kayıt anında engellenir.
Stok kodu nasıl yazılmalı?
Trendyol'un belgesine göre stok kodu en çok 100 karakter olabilir ve satıcının sisteminde tekil olmalıdır. Kendi düzeninizi seçerken üç kural işe yarar:
- Her varyantın kendi stok kodu olsun; modelin kodu, rengi ve bedeni aynı sırayla yazılsın (TS-2041-SYH-S gibi).
- Aynı kod bütün kanallarda aynı kalsın: kendi programınızda, bayi portalında ve pazaryerinde.
- Boşluk yerine tire kullanılsın; okunması ve aranması kolaylaşır.
BayiData'da ürün kodu firmada tekildir; aynı kod iki ürüne verilemez. Trendyol'daki stok kodu ürün kodunuzla aynıysa siparişin satırı, barkod eşleşmediğinde bile ürün koduyla bulunur.
Kodlar karışınca ne olur?
| Belirti | Olası sebep | Ne yapılır |
|---|---|---|
| İlan stok ve fiyat almıyor | Barkod alanına stok kodu yazılmış | Trendyol'daki barkodu katalogdaki barkodla karşılaştırın |
| Barkod bir hane eksik | Excel baştaki sıfırı silmiş | Sütunu metin yapıp listeyi yeniden alın |
| Bütün bedenlere aynı stok gidiyor | Varyantlar tek ürün kartında tutuluyor | Her beden-renk için ayrı ürün ve barkod açın |
| Sipariş satırı ürünle eşleşmedi | İlan barkodu sonradan değişmiş ya da ürün katalogda yok | Ürünü ekleyip barkodunu yazın |
| Sipariş listesinde kendi kodunuz görünmüyor | Stok kodu boş bırakılmış | Trendyol'da stok kodunu ürün kodunuzla doldurun |
| Ürün mağazaya bağlanmıyor | Ürün kartında barkod yok | Barkodu ekleyip ürünü yeniden bağlayın |
BayiData'da ilan eşleştirme: anahtar barkod
BayiData'da Trendyol ilanı katalogdaki ürüne barkodla bağlanır. Barkodu olmayan ürün mağazaya bağlanamaz; ekran sebebini söyler ve önce ürüne barkod eklemenizi ister. Ürün kartında birden çok barkod olabilir; eşleştirme listesinde her ilanın hangi barkodla bağlandığı görünür, Trendyol'daki barkodla aynı olduğunu buradan kontrol edersiniz.
Bağlama anında barkod ilana kopyalanır. Ürünün barkodu sonradan değişse bile ilanın hangi barkodla açıldığı kayıtlı kalır. Kataloğu binlerce kalem olan firma için toplu eşleştirme var: barkodu olan bütün satılabilir ve etkin ürünler tek seferde mağazaya bağlanır. Zaten bağlı olan ilana dokunulmaz, sizin kapattığınız ilan yeniden açılmaz. Kapalı ilanın stoğu ve fiyatı gönderilmez.
Aynı ürün birden çok Trendyol mağazasına bağlanabilir; her mağaza ayrı hesap olduğu için eşleştirme de mağaza başına tutulur.
Aynı barkod bayi siparişinde de çalışır
Barkodun işi pazaryeriyle bitmez. BayiData'da aynı barkodla bayi portalda ürünü arar, depo siparişi barkod okutarak toplar, Trendyol ilanı da o barkodla eşleşir. Tek bir alan üç işi besler.
Bunun iki sonucu var. Yanlış girilmiş bir barkod üç yerde birden sorun çıkarır; düzeltmesi de tek yerden yapılır. Barkodları bir kez temizleyen firma, pazaryeri bağlantısından önce depodaki toplama hatalarını da azaltmış olur.
Sipariş gelince satır ürüne nasıl bağlanır?
Trendyol siparişi çekildiğinde her satır kendi ürününüze bağlanmalıdır; stok ancak o zaman doğru üründen ayrılır. BayiData satırı şu sırayla arar:
- Bu mağazanın ilanlarında satırın barkodu.
- Bu mağazanın ilanlarına bağlı ürünlerin kodunda satırın stok kodu.
- Kataloğun bütün barkodlarında satırın barkodu.
- Kataloğun ürün kodlarında satırın stok kodu.
İlk adım en güvenilir eşleşmedir, çünkü o ilanı mağazaya siz bağladınız. Sonraki adımlar, ilan silinmiş ama sipariş gelmiş gibi durumlar içindir. Dördünde de bulunamayan satır siparişi aktarmaz: sipariş, hangi barkodun eşleşmediği yazılarak aktarılamayanlar listesinde görünür. Aktarılan siparişte stok otomatik ayrılır ve aynı sipariş ikinci kez açılmaz.

Trendyol'a bağlamadan önce kontrol listesi
- Satılacak her ürünün katalogda barkodu var mı?
- Beden ve renkler ayrı ürün olarak, her biri kendi barkoduyla açıldı mı?
- Katalogdaki barkodlar Trendyol'daki barkodlarla harfi harfine aynı mı?
- Excel'deki barkod sütunu metin olarak mı biçimlendirildi?
- Trendyol'daki stok kodları ürün kodlarınızla aynı mı?
- İlk gönderimden önce “şimdi gönderilse ne gider” önizlemesine bakıldı mı?
Bağlantının kendisi, API bilgileri ve sık hatalarla birlikte Trendyol entegrasyonu nasıl yapılır yazısında.
Kısa sorular
Stok kodu ile barkod aynı olabilir mi?
Trendyol buna engel koymaz, ama iki alanın işi farklıdır. Barkod çoğu zaman üreticinin ya da sizin aldığınız uluslararası barkoddur; stok kodu sizin iç kodunuzdur. İkisini ayrı tutmak, eşleşmeyen bir satırda ikinci bir anahtar bırakır.
Aynı ürünü iki mağazada farklı fiyatla satabilir miyim?
Evet. Her mağaza hesabının kendi fiyat listesi ve kâr payı olur; tek bir ilana özel fiyat da yazılabilir. Barkod iki mağazada da aynıdır, stok aynı depodan hesaplanır.
Katalogdaki barkodu değiştirirsem ilan ne olur?
İlan bağlandığı barkodu saklar ve gönderim o barkodla devam eder. Katalogdaki barkodu değiştirdiyseniz ürünü mağazaya yeniden bağlayın; ilanın barkodu yenisiyle güncellenir. Ardından Trendyol'daki barkodla aynı olduğunu kontrol edin.
Hepsiburada'da da eşleşme barkodla mı yürür?
Hayır. Hepsiburada stok ve fiyat satırını satıcının stok koduyla tanır; ilanı açarken stok kodu olarak ürün kodunuz yazılır. Stok kodunu bütün kanallarda aynı tutmak, ikinci bir pazaryeri açıldığında bu yüzden işinizi kolaylaştırır. Ayrıntı Hepsiburada entegrasyonu sayfasında.
BayiData'dan Trendyol'da yeni ilan açılır mı?
Açılmaz. İlan Trendyol'un kendi panelinde açılır; BayiData mevcut ilanı katalogdaki ürünle eşleştirir. Kategori ve özellik eşleştirmesi de yok.
Barkodu olmayan ürün Trendyol'a stok gönderir mi?
Göndermez. Ürün mağazaya bağlanamaz; önce barkod eklenir. İşlem tablosu ve kurulum Trendyol entegrasyonu sayfasında, depo tarafı stok ve depo yönetimi sayfasında.