Trendyol · Başlarken
Trendyol'a bağlanma
API anahtarlarını alıp mağazanızı bağlama, otomatik senkron sıklıkları ve sık hatalar.
Trendyol mağazanız API anahtarlarıyla bağlanır. Bağlandıktan sonra ürünleriniz, siparişleriniz, iadeleriniz ve cari hesap kayıtlarınız düzenli aralıklarla Fiyron'a okunur.
Yalnızca okuma: Fiyron Trendyol'da hiçbir şeyi değiştirmez. Fiyat, stok, sipariş durumu ya da iade üzerinde yazma işlemi yapılmaz.
Bilgileri Trendyol'dan alma
Trendyol satıcı panelinde Hesap Bilgilerim → Entegrasyon Bilgileri sayfasını açın (partner.trendyol.com/account/info?tab=integrationInformation). Oradan üç bilgi gerekir:
| Fiyron'daki alan | Trendyol'daki karşılığı |
|---|---|
| Satıcı ID (Cari ID) | Satıcı (Cari) numaranız; yalnızca rakamlardan oluşur |
| API Key | Entegrasyon bilgilerindeki API anahtarı |
| API Secret | Entegrasyon bilgilerindeki API şifresi (secret) |
Fiyron'da bağlama
- Panelde Pazaryeri Bağlantıları'nı açın ve Trendyol'u seçin.
- Üç alanı doldurun.
- Bağla ve doğrula'ya basın.
Fiyron, anahtarları doğrulamak için Trendyol'dan tek bir sipariş paketi sorgular. Başarılıysa "Trendyol bağlantısı doğrulandı" mesajını görürsünüz ve bağlantı Bağlı durumuna geçer. Bir mağaza açılır ve menüde Trendyol sayfaları görünür.
Anahtarlar şifrelenerek saklanır. Kayıtlı bağlantıda API Key'in yalnızca maskelenmiş hali görünür; secret alanı boş gelir. Anahtarları değiştirmeyecekseniz boş bırakıp Yeniden doğrula'ya basabilirsiniz.
Otomatik sipariş senkronu
Bağlantı sayfasındaki Otomatik sipariş senkronu anahtarı açıkken yeni ve güncellenen siparişler düzenli aralıklarla çekilir. Kapatırsanız otomatik çekim durur; siparişleri Senkronla düğmesiyle elle çekebilirsiniz.
Ne zaman ne çekilir?
| Veri | Otomatik sıklık | Elle çekme |
|---|---|---|
| Siparişler | Yaklaşık 15 dakikada bir | Siparişler sayfası ya da bağlantı sayfası "Senkronla" |
| Ürünler | 6 saatte bir | Bağlantı sayfası ürün senkronu, İçe Aktarma "API ile çek" |
| İadeler | En fazla saatte bir | İade Analizi "İadeleri güncelle" |
| Cari hesap (reklam, kesintiler) ve kargo faturası kalemleri | En fazla 6 saatte bir | Reklam Analizi "Kayıtları güncelle" |
| Buybox durumu | Otomatik yok | Buybox sayfası "Verileri güncelle" |
İlk bağlanışta geriye dönük veri alınır: siparişler son 90 gün, iade ve cari hesap kayıtları yaklaşık 18 ay. Büyük kataloglarda ilk çekim birkaç tur sürebilir; kalan kısım sonraki turda devam eder.
Not: Otomatik çekimler zamanlanmış görevlerle çalışır ve birkaç dakika gecikebilir. Anında veri gerekiyorsa ilgili sayfadaki güncelleme düğmesini kullanın.
Bağlantıyı yönetme
Bağlantı sayfasında (Bağlantıyı yönet) şunları görürsünüz: bağlantı durumu, son sipariş ve ürün senkronu zamanı ve özeti, anahtarları güncelleme ve bağlantıyı kaldırma. Bağlantıyı kaldırmak Trendyol hesabınızı etkilemez.
Sık karşılaşılan hatalar
| Mesaj / durum | Anlamı ve çözümü |
|---|---|
| Yetkilendirme hatası (401) | Satıcı ID, API Key ya da API Secret yanlış. Trendyol panelinden tekrar kopyalayın; başında ya da sonunda boşluk kalmadığından emin olun. |
| Erişim reddedildi (403) | Anahtarın bu servise yetkisi yok ya da yanlış satıcı kimliği kullanılıyor. Entegrasyon bilgilerini ve satıcı ID'yi kontrol edin. |
| Çok fazla istek (429) | Trendyol istek limitine takıldık. Fiyron otomatik bekleyip dener; kısa süre sonra tekrar deneyin. |
| Trendyol yanıt veremiyor (500/502/503) | Geçici Trendyol sorunu. Fiyron kendiliğinden 2 kez yeniden dener; sürerse biraz sonra deneyin. |
| Zaman aşımı (504) | İstek çok büyük. Tarih aralığını daraltın (rapor sayfalarında) ya da tekrar deneyin. |
Hata devam ederse bağlantı sayfasındaki son senkron özetine bakın; Sorun giderme makalesi daha fazla ayrıntı verir.
Sonraki adım
İlk kurulum kontrol listesi: ürünleri alın, alış fiyatı ve desi girin, kargo tarifenizi tanımlayın.