Trendyol entegrasyonu, mağazanızın stok, fiyat, sipariş ve kargo bilgisinin Trendyol satıcı paneline elle girilmek yerine kendi yazılımınızla Trendyol'un API'si arasında otomatik taşınmasıdır. Bağlantı Satıcı ID, API anahtarı ve API parolasıyla kurulur; stok ve fiyat toplu istekle gider, siparişler aralıkla çekilir, takip numarası geri yazılır.
Trendyol entegrasyonu ne işe yarar
Trendyol'da satan bir firma entegrasyon olmadan üç işi elle yapar. Depodaki sayım değiştikçe ilanların stoğunu panelden günceller. Gelen siparişi panelden okuyup kendi programına yeniden yazar. Kargoya verdiği paketin takip numarasını tek tek Trendyol'a girer. Mağaza büyüdükçe bu üç iş günün bir bölümünü alır ve hataların çoğu buradan çıkar: aynı stoktan bayiye de satan firmada son ürün iki kanala birden satılır.
Entegrasyon bu üç işi yazılıma devreder. Aşağıdaki tablo farkı özetliyor.
| İş | Elle | Entegrasyonla |
|---|---|---|
| Stok ve fiyat | Panelde ilan ilan güncellenir | Seçilen aralıkla, yüzlerce ilan tek istekte gider |
| Sipariş | Panelden okunur, programa yeniden yazılır | Aralıkla çekilir, stok aynı anda otomatik ayrılır |
| Kargo | Takip numarası tek tek girilir | Sevkiyat kapanınca numara Trendyol'a yazılır |
Başlamadan önce hazırlanacaklar
Bağlantıyı kurmadan önce şu dört şeyin hazır olması ilk gönderimi kolaylaştırır:
- Trendyol'da açık ilanlar. Entegrasyon çoğu zaman var olan ilanı günceller; yeni ilan açma ve kategori eşleştirme ayrı bir iştir ve BayiData'da bugün yok.
- Her ilanın barkodu. Trendyol stok ve fiyat satırını barkodla tanır; barkodu olmayan ilan gönderilmez.
- Fiyat kuralı. Trendyol'da yazan fiyat KDV dahildir. Fiyat listeniz KDV hariçse aradaki hesabın nerede yapılacağına karar verin.
- Kargo düzeni. Trendyol'un anlaşmalı kargosunu mu, kendi kargo anlaşmanızı mı kullandığınız kargo bildiriminin gerekip gerekmediğini belirler.
Birden çok mağaza ve depo
Aynı firmanın birden çok Trendyol mağazası olabilir. Her mağaza kendi Satıcı ID'si ve anahtarıyla ayrı bir hesap olarak bağlanır; birinin hatası ötekinin gönderimini durdurmaz. Her hesaba stoğun hangi depodan gideceği ayrıca yazılır. Depo seçilmezse bütün depoların kullanılabilir toplamı gider; tek bir depodan Trendyol'a çalışıyorsanız o depoyu seçmek, bayiye ayrılan stoğun pazaryerine görünmesini önler.
Adım 1: Trendyol API bilgilerini alın
Trendyol API entegrasyonu üç bilgiyle kurulur: Satıcı ID, API anahtarı ve API parolası. Satıcı ID'yi satıcı panelinde (partner.trendyol.com) Hesap Bilgileri bölümünde görürsünüz. API anahtarı ve parolası da satıcı panelinden alınır; menüdeki yeri panel güncellendikçe değişebildiği için burada bir menü yolu vermiyoruz.
Anahtar ve parola, mağazanızda stok ve fiyat değiştirme yetkisi taşır. Onları e-postayla dolaştırmayın, yalnız entegrasyon ekranına yazın. Bir çalışanınız ayrıldığında ya da anahtarın başka birinin eline geçtiğinden şüphelendiğinizde yenisini alıp entegrasyondaki eskisini değiştirin.
Adım 2: Kimlik doğrulama ve User-Agent kuralı
Trendyol isteklerinde kimlik HTTP Basic ile gider: kullanıcı adı yerine API anahtarı, parola yerine API parolası. Bunun yanında Trendyol, satıcı kimliğinizi taşıyan bir User-Agent başlığı bekler. BayiData bu başlığı “SatıcıID - SelfIntegration” biçiminde gönderir. Trendyol entegrasyonu bu başlıktan tanıyor; başlık eksik olduğunda istekler kısıtlanabiliyor.
Kendi entegrasyonunu yazan ekiplerin en sık atladığı ayrıntı bu başlıktır. İkinci ayrıntı adres: Trendyol ağ geçidini geçmişte değiştirdi; eski belgelerde api.trendyol.com/sapigw geçer, güncel adres apigw.trendyol.com/integration. BayiData'da adres değişirse kod değiştirmeden düzeltilebiliyor.
Adım 3: Stok ve fiyat gönderimi
Stok ve fiyat tek istekte, ilan listesi olarak gider. Her satırda dört alan vardır: barcode, quantity, salePrice ve listPrice. salePrice satış fiyatı, listPrice üstü çizili fiyattır ve ikisi de zorunludur. İkisine farklı tutar yazmak vitrinde indirim görüntüsü üretir; BayiData ikisine aynı tutarı yazar ve kampanya kararını size bırakır.
Trendyol bu isteği eşzamansız işler. Cevapta satır sonuçları yoktur, yalnız bir batchRequestId vardır. Hangi barkodun güncellendiği, hangisinin neden reddedildiği o kimlikle ayrıca sorulur. Sonucu sormayan bir entegrasyon reddedilen ilanı “gönderildi” sanar.
Gönderilecek stoğun hesabı da önemlidir. Depodaki miktarın tamamını göndermek yerine şu hesap yapılır:
- Kullanılabilir stok = fiziksel stok − bayi ve pazaryeri siparişleri için rezerve edilen miktar.
- Gönderilen stok = kullanılabilir stok − emniyet payı. Sonuç sıfırın altına inmez.
- Gönderilen fiyat = fiyat listesindeki tutar + kâr payı + KDV. İlana özel fiyat verdiyseniz o, KDV dahil kabul edilip olduğu gibi gider.
BayiData bu hesabı göndermeden önce gösterir: “şimdi gönderilse ne gider” önizlemesinde her ilanın gidecek stoğu ve fiyatı satır satır görünür. İlanlar yüzerli parçalar hâlinde gider; her parçanın sonucu bir dakika sonra sorulur, hazır değilse soru artan aralıklarla en çok on kez tekrarlanır.
Adım 4: Trendyol siparişlerini çekme
Sipariş çekmenin iki kuralı var. Birincisi, yalnız henüz kargolanmamış siparişleri istemek: Trendyol'da bunlar Created ve Picking durumundaki paketlerdir. Kargoya verilmiş ya da iptal edilmiş siparişi yeni diye almak depoya olmayan bir iş verir. İkincisi, her turda bütün geçmişi değil, en son alınan siparişten sonrasını istemek. Trendyol başlangıcı milisaniyelik zaman damgası olarak bekler.
Sipariş satırını okurken iki alan karışır. Satırın price alanı müşterinin indirimlerden sonra ödediği birim fiyattır; faturaya bu yazılmalıdır. vatBaseAmount alanı ise adına rağmen tutar değil KDV oranıdır (10, 20 gibi). Onu tutar sanıp bölen bir aktarım fiyatı bozar.
Aynı sipariş birden çok turda gelebilir. Sipariş numarasıyla tekil kayıt tutulmazsa stok iki kez düşer. BayiData aynı pazaryeri siparişini ikinci kez açmaz; ilk çekimde bir hafta geriye bakar.
Adım 5: Kargo bildirimi
Trendyol siparişi paket düzeyinde tanır ve paket numarası sipariş numarasından farklıdır. Takip numarası paket numarasıyla yazılır; bu yüzden paket numarası sipariş çekilirken saklanmalıdır.
Bildirimin gerekip gerekmediği kargo düzeninize bağlıdır. Trendyol'un anlaşmalı kargosunu kullanıyorsanız takip numarasını Trendyol üretir ve bildirim gerekmez. Kendi kargo anlaşmanızla gönderiyorsanız numara sizden gider. Bildirim sipariş başına bir kez yapılmalıdır: iki kez bildirmek pazaryerinde çift kargo kaydı açar.
Sık karşılaşılan hatalar
| Belirti | Olası sebep | Ne yapılır |
|---|---|---|
| İstekler reddediliyor ya da kısıtlanıyor | User-Agent başlığı eksik ya da Satıcı ID yanlış | Başlığın satıcı kimliğiyle gittiğini, Satıcı ID'nin doğru yazıldığını kontrol edin |
| Gönderim hep “kabul edildi” kalıyor | Toplu isteğin sonucu sorulmuyor | batchRequestId ile satır sonuçlarını sorun |
| Bir ilan reddedildi | Barkod Trendyol'daki ilanla eşleşmiyor ya da başka bir kural | Trendyol'un satır için verdiği sebebe göre ilanı düzeltin |
| Sipariş iki kez düştü | Sipariş numarasıyla tekil kayıt tutulmuyor | Aynı siparişi ikinci kez açmayın |
| Kargolanmış sipariş yeni gibi geldi | Durum süzmesi yapılmamış | Yalnız Created ve Picking durumlarını isteyin |
| Faturadaki tutar müşterinin ödediğinden farklı | Kampanya öncesi tutar alınmış | Satırın price alanını kullanın |
| KDV tutarı tutarsız | vatBaseAmount tutar sanılmış | Alanı KDV oranı olarak okuyun |
| Takip numarası yazılamıyor | Sipariş numarası gönderilmiş ya da Trendyol'un anlaşmalı kargosu kullanılıyor | Paket numarasını kullanın; anlaşmalı kargoda bildirim gerekmez |
Kendi kodunuz mu, ayrı bir entegratör mü, iş yazılımınızın bağlantısı mı?
Trendyol entegrasyonu üç yoldan kurulur ve her birinin bedeli farklı yerde ödenir.
- Kendi geliştirmeniz: API'yi kendi ekibiniz yazar. Yukarıdaki ayrıntıların hepsi (User-Agent, toplu isteğin sonucunu sormak, paket numarası, KDV oranı alanı) sizin sorumluluğunuzdadır ve Trendyol API'yi değiştirdiğinde kodu siz güncellersiniz.
- Ayrı bir pazaryeri entegratörü: stok ve sipariş Trendyol ile entegratör arasında akar; entegratörün de muhasebe programınıza ya da bayi sisteminize bağlanması gerekir. Stok iki yazılım arasında bir kez daha taşınır.
- İş yazılımınızın içindeki bağlantı: bayi siparişini, stoğu ve cariyi tutan yazılım Trendyol'a doğrudan bağlanır. Rezervasyon aynı kayıtta olduğu için bayiye ve Trendyol'a satılan stok aynı anda düşer.
Hangi yol seçilirse seçilsin, bu yazıdaki beş adım değişmez. Değişen, o adımların kimin elinde olduğudur.
BayiData'da Trendyol bağlantısı adım adım
- Pazaryerleri ekranında Trendyol hesabı eklenir; Satıcı ID, API anahtarı ve API parolası yazılır. Anahtar ve parola bir daha ekranda gösterilmez.
- Sına düğmesine basılır. Bağlantı doğruysa mağazada kaç ürün görüldüğü yazar.
- Mağaza hesabına stoğun hangi depodan, fiyatın hangi listeden gideceği, kâr payı ve emniyet payı yazılır. Aynı pazaryerinde birden çok mağaza ayrı hesap olur.
- Trendyol'daki ilanlar katalogdaki ürünlerle barkod üzerinden eşleştirilir.
- Önizlemede gidecek stok ve fiyat kontrol edilir, ilk gönderim yapılır ve sonuç satır satır okunur.
- Stok gönderimi ve sipariş çekme için aralık seçilir; en sık beş dakikada bir.
Bağlayıcı Trendyol'un entegrasyon belgesine göre yazıldı ve gerçek bir mağaza hesabıyla henüz sınanmadı. İlk gönderimi kurulumda sizin anahtarınızla birlikte yapıyoruz. Hangi işlemin çalıştığı, hangisinin çalışmadığı Trendyol entegrasyonu sayfasındaki tabloda; öteki pazaryerleriyle birlikte tek stoktan satışın anlatımı pazaryeri entegrasyonu sayfasında.