Qando

Trendyol Entegrasyonu — Adım Adım Kurulum

Trendyol satıcı panelinden API anahtarı alıp Qando'ya bağlama, kargo şablonu seçimi ve ilk sync.

Hangi bilgilere ihtiyacınız var?

Trendyol bağlantısı için iki anahtar gerekir:

  • API Key (apiKey)
  • API Secret (apiSecret)

Ayrıca Satıcı ID (sellerId) — kayıtlı supplier ID'niz. Bu bilgi Trendyol satıcı paneli üst banner'ında veya Hesap > Hesap Bilgilerim sayfasında görünür.

Trendyol Satıcı Paneli'nde API Key oluşturma

  1. partner.trendyol.com adresinden satıcı panelinize girin.
  2. Sağ üstte profil ikonu > Hesap Bilgilerim.
  3. Sol menüden Entegrasyon Bilgileri > Trendyol API Bilgileri.
  4. Yeni API Key Oluştur butonuna basın.
  5. Açılan ekranda API Key ve API Secret kopyalayın. Secret bir daha gösterilmez, güvenli yere kaydedin.

Qando'da yeni bağlantı oluşturma

  1. Qando panelinde sol menüden Entegrasyonlar açın.
  2. Üst sağda Yeni Bağlantı butonuna basın.
  3. Trendyol kartını seçin.
  4. Formu doldurun:
    • Bağlantı Adı — istediğiniz isim (örn. "Ana Mağaza")
    • Satıcı ID — Trendyol'daki sellerId
    • API Key — kopyaladığınız anahtar
    • API Secret — kopyaladığınız secret
  5. Kaydet butonuna basın.

Bağlantı TEST statüsünde oluşturulur. İlk Test Et çağrısı yapılmadan sync aktive olmaz.

Bağlantıyı test etme

  1. Bağlantı kartında Test Et butonuna basın.
  2. Sistem Trendyol API'sine ping atar; ~5 saniye içinde sonuç gelir.
  3. Başarılı ise statü ACTIVE olur ve yeşil onay görürsünüz.
  4. Hatalıysa lastErrorMsg kartta görünür — yaygın hatalar:
    • 401 Unauthorized → API Key/Secret yanlış
    • Connection refused → IP whitelist; Trendyol panelinden IP kontrolü
    • Invalid sellerId → Satıcı ID yanlış girilmiş

Kargo şablonu seçimi (zorunlu)

Trendyol'da kargo göndermek için kargo sağlayıcı şablonu (shipmentProvider) bağlantınıza atanmış olmalı. Aksi halde sipariş kargolarken hata alırsınız.

  1. Bağlantı detay sayfasında Kargo Şablonları bölümüne git.
  2. Şablonları Çek butonuna bas → Trendyol'dan anlaşmalı kargo şirketleri çekilir.
  3. Tercih ettiğiniz şablonu seç (örn. MNG Kargo, Aras Kargo, Yurtiçi Kargo).
  4. Varsayılan Yap butonuna bas.

Bu şablon artık kargoya verme akışında otomatik kullanılır.

İlk ürün ve sipariş sync

Bağlantı ACTIVE olunca:

  • Ürün Sync: Her 21:00'da otomatik. Manuel başlatmak için Senkronize Et > Ürünler.
  • Sipariş Sync: Her 5 dakikada otomatik. Manuel için Senkronize Et > Siparişler + tarih aralığı.
  • İade Sync: Her 10 dakikada otomatik.

Pazaryerine ürün gönderme

Qando'da oluşturduğunuz ürünleri Trendyol'a göndermek için bkz: Ürünü Pazaryerine Push Etme. Trendyol push akışı batchRequestId döner ve push history panelinden takip edilebilir.

Yaygın sorunlar

  • Test başarısız ama panele giriş yapabiliyorum → API entegrasyonu hesabınızda etkin değil olabilir. Trendyol'a yazıp aktive ettirin.
  • Sipariş gelmiyor → Bağlantı son sync zamanını kontrol et. 5 dakikadan eskiyse Bağlantı Sorunları.
  • Ürün sync ürünleri eksik çekti → Trendyol'da approved=true olmayan ürünler filtrelenir. Onay bekleyen ürünleriniz API'ye gelmez.

Sonraki adım