Trendyol entegrasyonu nasıl yapılır? Adım adım kurulum rehberi

Trendyol entegrasyonu ne sağlar?

Trendyol, geliştirici dokümanında entegrasyonu, Partner Programı'na katılan firmaların kendi sistemlerini Trendyol mağazasına bağlaması olarak tanımlar. API üzerinden ürün aktarma, stok ve fiyat güncelleme, sipariş işlemleri, fatura gönderme ve müşteri sorularını yanıtlama gibi işler yapılabilir.

Satıcı açısından anlamı şudur: panelde elle yaptığınız tekrar eden işlerin büyük kısmını bir yazılım yürütür. En çok fark yaratan kısım stok senkronudur. Trendyol dışında da satıyorsanız, bir kanaldaki satış diğerlerinde stoku düşürmelidir. Bu mantığı pazaryeri stok senkronu rehberinde ayrıntılı anlattık.

Başlamadan önce: hazırlık listesi

Kuruluma geçmeden önce şu dört konuyu netleştirin. Bunlar sonraki adımlarda zaman kaybını önler.

• Yönetici hesabı: Trendyol'a göre entegrasyon bilgileri yalnızca master user (admin rolü) ile girişte görünür. Alt kullanıcıyla giren çalışan bu bilgilere ulaşamaz.
• Barkod düzeni: Trendyol'daki her ürünün ve varyantın barkodu diğer kanallardaki karşılığıyla aynı mı? Aynıysa eşleştirme otomatikleşir.
• Stok kaynağı: hangi kanalın stok rakamı esas alınacak? Karar için stok kaynağı seçimi rehberine bakın.
• Fiziksel sayım: senkron, girdiği rakamı dağıtır. Yanlış rakamla başlamamak için çok satan ürünleri sayın.

Adım 1: Satıcı ID, API Key ve API Secret

Trendyol'un yetkilendirme sayfasına göre bağlantı için üç bilgi gerekir: satıcı kimliği (supplierId), API KEY ve API SECRET KEY. Bu bilgiler satıcı panelindeki "Hesap Bilgilerim" bölümünün "Entegrasyon Bilgileri" sayfasından alınır.

Ekranda hangi adımları izleyeceğinizi Trendyol API bilgileri nasıl alınır rehberimizde gösterdik; burada tekrarlamıyoruz. Bilmeniz gereken iki teknik nokta var:

• İstekler "basic authentication" yöntemiyle yetkilendirilir. Bilgiler hatalıysa Trendyol 401 hatası döner.
• Her istekte User-Agent başlığı bulunmalıdır. Trendyol, User-Agent içermeyen istekleri 403 hatasıyla engeller.

API Secret bir şifredir. E-postayla ya da mesajla paylaşmayın; yalnızca kullanacağınız entegrasyon yazılımının ekranına girin.

Adım 2: Entegratör mü, kendi yazılımınız mı?

Trendyol iki yolu da tanır. Yetkilendirme sayfasındaki kurala göre User-Agent biçimi, yazılımın kime ait olduğunu gösterir. Aracı firmayla çalışıyorsanız "Satıcı Id - Entegrasyon Firması İsmi", yazılım size aitse "Satıcı Id - SelfIntegration" gönderilir. Entegratör firma adı alfanumerik karakterlerle en çok 30 karakter olabilir.

Entegratör seçerken fiyat dışında neye bakacağınızı entegrasyon yazılımı seçerken sorulacak 12 soru yazısında topladık.

Test ortamı mı, canlı ortam mı?

Trendyol'un canlı ve test ortam bilgileri sayfası iki ortamı birbirinden ayırır:

• Canlı ortam: gerçek mağazanızdır. Erişim için IP yetkilendirmesi gerekmez.
• Test ortamı (stage): IP yetkilendirmesi ister. Test hesabı ve API bilgileri canlı bilgilerden tamamen farklıdır.

Kendi yazılımını geliştiren firmalar önce test ortamında çalışır. Hazır bir entegratör kullanıyorsanız test ortamıyla çoğu zaman uğraşmazsınız; yazılım zaten canlıda çalışır. Sık yapılan hata, test ortamı bilgilerini canlı bağlantıya girmektir. Bu durumda bağlantı yetkilendirme hatası verir.

Adım 3: İlk eşleştirme

Eşleştirme, Trendyol'daki her ürünün diğer kanallardaki karşılığını sisteme bir kez tanıtmaktır. Kural basittir: barkodlar her yerde aynıysa eşleştirme otomatik yapılır, farklıysa elle onay gerekir.

• Varyantlı ürünlerde her beden ve renk ayrı eşleşir.
• Barkodu olmayan ürünler için önce barkod tanımlayın; barkod tanımlama rehberi yol gösterir.
• İlk gün tüm kataloğu değil, en çok satan 20-30 ürünü eşleştirip kontrol edin.

Ayrıntılar ürün eşleştirme rehberinde. Hangi ürünün hangi kanalda eksik olduğunu görmek için platform kapsamı raporu pratik bir kontrol listesidir.

Adım 4: Stok, fiyat ve sipariş testi

Trendyol stok ve fiyatı aynı servisle günceller. Stok ve fiyat güncelleme sayfasındaki kurallar, testte gördüğünüz davranışı açıklar:

• Bir istekte en çok 1.000 ürün (SKU) güncellenebilir.
• Bir ürün için en çok 20 bin adet stok girilebilir.
• Aynı istek 15 dakika içinde değiştirilmeden tekrar gönderilirse hata alınır; yalnızca değişen değerler gönderilmelidir.
• İşlemin sonucu toplu işlem kontrol servisinden izlenir. Onaylı ürünlerde güncelleme "eş zamana yakın" gerçekleşir.

Testi şu sırayla yapın: bir üründe stoku bir adet azaltın ve Trendyol'da değiştiğini görün. Sonra fiyatı küçük bir tutar değiştirip geri alın. Son olarak gelen bir siparişin entegrasyon panelinde göründüğünü ve diğer kanallarda stoku düşürdüğünü kontrol edin.

Siparişler için Trendyol webhook da sunar. Webhook modeli sayfasına göre sipariş paketinin durumu değiştiğinde sizin belirlediğiniz adrese bildirim gönderilir. Aynı sayfa, webhook iletimi her zaman garanti olmadığı için sipariş servisinin düzenli aralıklarla ayrıca sorgulanmasını önerir. Sağlam bir entegrasyon ikisini birlikte kullanır.

Kurulumdan sonraki ilk hafta

Bağlantı kurulduktan sonraki ilk hafta, sorunların en kolay yakalandığı dönemdir. Her gün kısa bir kontrol yapın:

• Gün sonunda en çok satan beş ürünün stokunu Trendyol'da ve diğer kanallarda karşılaştırın.
• Entegrasyon panelinde başarısız gönderim ya da bağlantı uyarısı olup olmadığına bakın.
• İptal ve iade olan siparişlerde stokun nasıl değiştiğini not edin. İade edilen ürünün depoya ulaşmadan satışa açılması yeni bir fazla satış riski doğurur.
• Yeni açtığınız ürünlerin eşleşip eşleşmediğini kontrol edin. Eşleşmeyen ürün senkrona katılmaz.
• Fiyat değişikliklerinin doğru kanala, doğru tutarla gittiğini birkaç üründe doğrulayın.

Bir hafta boyunca sorun görmezseniz kontrolleri haftalık rutine çevirebilirsiniz. Kâr tarafını da bu dönemde kurun: komisyon ve kargo düşüldükten sonra hangi ürünün kazandırdığını pazaryeri kâr/zarar hesabı rehberiyle hesaplayın.

Sık yapılan hatalar ve çözümleri

• 401 hatası: API Key ya da Secret yanlış, başında veya sonunda boşluk var ya da test ortamı bilgileri girilmiş. Bilgileri yeniden kopyalayın.
• 403 hatası: istekte User-Agent eksik ya da hatalı. Hazır yazılımda bu yazılımın sorunudur; destek ekibine bildirin.
• Bilgiler görünmüyor: panele master user ile girmediniz. Yönetici hesabıyla tekrar deneyin.
• Stok değişmiyor: ürün eşleşmemiş olabilir ya da aynı değer 15 dakika içinde tekrar gönderilmiştir. Eşleştirmeyi ve toplu işlem sonucunu kontrol edin.
• Yoğun dönemde gecikme: Trendyol istek sınırlarını servis grupları bazında uygular (servis limitleri). Binlerce ürünlük güncelleme bu yüzden dakikalar içinde yayılır; bu bir hata değildir.

Kurulumdan sonra önemli olan sürekliliktir. Bu adımları otomatik yürüten araçlar stok değişimini tüm mağazalara dağıtır ve başarısız gönderimleri gösterir. Saystok'ta bu akış stok senkronizasyonu ile çalışır; Trendyol ödemelerinizi de hakediş mutabakatı ile kontrol edebilirsiniz.