Trendyol kataloğunuzu kendi mağazanıza kontrollü biçimde taşımak için ürün eşleme, varyant, fiyat, stok, görsel ve doğrulama süreçlerini planlayın.
Trendyol'daki ürünleri kendi e-ticaret kanalına aktarmak, ürün adlarını ve fiyatları bir dosyadan diğerine kopyalamaktan ibaret değildir. Güvenilir bir geçiş; ürün kimliği, kategori nitelikleri, varyant ilişkileri, stok, vergi, medya hakları ve sipariş sonrası operasyonu tek bir veri modeli altında uzlaştırır. Hedef, pazaryerindeki satışı kapatmak değil; markanın kendi kataloğunu yönetebildiği ek bir kanal açmaktır.
Trendyol'un resmi geliştirici dokümantasyonunda V2 güncel entegrasyon alanı olarak sunulur. Uç noktalar ve alan gereksinimleri değişebileceğinden uygulama sırasında her zaman resmi V2 dokümanını ve satıcı hesabınıza tanımlı yetkileri esas alın. Ekran kazıma, tüketici arayüzünü otomatik kopyalama veya izinsiz veri alma sürdürülebilir entegrasyon yöntemi değildir.
Önce aktarılabilecek veriyi tanımlayın
Üç veri sınıfını birbirinden ayırın:
- Markanın ana verisi: kendi SKU'su, barkodu, ürün adı, açıklaması, maliyeti, vergi oranı ve kullanım hakkı markaya ait görseller.
- Kanal verisi: Trendyol ürün/merchant kimliği, kategori eşlemesi, kanal fiyatı ve pazaryerine özgü durum kodları.
- Platforma veya üçüncü taraflara ait olabilecek veriler: müşteri yorumları, puanlar, rozetler, sayfa düzeni ve platform üretimi görseller.
Yeni mağazanın çekirdeği birinci sınıf veriden kurulmalıdır. İkinci sınıf alanlar yalnız eşleme ve uzlaştırma amacıyla saklanır. Üçüncü sınıf veriyi taşımadan önce kullanım yetkisini açıkça doğrulayın. Özellikle yorum ve puanları markanın serbestçe çoğaltabileceği katalog içeriği varsaymayın.
Kaynak-hedef eşleme sözlüğü oluşturun
Geçiş başlamadan önce ekiplerin birlikte onayladığı bir veri sözlüğü hazırlayın:
| Kaynak kavramı | Hedef alan | Dönüşüm kuralı | Hata davranışı |
|---|---|---|---|
| merchantSku | canonicalSku | Boşluk temizle, büyük/küçük harfi değiştirme | Eksikse karantinaya al |
| barcode | barcode | Metin olarak koru; baştaki sıfırı silme | Mükerrerse durdur |
| productMainId | productGroupKey | Varyantları aynı ürün altında grupla | Yetim varyantı raporla |
| categoryId | targetCategoryId | Onaylı kategori eşleme tablosu kullan | Eşleşme yoksa taslak bırak |
| attributes | attributes | Kod, değer ve birim normalizasyonu | Zorunlu alan eksikse yayınlama |
| salePrice | channelPrice | Vergi ve marj kuralını uygula | Eşik altındaysa onay iste |
| quantity | sourceInventory | Güvenlik stoğu düş, negatif değeri sıfırla | Anomali alarmı üret |
| imageUrls | mediaAssets | HTTPS erişimi, format ve hak kontrolü | Başarısız görseli yayınlama |
Ürün adı gibi görünen bir alan bile dikkat ister. Pazaryeri için anahtar kelime ağırlıklı bir ad, marka mağazasının editoryal tonuna uymayabilir. Ana katalogda nötr ürün adı tutulabilir; kanal başlığı ayrı üretilebilir. Aynı yaklaşım açıklama, SEO metni ve teslimat vaadi için de geçerlidir.
Varyant modeli en kritik noktadır
Renk, beden ve hacim seçenekleri kaynak sistemde farklı ürün satırları olarak görünebilir. Hedef mağaza ise bunları tek ürün detay sayfasında seçenek olarak sunabilir. Her varyantın kendi SKU, barkod, stok, fiyat ve görsel ilişkisi korunmalıdır.
Örneğin “Siyah / 38” varyantını yalnız “38” seçeneğine indirmek yanlış ürünü gönderme riski yaratır. Varyant anahtarı, renk kodu ile beden kodunun deterministik birleşimi olabilir; ancak bu anahtar sonradan değişmemelidir. Ana ürün ile varyant matrisi şu testlerden geçer:
- Aynı ürün grubunda iki varyant aynı seçenek kombinasyonuna sahip mi?
- Bir barkod birden fazla aktif SKU'ya bağlanmış mı?
- Her varyantın satılabilir stok ve fiyatı var mı?
- Görsel yalnız ana ürüne mi, belirli renge mi ait?
- Devre dışı kaynak varyant hedefte yanlışlıkla yeniden açılıyor mu?
Güvenli entegrasyon mimarisi
Doğrudan “Trendyol'dan oku, canlı mağazaya yaz” hattı kırılgandır. Araya gözlemlenebilir bir hazırlama katmanı koyun:
Yetkili kaynak bağlantısı → ham veri alanı → dönüştürme/eşleme → doğrulama → ana katalog → mağaza yayıncısı
Ham yanıtın zaman damgalı bir kopyası hata incelemesini kolaylaştırır; kişisel veri veya sır içerebilecek alanlar gereksiz yere tutulmamalı ve erişim kısıtlanmalıdır. Dönüştürme adımı tekrarlanabilir olmalı: aynı kaynak sürümü ikinci kez işlendiğinde yeni mükerrer ürün üretmemelidir. Bunun için idempotency anahtarı olarak kaynak mağaza kimliği, SKU ve veri sürümü kullanılabilir.
Bağlantı katmanı resmi limitlere uymalı, geçici hatalarda artan bekleme ile yeniden denemeli ve kalıcı 4xx hatalarını sonsuz döngüye sokmamalıdır. Kimlik bilgileri kod veya feed URL'sine yazılmaz; sır yönetiminde tutulur ve en az yetkiyle sınırlandırılır. Entegrasyonu kullanan satıcı hesabının buna açıkça yetkili olması gerekir.
Tam aktarım ve sürekli senkronizasyonu ayırın
İlk katalog aktarımı bir proje, stok ve fiyat güncellemesi ise devam eden bir operasyondur.
- İlk yükleme: ürün gövdesi, varyantlar, nitelikler ve medya taslak olarak alınır.
- Stok senkronizasyonu: kısa aralıklarla satılabilir adet güncellenir; kanal başına güvenlik stoğu uygulanır.
- Fiyat senkronizasyonu: finansın onayladığı fiyat kaynağı belirlenir; otomatik değişim marj tabanını aşamaz.
- İçerik senkronizasyonu: otomatik üzerine yazmak yerine değişiklik kuyruğuna alınabilir; marka mağazasındaki zengin içerik korunur.
- Pasifleştirme: kaynakta silinen veya kapanan ürün hedefte doğrudan yok edilmez; durumu pasif yapılır, açık sipariş ve rapor bağlantıları korunur.
İki kanalda aynı fiziksel stok satılıyorsa “son bilinen stok” yeterli değildir. Sepete ekleme ile ödeme arasında rezervasyon, iptal halinde serbest bırakma ve oversell önleme kuralı gerekir. Kritik ürünlerde pazaryeri ve mağaza için ayrı tahsis veya güvenlik stoğu en basit korumadır.
Üç kapılı doğrulama
Kapı 1 — şema kontrolü: zorunlu alan, tip, uzunluk, izin verilen değer, tekillik ve referans ilişkileri.
Kapı 2 — ticari kontrol: KDV, liste/satış fiyatı, minimum katkı payı, stok durumu, satışa uygunluk ve medya hakkı.
Kapı 3 — deneyim kontrolü: mobil görünüm, varyant seçimi, sepete ekleme, arama/filtre, teslimat bilgisi ve checkout.
Otomatik rapor en az şu uzlaştırmaları vermelidir: kaynak ürün sayısı ile alınan satır sayısı; benzersiz SKU ve barkod sayısı; ana ürün/varyant toplamı; yayımlanan, taslak ve karantinadaki ürün; erişilemeyen görsel; fiyat veya stok anomalisi. Ayrıca kategori başına örneklem seçilerek insan gözüyle kontrol yapılır.
Örnek geçiş
Bir ev-yaşam markasının Trendyol'da 600 ürün satırı olduğunu düşünelim. Keşif sonunda bunların 420 ana ürüne, 180'inin varyanta karşılık geldiği anlaşılır. İlk dalga, son 90 günde satış alan ve stok sürekliliği yüksek 80 ana ürünle sınırlanır. Kategori eşleme tablosunda 12 hedef kategori, 46 zorunlu özellik ve yedi birim dönüşümü tanımlanır. Ürünler taslak mağazaya alınır; 11 eksik barkod, sekiz mükerrer SKU ve 17 erişilemeyen görsel karantinaya düşer. Hatalar çözülmeden canlı yayın yapılmaz. Onay sonrası önce 10 ürün, sonra 80 ürün açılır; 20 test siparişiyle stok, kargo ve iade uçtan uca doğrulanır.
RACI: geçişte kim neyi sahiplenir?
| İş | Sorumlu | Nihai onay | Danışılan | Bilgilendirilen |
|---|---|---|---|---|
| Resmi bağlantı ve güvenlik | Entegrasyon/BT | Teknoloji lideri | Trendyol hesabı yöneticisi | E-ticaret |
| Alan ve kategori eşleme | Katalog operasyonu | E-ticaret lideri | Ürün, SEO | Destek |
| Fiyat ve vergi | Finans | Finans lideri | E-ticaret | Yönetim |
| Medya ve metin hakları | Marka/içerik | Marka lideri | Hukuk | Katalog ekibi |
| Stok ve sipariş | Operasyon | Operasyon lideri | BT, finans | Destek |
| Canlıya geçiş kararı | Proje yöneticisi | E-ticaret lideri | Tüm iş sahipleri | Şirket |
Canlıya çıkış kontrol listesi
- Güncel resmi V2 dokümanı ve hesap yetkileri teyit edildi mi?
- Kaynak kimliği ile marka SKU'su ayrı ve izlenebilir mi?
- Kategori/nitelik eşlemeleri sürümlü ve onaylı mı?
- Varyant matrisi, barkod tekilliği ve görsel ilişkisi doğrulandı mı?
- Fiyat, vergi, marj tabanı ve stok güvenlik kuralı test edildi mi?
- Entegrasyon tekrar çalıştığında mükerrer ürün üretmiyor mu?
- Hata kuyruğu, alarm, yeniden deneme ve manuel düzeltme sahibi belli mi?
- En az bir iptal, iade ve stok tükendi senaryosu gerçekçi siparişle sınandı mı?
Katalog geçişi tamamlandığında ürünleri yalnız yeni mağazada listelemekle kalmayın; seçili koleksiyonları creator vitrinlerine bağlayarak yeni kanalın talep tarafını da kurun. XML tabanlı bir sonraki adım için creator storefront feed rehberini kullanabilirsiniz.
E-ticaret satıcı kurulumunu başlatın veya marka hesabı oluşturun; ürün kataloğunuzu kontrollü biçimde kendi kanalınıza ve influencer satış ağına açın.