TotalApp Dökümanlar

Trendyol Entegrasyonu

Trendyol satıcı hesabınızı bağlayın, canlı katalog ve siparişlerinizi görüntüleyin ve stok, fiyat ve kargo hakkında Yapay Zeka Asistanı'na soru sorun.

Genel Bakış

Trendyol Entegrasyonu ekranı (E-ticaret → Pazaryeri Yönetimi → Trendyol), TotalApp ile Trendyol satıcı hesabınız arasındaki bağlantı merkezidir. API bilgilerinizi yönetir, canlı ürün kataloğunuzu ve sevkiyat paketlerinizi yükler, kullanılan Trendyol REST uç noktalarını listeler ve pazaryeri verilerinize doğrudan erişimi olan gömülü bir Yapay Zeka Asistanı sunar.

Yalnızca Sunucu Taraflı API Çağrıları

Trendyol API ağ geçidine (https://apigw.trendyol.com) yapılan tüm istekler, tarayıcınızdan değil, TotalApp sunucusundan HTTP Basic kimlik doğrulaması ile yapılır. Bu, API Key ve Secret bilgilerinizi güvende tutar ve CORS kısıtlamalarını önler.

Bağlantıyı Kurma

Adım 1 — Trendyol Entegrasyon Bilgilerinizi Alın

TotalApp, Trendyol Satıcı ID ve API bilgilerinizi kullanarak bağlanır. Bulmak için:

  1. Trendyol Partner (partner.trendyol.com) hesabınıza giriş yapın.
  2. Hesap → Entegrasyon Bilgileri bölümüne gidin.
  3. Satıcı ID (Tedarikçi ID olarak da bilinir) değerinizi kopyalayın.
  4. API Key ve API Secret değerlerinizi kopyalayın.

Adım 2 — Bilgileri TotalApp'e Girin

Ayarlar → Entegrasyonlar → E-Ticaret → Trendyol bölümünü açın ve şunları girin:

AlanNerede bulunurÖrnek
Satıcı ID (Tedarikçi ID)Trendyol Partner → Hesap → Satıcı Bilgileri123456
API KeyTrendyol Partner → Hesap → Entegrasyon Bilgilerixxxxxxxxxxxxxxxx
API SecretTrendyol Partner → Hesap → Entegrasyon Bilgilerixxxxxxxxxxxxxxxx

Trendyol Entegrasyonu ekranında Satıcı Bağlantısı panelini açın ve Bağlantıyı Test Et düğmesine tıklayın. Bilgiler geçerliyse TotalApp bir sayfa ürün çeker ve sayıyı görüntüler.

Adım 3 — Canlı Veri Yükleyin

Trendyol'dan en güncel anlık görüntüyü çekmek için Ürünleri Yükle ve Siparişleri Yükle düğmelerini kullanın:

  • Ürün Kataloğu — barkod, başlık, marka, stok adedi, satış fiyatı ve onay durumu.
  • Sevkiyat Paketleri — sipariş numarası, müşteri, ürün adedi, tutar ve paket durumu.

İstek Üzerine Senkronizasyon

Veriler arka planda otomatik olarak senkronize edilmez, istek üzerine yüklenir. Tabloların ve Yapay Zeka Asistanı'nın en güncel Trendyol durumunu yansıtmasını istediğinizde yükleme düğmelerine tıklayın.

API Uç Noktaları

Ekran, TotalApp'in kullandığı Trendyol Ürün ve Sipariş Entegrasyonu uç noktalarını listeleyen bir API Uç Noktaları referans paneli sunar. {sellerId}, {packageId} ve {batchId} gibi yol parametreleri çağrı sırasında doldurulur.

Ürün Entegrasyonu

MetotYolAmaç
GET/integration/product/sellers/{sellerId}/productsÜrünleri filtrele
POST/integration/product/sellers/{sellerId}/productsÜrün oluştur
PUT/integration/product/sellers/{sellerId}/productsÜrün güncelle
POST/integration/inventory/sellers/{sellerId}/products/price-and-inventoryFiyat & stok güncelle
GET/integration/product/sellers/{sellerId}/products/batch-requests/{batchId}Toplu istek durumunu sorgula
GET/integration/product/brandsMarka listesini getir
GET/integration/product/product-categoriesKategori ağacı & özniteliklerini getir

Sipariş Entegrasyonu

MetotYolAmaç
GET/integration/order/sellers/{sellerId}/ordersSevkiyat paketlerini / siparişleri getir
PUT/integration/order/sellers/{sellerId}/shipment-packages/{packageId}/tracking-detailsKargo takip numarasını güncelle
PUT/integration/order/sellers/{sellerId}/shipment-packages/{packageId}Paket durumunu güncelle

Ürün API v1 Kullanımdan Kaldırma

Trendyol geliştirici dokümantasyonuna göre Ürün V1 servisleri 2026 yılında kaldırılmaktadır. Geçiş yaparken yukarıdaki uç nokta yollarını güncel Trendyol Ürün V2 dokümantasyonuyla karşılaştırın.

Yapay Zeka Asistanı

Ekranın sağ tarafındaki Yapay Zeka Asistanı paneli, Trendyol verilerinize sohbet tabanlı bir arayüz sunar. Bilgiler yapılandırıldığında TotalApp, canlı katalog ve siparişlerinizi sunucu tarafında çeker ve bağlam olarak sağlar; böylece asistan analitik sorularınızı anında yanıtlar.

Neler Sorabilirsiniz

  • Stok soruları: “Hangi ürünlerin stoğu azaldı?”
  • Sipariş soruları: “Bu haftanın siparişlerini duruma göre özetle.”
  • Katalog soruları: “Onay bekleyen ürünleri listele.”
  • Fiyat soruları: “En yüksek satış fiyatına sahip ürünler hangileri?”

Writer Engine Desteği

Asistan, Ayarlar → Agentic → Writer Engine seçiminize uyar. Local CLI veya Hosted API modunda canlı Trendyol verisi sunucu tarafında çekilerek bağlama eklenir. Ollama, Local LLM veya Web LLM modunda istek tamamen istemci tarafında çalışır ve canlı pazaryeri verisi kullanılamaz — veriye dayalı raporlar için Local CLI veya Hosted API'ye geçin.

Rapor Olarak Kaydetme

Yapay zeka yanıt verdikten sonra yanıtın altında bir Rapor Olarak Kaydet düğmesi belirir. Tıkladığınızda yanıt, sorunuz ve içinde bulunulan ay ile otomatik olarak adlandırılıp E-ticaret Raporları altına kaydedilir.

Sık Sorulan Sorular

Trendyol bilgilerim nerede saklanır?
Satıcı ID, API Key ve API Secret bilgileriniz Ayarlar → Entegrasyonlar üzerinden saklanır. Trendyol'a yapılan tüm çağrılar TotalApp sunucusundan HTTP Basic kimlik doğrulaması ile yapılır — bilgiler asla tarayıcıya açık edilmez.
Bağlantı testi HTTP 401 ile başarısız oluyor. Ne kontrol etmeliyim?
401 hatası, API Key/Secret çiftinin yanlış olduğunu ya da Satıcı ID'nin bilgilerle eşleşmediğini gösterir. Üç değeri de Trendyol Partner → Hesap → Entegrasyon Bilgileri bölümünden yeniden kopyalayıp tekrar test edin.
TotalApp Trendyol verilerimi değiştirir mi?
Entegrasyon ekranı okuma odaklıdır: katalog ve siparişlerinizi yükler ve bunlarla ilgili soruları yanıtlar. Yazma işlemleri (fiyat/stok güncelleme, paket durumu değiştirme) şeffaflık için uç nokta referansında listelenir ve yalnızca siz açıkça tetiklediğinizde kullanılır.

Sonraki Adımlar