Trendyol Entegrasyonu Nasıl Kurulur? API Anahtarından İlk Ürüne

Trendyol mağazanız açıldı ve ilk ürünleri panelden tek tek girdiniz. Ürün sayısı arttıkça stoğu iki yerde tutmak, siparişi bir ekranda görüp faturayı başka bir ekranda kesmek zorlaşır. Trendyol entegrasyonu bu işi kendi sisteminize bağlar: ürün sizden Trendyol'a gider, sipariş Trendyol'dan size gelir, stok iki tarafta aynı kalır.

Bu yazı entegrasyonu kurmanın sırasını anlatıyor: API anahtarını almaktan ilk ürünün yayına çıkmasına ve ilk siparişin panele düşmesine kadar. Henüz satıcı hesabınız yoksa önce Trendyol'da mağaza açma yazımıza bakın. Ters yönde, yani Trendyol'daki ürünleri kendi sitenize çekmek istiyorsanız Trendyol ürünlerini kendi mağazanıza taşıma rehberi o yolu anlatıyor.

Başlamadan önce: hesap, yetki ve ürün verisi

Entegrasyon ekranını açmadan önce üç şeyin hazır olması gerekir. Biri eksikse bağlantı ya hiç kurulmaz ya da ilk üründe takılır.

• Tamamlanmış satıcı başvurusu. Trendyol, adres servisinin açıklamasında satıcı başvuru süreciniz tam tamamlanmadıysa bu servisi kullanmamanızı istiyor. Önce başvuru ve sözleşme adımlarını bitirin.
• Ana kullanıcı erişimi. API bilgileri yalnız ana kullanıcıyla (admin rolü) giriş yapıldığında görünür. Mağazayı bir çalışanın hesabıyla yönetiyorsanız bu adımı hesap sahibi yapmalı.
• Temiz ürün verisi. Her varyant için benzersiz bir barkod, her model için bir model kodu, açıklama, görsel, KDV oranı ve stok adedi. Barkodunuz yoksa ya da tedarikçi barkoduyla çalışıyorsanız önce barkod ve GTIN rehberini okuyun.

Bir de karar var: entegrasyonu kendi yazılımınızla mı kuracaksınız, yoksa entegrasyonu içinde gelen bir altyapı mı kullanacaksınız? Bu kararın maliyet ve risk tarafını entegratör mü, entegrasyonlu altyapı mı yazısında karşılaştırdık. Aşağıdaki adımlar iki yolda da aynı sırayla yürür.

Adım 1: Trendyol API anahtarını alın

Trendyol'un yetkilendirme dokümanına göre üç bilgiye ihtiyacınız var: Satıcı ID, API Key ve API Secret. Üçü de satıcı panelinde, sağ üstteki mağaza adınızın altındaki Hesap Bilgilerim menüsünde, Entegrasyon Bilgileri bölümündedir.

• Paylaşmayın. Bütün entegrasyon işlemleri bu bilgilerle yapıldığı için Trendyol, anahtarın GitHub gibi açık platformlarda paylaşılmaması konusunda ayrıca uyarıyor. E-postayla ya da mesajla gönderdiyseniz kimin elinde olduğunu bilin.
• Aracı firma kimliği. Bir yazılım firmasıyla çalışıyorsanız her istekte firmanın adı User-Agent başlığında "Satıcı Id - Firma adı" biçiminde gider; yazılım size aitse firma adı yerine "SelfIntegration" yazılır. Bu bilgi olmayan istek 403 hatasıyla reddedilir.
• Test ortamı ayrıdır. Test ortamının hesap ve API bilgileri canlıdan tamamen farklıdır. Erişim için sunucu IP adresinizin Trendyol'a bildirilmesi ve çağrı merkezi üzerinden talep açılması gerekir. Kendi yazılımınızı geliştirmiyorsanız test hesabına ihtiyacınız yoktur.

Entegrasyonu kendi kodunuzla yazmayı düşünüyorsanız neyle karşılaşacağınızı Trendyol ürünlerini taşıma yazısında özetledik; bu rehber panelden kurulumu anlatır.

Adım 2: Kanalı bağlayın ve çalışma modunu seçin

Mubido'da bağlantı Pazaryeri › Satış Kanalları › + Yeni Kanal ekranından yapılır. Trendyol'u seçer, Supplier ID, API Key ve API Secret alanlarını doldurur, kanal kartındaki Test Bağlantı düğmesine basarsınız. Bilgileri kopyalarken baştaki ve sondaki boşluklara dikkat edin; bağlantı hatalarının en sık sebebi budur. Ekranlar adım adım pazaryeri bağlama rehberinde. Bağlantı testi geçince Trendyol'un kategori ağacı ve marka kataloğu çekilir.

Kanalı açarken iki moddan birini seçersiniz:

• İzleme: Mubido ilanları ve siparişleri yalnız okur, Trendyol'a hiçbir şey yazmaz. Trendyol'da zaten satış yapıyorsanız buradan başlayın. Mevcut ilanlarınız barkod ve stok koduyla ürünlerinize eşlenir; stoğu sıfırlamayacak eşleşmeler kendiliğinden bağlanır, gerisi onayınıza gelir.
• Yönetiliyor: ürün, stok ve isterseniz fiyat Mubido'dan gider. Yeni bağlanan kanalda fiyat gönderimi kapalı başlar. Stok senkronu ise bilerek kapatılamaz; bir kanalda satılan ürün bütün bağlı mağazalarda düşer.

Sahada gördüğümüz en pahalı hata, modu erken değiştirmek. Yönetim modunda Mubido Trendyol'dan stok okumaz; kendi kaydını doğru kabul eder ve düzenli taramada bunu Trendyol'a yazar. Bir mağazada kanal, Mubido'daki stoklar Trendyol'daki gerçek sayılarla eşitlenmeden yönetime alındı. Sonraki taramada Trendyol panelinden kapatılmış bedenler yeniden satışa açıldı, açık bedenlerin bir kısmı kapandı. Doğru sıra şudur: izleme modunda bağlayın, stokları gerçek sayımla eşitleyin, fiyat kararını verin, sonra yönetime geçin.

İki ayrı Trendyol mağazanız varsa ikisini de ayrı adlarla bağlayabilirsiniz; her birinin siparişi ve stoğu ayrı izlenir.

Adım 3: Kargo, teslim süresi ve fiyat kuralını ayarlayın

Ürün göndermeden önce kanalın gönderim ayarları tamam olmalı. Trendyol'un kargo firmaları sayfası iki modeli ayrı listeler: Trendyol'un anlaşmalı olduğu ve ücretini Trendyol'un ödediği gönderiler ile satıcının kendi anlaşmasıyla yaptığı gönderiler. Hangisiyle çalıştığınızı satıcı panelinizden kontrol edin.

• Kargo şirketi: Mubido'da kanal ayarlarındaki Gönderim / Kargo bölümünden seçilir. Bu alan boş kaldığı için Trendyol'a yeni ürün açamayan kanallar gördük; panel artık alan boşken uyarıyor ve kurulumda eksik olarak gösteriyor.
• Sevkiyat süresi: Trendyol'un ürün yaratma kurallarına göre ürün bazında sevkiyat süresi gönderilmezse hesabınızdaki varsayılan termin süresi uygulanır. Ağustos 2026'dan beri "Bugün Kargoda" için 0, "En Geç Yarın Kargoda" için 1 değeri kullanılıyor.
• Sevkiyat ve iade adresi: Ürüne sevkiyat ve iade deposu bağlanabilir; adres kimlikleri Trendyol panelinde tanımladığınız adreslerden gelir. Birden çok deponuz varsa adresleri bağlantıdan önce Trendyol panelinde tamamlayın.
• Fiyat kuralı: Trendyol komisyonunu ve desiye göre kargo payını kanal ayarına bir kez girersiniz; pazaryeri fiyatı (fiyat + kargo) ÷ (1 − komisyon) ile hesaplanır. Kategoriye özel komisyon ve ürüne özel elle fiyat da tanımlanabilir. Rakamları önce Trendyol komisyon hesaplama aracında deneyin; net kârın tamamı Trendyol'da kâr hesaplama yazısında.

Trendyol siparişlerinin kargo etiketini Mubido'dan basmak istiyorsanız bir izin daha gerekir. Trendyol etiketi dışarıya yalnız ortak etiket servisinden verir ve bu servis satıcı hesaplarında kapalı gelir. Yetkiyi, satıcı panelinden açacağınız destek talebiyle Trendyol tanımlar. Ayrıntılar sipariş ve kargo etiketi rehberinde.

Adım 4: Kategori, marka ve özellikleri eşleyin

Trendyol, ürün yaratma isteğinden önce marka listesinin, kategori listesinin, kategori özelliklerinin ve özellik değerlerinin servislerinden alınmasını istiyor. Yani ürününüzü Trendyol'un kimlikleriyle tarif etmeniz gerekir: kategori bir kimliktir, marka bir kimliktir, renk ve beden gibi özellikler de çoğunlukla bir değer kimliğidir.

• Kategori: en alttaki (yaprak) kategori seçilir. Zorunlu özellikler bu seçime göre değişir.
• Marka: Trendyol yalnız kendi marka kataloğundaki markaları kabul eder. Markanız listede yoksa önce Trendyol satıcı panelinden marka başvurusu yaparsınız; entegrasyondan yeni marka açılamaz.
• Varyant yapısı: aynı modelin bedenleri aynı model kodunu (productMainId) taşır. Trendyol'da renk gibi "slicer" özellikler ürünü ayrı sayfalarda açar; beden gibi "varianter" özellik aynı sayfada seçenek olur. Bir kategoride yalnız bir varianter seçilebilir.

Mubido'da kategorileriniz Trendyol kategorilerine yapay zekayla önerilir, siz onaylarsınız; eksik zorunlu özellikler varsayılanlardan ve kategori yolundan doldurulur. Önerileri onaylamadan önce hedef kitleye bakın: çocuk ürünlerinin yetişkin rafına önerildiğini gördüğümüz oldu. Ekranın kullanımı kategori ve marka eşleştirme rehberinde. Bu adımın neden bu kadar vakit aldığını ve toplu eşleştirmede çalışma sırasını kategori ve marka eşleştirme yazısında anlattık. Bir modelin renklerini tek ilan altında toplamak için ürün gruplama rehberine bakın.

Adım 5: İlk ürünü seçin ve gönderin

Bütün kataloğu birden göndermeyin. Varyantlı, görselleri hazır, kategorisi net bir model seçin ve önce onu gönderin. İlk üründe çıkan hata, toplu gönderimde yüzlerce satırda tekrar eder.

Trendyol'un ürün yaratma kuralları bir ürünün hangi alanlarla gitmesi gerektiğini yazıyor. İlk gönderimde en çok takılan alanlar şunlar:

Açıklama satırı sahadan geliyor: uzun açıklaması boş, yalnız kısa açıklaması dolu ürünlerin Trendyol'a gitmediğini gördük. Mubido artık uzun açıklama yoksa kısa açıklamayı kullanıyor, ama ilk gönderimden önce açıklamanın dolu olduğuna yine de bakın.

Mubido'da her ürün gönderilmeden önce Trendyol kurallarına göre denetlenir. Hatalı ürün gönderilmez ve sebebi panelde gösterilir. İlk ürün sorunsuz geçince seçtiğiniz ürünleri ya da mağazanın tamamını toplu gönderirsiniz.

Adım 6: Onay sürecini ve gönderim sonucunu okuyun

Gönderim isteğinin kabul edilmesi, ürünün yayında olduğu anlamına gelmez. Trendyol'a göre başarılı bir aktarımdan sonra ürün onay sürecine girer; onayı süren ya da reddedilen ürün yayına çıkmaz. Yayına alınma süresini Trendyol belirler.

Her toplu istek bir işlem numarası (batchRequestId) döndürür. Toplu işlem kontrolü servisi bu numarayla işin bitip bitmediğini ve hangi kalemin neden hata aldığını gösterir. Trendyol ürün ve stok-fiyat işlemlerinin sonucunu dört saat boyunca gösteriyor. Kendi yazılımınızı kullanıyorsanız sonucu bu süre içinde okuyup kaydedin; yoksa "gönderdim ama yok" durumunun sebebini sonradan bulamazsınız.

Mubido bu adımı sizin yerinize yapar. Gönderimin kabul ve ret sonucu Trendyol'dan geri okunur, reddedilen ürünler sebebiyle Sorunlar listesine düşer; düzeltip yeniden gönderirsiniz. Aynı ürünü ikinci kez göndermek ikinci bir ilan açmaz, çünkü Mubido önce ürünün Trendyol'da olup olmadığına bakar. En yaygın ret mesajlarını ve düzeltmelerini pazaryerinde ürün neden reddedilir yazısında topladık.

Adım 7: İlk siparişte akışı uçtan uca doğrulayın

Ürün yayına çıktı. Entegrasyonun asıl sınavı ilk siparişte olur. İlk siparişte şu sırayı kontrol edin:

1. Sipariş listeye düştü mü? Trendyol siparişleri 5 dakikada bir çekilir ve web mağaza siparişleriyle aynı listede görünür.
2. Stok her kanalda düştü mü? Satış, iade ya da elle düzeltme bağlı kanallara kendiliğinden gider; ayrıca 6 saatte bir kontrol taraması yapılır. Canlı bir mağazada yaptığımız ölçümde panelde değiştirilen stok, Trendyol tarafında 40 saniyeden kısa sürede göründü.
3. Paket işleme alındı mı? Mubido'dan işleme aldığınızda paket Trendyol'da "Picking" durumuna geçer.
4. Etiket ve fatura çıktı mı? Kargo etiketi PDF olarak basılır (ortak etiket yetkisi varsa). Kestiğiniz e-faturanın bağlantısı ilgili Trendyol paketine iletilir.

Kendi yazılımınızı kullananlar için bir uyarı: Trendyol, 15 Ekim 2026'dan itibaren sipariş paketlerini yeni (v2) servisten veriyor. Yeni serviste geriye dönük en fazla bir aylık sipariş sorgulanabiliyor, tarih aralığı en fazla iki hafta olabiliyor ve bir istekte en çok 200 paket dönüyor. Bir paketteki kalemlerden biri iptal edilirse sipariş numarası aynı kalır, ama paket yeni bir kimlik ve yeni bir kargo barkoduyla yeniden oluşur. Siparişi eski paket kimliğine bağlayan yazılım bu değişikliği kaçırır. Mubido'da liste penceresinin dışında kalmış eski bir siparişi sipariş numarasıyla içe alabilirsiniz.

İki kanalda aynı ürünü satarken stoğun neden kayabileceğini ve nasıl önlendiğini stok senkronizasyonu ve oversell yazısında anlattık.

Kurulumu kim yapar?

Yukarıdaki yedi adım, entegrasyonu kendiniz kuruyormuş gibi yazıldı; her adımda neye bakacağınızı bilmeniz için. Mubido'da Trendyol kanalının bağlantısını, kategori eşleştirmesini ve ilk ürün aktarımını kurulum sürecinde biz yapıyoruz. Siz API bilgilerinizi verir, eşleştirme önerilerini ve yönetim moduna geçişi onaylarsınız.

Trendyol bağlantısında hangi işin Mubido'dan, hangisinin Trendyol panelinden yürüdüğünün tam listesi Trendyol entegrasyonu sayfasında. Aynı panelden diğer pazaryerlerinin nasıl bağlandığını pazaryeri entegrasyonu sayfasında görebilirsiniz.