Trendyol API Entegrasyon Rehberi: Sıfırdan Canlıya

Trendyol, Türkiye’nin en büyük pazaryerlerinden biri ve binlerce satıcının operasyonunu doğrudan etkiliyor. Pazaryerinde elle çalışmak — siparişi göz dolduran panelden alıp Excel’e aktarıp stoğu manuel düşürmek — bir noktadan sonra ölçeklenmiyor. Trendyol API entegrasyonu tam olarak bu sınırı kaldırmak için var.

Bu rehberde Trendyol API’sinin neyi neyle bağladığını, hangi adımlarda hangi servislerin kullanıldığını ve siparişten faturalamaya kadar olan akışı Zoho CRM ve Zoho Inventory ile nasıl bağlayacağınızı anlatıyoruz. Kaynaklar: developers.trendyol.com.

Trendyol API Nedir, Hangi Operasyonları Kapsar?

Trendyol API, Trendyol Partner Program’a kayıtlı satıcıların kendi e-ticaret sistemleri ile pazaryerini bağlamasını sağlayan bir REST API’dir. Resmi dokümantasyon iki sürümle gelir: v2.0 ve v3.0 — v1 ürün servisleri 10 Ağustos 2026’dan sonra geçersiz olacaktır (kaynak: developers.trendyol.com/v3.0/docs/3-product-update).

API’nin kapsadığı ana operasyonlar:

• Ürün yönetimi — ürün gönderme, güncelleme, fiyat ve stok güncellemeleri.
• Sipariş yönetimi — gelen siparişleri çekme, paketleme bilgisi gönderme, kargo bilgisi güncelleme.
• İade yönetimi — iade taleplerini takip etme, onay/red akışları.
• Soru-yanıt yönetimi — müşteri soruları otomatik çekilebilir, yanıt API üzerinden gönderilebilir.
• Webhook desteği — sipariş, stok, fiyat, iade gibi olaylarda anlık bildirim alınabilir (kaynak: developers.trendyol.com/v2.0/docs/webhook-create).
• Fatura entegrasyonu — Trendyol'a fatura PDF'inin yüklenmesi.
• BuyBox kontrolü — bir ürünün birden fazla satıcısı varsa BuyBox sahibinin sorgulanması.

Hız limiti olarak servis bazında 1000 istek/dakika gibi sınırlar tanımlıdır — entegrasyon mimarinizi bu limitlere göre tasarlamanız gerekir.

Pazaryeri Entegrasyon Mimarisi: Tek Yönlü vs Çift Yönlü

Pazaryeri entegrasyonu kurarken iki temel mimari seçim vardır:

• Tek yönlü push — sadece kendi sisteminizden Trendyol'a doğru veri gönderirsiniz (örn. ürün, fiyat, stok).
• Tek yönlü pull — sadece Trendyol'dan veri çekersiniz (örn. siparişler).
• Çift yönlü senkron — her iki yönde veri akar. CRM'de yapılan stok güncellemesi Trendyol'a yansır, Trendyol'dan gelen sipariş CRM'e düşer.

Profesyonel e-ticaret operasyonlarında çift yönlü senkron tercih edilir. Sebebi basit: tek yönlü mimaride iki sistem bir noktada birbirinden ayrışır, müşteri sayısı arttıkça veri tutarsızlığı katlanarak büyür.

Çift yönlü senkron için iki yaklaşım var:

1. Polling — belirli aralıklarla (örn. her 5 dakikada) Trendyol API'den veri çekme. Basit ama gecikme yaratır.
2. Webhook — Trendyol bir olay gerçekleştiğinde sizin sisteminize anlık bildirim gönderir. Düşük gecikme, ölçeklenebilir.

Modern bir entegrasyon mimarisinde webhook’lar olabildiğince geniş kullanılır, polling yalnızca yedek mekanizma olarak tutulur.

E Ticaret Entegrasyon Adımları (Kimlik Doğrulama, Veri Eşleştirme, Webhook)

Sıfırdan bir Trendyol API entegrasyonu kurarken adımlar:

1. Kimlik bilgilerini al — Trendyol Satıcı Paneli'nde "Hesap Bilgileri > Entegrasyon Bilgileri" sayfasından SellerId, API Key ve API Secret alınır.
2. Basic Authentication kurulumu — API çağrılarında SellerId:ApiSecret kombinasyonu Basic Auth header olarak gönderilir.
3. Test ortamı — Trendyol'un sandbox ortamında ürün gönderimi, sipariş simülasyonu yapılır.
4. Veri eşleştirme — kendi ürün katalog modelinizdeki alanları Trendyol'un beklediği yapıya (barcode, productMainId, brandId, categoryId, attributes) çevirin.
5. Ürün gönderimi (Product v2) — onaylı ürünlerde barcode, brandId, categoryId değiştirilemez. Partial update destekli.
6. Sipariş çekme — paketlenecek siparişler servis ile çekilir, paketlendiğinde kargo bilgisi geri gönderilir.
7. Webhook tanımlama — sipariş oluşturma, iade, soru, fiyat değişimi olayları için webhook URL'leri kaydedilir.
8. Hata yönetimi — 4xx ve 5xx hata yanıtlarında retry/exponential backoff mantığı kurulur.
9. İzleme ve loglama — her istek/yanıt loglanır, hız limiti yaklaşımları takip edilir.

Bu mimarinin uçtan uca kurulumu için pazaryeri entegrasyon hizmetimizden yararlanabilirsiniz — ürün eşleştirme, sipariş akışı ve Zoho entegrasyonunu birlikte yönetiyoruz.

Trendyol Verilerini Zoho CRM ve Zoho Inventory ile Bağlama

Trendyol API'sini doğrudan kullanmak yerine, Zoho ekosistemini orta katman olarak kullanmak güçlü bir mimari sunar:

• Zoho Inventory — Trendyol siparişleri sales order olarak otomatik düşer, paketleme ve stok düşürme akışı yönetilir.
• Zoho CRM — sipariş veren müşteri Contact ve Account modüllerinde otomatik oluşur, müşteri yaşam döngüsü takip edilir.
• Zoho Books — sipariş kapanınca fatura otomatik kesilir, gelir tablosu güncel kalır.
• Zoho Flow — Trendyol API'sini Zoho'ya bağlayan workflow'ları kodsuz tasarlamanın merkezi.
• Zoho Analytics — Trendyol satışları, kanal kıyaslaması, kar marjı analizleri tek panelden raporlanır.

Bu mimarinin avantajı: Trendyol'un yanında Hepsiburada, N11, Amazon gibi başka pazaryerleri eklediğinizde her yeni pazar için sıfırdan entegrasyon kurmazsınız — Zoho ekosistemine eklemek yeterlidir.

Sık Karşılaşılan API Hataları ve Çözümleri

Trendyol API entegrasyonunda en sık karşılaşılan sorunlar:

1. Hız limiti aşımı (429 Too Many Requests) — istek sayısını queue'ya bağlayın, exponential backoff uygulayın.
2. Onaylı ürün güncelleme reddi — onaylı ürünlerde barcode, brandId, categoryId değiştirilemez. Yeni varyant eklenecekse yeni ürün gönderilmeli.
3. Webhook gelmiyor — webhook URL'iniz HTTPS olmalı, 200 OK döndürmeli, 5 saniye içinde yanıt vermeli.
4. Sipariş bulunamıyor — paketleme statüsündeki siparişler çekilirken status filtresi doğru kullanılmalı.
5. Stok senkronizasyon gecikmesi — polling sıklığı düşükse iki sistem arası fark oluşur. Webhook tercih edin.
6. Yetkisiz hata (401 Unauthorized) — API Secret'ın sıfırlanmış olabileceğini, paneldeki yeni Secret'ı kullanmayı kontrol edin.

Bu hataları proaktif yönetmek için her entegrasyon projesinde retry mekanizması, dead letter queue ve detaylı loglama tasarlanmalıdır. CRM ile bağlantı kurarken kullanılabilecek Zoho CRM entegrasyon hizmetimizi inceleyebilirsiniz.

Sonuç: Pazaryeri Operasyonlarını Tek Panelden Yönetin

Trendyol API entegrasyonu işletmeye sağladıkları:

• Manuel sipariş işleme zamanını dramatik şekilde azaltır.
• Stok tutarsızlığı (overselling) riskini ortadan kaldırır.
• Müşteri verisini Excel parçalarından çıkarıp CRM'e taşır.
• Çoklu pazaryeri yönetimini tek mimari altında birleştirir.

Trendyol API ile Zoho CRM ve Zoho Inventory entegrasyonunu birlikte kurmak istiyorsanız, e-ticaret entegrasyon hizmetimiz ile bağlantıya geçebilirsiniz.