Trendyol entegrasyonu üç adımda kurulur: önce Trendyol satıcı panelinden API bilgilerinizi alırsınız, sonra bu
bilgileri Pixa'daki kurulum ayarlarına yazarsınız, en sonunda bağlantıyı test edersiniz. Trendyol tarafında ayrı
bir başvuru ya da onay süreci yoktur; API bilgileri satıcı panelinde hazır bulunur.
Her Trendyol mağazası Pixa'da ayrı bir entegrasyon kartıdır. Birden fazla mağazanız varsa bu adımları her
mağaza için ayrı ayrı yaparsınız; ayrıntı için sayfanın sonundaki "Birden fazla Trendyol mağazam var" bölümüne
bakın.
Başlamadan önce hazır olması gerekenler
Gereken | Nereden bulunur |
Aktif bir Trendyol satıcı hesabı | Trendyol Satıcı Paneli'ne giriş yapabiliyor olmalısınız. |
Satıcı ID | Satıcı panelinde Hesap Bilgilerim → Entegrasyon Bilgileri sayfasında yer alır. Pixa'da Tedarikçi Id alanına yazılır. |
API Key | Aynı sayfada yer alır. Pixa'da Kullanıcı Adı alanına yazılır. |
API Secret | Aynı sayfada yer alır. Pixa'da Şifre alanına yazılır. |
Pixa'da ana kullanıcı hesabı | Kurulum ayarları ve Aktif/Pasif işlemleri yalnızca ana kullanıcıya açıktır; alt kullanıcılar bu alanları görmez. |
Siparişleri bir ERP'ye ya da kargo firmasına otomatik aktaracaksanız, ilgili ERP ve kargo entegrasyonlarının
Pixa'da önceden kurulu olması gerekir. Trendyol kurulumunda yalnızca bunların adını seçersiniz.
1. Adım: Trendyol'dan API bilgilerini alın
Trendyol Satıcı Paneli'ne giriş yapın.
Hesap Bilgilerim menüsüne girin.
Entegrasyon Bilgileri sekmesini açın.
Satıcı ID, API Key ve API Secret değerlerini kopyalayın.
Bilgileri kopyalarken başına ya da sonuna boşluk gelmemesine dikkat edin. API Secret'ı Trendyol panelinden
yenilerseniz eski değer geçersiz olur ve Pixa'daki bağlantı kesilir; yeni değeri Pixa'ya da yazmanız gerekir.
2. Adım: Pixa'da kurulum ayarlarını kaydedin
Sol menüden Market'e girin.
Arama kutusuna "Trendyol" yazın ve Trendyol kartında Kur'a tıklayın. Kurulum sayfası açılır.
Kurulum sayfası dört adımdan oluşur. Her adımda ayarlar açık/kapalı anahtarlar ya da metin alanları olarak
listelenir; zorunlu alanlar yıldız ile işaretlidir.
Adım | Ne ayarlanır |
Mağaza Bilgileri | Tedarikçi Id (Satıcı ID, zorunlu), Kullanıcı Adı (API Key, zorunlu), Şifre (API Secret, zorunlu), isteğe bağlı Özel İsimlendirme |
Sipariş Ayarları | Siparişleri Getir, Siparişleri Webhook ile Anında Çek, Otomatik işleme al, Erp Adı ve Erp'ye Anlık İlet, Kargoya Anlık İlet, Satıcı Anlaşmalı Kargo Firmaları, kargo etiketi seçenekleri, İadeler Erp'ye İletilsin, Mikro ihracat siparişlerinin aktarımını pasif et |
Ürün & Stok Ayarları | Stokları Gönder, Stok Alt Limiti, Buffer Stok, Stokları Pixa'ya Getir, Fiyatları Çek |
Diğer Ayarlar | Entegrasyon Aktif, Fiyatları Gönder, Sabit Marka Adı, Kataloğa Özel Barkod Tanımı, Kataloğa Özel Model Kodu, Yeniden Eşleştirme Pasif |
Zorunlu alan boş bırakılırsa Devam et çalışmaz ve "Lütfen zorunlu alanların hepsini doldurunuz" uyarısı
görünür.Son adımda Kaydet ve Bitir'e tıklayın. "Kaydedildi" mesajından sonra Market sayfasına yönlendirilirsiniz.
Sayfanın üst çubuğunda Entegrasyon anahtarı vardır. Bağlantı testine geçmeden önce bu anahtarın Aktif
olduğundan emin olun. Üst çubuktaki arama kutusu (Ayarlarda ara) ile herhangi bir ayarı adına göre bulabilirsiniz;
sağdaki Ayar Özeti hangi ayarların dolu olduğunu adım adım gösterir.
İlk kurulumda hangi anahtarların açılacağı hakkında karar veremiyorsanız yalnızca zorunlu alanları doldurup
kaydedin. Sipariş, stok ve fiyat ayarlarını daha sonra Market → Trendyol → Yapılandır → Kurulum
Ayarları yolundan istediğiniz zaman değiştirebilirsiniz. Her ayarın ne yaptığı ilgili makalede anlatılır:
sipariş aktarımı,
stok gönderimi,
fiyat gönderimi.
3. Adım: Bağlantıyı test edin
Market → Trendyol → Yapılandır → sağdaki Kurulum Ayarları'na girin.
Üst çubuktaki Bağlantıyı Test Et düğmesine tıklayın. Düğme "Test ediliyor…" olur, sonuç "Bağlantı
başarılı" ya da "Bağlantı hatası" olarak görünür; başlığın yanındaki rozet de "Bağlı" ya da "Bağlantı hatası"
olur.
Test, Satıcı ID ve API bilgileriyle Trendyol'dan sipariş listenizin okunabildiğini doğrular. Test ürün
eşleştirme ya da başka bir işlem başlatmaz.
"Bağlantı hatası" alıyorsanız sırayla kontrol edin:
Tedarikçi Id, Kullanıcı Adı ve Şifre doğru mu? En sık neden, API Key ile API Secret'ın yer
değiştirmesi ya da eksik kopyalanmasıdır. Trendyol panelinden yeniden kopyalayıp kaydedin.Trendyol panelinde API Secret yenilenmiş mi? Yenilendiyse yeni değeri Pixa'ya yazın.
Entegrasyon Aktif mi? Pasif entegrasyonda hiçbir işlem çalışmaz.
Trendyol satıcı hesabınız askıda mı? Bu durumda önce Trendyol tarafını düzeltin.
Siparişleri anında çekme (webhook)
Pixa, Trendyol siparişlerini birkaç dakikada bir kontrol eder. Siparişleri Webhook ile Anında Çek ayarını
açarsanız Pixa, Trendyol'a bir bildirim adresi tanımlar; yeni sipariş oluştuğu anda Trendyol bu adrese haber
verir ve sipariş periyodik kontrolü beklemeden Pixa'ya düşer.
Ayarı açıp kaydetmeniz yeterlidir; bildirim adresi Pixa tarafından otomatik tanımlanır ve doğrulanır.
Periyodik kontrol kapanmaz, yedek olarak çalışmaya devam eder. Bir bildirim ulaşmazsa sipariş sonraki turda
yine gelir.Siparişleri Getir kapalıysa webhook ile gelen sipariş de işlenmez.
Ne yapar, ne yapmaz
Kabiliyet | Durum |
✅ | |
✅ | |
✅ | |
✅ | |
✅ | |
✅ | |
✅ | |
✅ | |
✅ Her gece | |
Soru-cevap takibi | ✅ |
Kargoya verildi / teslim edildi bilgisinin Trendyol'a gönderilmesi | 🔴 Gönderilmez — Trendyol kargo firmalarıyla kendi entegredir, statüyü doğrudan alır |
Çalışma sıklıkları
İşlem | Sıklık |
Sipariş çekme | Birkaç dakikada bir — webhook açıksa anında |
Satırları eşleşmeyen siparişlerin yeniden denenmesi | Yaklaşık 20 dakikada bir, 7 gün boyunca |
Kargoya verilenlerin güncellenmesi | 15 dakikada bir |
Teslim edilenlerin güncellenmesi | Günde bir kez, akşam |
İptallerin çekilmesi | 10 dakikada bir |
İade taleplerinin çekilmesi | Günde üç kez + gece tam tarama |
Stok gönderimi | Değişenler birkaç saatte bir, tam senkron her gece — ayrıca sipariş düştüğü anda |
Fiyat gönderimi | 🔴 Periyodik tarama yok — fiyat değiştiğinde gönderilir |
Ürün eşleştirme | Günde üç kez |
Ortak etiket çekme | Birkaç dakikada bir |
Soru-cevap | Saatte iki kez |
Komisyon / kargo maliyeti | Her gece |
Kurulumdan sonra
Kurulu entegrasyonlar Market sayfasında Kurulu entegrasyonlar başlığı altında listelenir. Kartın
Yapılandır penceresinde sağ tarafta Kurulum Ayarları, Pasif Et / Aktif Et ve entegrasyonun
açık görevlerinin listesi bulunur.Pasif Et, onay için "onaylıyorum" yazmanızı ister. Pasif entegrasyonda sipariş çekme, stok ve fiyat
gönderimi dahil tüm otomatik işlemler durur; ayarlarınız silinmez, Aktif Et ile kaldığı yerden devam eder.Siparişlerin gelmesi için Siparişleri Getir, stok ve fiyatın gitmesi için Stokları Gönder ve
Fiyatları Gönder açık olmalıdır.Kurulumdan sonra neyi ne zaman beklemelisiniz:
İşlem | Sıklık |
Yeni siparişlerin kontrolü | Yaklaşık 4 dakikada bir; webhook açıksa sipariş anında düşer |
Stok gönderimi | Değişen ürünler birkaç saatte bir, tüm ürünler her gece; ayrıca her sipariş sonrasında |
Fiyat gönderimi | Fiyat değiştiğinde ve panelden Fiyatları Güncelle dendiğinde |
Ürün eşleştirme | Periyodik eşleştirme açıksa günde üç kez; istediğiniz zaman elle de çalıştırabilirsiniz |
Kargoya verilen siparişler | Yaklaşık 15 dakikada bir |
Teslim edilen siparişler | Her gün akşam |
İptaller | Yaklaşık 10 dakikada bir |
İade talepleri | Günde üç kez |
Ürünlerinizi Pixa'dan göndermeyi planlıyorsanız Trendyol'da ürünler ilk gönderimde onay sürecinden geçer;
onaylanana kadar stok ve fiyat platformda görünmeyebilir. Ayrıntı için
ürün gönderimi.Trendyol'da hâlihazırda satılan ürünleriniz varsa önce
ürün eşleştirme yapın; eşleşmeyen ürüne stok ve fiyat
gitmez.
Birden fazla Trendyol mağazası
Aynı hesapta birden fazla Trendyol mağazası çalıştırabilirsiniz. Her mağaza ayrı bir entegrasyon kartıdır;
kendi API bilgileri, kendi ayarları ve kendi kataloğu olur. Kartları ayırt etmek için Özel İsimlendirme
alanını doldurun.
Mağaza bazında ayrışan ayarlar, kategori eşleştirmede ana mağaza kuralı ve yalnız ana mağazada çalışan
işlemler birden fazla Trendyol mağazası
rehberinde anlatılır.
Sık karşılaşılan durumlar
"Entegrasyon ayarı bulunamadı" uyarısı alıyorum. Bu uyarı Trendyol kurulumunun hiç kaydedilmediği ya da
entegrasyonun pasif olduğu durumda görünür. Market'te Trendyol kartı Kur gösteriyorsa kurulum
yapılmamıştır; Yapılandır gösteriyorsa Aktif Et'e bakın.
Ayarlar doğru ama bağlantı hatası alıyorum. API Key ve API Secret'ın yerleri karışmış olabilir: Kullanıcı
Adı alanına API Key, Şifre alanına API Secret yazılır. Satıcı ID'nin başka bir mağazaya ait olmadığından da
emin olun.
API Secret'ı yeniledim, siparişler gelmiyor. Yenilenen değer eskisini geçersiz kılar. Yeni değeri
Kurulum Ayarları → Şifre alanına yazıp kaydedin ve bağlantıyı yeniden test edin.
Trendyol servislerinde değişiklik oldu, entegrasyonu güncellemem gerekir mi? Hayır. Trendyol'un servis
adresi ya da sürümü değiştiğinde güncelleme Pixa tarafında yapılır; sizin bir işlem yapmanız gerekmez.
Birden fazla Trendyol mağazam var. Her mağaza Pixa'da ayrı bir kart olarak tanımlanır (Trendyol, Trendyol2,
…) ve her biri için ayrı Satıcı ID, API Key ve API Secret girilir. Kartları ayırt etmek için Özel İsimlendirme
alanına mağaza adınızı yazın. Sipariş, stok ve fiyat ayarları mağaza başına ayrı tutulur; bir mağazada yaptığınız
değişiklik diğerine geçmez. Ek mağaza kartı için Market sayfasındaki Yeni entegrasyon talep et düğmesini
kullanın ya da destek ekibine yazın.
Trendyol e-Faturam kullanıyorum. Trendyol e-Faturam, faturalarınızı Trendyol üzerinden kesmenizi sağlayan
ayrı bir entegrasyondur ve Market'te ayrı bir kart olarak kurulur. Bu makaledeki kurulum onu kapsamaz; ayrıntı
için fatura gönderimi.