Trendyol, Hepsiburada, N11 ve Amazon'u hazır entegratörle mi yoksa özel API ile mi yönetmelisiniz? Beş karar sorusu, API sınırları, varsayımsal maliyet örneği ve kontrol listesi.
Trendyol, Hepsiburada, N11 ve Amazon'da birlikte satış yapan bir işletme için stok, fiyat, ürün ve sipariş verisini kanallarla konuşturmanın üç yolu vardır: hazır bir entegratör paneli, kendi geliştirdiğiniz API entegrasyonu ya da ikisinin karışımı. Bu yazı, kararı hangi sorulara göre vereceğinizi, pazaryerlerinin API tarafında bilmeniz gerekenleri ve sözleşme öncesi kontrol listesini sıralıyor.
Üç Yol: Entegratör, Özel Entegrasyon ve Melez Model
Hazır entegratör, birden çok pazaryerini tek panelden yöneten, aylık ya da yıllık abonelikle çalışan bir yazılım hizmetidir. Ürün aktarımı, stok-fiyat güncellemesi ve sipariş çekme hazır gelir; siz yalnızca pazaryeri hesap bilgilerinizi tanımlarsınız.
Özel entegrasyon, pazaryerlerinin sunduğu API'lere doğrudan bağlanan ve ERP'nizle ya da mağaza sisteminizle konuşan size özel bir yazılımdır. İş kuralları sizin süreçlerinize göre yazılır; bakım ve izleme sorumluluğu da size ya da yazılım ortağınıza aittir.
Melez model, gündelik işleri (ürün listeleme, sipariş ekranı) entegratöre bırakıp yalnızca size özgü akışları (ERP'den stok, özel fiyat kuralı, e-fatura sırası) özel yazılımla çözmektir. Hazır paket ile özel yazılım arasındaki genel çerçeveyi hazır paket mi, özel yazılım mı yazımızda ele almıştık; burada konuyu pazaryeri entegrasyonuna indiriyoruz.
Pazaryeri API'lerinde Bilmeniz Gerekenler
Hangi yolu seçerseniz seçin, altta aynı API kuralları çalışır. Trendyol'un geliştirici dokümanından örnek vermek gerekirse:
- Kimlik bilgileri satıcıya aittir. İstekler supplierId, API anahtarı ve API gizli anahtarıyla yapılır; bu bilgileri yalnızca hesabın ana kullanıcısı görebilir. Her supplierId'nin kendi anahtarı vardır ve canlı ile test ortamı için bilgiler farklıdır. Anahtarlar GitHub gibi açık platformlarda paylaşılmamalıdır.
- İstekler kimliğini bildirir. Her istekte User-Agent başlığı zorunludur; başlığı olmayan istek 403 hatasıyla engellenir. Entegratör kullanıyorsanız biçim "{satıcı no} - {entegratör firma adı}", kendi yazılımınızı kullanıyorsanız "{satıcı no} - Self Integration" olarak tarif edilir.
- İstek sayısı sınırlıdır. Aynı uç noktaya 10 saniye içinde en fazla 50 istek gönderilebilir; 51. istek 429 hatası döndürür.
- Toplu işlemler eş zamansız sonuçlanır. Ürün oluşturma, stok-fiyat güncelleme gibi işlemler bir toplu işlem numarası döndürür; sonucu bu numarayla ayrıca sorgularsınız. İşlem durumu IN_PROGRESS ya da COMPLETED, kalem durumu SUCCESS ya da FAILED olarak görünür. Yani "istek gönderildi" ile "stok güncellendi" aynı şey değildir.
- Sürümler kapanır. Trendyol geliştirici sayfası, Product V2 ve Order V2 servislerinin yayında olduğunu ve V1 servislerinin 15 Ekim 2026 itibarıyla devre dışı bırakılacağını duyuruyor. Hangi yolu seçerseniz seçin, entegrasyonunuzun V2 kullandığını doğrulayın.
Amazon'un Selling Partner API'sinde de mantık benzerdir ama kural farklıdır: istekler bir jeton kovası (token bucket) algoritmasıyla sınırlanır, sınır işleme ve satıcı-uygulama çiftine göre değişir ve aşıldığında 429 döner. Amazon, iyi yazılmış bir uygulamada bile ara sıra 429 görülebileceğini söyler; yeniden denemeler için geri çekilme (back-off) stratejisi, sık sorgulama yerine bildirimler ve Feeds ile Reports gibi toplu işlemler önerilir. Bu ayrıntılar yazılımın sıradan bir "stoku gönder" döngüsünden fazlası olması gerektiğini gösterir. Hepsiburada ve N11 için güncel sınırları ve zorunlu alanları, ilgili platformun satıcı geliştirici dokümanından kontrol edin.
Güçlü ve Zayıf Yanlar
Hazır Entegratör
Güçlü yanlar: hızlı başlangıç, bakım yükünün satıcıda olmaması, API sürümü değişince güncellemeyi sağlayıcının yapması ve birden çok kanalı tek ekrandan görme. Mağaza sayınız az, ürün yapınız standart ve ERP'niz yoksa ya da basitse çoğu zaman en mantıklı başlangıçtır.
Zayıf yanlar: kurallar sağlayıcının sunduğu seçeneklerle sınırlıdır. Kanal başına farklı fiyat kuralı, tampon stok, ERP'deki depoya göre stok ayrımı ya da özel bir fatura sırası gerekiyorsa panelde karşılığını bulamayabilirsiniz. Ayrıca hesabınızın yönetimi (bağlı anahtarlar, veri geçmişi) bir üçüncü tarafa bağlanır; sağlayıcı değiştirmek istediğinizde ürün eşleştirmelerini yeniden kurmanız gerekebilir.
Özel Entegrasyon
Güçlü yanlar: iş kurallarının tamamı sizin elinizdedir; stok doğrudan ERP'nizden olay tabanlı akabilir, fiyat kanal bazında hesaplanabilir, fatura ve kargo adımları sipariş zincirine tam oturur. Bu akışın nedenlerini çok kanallı stok ve fiyat senkronizasyonu ve ERP entegrasyonu yazılarımızda anlattık.
Zayıf yanlar: başlangıç maliyeti yüksektir ve iş bitmez. Pazaryeri sürüm kapatır, alan ekler, sınır değiştirir; yukarıdaki V1 kapanışı gibi her değişikliği izleyip uyarlayacak biri olmalıdır. Hata yönetimi (429, başarısız toplu işlem kalemleri, yinelenen sipariş), izleme ve mutabakat da yazılımın parçasıdır. Yöntem seçimine ilişkin ayrıntılar için API entegrasyonu yazımıza bakabilirsiniz.
Karar İçin Beş Soru
- Kaç kanal ve kaç ürün yönetiyorsunuz? Az kanal ve az ürün entegratöre, çok kanal ve çok varyantlı katalog özel akışa yaklaşır.
- Stokun kaynağı nerede? Stok ERP ya da depo yazılımında doğuyorsa ve gecikme satış kaybettiriyorsa, olay tabanlı akış gerekir.
- Kanallara özel kuralınız var mı? Kanal başına fiyat, kampanya fiyatı, tampon stok gibi kurallar paneldeki seçeneklere sığıyor mu?
- Hatayı kim yakalıyor? Başarısız bir toplu işlem kalemi ya da yinelenen sipariş fark edildiğinde sorumlu kim ve ne kadar sürede müdahale ediyor?
- Çıkış stratejiniz ne? Sağlayıcıdan ayrılırsanız ürün eşleştirmeleri, sipariş geçmişi ve ayarlar size nasıl dönüyor?
Maliyet Karşılaştırması: Varsayımsal Üç Yıl
Gerçek fiyatlar sağlayıcıya, ürün sayısına ve kapsama göre çok değişir; aşağıdaki rakamların hepsi varsayımdır. Yalnızca hesabın mantığını göstermek içindir.
Varsayımsal örnek
Entegratör aboneliği için aylık 6.000 TL varsayalım: 36 ay × 6.000 = 216.000 TL. Özel entegrasyon için ilk geliştirme 250.000 TL, her yıl için bakım ve izleme 60.000 TL olsun: 250.000 + (3 × 60.000) = 430.000 TL. Bu varsayımlarla üç yılın sonunda özel çözüm daha pahalıdır; ancak karşılaştırmanın dışında kalanlar fark yaratabilir. Entegratörün karşılayamadığı bir kural yüzünden ayda 40 stoksuz satış yaşıyorsanız ve her biri ortalama 300 TL'lik iptal, ceza ya da kayıp doğuruyorsa aylık kayıp 12.000 TL, üç yılda 432.000 TL eder. Yani karar, abonelik ile geliştirme bedelinin değil, iki yolun yarattığı toplam maliyetin karşılaştırmasıdır.
Hız sınırı da bir maliyettir. Bir uç nokta tek istekte tek ürün alıyorsa ve 50 istek / 10 saniye sınırı geçerliyse saniyede en fazla 5 istek gönderebilirsiniz. 12.000 ürünün tamamını bu uç noktadan güncellemek 12.000 ÷ 5 = 2.400 saniye, yani yaklaşık 40 dakika sürer (varsayımsal; uç noktanın toplu kalem kabul edip etmediği dokümandan kontrol edilmelidir). Fiyat değişikliğini ya da stoku bu süreye yaymak mümkündür, ama yoğun kampanya anında bu gecikme siparişe yetişemeyen stok demektir.
Aşamalı Yol Haritası
Kararı tek seferde vermek zorunda değilsiniz. Pratikte işe yarayan sıra şöyledir:
- Ay 1: Standart bir entegratörle en az bir pazaryerini açın ve ürün eşleştirmelerini düzenli tutun.
- Ay 2-3: Gecikmiş stok güncellemesi, yinelenen sipariş, başarısız toplu işlem gibi sorunları tek bir listede toplayın; her birinin tahmini maliyetini yazın.
- Ay 4: Listeyi gözden geçirin. Sorunların çoğu panel ayarıyla çözülüyorsa entegratörde kalın; birkaç tekrarlayan ve pahalı sorun paneli aşıyorsa yalnızca o akışı özel yazılıma taşıyın.
- Sonrası: Taşıdığınız akış için izleme ve haftalık mutabakat kurun; sürüm kapanışlarını takip edecek bir sorumlu atayın.
Bu yaklaşım, henüz ihtiyacınızı bilmediğiniz bir yazılıma baştan yatırım yapmanızı engeller ve elinizdeki verinin gerçek ihtiyacı göstermesini sağlar.
Sözleşme ve Kurulum Kontrol Listesi
- API anahtarlarının sahibi siz olun; sağlayıcıya yalnızca gerekli yetkiyi verin ve ayrılırken anahtarları yenileyebileceğinizi netleştirin.
- Entegrasyonun Trendyol'da V2 servislerini kullandığını ve sürüm değişikliklerinde sağlayıcının hangi sürede güncelleme yaptığını yazılı alın.
- Stok ve fiyat güncellemesinin kaç dakikada pazaryerine yansıdığını (en kötü durumda) ve başarısız toplu işlemlerin nasıl raporlandığını sorun.
- 429 hatasında yeniden deneme ve geri çekilme davranışını öğrenin.
- Ürün eşleştirme tablosunu (SKU ile pazaryeri ürün kodu) dışa aktarabildiğinizi doğrulayın.
- Pazaryeri panelindeki sipariş sayısı ile entegrasyon sistemindeki sipariş sayısını haftalık karşılaştıran bir mutabakat adımı belirleyin.
- Hata ve gecikme için sorumlu kişi ile müdahale süresini belirleyin.
- Özel yazılımda bakım, izleme ve sürüm takibi kapsamını teklifte ayrı kalem olarak isteyin.
Sonuç
Doğru yol çoğu zaman ya-ya-da değil, aşamalıdır. Başlangıçta standart bir entegratörle kanalları açın, kuralları ve hataları kayda geçirin; entegratörün karşılayamadığı akışlar sayılabilir hale geldiğinde yalnızca onları özel yazılıma taşıyın. Hangi yolu seçerseniz seçin API anahtarlarının, ürün eşleştirmelerinin ve mutabakat raporunun sizde olması, kararı ileride tersine çevirebilmenizin güvencesidir.
Kaynaklar: Trendyol Developers: Getting Started, Authorization (kimlik bilgileri, User-Agent, istek sınırı), Check Batch Request Result; Amazon Selling Partner API: Usage plans and rate limits (2026). Hesap örneği varsayımsaldır.