Entegrasyon öncesi hazırlık ve hesap doğrulama
Trendyol API entegrasyonuna başlamadan önce satıcı panelinde API erişiminin aktif olduğunu ve supplier ID'nizin doğru tanımlandığını doğrulayın. Birçok entegrasyon hatası, panelde henüz onaylanmamış mağaza statüsünden veya eksik vergi levhası kaydından kaynaklanır.
Operasyon ekibinizle IT tarafının ortak bir sözlük oluşturması kritiktir: barkod, merchantSku, contentId ve barcode alanlarının hangi ERP kolonlarına karşılık geldiğini yazılı hale getirin. Bu eşleştirme tablosu, ileride yaşanacak katalog uyuşmazlıklarının %60'ını önler.
- Satıcı paneli → Entegrasyon → API bilgileri ekranını kontrol edin
- Supplier ID ve API key/secret çiftini güvenli kasada saklayın
- Test ve production endpoint URL'lerini ayrı ortam değişkenlerine yazın
Kimlik bilgileri ve ilk bağlantı testi
Trendyol API kimlik doğrulaması Basic Auth veya bearer token modeline göre yapılandırılır; entegrasyon katmanınızda credential'ları asla loglamayın. İlk test çağrısı olarak düşük riskli bir GET endpoint'i — örneğin marka listesi veya sipariş sayısı sorgusu — kullanın.
Bağlantı başarılı olsa bile yanıt süresini ve rate limit header'larını kaydedin. Yoğun saatlerde 429 hatası alıyorsanız, exponential backoff ile yeniden deneme stratejisini entegrasyon koduna gömün; aksi halde batch kuyruğunuz tıkanır.
Sandbox ortamında pilot SKU grubu
Canlıya geçmeden önce 10–20 düşük hacimli SKU ile stok ve fiyat push'unu test edin. Pilot grubu tek renk/beden varyantından oluşan ürünler olmalı; böylece varyant eşleşme hatalarını izole edebilirsiniz.
Her push işleminden sonra batchRequestId değerini saklayın ve sonuç endpoint'inden durumu sorgulayın. «Gönderildi» ile «yansıdı» arasındaki farkı ölçmek için paneldeki stok değerini API yanıtıyla karşılaştıran otomatik bir doğrulama scripti yazın.
- Stok push → batch sonucu → panel doğrulama üçlüsünü pilot checklist'e ekleyin
- Hatalı SKU'ları ayrı bir exception raporuna düşürün
- Pilot süresini en az 3 iş günü tutun; hafta sonu sipariş dalgalanmalarını gözlemleyin
Canlı geçiş kontrol listesi
Canlı geçişte tüm kataloğu bir seferde açmak yerine kademeli rollout uygulayın: önce stok senkronu, ardından fiyat, en son sipariş çekme. Her aşamada geri alma (rollback) planınız hazır olsun — örneğin son bilinen iyi stok snapshot'ına dönüş.
Geçiş günü operasyon ekibi, depo ve müşteri hizmetleriyle ortak bir war room saatleri belirlesin. İlk 48 saatte saatlik sync sağlığı raporu alın; sapma eşiği %2'yi geçen SKU'lar için manuel inceleme kuyruğu açın.
Sürekli izleme ve runbook
Entegrasyon canlıya alındıktan sonra bitmez. Günlük rutine şunları ekleyin: başarısız batch sayısı, ortalama yanıt süresi, credential süre dolumu uyarısı ve sipariş çekme gecikmesi. Her hata kodu için runbook maddesi yazın: 401 → credential yenile, 429 → backoff artır, 5xx → Trendyol status sayfasını kontrol et.
Aylık olarak API versiyon değişiklik duyurularını takip edin. Deprecated endpoint'lere bağımlılık, kampanya dönemlerinde ani kesintiye yol açar; migration takvimini Q planına dahil edin.
Sık sorulan sorular
Trendyol API için hangi teknik yetkinlikler gerekir?
REST API tüketimi, JSON işleme, güvenli credential yönetimi ve temel queue/batch mantığı yeterlidir. Operasyon ekibi tarafında ise barkod-SKU eşleştirme disiplini en az kodlama kadar önemlidir.
Test ortamı olmadan entegrasyon yapılabilir mi?
Teknik olarak mümkün olsa da önerilmez. Düşük hacimli pilot SKU ile canlı test, kontrolsüz stok sapması ve oversell riski taşır. En az bir haftalık kademeli pilot şarttır.
Entegrasyon sonrası manuel panel kullanımı devam etmeli mi?
Acil müdahale için panel erişimi kalmalı, ancak rutin stok ve fiyat güncellemeleri API üzerinden yapılmalıdır. Çift kaynak (panel + API) en yaygın tutarsızlık nedenidir.
Supplier ID değişirse ne yapılmalı?
Tüm ortam değişkenlerini, webhook URL'lerini ve batch job konfigürasyonlarını güncelleyin. Eski ID ile gönderilen istekler sessizce reddedilebilir; geçiş sonrası 24 saat ekstra izleme yapın.
Pillar rehber
Trendyol satıcıları için entegrasyon yalnızca «ürün çekmek» değildir. Güvenli credential yönetimi, batch push sonuçları, katalog eşleştirme ve sync izleme birlikte çalışmalıdır.
Trendyol entegrasyonu: API'den operasyona
