Giriş

Duyurular !

Tedarik Edememe Servisi'ne ait endpoint ve body güncellenmiştir. 31 Ağustos 2021 tarihine kadar eski ve yeni servis beraber aktif durumda olacaktır. 31 Ağustos sonrasında eski servis kullanıma kapatılacaktır. Sistemlerinizi yeni servis ile çalışacak şekilde revize etmeniz gerekmektedir. Bu değişiklikten yemek ve market entegrasyonları etkilenmeyecektir.

Trendyol teslimatlarına ait “7” ile başlayan 13 haneli kargo barkod numaraları, barkod havuzumuzdan belirli bir kural ile üretilerek kargo firmasına teslimat oluşturma anında iletilmektedir. Ağustos ayı içerisinde kargo barkodlarında hane artışına gidilecek ve kargo barkodları 16 haneli olarak oluşturulmaya başlanacaktır.

Yeni muhasebe servisimiz yayındadır. İncelemek için muhasebe entegrasyonu bölümüne göz atabilirsiniz.

Trendyol API Entegrasyonu Nedir & Ne İşe Yarar ?

Trendyol API Entegrasyonu, Trendyol Partner Programı’na (Marketplace) katılan firmaların Trendyol API servisleri aracılığıyla Trendyol mağazalarını kendi e-ticaret sistemlerine bağlayarak ürün aktarımı, stok ve fiyat güncellemesi, sipariş işlemleri, fatura gönderimi ,müşteri soruları işlemleri gibi bir çok işlemi yapmasına olanak sağlar.

API Bağlantısının Kurulması (Authorization)

Authorization için basic auth kullanılacaktır.

Canlı ortamda kullanacağınız basic auth için gerekli API kullanıcı bilgilerinize satıcı paneliniz üzerinde yer alan “Hesap Bilgilerim” menüsü içerisindeki “Entegrasyon Bilgileri” başlığından ulaşabilirsiniz.

1 Ocak 2021 itibari ile Trendyol Partner API ‘ye yapılacak bütün isteklerde Header'da Auth ve User-Agent bilgilerinin bulunması zorunludur.

User-Agent bilgisi olarak aracı bir firma ile çalışılıyor ise "Satıcı Id - {Entegrasyon Firması İsmi}" , entegrasyon yazılımı firmaya ait ise "Satıcı Id - SelfIntegration" gönderilmelidir.

Örnek 1 :

  • SatıcıId : 1234
  • Entegratör firma ismi : TrendyolSoft
  • Gönderilecek user-agent bilgisi : "1234 - TrendyolSoft"

Örnek 2 :

  • SatıcıId : 4321
  • Entegratör firma yok. Yazılım firmaya ait.
  • Gönderilecek user-agent bilgisi : "4321 - SelfIntegration"

NOT: Entegratör firma isminizi alfanumerik karakterler ile maksimum 30 hane olacak şekilde gönderiniz.

User-Agent bilgisi gönderilmeyen istekler 403 hatası dönecek şekilde blocklanacaktır.

Trendyol API Servis İstek Sınırlaması

Trendyol Partner API'ye yapacağınız tüm isteklerde aynı endpointe 10 saniye içerisinde maksimum 50 request atabilirsiniz. 51. requesti denediğiniz an sizlere "429 status code and it say too.many.requests" hatası dönecektir.

1 Şubat 2021 itibari ile API entegrasyon getOrders servislerine yapılacak isteklerde "size" parametresine verilebilecek maksimum değer : 50 , "page" parametresine verilebilecek maksimum değer : 10000 olarak sınırlandırılacaktır. "size" ve "page" limitini aşan isteklere status:400 hatası dönecektir.

CANLI ORTAM BİLGİLERİ

Canlı ortamda herhangi bir IP yetkilendirmesine gerek bulunmamaktadır.

Satıcı ID ve API Key bilgilerinize Trendyol Satıcı Paneli üzerinden sağ üstte bulunan Mağaza Adınıza > Hesap Bilgilerim menüsüne tıklayarak ulaşabilirsiniz.

Canlı ortam endpoint bilgisi :

https://api.trendyol.com/sapigw/

TEST ORTAMI BİLGİLERİ

Test ortamı hesap ve API bilgileriniz canlı ortam bilgilerinizden tamamen farklıdır.

1. Adım : Test ortamına erişebilmek için uygulama sunucularının IP bilgileri Trendyol tarafına bildirilerek erişim tanımı yapılmalıdır. Birden fazla IP tanımı yapılabilir, tanımlanan IP ler daha sonra bildirilmesi halinde güncellenebilir.

NOT : Test ortamı talebi ve IP yetkilendirmesi işlemleri için 0850 258 58 00 numaralı çağrı merkezi üzerinden satıcı bildirimi oluşturmanız gerekmektedir.

NOT : Test ortamında alacağınız 503 hatası IP yetkilendirmesi olmamasından kaynaklıdır.

2. Adım (IP yetkilendirmesi gerektirmektedir) : Test ortamı için ortak test hesabını kullanabilir veya buradan kendi test mağazanızı oluşturabilirsiniz.

Ortak test hesabı bilgileri için 0850 258 58 00 numaralı çağrı merkezi üzerinden satıcı bildirimi oluşturmanız gerekmektedir.

API bilgilerinize stage partner sayfasınızda her alan "Hesap Bilgilerim" bölümünden ulaşabilirsiniz.

3. Adım (IP yetkilendirmesi gerektirmektedir): Testlerinizi test mağaza API bilgileri ile kendi yazılımınız üzerinden veya POSTMAN aracılığı ile örnek collection kullanarak yapabilirsiniz.

Örnek Collection : https://www.getpostman.com/collections/f9b539a8c0473552e56e

Collection dosyasını Postman > Import > Link yolu ile ekleyebilirsiniz.

Stage Trendyol Paneli: https://stagepartner.trendyol.com/account/login

Test ortamı endpoint bilgisi : https://stageapi.trendyol.com/stagesapigw/