Trendyol API Entegrasyonu: Nasıl Yapılır + Gerçek Sorunlar ve Çözümleri (2026)
Trendyol API entegrasyonu ile sipariş, stok ve ürün yönetimini otomatize edin. E-ticaret sitenizi Trendyol'a bağlamak için teknik rehber.
moyduz’u Google’da tercih ettiğin kaynaklara ekle
Özet
Bu rehber, Trendyol API anahtarının alınmasından temel authentication’a, ürün, stok ve sipariş yönetimi endpoint’lerine kadar adım adım entegrasyon sürecini anlatır. Teknik detaylar ve örnek isteklerle, sisteminizi otomatikleştirerek operasyonel verimliliği artırmayı hedefler.
Kısa Cevap
Trendyol entegrasyonu, API anahtarı ve gizli anahtar alıp, temel URL’ye Basic Auth ile bağlanarak, ürün, stok ve sipariş endpoint’lerini kullanarak sisteminizi Trendyol Satıcı Merkezi’ne bağlamaktır. Böylece veri akışı otomatikleşir, manuel işlem ihtiyacı ortadan kalkar. Bu süreçte, sipariş çekme (polling) veya webhook, stok güncelleme ve kargo bildirimi gibi fonksiyonları API dökümantasyonuna uygun JSON istekleriyle gerçekleştirirsiniz.
Sorun
Birçok küçük ve orta ölçekli e‑ticaret işletmesi, Trendyol’da manuel ürün ve sipariş girişinin zaman alıcı olduğunu ve hata oranının yüksek olduğunu bildiriyor. Stok seviyeleri iki platform arasında tutarsızlaşıyor, bu da müşteriye yanlış bilgi verilmesine yol açıyor. Ayrıca, kargo bildirimlerini elle yapmak, gecikmelere ve iade maliyetlerine neden oluyor.
Çözüm
Sayfa, API anahtarının nasıl alınacağını ve Basic Auth ile nasıl bağlanılacağını gösterir. Ürün, stok ve sipariş endpoint’lerine örnek JSON istekleri sunarak, veri akışını otomatikleştirmenizi sağlar. Webhook veya polling ile anlık sipariş çekimi, batch stok güncellemeleri ve kargo bildirimleri için adım adım talimatlar verir.
Nasıl Çalışır
- Trendyol Satıcı Merkezi'nden API Key, Secret ve Supplier ID alın.
- Base64 kodlamasıyla Basic Auth başlığını oluşturun ve API’ye bağlanın.
- Ürün ekleme/güncelleme endpoint’iyle katalogunuzu senkronize edin.
- Sipariş çekme (polling) veya webhook kurarak yeni siparişleri alın.
- Stok ve fiyat güncellemelerini batch olarak gönderin, kargo bilgilerini API üzerinden bildirin.
Trendyol Entegrasyonu Nedir?
Çoğu rehber sadece API anlatır. Ama gerçek problem entegrasyon sonrası başlar.
Trendyol entegrasyonu, e-ticaret siteniz veya stok yönetim sisteminizle Trendyol Satıcı Merkezi'ni birbirine bağlayan API bağlantısıdır. Entegrasyon sayesinde:
- Ürün bilgileri otomatik senkronize olur
- Siparişler anında alınır ve işlenir
- Stok seviyeleri iki yönlü güncellenir
- Fatura ve kargo süreci otomatize edilir
Trendyol Seller API Nasıl Çalışır?
Trendyol, satıcılara REST tabanlı bir API sunar. API temel olarak şu endpoint gruplarını içerir:
Ürün Yönetimi
- Ürün listesi alma, ürün ekleme/güncelleme
- Kategori ve özellik eşleştirme
- Fiyat ve stok güncelleme
Sipariş Yönetimi
- Yeni siparişleri çekme (polling veya webhook)
- Sipariş onaylama
- Kargo entegrasyonu ve takip numarası gönderme
İade Yönetimi
- İade taleplerini alma
- İade onaylama/reddetme
API Erişimi Nasıl Alınır?
- Trendyol Satıcı Merkezi'ne (seller.trendyol.com) giriş yapın
- Entegrasyonlar → API Yönetimi bölümüne gidin
- API anahtarı (API Key) ve gizli anahtar (API Secret) oluşturun
- Tedarikçi ID'nizi (Supplier ID) not alın — tüm API çağrılarında kullanılır
API dokümantasyonu: developers.trendyol.com
Entegrasyon Yöntemleri
1. Hazır Entegrasyon Platformları
En hızlı yol. Aylık abonelikle çalışır.
Önerilen platformlar:
- Entegra – çok kanallı, Trendyol + HB + N11 + GittiGidiyor
- Pazaryerim – küçük işletmeler için uygun fiyatlı
- MuhaFazacı – muhasebe entegrasyonlu
- Kolaytransfer – stok odaklı
Maliyet: 500–2.500 TL/ay
2. WooCommerce / Shopify Eklentisi
- WooCommerce: "Trendyol WooCommerce Entegrasyon" eklentileri (pazarama, pazar.guru)
- Shopify: Türkiye pazaryeri eklentileri (sınırlı, üçüncü taraf)
Maliyet: 200–800 TL/ay veya tek seferlik eklenti ücreti
3. Özel API Entegrasyonu
Kendi teknik altyapınız varsa veya iş süreçlerinize özgü mantık gerektiriyorsa özel entegrasyon en iyi seçenektir.
Örnek kullanım senaryoları:
- Çoklu depo, çoklu mağaza yönetimi
- ERP yazılımıyla (SAP, Logo) doğrudan bağlantı
- Özel fiyatlandırma algoritmaları (rakip takip, dinamik fiyat)
- Otomatik kargo etiket basımı
Trendyol Entegrasyonunun Teknik Adımları
Authentication
Base URL: https://api.trendyol.com/sapigw/
Authorization: Basic <Base64(API_KEY:API_SECRET)>
Sipariş Çekme (Polling)
GET /suppliers//orders?status=Created&page=0&size=50
Webhook desteği de mevcuttur — yeni sipariş gelince anlık bildirim alınır. Yüksek hacimli operasyonlarda webhook tercih edilmeli; polling aralığını 15 dakikanın üzerinde tutmak sipariş gecikmesine neden olabilir.
Stok Güncelleme
POST /suppliers//products/price-and-inventory
[
]
Stok güncellemesi batch olarak yapılabilir (maks. 50 ürün/istek, rate limit var).
Kargo Bildirimi
POST /suppliers//shipment-packages/
{
"lines": [],
"cargoProviderName": "Yurtiçi",
"trackingNumber": "1234567890"
}
Sık Yapılan Hatalar
Rate limiting: Trendyol API'si dakika başına istek sınırlaması uygular. Ani toplu istekler 429 hatası verir. Exponential backoff + kuyruk mekanizması şarttır.
Stok tamponu koymamak: Site stoğunu Trendyol'a bire bir yansıtmak negatif stok riskini artırır. Genellikle %10-20 tampon bırakılır.
Kategori eşleştirme hataları: Yanlış kategori → ürün listelenmez veya görünürlük düşer. Trendyol kategori ID'lerini önceden map'leyin.
Sipariş senkronizasyon gecikmesi: Polling aralığı çok uzun tutulursa gecikmeli işlem olur. Webhook kullanımı tercih edilmeli.
🚨 Gerçek Senaryo: Entegrasyon Yaptık Ama Siparişler Senkron Olmadı
Bir müşterimiz Trendyol entegrasyonunu kurduktan sonra ilk 48 saat içinde 120 sipariş aldı. Ancak sistemde sadece 83 sipariş görünüyordu.
Sorun neydi?
- Polling interval 15 dakika olarak ayarlanmıştı
- Yoğun sipariş anında API rate limit'e takıldı
- 429 hataları loglanmadığı için fark edilmedi
Sonuç:
- 37 sipariş manuel yakalandı
- 12 sipariş geç kargolandı
- 4 tanesi iptal oldu
Çözüm:
- Webhook'a geçildi
- Retry + queue sistemi eklendi
- Logging zorunlu hale getirildi
Sonraki 7 gün: %100 sipariş senkronizasyonu sağlandı.
Bu senaryo, Trendyol entegrasyonlarında en sık gördüğümüz hatanın gerçek hayattaki yansımasıdır. Teknik kurulum doğru olsa bile, izleme ve hata yönetimi olmadan sistem güvenilmez çalışır.
Teknik olarak entegrasyon kurmak kolaydır. Zor olan, sistemin gerçek trafik altında doğru çalışmasıdır — izleme, hata yönetimi ve webhook altyapısı olmadan kurulum yarım kalır.
Trendyol entegrasyonunu profesyonel şekilde kurmak mı istiyorsunuz? Moyduz olarak özel API entegrasyonları ve çoklu pazaryeri yönetim sistemleri geliştiriyoruz. Ücretsiz keşif görüşmesi için iletişime geçin.
Yapay zekâ ile özetleyin