Trendyol entegrasyonu:
ürün, stok ve sipariş tek panelde.

Trendyol entegrasyonu: kurulumdan hakedişe kadar bilmeniz gerekenler

Trendyol entegrasyonu, mağazanızı Trendyol'un satıcı API'si üzerinden stok, fiyat, sipariş, kargo ve fatura tarafında başka bir yazılıma bağlamaktır. Bağlantı, API bilgilerinin girilmesiyle kurulur; sorunsuz çalışması ise Trendyol'un stok, sipariş ve fatura kurallarını bilmeye bağlıdır. Bu bölümde API bilgilerinin nereden alındığını, Trendyol'un stok ve fiyat güncellemesinde koyduğu sınırları, sipariş ve iade akışını, fatura iletimini ve en sık yapılan hataları sırayla anlatıyoruz.

Trendyol entegrasyonu kimin işine yarar, ne zaman gerekir?

Trendyol, satıcıların kendi sistemlerini mağazalarına bağlayabilmesi için bir Partner API sunar. Resmî geliştirici dokümanına göre bu API ile ürün aktarma, stok ve fiyat güncelleme, sipariş işlemleri, fatura gönderme ve müşteri sorularını yanıtlama yapılabilir. Bir Trendyol entegrasyon programı bu servisleri sizin yerinize kullanır; siz de her işlem için satıcı paneline girmek zorunda kalmazsınız.

Entegrasyon herkes için aynı derecede acil değildir. Şu durumlardan biri sizin için geçerliyse elle yönetim kısa sürede hataya döner:

• Aynı ürünü Trendyol'un yanında başka bir pazaryerinde ya da kendi sitenizde de satıyorsanız
• Varyantlı (beden, renk) ürünleriniz ya da 5'li, 10'lu paketleriniz varsa
• Günde birden fazla sipariş hazırlıyor ve her birine ayrı fatura ve kargo etiketi üretiyorsanız
• Komisyon ve kargo kesintilerinin hakedişinize doğru yansıyıp yansımadığını kontrol etmek istiyorsanız

Trendyol API bilgileri nereden alınır?

Trendyol API entegrasyonu üç bilgiyle kurulur: Satıcı ID, API Key ve API Secret. Trendyol'un yetkilendirme dokümanına göre bu bilgiler satıcı panelindeki Hesap Bilgilerim menüsünün altında, Entegrasyon Bilgileri sayfasında yer alır ve yalnızca yönetici (master) kullanıcıyla giriş yapıldığında görünür. Mağaza şifrenizi hiçbir entegrasyon firmasıyla paylaşmanız gerekmez.

1. Trendyol satıcı paneline yönetici yetkisine sahip kullanıcıyla giriş yapın.
2. Sağ üstteki mağaza adınızdan Hesap Bilgilerim bölümüne, oradan Entegrasyon Bilgileri sayfasına geçin.
3. Satıcı ID, API Key ve API Secret değerlerini kopyalayın.
4. Bu üç bilgiyi eticaretcim'de Trendyol bağlantı ekranına girip kaydedin.
5. Mevcut ilanlarınız panele okunur ve barkod ya da stok koduyla eşleşir. Eşleşmeleri kontrol edin; siz onaylamadan hiçbir ilanınız değişmez.

Trendyol API güvenliği: User-Agent ve anahtar paylaşımı

Trendyol, API bilgilerinin GitHub gibi açık platformlarda paylaşılmamasını ister. Her istekte User-Agent bilgisi gönderilmesi zorunludur; bu bilgi eksik olan istekler 403 hatasıyla reddedilir. Aracı bir yazılım kullanıyorsanız bu alanda satıcı ID'niz ve entegratörün adı birlikte yer alır, bunu yazılım sizin yerinize gönderir. Canlı (PROD) ve test (STAGE) ortamının bilgileri farklı olabilir, bu yüzden test için aldığınız anahtarı canlı mağazada kullanmayın.

Trendyol stok entegrasyonu ve fiyat güncellemesinin kuralları

Trendyol stok entegrasyonu, satılabilir stok adedinin ve fiyatın Trendyol'a gönderilmesine dayanır. Trendyol'un dokümanı bu güncelleme için bazı net sınırlar koyar. Bunları bilmek, "stoğu güncelledim ama Trendyol'da değişmedi" sorununun çoğunu açıklar.

Trendyol için kanal başına fiyat farkı: örnek hesap

eticaretcim'de her ürünün tek bir stok kartı vardır ve kanal başına yüzde ya da tutar olarak fiyat farkı tanımlanır. Örneğin bir ürünün ana fiyatı ₺500 ise ve Trendyol için %10 fark girdiyseniz, Trendyol'a ₺550 gönderilir. Komisyon kategoriye göre değiştiği için bu farkı kendi kategorinizin güncel oranına göre belirleyin; oranı Trendyol satıcı panelinden kontrol edebilirsiniz. Ayrıntılar için stok ve fiyat senkronizasyonu sayfasına bakabilirsiniz.

Paket ve set ürünlerde Trendyol stoğu nasıl düşer?

Trendyol'da 5'li ya da 10'lu paket olarak açtığınız ilanlar ayrı ürün gibi görünür, ama depoda aynı tekil üründen düşer. Panelde paket stoğu tek stok biriminden hesaplanır, set satışında da stok bileşenlerden düşer. Böylece tekli ilandan satış olduğunda paket ilanının stoğu da buna göre azalır.

Trendyol sipariş entegrasyonu: paket akışı ve iptal

Trendyol'da siparişler paket (shipment package) olarak işlenir. Geliştirici dokümanındaki sipariş akışına göre paket oluştuktan sonra satıcı paketi hazırlık (Picking) aşamasına alır, isteğe bağlı olarak faturalandı (Invoiced) bilgisini girer ve gönderime geçer. Bu akışta iki durum özellikle önemlidir:

• Tedarik edememe: Ürünü gönderemeyecekseniz siparişin tamamını ya da bir kısmını iptal edebilirsiniz. Kısmi iptalde mevcut paket iptal olur, aynı sipariş numarası altında yeni bir paket ve yeni bir kargo takip numarası oluşur.
• Paket bölme: Bir siparişteki ürünleri ayrı ayrı göndermek isterseniz paket bölünür; eski paket bozulur, yine aynı sipariş numarası altında yeni paketler oluşur.

Bu yüzden Trendyol sipariş entegrasyonunda takip edilmesi gereken şey sipariş numarası değil, paket numarasıdır. Kargo takip numarası ve fatura pakete bağlıdır. eticaretcim'de Trendyol siparişleri diğer kanallarla aynı listede Yeni, Hazırlanıyor, Faturalandı, Kargolandı ve Teslim aşamalarında izlenir; otomatik onay açılabilir, geciken siparişler için uyarı alırsınız. Liste ekranının ayrıntıları sipariş yönetimi sayfasında anlatılıyor.

Trendyol iade talebini onaylama ve reddetme

Müşteri iade talebi oluşturduğunda Trendyol, iade gerekçesini satıcıya iletir. Satıcı talebi onaylayabilir ya da gerekçesini seçerek ret talebi açabilir; ret kabul edilirse ürün müşteriye geri gönderilir. Panelde iadeler ve talepler ayrı bir kutuda toplanır, böylece hangi iadenin işlem beklediği gözden kaçmaz.

Trendyol kargo ve fatura entegrasyonu

Trendyol'un kargo dokümanı iki model tanımlar: Trendyol'un anlaşmalı kargosunun kullanıldığı model ve satıcının kendi kargo anlaşmasıyla gönderdiği model. Dokümanda her iki model için listelenen firmalar şunlardır:

• Aras Kargo, Yurtiçi Kargo, PTT Kargo, Sürat Kargo
• DHL eCommerce, Kolay Gelsin Kargo
• Horoz Lojistik, Ceva MP

Kendi sözleşmenizle çalışıyorsanız eticaretcim'de kargo firmanızı bağlar, birincil kargoyu seçer, barkod ve etiketi panelden alırsınız; takip numarası pazaryerine iletilir. Kargo kesintisi kontrolüyle beklenenden fazla kesilen kargo bedellerini de fark edersiniz. Kargo tarafının ayrıntıları için kargo entegrasyonu sayfasına bakabilirsiniz.

Fatura Trendyol'a nasıl iletilir?

Trendyol, satıcının kendi sisteminde oluşturduğu e-Arşiv ya da e-Fatura bağlantısını paket bazında almak için ayrı bir servis sunar. Dokümana göre bu bağlantılar 10 yıl boyunca erişilebilir kalmalıdır. Trendyol Yurt Dışı Aracılığı siparişlerinde e-Arşiv değil e-Fatura kesilmesi gerekir; mikro ihracat paketlerinde fatura numarası ve tarihi zorunludur.

Panelde siparişe otomatik e-Arşiv ya da e-Fatura kesebilir, faturayı kanalın desteklediği yolla Trendyol'a iletebilir, toplu fatura ve etiket alabilirsiniz. Bağlanabilen programlar e-Fatura ve e-Arşiv entegrasyonu sayfasında listeleniyor.

Trendyol komisyonu, hakediş ve sipariş bazında kâr kontrolü

Trendyol'da satış bedeli, komisyon ve kargo gibi kesintiler düşüldükten sonra hakediş olarak ödenir. Komisyon oranı kategoriye göre değişir ve zaman içinde güncellenebilir; ödeme takviminiz için de en doğru kaynak satıcı panelinizdeki finans ekranıdır. Bu yüzden genel bir oranla hesap yapmak yerine her siparişi kendi kesintisiyle değerlendirmek gerekir.

eticaretcim'in hakediş mutabakatı ekranı her sipariş için şunları gösterir:

• Sipariş bazında net kâr
• Beklenenden fazla kesilen komisyon ve fazla kargo kesintisi
• Ödenmemiş görünen hakedişler
• Zarar eden siparişler ve kanal karşılaştırması

Kampanya dönemlerinde zararına satışı erken fark etmek için bu ekranın nasıl çalıştığını hakediş ve komisyon kontrolü sayfasında görebilirsiniz.

Trendyol entegrasyonunda sık yapılan hatalar ve kontrol listesi

Entegrasyon sorunlarının büyük kısmı yazılımdan değil, ürün verisinden kaynaklanır. Bağlantıyı kurmadan önce ve kurduktan sonraki ilk günlerde şu noktaları kontrol edin:

1. Barkod tutarlılığı: Aynı ürün farklı kanallarda farklı barkodla açıldıysa eşleşme kurulamaz. Önce barkod ve stok kodlarını tek düzene getirin.
2. Varyant yapısı: Beden ve renk varyantlarının her biri ayrı barkod taşımalı; ana ürüne tek barkod vermek stok hatası doğurur.
3. Kategori özellikleri: Trendyol kategoriye özel zorunlu özellikler ister. Eksik özellik ilanın reddedilmesine yol açar; panelde reddedilen ilanın sebebini görebilirsiniz.
4. Elle müdahale: Entegrasyon açıkken stoğu Trendyol panelinden elle değiştirmek, bir sonraki güncellemede üzerine yazılabilir. Değişikliği tek yerden yapın.
5. Kritik stok: Son birkaç adette satış hızlanıyorsa kritik stok uyarısını kullanın ve stok çakışmaları listesini düzenli kontrol edin.

Çok kanallı satışta stok hatalarını önlemek için hazırladığımız aşırı satışı önleme rehberi bu listeyi daha ayrıntılı ele alıyor. Hangi paketin size uygun olduğunu görmek için fiyatlar sayfasına göz atabilirsiniz; Başlangıç paketinde tek kanal olarak Trendyol'u seçebilirsiniz.