Trendyol stok kodu nedir? Barkod ve model kodundan farkı, nasıl oluşturulur

Kısa cevap: Trendyol'da stok kodu, bir ürünü sizin kendi sisteminizde tanımlayan koddur; İngilizcede SKU denir. Trendyol'un entegrasyon belgelerinde bu alanın adı `stockCode`, tanımı "tedarikçinin kendi sistemindeki benzersiz stok kodu", uzunluğu ise en fazla 100 karakter. Stok kodu, ürünün barkodundan (zorunlu, en fazla 40 karakter) ve varyantları bir araya toplayan model kodundan (en fazla 40 karakter) ayrı bir alandır. Siparişlerde de aynı kod geri gelir; bu sayede hangi siparişin depodaki hangi ürün olduğunu hemen bilirsiniz. Birden çok pazaryerinde satıyorsanız aynı ürüne her yerde aynı stok kodunu vermek, ürünlerinizi stok koduna göre bütün pazaryerlerinde eşleştiren bir panel kullanmanın da ön koşuludur.

Stok kodu ne demek?

Stok kodu, ürününüze sizin verdiğiniz kimlik numarasıdır. Trendyol'un ürün numarası, barkod ya da kategori kodu gibi dışarıdan gelen bir kod değildir; deponuzda, muhasebe programınızda ve Excel listenizde ürünü hangi kodla takip ediyorsanız odur. Trendyol bu alana "tedarikçinin kendi sistemindeki stok kodu" diyor; "satıcı stok kodu" ifadesi de aynı şeyi anlatır.

Trendyol'un ürün aktarma belgesine göre stok kodu alanı zorunlu değildir. Yani kodsuz da ürün yükleyebilirsiniz. Ama birkaç düzine üründen sonra stok kodu olmadan çalışmak hem depoda hem de muhasebede ciddi karışıklık yaratır; bu yüzden zorunlu değilmiş gibi değil, zorunluymuş gibi davranmanızı öneririz.

Stok kodu, barkod ve model kodu: üç ayrı alan

Satıcıların en çok karıştırdığı konu, ürün girişindeki bu üç kodun farkıdır. Trendyol'un entegrasyon belgelerine göre:

• Stok kodu (`stockCode`) — Ne işe yarar?: Ürünün sizin sisteminizdeki kodu. Siparişlerde `merchantSku` olarak geri gelir.; Zorunlu mu?: Hayır; Uzunluk: En fazla 100 karakter
• Barkod (`barcode`) — Ne işe yarar?: Ürünün (her varyantın) barkodu. Stok ve fiyat güncellemeleri bu barkoda göre yapılır.; Zorunlu mu?: Evet; Uzunluk: En fazla 40 karakter
• Model kodu (`productMainId`) — Ne işe yarar?: Aynı ürünün renk, beden gibi varyantlarını tek ürün altında toplar. Satıcı panelindeki "Model Kodu"na karşılık gelir.; Zorunlu mu?: Evet; Uzunluk: En fazla 40 karakter

Kısacası: barkod ürünü Trendyol'da tanıtır, model kodu varyantları gruplar, stok kodu ise ürünü sizin işinizle bağlar. Bir tişörtün beyaz-M, beyaz-L ve siyah-M varyantları aynı model kodunu taşır; her birinin ayrı barkodu ve ayrı stok kodu olur.

Trendyol stok kodu kaç haneli olmalı?

Belirli bir hane sayısı yok. Trendyol'un belgelerinde stok kodu için yalnızca bir üst sınır var: 100 karakter. Barkod ve model kodu için bu sınır 40 karakter.

Barkod için belgelerde ayrıca şu kurallar yazıyor:

• Özel karakter olarak yalnızca nokta (.), tire (-) ve alt çizgi (_) kullanılabilir.
• Türkçe karakterler (ğ, ş, İ, ü gibi) kabul edilir.
• Barkodun ortasında boşluk varsa boşluk silinip birleştirilerek aktarılır; sonraki stok ve fiyat güncellemelerinizi de bu birleşmiş barkoda göre yapmanız gerekir.

100 karakter sınır, hedef değildir. Pratikte kısa ve okunabilir bir stok kodu, depoda ürünü bulan kişinin de, siparişi kontrol eden kişinin de işini kolaylaştırır.

Stok kodu neden bu kadar önemli?

• Sipariş ile ürün arasında köprü kurar. Trendyol'un belgesine göre ürün verisindeki stok kodu, sipariş verisinde `merchantSku` alanı olarak yer alır. Sipariş geldiğinde ürünü barkodla değil, kendi kodunuzla tanırsınız.
• Depoda doğru ürünü toplatır. Raf etiketiniz, toplama listeniz ve stok sayımınız aynı kodla çalışırsa yanlış varyant gönderme riski azalır.
• Muhasebe ve stok programıyla konuşur. Fatura ve stok kayıtlarındaki ürün kodu ile pazaryerindeki kod aynıysa kayıtları eşleştirmek için elle uğraşmazsınız.
• Birden çok pazaryerinde aynı ürünü tanımanızı sağlar. Aynı ürünü Trendyol, Hepsiburada ve N11'de satıyorsanız ortak dil stok kodudur. Bir pazaryerinde satış olduğunda diğerlerindeki stoğun düşmesi için ürünün her yerde aynı ürün olarak tanınması gerekir.

Trendyol stok kodu nasıl oluşturulur?

Trendyol stok kodu için bir şablon dayatmıyor; kodu siz belirlersiniz. İyi bir stok kodu sistemi kurmak için şu kurallar işinizi kolaylaştırır:

1. Her varyanta ayrı kod verin. Beyaz-M ile beyaz-L aynı kodu taşırsa stok takibi anlamsız hale gelir.
2. Bir kodu bir kez kullanın. Satıştan kaldırdığınız bir ürünün kodunu yeni bir ürüne vermeyin; eski sipariş ve faturalarda karışıklık çıkar.
3. Anlamlı ama kısa bir yapı seçin. Örneğin ürün grubu - model - renk - beden sırası: `TSH-0142-BYZ-M`. (Bu yapı bir örnektir, Trendyol kuralı değildir.)
4. Sade karakterler kullanın. Harf, rakam ve tire çoğu program için yeterlidir. Boşluk ve Türkçe karakterler bazı muhasebe, kargo ya da Excel araçlarında sorun çıkarabilir; kodu bütün sistemlerinizde aynı tutmak için bunlardan kaçınmak daha güvenlidir.
5. Büyük-küçük harfi sabitleyin. `tsh-0142` ile `TSH-0142` bazı sistemlerde iki ayrı ürün sayılabilir. Hep aynı yazımı kullanın.
6. Kodu sonradan değiştirmeyin. Kod değişirse eski siparişler, faturalar ve entegrasyonlar yeni kodla eşleşmez.

Tedarikçinizin ürün kodunu stok kodu olarak kullanmak ilk bakışta pratik görünür; ama aynı ürünü iki tedarikçiden aldığınızda ya da tedarikçi kodlarını değiştirdiğinde sorun çıkar. Kendi kod sisteminizi kurup tedarikçi kodunu ayrı bir alanda tutmak daha sağlamdır.

Barkod ve model kodunda dikkat edilecekler

Trendyol'un ürün güncelleme belgesine göre onaylanmış bir üründe barkod, model kodu, marka ve kategori alanları güncellenemez. Bu yüzden ürünü yüklemeden önce bu alanları kontrol edin: yanlış girilmiş bir barkodu onaydan sonra düzeltmek kolay değildir.

Belgelerde ayrıca iki pratik not var: Ürün stoksuz oluşturulabilir (stok ilk başta 0 olur) ve stok yalnızca stok güncelleme servisi üzerinden değiştirilebilir. Entegrasyon kullanıyorsanız ürün bilgisi ile stok bilgisinin ayrı yollardan gittiğini bilmek, "ürün yüklendi ama stok görünmüyor" türü sorunları anlamanızı kolaylaştırır.

Barkodunuz yoksa ve kendi GS1 numaranız varsa EAN-13 barkodlarınızı kendiniz üretebilirsiniz; Pratienda'nın barkod üretimi bu iş içindir.

Hepsiburada ve N11'de de aynı stok kodunu kullanın

"hepsiburada stok kodu nedir" ve "n11 stok kodu nedir" aramaları da aynı soruyu soruyor: Bu pazaryerlerinde de satıcının kendi ürün kodu ile pazaryerinin verdiği ürün numarası ayrı şeylerdir. Alan adları ve kuralları her pazaryerinde farklı olabilir; ürün girişinde ilgili satıcı panelinin yardım sayfasındaki güncel kurala bakın.

Önemli olan, aynı ürüne her pazaryerinde aynı stok kodunu vermektir. Trendyol'da `TSH-0142-BYZ-M` olan ürün Hepsiburada'da başka, N11'de başka bir kodla girilirse:

• Hangi pazaryerinden kaç adet sattığınızı tek tabloda göremezsiniz,
• Bir yerde satılan ürünün diğerlerinde stoktan düşmesi için ayrıca eşleştirme yapmanız gerekir,
• Son adet iki pazaryerinde aynı anda satılabilir ve bir siparişi iptal etmek zorunda kalırsınız.

Varyant düzeyinde aynı kod kullanmak, komisyon kontrolünde de işe yarar: Trendyol'da aynı ürünün varyantlarında komisyon oranı farklı olabildiği için kârı varyant varyant izlemeniz gerekir. Bu hesabın nasıl yapıldığını trendyol komisyon hesaplama yazımızda anlattık.

Sık yapılan hatalar

• Stok kodunu boş bırakmak. Zorunlu olmadığı için atlanır, sonra yüzlerce ürünü geriye dönük kodlamak gerekir.
• Barkodu stok kodu sanmak. Barkod Trendyol'un ürünü tanıdığı koddur; sizin iç kodunuzun yerini tutmaz.
• Varyantlara aynı kodu vermek. Stok varyant düzeyinde tutulur; kod da varyant düzeyinde olmalıdır.
• Her pazaryerine farklı kod girmek. Elle yapılan girişlerde en sık görülen hatadır ve stok eşitlemeyi imkânsız hale getirir.
• Kodu Excel'de bozmak. Başında sıfır olan kodlar (ör. `00142`) sayı biçiminde açıldığında `142`'ye dönüşebilir. Stok kodu sütununu metin olarak biçimlendirin.

Pratienda stok kodlarınızla nasıl çalışır?

Pratienda, Trendyol, Hepsiburada ve N11 mağazalarınızı tek panelde toplar ve stok kodlarına (SKU) göre aynı ürünü her pazaryerinde tanıyıp tek ürün kartında birleştirir. Bir pazaryerinde satış olduğunda stok diğerlerinde de düşer; böylece fazla satış ve iptal riski azalır. Siparişleriniz üç pazaryerinden tek listede, durumlarıyla birlikte görünür. Fiyat robotu da rakip fiyatlarını izleyip belirlediğiniz taban fiyatın altına inmeden öneri yapar; trendyol buybox nedir yazımızda bunun neden önemli olduğunu anlattık. Siz onaylamadan hiçbir fiyat değişmez.

Stok kodlarınız düzenliyse kurulum kolaylaşır: Pazaryeri hesaplarınızı API bilgileriyle bağladığınızda eşleştirme bu kodlar üzerinden yapılır. Başlangıç paketi aylık 2.890 TL + KDV; sunucu ve paketteki yapay zekâ kullanımı dahildir.

Pratienda'yı inceleyin →

Sık sorulan sorular

Trendyol'da stok kodu girmek zorunlu mu?
Trendyol'un ürün aktarma belgesine göre zorunlu değil. Ancak siparişleri, depoyu ve diğer pazaryerlerini aynı ürünle eşleştirmek için her varyanta bir stok kodu vermenizi öneririz.

Stok kodu ile barkod aynı olabilir mi?
Trendyol'un belgelerinde bunu yasaklayan bir kural görmedik. Yine de ikisi farklı işler görür: Barkod ürünü pazaryerinde tanıtır, stok kodu sizin iç kodunuzdur. Barkodu olmayan ya da barkodu değişebilecek ürünlerde ayrı bir stok kodu tutmak daha güvenlidir.

Onaylanan ürünün barkodunu değiştirebilir miyim?
Trendyol'un ürün güncelleme belgesine göre onaylanmış üründe barkod, model kodu, marka ve kategori güncellenemez. Bu alanları ürünü yüklemeden önce kontrol edin.

Kaynak: Trendyol Developers, "Product Create v2", "Product Create V1" ve "Product Update V1" sayfaları. Bilgiler 24 Ekim 2026 itibarıyla geçerlidir; Trendyol kurallarını değiştirebilir.