Türkiyemin'e bağlanmak gözünüzde büyüyor olabilir, ama aslında işin özü iki bilgi: Key ID ve Secret. Bu ikisini Türkiyemin satıcı panelinden alıp Ventegre paneline giriyorsunuz, bağlantı kuruluyor. Geri kalan her şey — ürün aktarımı, stok ve fiyat senkronizasyonu — bu bağlantının üstüne çalışıyor.
Bu yazıda Türkiyemin panelinden bu iki bilgiyi tam olarak nereden alacağınızı, Ventegre'de 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 dakika içinde mağazanız bağlı olacak.
Trendyol'dan gelenler için not: Türkiyemin'de Trendyol'daki gibi "Entegratör adı" yazma ya da sevkiyat/iade adresi seçme adımları yok. Sadece bir API anahtarı oluşturup bağlamanız yeterli — bağlantı daha sade.
Bağlantı İçin Ne Lazım?
Başlamadan önce iki şey hazır olsun:
- Aktif Türkiyemin satıcı hesabı. Mağaza başvurunuz tamamlanmış ve panelinize giriş yapabiliyor olmanız gerekiyor.
- Ventegre hesabı. Ücretsiz hesap buradan açılır.
İkisi de hazırsa başlayalım.
1. Türkiyemin Satıcı Paneline Giriş Yapın
Tarayıcıdan firma.turkiyemin.com adresine gidin ve satıcı bilgilerinizle giriş yapın. Satıcı paneli doğrudan burada açılır. Ürün, sipariş ve ayarların yönetildiği yer burasıdır.
2. API Anahtarları Sayfasını Açın
Giriş yaptıktan sonra sol menüdeki Destek bölümüne inin. Orada iki menü göreceksiniz: Destek Merkezi ve Entegrasyon. Entegrasyon menüsüne tıklayın.
Bu sizi API Anahtarları sayfasına götürür. Sayfanın başlığında şunu okursunuz:
Entegrasyon uygulamalarınız (ERP, entegratör) için API anahtarları oluşturun.
Eğer daha önce hiç anahtar oluşturmadıysanız tablo boş gelecektir. Bu normal; bir sonraki adımda oluşturacağız.
İpucu: Aynı sayfada sağ üstte "API Dokümantasyonu" butonu da var. Türkiyemin'in kendi API dökümanını açar; teknik merakınız varsa bakabilirsiniz, ama bağlantı kurmak için gerekli değil.
3. "Yeni Anahtar" Oluşturun
Sayfanın sağ üstündeki "Yeni Anahtar" butonuna basın. Karşınıza küçük bir pencere çıkar ve anahtara bir ad vermenizi ister. Bu ad sadece sizin için bir hatırlatma; Ventegre'yi bağladığınızı bilmek adına Ventegre yazmanızı öneririm.
Oluştur butonuna bastığınızda Türkiyemin sizin için iki bilgi üretir:
| Bilgi | Açıklama |
|---|---|
| Key ID | Bağlantının açık anahtarı. Anahtar listesinde her zaman görünür, sonra da ulaşabilirsiniz. |
| Secret | Bağlantının gizli anahtarı. Bu pencerede bir kez gösterilir ve bir daha asla görüntülenemez. |
İkisini de hemen kopyalayın. Pencerede her birinin yanında bir Kopyala butonu var.
Kritik uyarı: Secret değerini şimdi kopyalamazsanız daha sonra tekrar ulaşamazsınız. Türkiyemin güvenlik gereği bu değeri sadece oluşturulduğu an gösterir. Panonuza yapıştırın, başını ve sonunu kontrol edin; eksik karakter varsa bağlantı kurarken "kabul edilmedi" hatası alırsınız. Kaybederseniz çözüm kolay: yeni bir anahtar oluşturursunuz.
Pencereyi güvenli bir şekilde kapatın. Anahtar listenizde artık Ventegre adlı, Aktif durumda bir anahtar görünmesi lazım.
İşte bu kadar — bağlantı için ihtiyacınız olan tek şey bu iki değer.
4. Ventegre Panelinde Türkiyemin'i Bağlayın
Key ID ve Secret elinizdeyken Ventegre tarafına geçiyoruz.
- Ventegre paneline giriş yapın.
- Ayarlar sayfasını açın. Burada tüm pazaryerleri kartlar halinde listelenir.
- Türkiyemin kartını bulun ve üzerindeki "Sisteme Bağla" butonuna basın.
- Açılan pencerede iki alan doldurun:
- API Anahtarı (API Key) → Türkiyemin'deki Key ID
- API Şifresi (API Secret) → Türkiyemin'deki Secret
- "Bağlantıyı Test Et" butonuna tıklayın.
İsimlendirme biraz farklı gelebilir; eşleştirme şöyle:
| Ventegre'deki alan | Türkiyemin'deki karşılığı |
|---|---|
| API Anahtarı (API Key) | Key ID |
| API Şifresi (API Secret) | Secret |
Bu noktada Ventegre, girdiğiniz bilgilerle Türkiyemin'e gerçek bir istek atıp bilgilerin doğru olduğunu teyit eder. Uydurma bir Key ID ya da yanlış bir Secret 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 Secret korunur.
Test başarılı olursa pencere yeşil onay verir ve Türkiyemin 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.
5. Bağlantı Kurulduktan Sonra Ne Oluyor?
Bağlantı kurulur kurulmaz iki şey hazır olur:
- Ventegre'deki ürünlerinizi Türkiyemin'e gönderebilirsiniz. Bağlantı, ürün gönderme ve fiyat/stok güncellemelerinin kapısını açar. Ürünlerinizi nasıl göndereceğinizi ürün gönderme rehberinde anlatıyoruz.
- Fiyat ve stok değişiklikleri Türkiyemin'e otomatik gider. Ventegre'de bir ürünün stoğunu veya fiyatını değiştirdiğinizde güncelleme Türkiyemin'e yansır.
Türkiyemin tek yönlü çalışır: Ventegre'den Türkiyemin'e ürün, fiyat ve stok akar; ters yön (Türkiyemin'deki ürünleri Ventegre'ye çekme) şu an desteklenmiyor. Bu yüzden Türkiyemin'de yapılan satışlar Ventegre'ye otomatik düşmez — stoğunuzu Ventegre'den yönetip güncel tutmanız gerekir.
Bağlantı kurulduktan sonra ürün yönetimi ve diğer kanallara genişletme ayrı konular. Onları blogdaki ilgili rehberlerde detaylı işliyoruz.
Sıkça Sorulan Sorular
Hayır. API anahtarı oluşturmak ve Ventegre'ye bağlamak tamamen ücretsiz. Türkiyemin'in satış komisyonu ayrıdır; bağlantı kurmak için ek bir ücret yoktur.
Hayır. Türkiyemin'de Trendyol'daki gibi panele "Çalıştığınız entegratörün adı" yazma adımı yoktur. Sadece API Anahtarları sayfasından bir anahtar oluşturmak yeterli. Ventegre bu anahtarla bağlanır.
Secret güvenlik gereği yalnızca oluşturulduğu anda gösterilir ve bir daha görüntülenemez. Çözüm basit: API Anahtarları sayfasına dönün, eski anahtarı İptal Et'in, Yeni Anahtar ile yeni bir tane oluşturun (yeni Key ID ve Secret gelir). Sonra Ventegre'deki kaydınızı yeni bilgilerle güncelleyin.
Ventegre, test sırasında Türkiyemin'e gerçek bir istek atar. "Bilgiler kabul edilmedi" benzeri bir hata alırsanız iki olası neden var:
- Key ID veya Secret eksik kopyalandı. En yaygın neden. Secret'ı oluşturma penceresinden kopyalarken başını ve sonunu kontrol edin; eksik karakter olmasın. Kaybettiyseniz yeni anahtar oluşturun.
- Anahtar iptal edilmiş. API Anahtarları sayfasında anahtarınızın Aktif göründüğünden emin olun. Yanlışlıkla iptal ettiyseniz yeni bir tane oluşturun.
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. Türkiyemin'de aynı anda tek entegratör (Ventegre) ile çalışın.
Ventegre'den bağlantıyı kaldırdığınızda Türkiyemin'e stok güncellemesi gitmez. Bu, ürünlerinizin Türkiyemin'de yanlış stokla satılmasına yol açabilir. Geçici olarak durdurmak istiyorsanız bağlantıyı açık bırakıp Ventegre destek ekibine danışın; kalıcı ayrılma yerine daha sağlıklı bir yol bulabiliriz.
Bu menü sol panelde Destek bölümünün altındaki Entegrasyon öğesidir. Panelinize yeni kabul edildiyseniz ve menü görünmüyorsa sayfayı yenileyin; hâlâ yoksa Türkiyemin destek ekibiyle iletişime geçin — hesabınızda entegrasyon izni henüz açılmamış olabilir.
Bir mağaza aynı anda yalnızca bir Ventegre şirketiyle bağlanabilir. Mağazayı taşımak istiyorsanız önce eski bağlantıyı kaldırın, sonra yeni hesaptan bağlayın.
Türkiyemin'e bağlantı kurmak bu kadar. Adım özeti: anahtar oluştur → Key ID + Secret'u al → Ventegre'ye gir → test et. Bağlantı kurulur kurulmaz ürün ve stok akışı büyük ölçüde otomatik çalışmaya başlar. Ürün gönderme ve operasyon 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.