Genel Bakış
Trendyol Entegrasyonu eklentisi, e-ticaret sitenizi Trendyol pazaryeri ile tam entegre etmenizi sağlar. Ürünlerinizi otomatik olarak Trendyol'a gönderebilir, siparişleri çekebilir ve stok/fiyat güncellemelerini anlık olarak yapabilirsiniz.
Tek tıkla tüm ürünlerinizi gönderin
Siparişleri otomatik çekin
Anlık stok ve fiyat güncelleme
Kargo bilgilerini otomatik gönder
Bu eklentiyi kullanabilmek için aktif bir Trendyol Partner (Satıcı) hesabınızın olması gerekmektedir.
Kurulum
1. Eklentiyi Yükleyin
- Admin Panel → Eklentiler → Eklenti Mağazası menüsüne gidin
- "Trendyol Entegrasyonu" eklentisini bulun ve Yükle butonuna tıklayın
- Kurulum tamamlandığında eklenti otomatik olarak aktif hale gelecektir
2. API Bilgilerini Alın
Trendyol Partner Panel'den API bilgilerinizi almanız gerekmektedir:
- partner.trendyol.com adresine giriş yapın
- Entegrasyon → API Hesapları menüsüne gidin
- Yeni API Hesabı Oluştur butonuna tıklayın
- Oluşturulan bilgileri not alın:
- Satıcı ID (Supplier ID)
- API Key
- API Secret
API bilgilerinizi güvenli bir yerde saklayın. Bu bilgilere sahip olan herkes Trendyol mağazanızı yönetebilir.
3. API Ayarlarını Yapılandırın
- Admin Panel → Trendyol → Ayarlar menüsüne gidin
- API bilgilerinizi girin:
- Satıcı ID: Trendyol Partner Panel'deki satıcı numaranız
- API Key: Oluşturduğunuz API anahtarı
- API Secret: API gizli anahtarı
- Bağlantıyı Test Et butonuna tıklayarak bağlantıyı doğrulayın
- Kaydet butonuna tıklayın
Ek Ayarlar
| Otomatik Stok Senkronizasyonu | Stok değişikliklerini otomatik Trendyol'a gönder |
| Otomatik Fiyat Senkronizasyonu | Fiyat değişikliklerini otomatik Trendyol'a gönder |
| Sipariş Çekme Sıklığı | Siparişlerin kontrol edilme aralığı (dk) |
| Varsayılan Kargo Firması | Siparişler için varsayılan kargo şirketi |
Kategori Eşleştirme
Ürünlerinizi Trendyol'a göndermeden önce, kategorilerinizi Trendyol kategorileriyle eşleştirmeniz gerekmektedir.
Kategorileri Eşleştirme Adımları
- Trendyol → Kategoriler menüsüne gidin
- Trendyol Kategorilerini Güncelle butonuna tıklayarak güncel kategori listesini çekin
- Her yerel kategoriniz için:
- Tabloda yerel kategorinizi bulun
- Açılır menüden uygun Trendyol kategorisini seçin
- Kaydet butonuna tıklayın
Doğru kategori seçimi, ürünlerinizin Trendyol'da daha kolay bulunmasını sağlar. Alt kategorilere kadar inerek en spesifik kategoriyi seçin.
Marka Eşleştirme
Trendyol, ürünlerin markasını zorunlu kılar. Yerel markalarınızı Trendyol marka listesiyle eşleştirmeniz gerekmektedir.
Markaları Eşleştirme Adımları
- Trendyol → Markalar menüsüne gidin
- Trendyol Markalarını Güncelle butonuna tıklayarak güncel marka listesini çekin
- Her yerel markanız için:
- Tabloda yerel markanızı bulun
- Açılır menüden uygun Trendyol markasını seçin veya arama yapın
- Kaydet butonuna tıklayın
Markanız Trendyol listesinde yoksa, Partner Panel'den marka başvurusu yapmanız gerekmektedir.
Ürün Yönetimi
Ürün Listesi
Trendyol → Ürünler menüsünden tüm ürünlerinizi ve senkronizasyon durumlarını görebilirsiniz.
| Durum | Açıklama | İşlem |
|---|---|---|
| Senkronize | Ürün Trendyol'da aktif durumda | Güncelle / Stok-Fiyat Sync |
| Bekliyor | Ürün henüz gönderilmemiş | Eşleştir / Gönder |
| Hatalı | Gönderim sırasında hata oluştu | Hatayı İncele / Tekrar Dene |
Tek Ürün Gönderme
- Ürün listesinde göndermek istediğiniz ürünü bulun
- Eşleştir butonuna tıklayarak:
- Trendyol kategorisini seçin
- Trendyol markasını seçin
- Barkod numarasını girin (EAN/UPC formatında)
- Kaydet butonuna tıklayın
- Gönder butonuna tıklayarak ürünü Trendyol'a gönderin
Toplu Ürün Gönderme
- Göndermek istediğiniz ürünleri checkbox ile seçin
- Seçilenleri Gönder butonuna tıklayın
- Onay mesajını kabul edin
- İşlem tamamlandığında sonuç raporu görüntülenecektir
Aynı kategorideki ürünleri seçip Toplu Eşleştir butonu ile hepsine aynı Trendyol kategori ve markasını atayabilirsiniz.
Stok & Fiyat Yönetimi
Trendyol → Stok & Fiyat menüsünden envanter senkronizasyonunu yönetebilirsiniz.
Otomatik Senkronizasyon
Ayarlardan aktif edildiğinde:
- Ürün stoğu değiştiğinde otomatik olarak Trendyol'a bildirilir
- Fiyat değişikliği yapıldığında otomatik olarak Trendyol'a yansır
- Sipariş geldiğinde stok otomatik düşer
Manuel Senkronizasyon
Uyumsuzluk Kontrolü
Stok & Fiyat sayfası, yerel sistemdeki değerler ile Trendyol'daki değerler arasındaki farklılıkları otomatik tespit eder:
- Stok Uyumsuzlukları: Yerel stok ≠ Trendyol stoğu olan ürünler listelenir
- Fiyat Uyumsuzlukları: Yerel fiyat ≠ Trendyol fiyatı olan ürünler listelenir
- Tek tıkla her ürün için senkronizasyon yapılabilir
Otomatik Görev (CRON) Kurulumu
Siparişlerin, stok ve fiyat güncellemelerinin otomatik olarak senkronize edilmesi için sunucunuza CRON job eklemeniz gerekmektedir.
CRON URL'ini Alın
- Trendyol → Ayarlar menüsüne gidin
- "Otomatik Görev (CRON) Ayarları" bölümünde CRON URL'inizi göreceksiniz
- Kopyala butonuna tıklayarak URL'yi kopyalayın
CRON URL'i gizli bir anahtar içerir. Bu URL'i kimseyle paylaşmayın. Yetkisiz kişiler bu URL ile senkronizasyon işlemlerini tetikleyebilir.
cPanel ile CRON Kurulumu
- cPanel hesabınıza giriş yapın
- Cron Jobs (Zamanlanmış Görevler) bölümüne gidin
- Yeni bir CRON job ekleyin:
- Dakika: */15 (her 15 dakikada bir)
- Saat: * (her saat)
- Gün: * (her gün)
- Ay: * (her ay)
- Hafta Günü: * (haftanın her günü)
- Komut: alanına şunu yazın:
curl -s "CRON_URL_BURAYA" > /dev/null 2>&1
Not: "CRON_URL_BURAYA" yerine kopyaladığınız URL'i yapıştırın.
Alternatif: PHP CLI ile CRON
Sunucunuzda PHP CLI varsa, daha performanslı olan bu yöntemi kullanabilirsiniz:
*/15 * * * * php /home/kullanici/public_html/addons/trendyol-integration/cron.php
Not: "/home/kullanici/public_html" yerine kendi site dizininizi yazın.
CRON Sıklığı Önerileri
Yoğun satış dönemleri için. Siparişler hızlıca çekilir.
*/5 * * * *
Önerilen ayar. Çoğu mağaza için idealdir.
*/15 * * * *
Düşük satış hacmi olan mağazalar için.
*/30 * * * *
CRON Test Etme
- Trendyol → Ayarlar menüsüne gidin
- CRON bölümündeki CRON'u Test Et butonuna tıklayın
- Başarılı mesajı görürseniz CRON çalışıyor demektir
- Trendyol → Loglar sayfasından "cron_" ile başlayan logları kontrol edin
- Yeni siparişleri otomatik çeker
- Stok değişikliklerini Trendyol'a gönderir
- Fiyat güncellemelerini senkronize eder
- Kategori ve marka cache'ini haftalık günceller
- Tüm işlemleri log kaydı tutar
Sipariş Yönetimi
Trendyol → Siparişler menüsünden Trendyol siparişlerini görüntüleyebilir ve yönetebilirsiniz.
Sipariş Durumları
| Durum | Açıklama | Yapılacak İşlem |
|---|---|---|
| 📥 Created | Yeni sipariş oluşturuldu | Onayla ve hazırla |
| 📦 Picking | Ürünler hazırlanıyor | Paketleme işlemine başla |
| 📄 Invoiced | Fatura kesildi | Kargoya ver |
| 🚚 Shipped | Kargoya verildi | Takip et |
| ✅ Delivered | Teslim edildi | - |
| ❌ Cancelled | İptal edildi | Stok iade işlemi |
Kargo Bilgisi Gönderme
- Sipariş detayında Kargo Bilgisi Gir butonuna tıklayın
- Kargo firmasını seçin
- Takip numarasını girin
- Gönder butonuna tıklayın
Kargo bilgisi gönderildikten sonra sipariş durumu otomatik olarak "Shipped" olarak güncellenir ve müşteriye bildirim gider.
Dashboard & Raporlar
Trendyol → Dashboard menüsünden genel durumu ve istatistikleri görüntüleyebilirsiniz.
Ürün İstatistikleri
- Toplam eşleştirilen ürün
- Senkronize ürün sayısı
- Bekleyen ürün sayısı
- Hatalı ürün sayısı
Sipariş İstatistikleri
- Bugünkü siparişler
- Bekleyen siparişler
- Kargodaki siparişler
- Toplam ciro
Senkronizasyon Logları
Trendyol → Loglar menüsünden tüm API işlemlerini ve senkronizasyon geçmişini inceleyebilirsiniz.
Log Tipleri
- product_create: Yeni ürün oluşturma
- product_update: Ürün güncelleme
- stock_update: Stok güncelleme
- price_update: Fiyat güncelleme
- order_fetch: Sipariş çekme
- cargo_update: Kargo bilgisi gönderme
- api_error: API hatası
Eski logları temizlemek için Logları Temizle butonunu kullanabilirsiniz. Varsayılan olarak 30 günden eski loglar temizlenir.
Sık Sorulan Sorular
Ürünüm neden Trendyol'da görünmüyor?
Ürünün Trendyol'da görünmesi için:
- Kategori ve marka eşleştirmesi yapılmış olmalı
- Geçerli bir barkod girilmiş olmalı
- Ürün resmi yüklenmiş olmalı (en az 1 resim)
- Stok miktarı 0'dan büyük olmalı
- Trendyol'un onay sürecinden geçmiş olmalı (24-48 saat)
"Barkod zaten kullanılıyor" hatası alıyorum
Bu hata, aynı barkodun başka bir satıcı tarafından kullanıldığı anlamına gelir. Çözümler:
- Ürüne benzersiz bir barkod atayın
- Kendi stok kodunuzu barkod olarak kullanın
- Trendyol destek ile iletişime geçin
Stok güncellenmesi ne kadar sürer?
Stok güncellemeleri genellikle anında işlenir. Ancak yoğun dönemlerde 5-15 dakika gecikme olabilir. Dashboard'dan son senkronizasyon zamanını kontrol edebilirsiniz.
Siparişler otomatik çekilmiyor
Otomatik sipariş çekme için:
- CRON job'ların aktif olduğundan emin olun
- Ayarlardan "Otomatik Sipariş Çekme" seçeneğini kontrol edin
- API bağlantısının aktif olduğunu doğrulayın
- Logları kontrol ederek hata mesajlarını inceleyin
Komisyon oranları nasıl hesaplanıyor?
Trendyol komisyon oranları kategoriye göre değişir ve Trendyol tarafından belirlenir. Komisyon detayları sipariş detayında görüntülenir. Güncel komisyon oranları için Trendyol Partner Panel'i kontrol edin.
Destek & İletişim
Teknik Destek
Eklenti ile ilgili teknik sorunlarınız için destek talebi oluşturun.
destek@markaclick.com