Trendyol'a bağlanmak denince gözünüzde büyüyor olabilir, ama aslında işin özü üç parça bilgi: Satıcı ID, API Key ve API Secret. Bu üçünü Trendyol satıcı panelinden alıp Ventegre paneline giriyorsunuz, bağlantı kuruluyor. Geri kalan her şey — ürün aktarımı, stok senkronizasyonu, sipariş akışı — bu bağlantının üstüne çalışıyor.
Bu yazıda Trendyol'dan bu üç bilgiyi tam olarak nereden alacağınızı, Ventegre panelinde nasıl bağlayacağınızı ve en sık karşılaşılan hataları nasıl çözeceğinizi anlatıyorum. Yazıyı sonuna kadar takip ederseniz 5–10 dakika içinde mağazanız bağlı olacak.
Bağlantı İçin Ne Lazım?
Başlamadan önce iki şey hazır olsun:
- Aktif Trendyol satıcı hesabı. Mağaza açma sürecini tamamlamış, Trendyol onayı gelmiş olmanız gerekiyor. Bunun için Trendyol satıcı olma rehberimize göz atabilirsiniz.
- Ventegre hesabı. Ücretsiz hesap buradan açılır.
İkisi de hazırsa başlayalım.
1. Trendyol Satıcı Paneline Giriş Yapın
Tarayıcıdan partner.trendyol.com adresine gidin ve satıcı bilgilerinizle giriş yapın. Trendyol bu panele "Satıcı Paneli" diyor; burası ürün, sipariş ve ayarların yönetildiği yer.
2. Entegrasyon Bilgileri Sayfasını Açın
Giriş yaptıktan sonra sağ üst köşedeki kullanıcı menüsüne (profil ikonu veya ünvanınız) tıklayın. Açılan menüden şu yolu izleyin:
Hesap Bilgileri → Entegrasyon Bilgileri
Bu sayfa, API bağlantısı için gerekli tüm bilgilerin üretildiği yer. Eğer daha önce hiç entegratör tanımlamadıysanız karşınıza boş bir ekran çıkacak. Bu normal; bir sonraki adımda dolduracağız.
3. Entegratör Olarak "Ventegre" Yazın
İşte bağlantının kalbi burası. Trendyol, API bilgilerini sadece "bir entegratör ile çalıştığını" bildiği satıcılara verir. Bu yüzden önce kendinizi tanıtmanız gerekiyor.
Sayfada şu alanları göreceksiniz:
- "Pazaryeri entegratörü ile çalışıyor musunuz?" — Bu soruyu Evet olarak işaretleyin.
- "Çalıştığınız Entegratörün Adı" — Bu alana
Ventegreyazın. Büyük/küçük harf önemli değil, ama "ventegre" ya da "Ventegre" dışında bir varyasyon yazmayın.
Bu adım kritik. Entegratör adını yanlış yazarsanız API bilgileri yine de oluşabilir ama Trendyol tarafında bağlantı sağlıklı çalışmaz. Yazımı tek kelime, bitişik olarak girin: Ventegre.
Kaydet butonuna tıklayın.
4. Üç Bilgiyi Kopyalayın
Kaydettikten sonra aynı sayfada üç bilgi otomatik olarak oluşacak:
| Bilgi | Açıklama |
|---|---|
| Satıcı ID (Mağaza Numarası) | Mağazanızın sayısal kimliği. Genelde 5–7 haneli bir sayı. |
| API Key | Bağlantı için açık anahtar. Uzun bir alfanümerik dizi. |
| API Secret | Bağlantı için gizli anahtar. API Key kadar uzun, ama bu bilgi asla paylaşılmamalı. |
Bu üç bilgiyi bir yere not edin. API Secret'ı özellikle güvenli saklayın; kimseyle paylaşmayın, e-posta/WhatsApp ile göndermeyin.
Not: Bazı satıcılar API Secret'ı kopyalarken eksik alıyor. Kopyaladıktan sonra not defterine yapıştırıp başını ve sonunu kontrol edin; eksik karakter varsa bağlantı kurarken "kabul edilmedi" hatası alırsınız.
5. Ventegre Panelinde Trendyol'u Bağlayın
Üç bilgiyi aldıktan sonra Ventegre tarafına geçiyoruz.
- Ventegre paneline giriş yapın.
- Üst menüden "Pazaryeri API" sekmesine tıklayın. Bu sizi ayarlar sayfasına götürür.
- "Pazaryeri Entegrasyonları" bölümünde Trendyol kartını bulun. Kartın üzerinde "Sisteme Bağla" yazan butona basın.
- Açılan pencerede üç alan doldurun:
- Satıcı Kimliği (Seller ID) → Trendyol'dan aldığınız Satıcı ID
- API Anahtarı (API Key) → API Key
- API Şifresi (API Secret) → API Secret
- Pencerenin alt tarafında Sevkiyat Adresi ve İade Adresi seçenekleri de görünecek. Bunlar Trendyol'daki kayıtlı adreslerinizden gelir. Boş bırakırsanız Trendyol satıcı varsayılanınız kullanılır; özel bir tercihınız yoksa boş bırakabilirsiniz.
- "Bağlantıyı Test Et" butonuna tıklayın.
Bu noktada Ventegre, girdiğiniz bilgilerle Trendyol'a gerçek bir istek atıp bilgilerin doğru olduğunu teyit eder. Uydurma bir API Key ya da yanlış bir Satıcı ID girdiyseniz test başarısız olur; bu kötü bir şey değil, tam tersine — bağlantı kurulmadan sorun yakalanır.
İpucu: Daha önce bağlamışsanız, API Şifresi alanında
••••••••şeklinde maskeleme görürsünüz. Değiştirmek istemiyorsanız boş bırakın; mevcut anahtar korunur.
Test başarılı olursa pencere yeşil onay verir ve Trendyol kartı "Bağlı" durumuna geçer. Hata alırsanız aşağıdaki Sık Karşılaşılan Sorunlar bölümüne bakın.
6. Bağlantı Kurulduktan Sonra Ne Oluyor?
Burada çoğu kişinin beklediğinin aksine, yapacaklarınız çok az. Ventegre bağlantı kurulur kurulmaz arka planda şu işleri başlatır:
- Ürünleri otomatik çeker. Trendyol'daki tüm ürünleriniz sayfa sayfa çekilmeye başlar. Bu işlem arka planda çalışır; bir butona basmanıza gerek yok. Aynı ekranda ilerlemeyi görebilirsiniz ("Ürünleriniz çekiliyor…").
- Siparişleri anlık almaya başlar. Trendyol'da yeni bir sipariş oluştuğu anda Ventegre'ye düşer. Ek olarak Ventegre her dakika Trendyol'u kontrol eder; anlık bildirim bir şekilde kaçırılsa bile sipariş yine de gelir.
- Stok senkronizasyonu açılır. Trendyol'da bir ürün satıldığında stok Ventegre'de düşer ve aynı ürünü Hepsiburada/N11 gibi diğer kanallarınızda varsa orada da düşer. Bu, fazla satış (oversell) riskini sıfırlar.
Çekilen ürünler Trendyol'daki gerçek durumlarıyla gelir: Trendyol'da satıştaysa Yayında, satışta değilse Yayında değil olarak görünür. Yani Ventegre'de gördüğünüz durum, Trendyol'daki durumdur. İstediğinizi seçip eşleştirme yapabilir, fiyat düzenleyebilir, başka pazaryerlerine gönderebilirsiniz.
Bağlantı kurulduktan sonra ürün yönetimi, sipariş operasyonu ve diğer kanallara genişletme ayrı konular. Onları blogdaki ilgili rehberlerde detaylı işliyoruz.
Sıkça Sorulan Sorular
Hayır. API bilgilerini almak ve Ventegre'ye bağlamak tamamen ücretsiz. Trendyol'un satış komisyonu ayrıdır, bağlantı kurmak için ek ücret yoktur.
Teknik olarak mümkün ama önerilmez. Aynı anda iki entegratör ürün ve stok güncellemesi yaparsa veriler çakışır, fazla satış veya stok bozulmaları yaşanır. Trendyol panelinde aynı anda tek entegratör ile çalışın.
Ventegre panelinden bağlantıyı kestiğinizde Trendyol'a stok güncellemesi gitmez. Bu, ürünlerinizin Trendyol'da yanlış stokla satılmasına yol açabilir. Kalıcı olarak ayırmak istemiyorsanız bağlantıyı açık bırakın; geçici olarak durdurmak istiyorsanız destek ekibine danışın.
Trendyol paneli güvenlik gereği Secret'ı bir kez gösterir. İlk aldığınızda mutlaka kaydedin. Kaybettiyseniz aynı entegratör ile yeni API bilgisi oluşturabilir, Ventegre'deki kaydı yeni bilgilerle güncelleyebilirsiniz.
Trendyol panelinde "Pazaryeri entegratörü ile çalışıyor musunuz?" sorusunu henüz Evet yapmadınız. O seçeneği aktif edip entegratör adına Ventegre yazın ve kaydedin; bilgiler anında oluşur.
Ventegre, test sırasında Trendyol'a gerçek bir istek atar. "Trendyol bu bilgileri kabul etmedi" benzeri bir hata alırsanız üç olası neden var:
- API Key veya API Secret eksik kopyalandı. En yaygın neden. Trendyol paneline dönün, bilgileri baştan kopyalayın ve son karakterin de tam geldiğinden emin olun.
- Satıcı ID yanlış. Satıcı ID sadece rakamlardan oluşur. Başında/sonunda boşluk varsa silin.
- Entegratör adı yanlış yazılmış. Trendyol panelinde entegratör adının
Ventegreolduğundan emin olun.
Sevkiyat/iade adresi seçenekleri Trendyol'daki kayıtlı adreslerinizden gelir. Önce API bilgilerinizi girip "Bağlantıyı Test Et" deyin, sonra pencereyi kapatıp açın; adresler dolmuş olacak. Hâlâ boşsa Trendyol satıcı panelinde adres tanımlı olmayabilir.
Bağlantı sonrası ürün çekme işlemi otomatik başlar ama bazı durumlarda uzayabilir: binlerce ürününüz varsa sayfa sayfa çekmek zaman alır. İlerleme "Pazaryeri API" sayfasında görünür. On dakikalardır hiç ilerleme yoksa destek ekibine haber verin; arka planda bir aksama olmuş olabilir.
Trendyol'a bağlantı kurmak bu kadar. Bağlantı kurulur kurulmaz ürün ve sipariş akışı büyük ölçüde otomatik çalışmaya başlar. Ürün yönetimi, sipariş operasyonu ve diğer kanallara genişletme hakkında rehberleri blogda topluyoruz; takipte kalın.
Bağlantıda takıldığınız bir yer olursa Ventegre destek ekibiyle iletişime geçin; bağlantı sürecini birlikte tamamlayalım.