Trendyol Entegrasyonu

Trendyol entegrasyonu, kendi e-ticaret altyapınız ile Trendyol Satıcı (Marketplace) API'si arasında otomatik veri alışverişi kuran yazılım katmanıdır. Trendyol'un kendi ifadesiyle bu servisler ürün aktarımı, stok ve fiyat güncellemesi, sipariş işlemleri ve fatura gönderimi için tasarlanmıştır. Pratikte entegrasyonun üstlendiği is su şekilde dağılır:

Önemli sınır: Entegrasyon, Trendyol'un kategori kurallarını, komisyon oranlarını veya ürün onay sürecini değiştirmez. Komisyon oranını Trendyol belirler, entegrasyon yalnızca bu veriyi okur ve raporlar.

Trendyol, entegrasyon servislerini tek bir ana alan adi üzerinden sunar: https://apigw.trendyol.com. Test (stage) ortami ise https://stageapigw.trendyol.com adresindedir. Servisler islevlerine göre gruplanmistir; entegrasyon yazan tarafin bilmesi gereken ana gruplar sunlardir:

Trendyol servisleri surumluyor. Duyurulan takvime göre ürün servisleri 15 Eylul 2026, sipariş ve paket servisleri 15 Ekim 2026 tarihine kadar V2 surumlerine tasinmaktadir. Guncel uc nokta listesi için developers.trendyol.com/reference referans alinmalidir.

1. Trendyol satıcı hesabinin acik ve onayli oldugunu dogrulayin

Entegrasyon, var olan bir Trendyol satıcı hesabinin uzerine kurulur. Magaza acilisi, vergi ve kategori onaylari tamamlanmadan API anahtarı uretilmez. Bu asama Trendyol Satıcı Merkezi tarafindadir, yazılım tarafi bir sey yapamaz.

2. API anahtarı ve gizli anahtarı alin

Trendyol dokumantasyonuna göre API bilgileri satıcı panelinde Hesap Bilgilerim > Entegrasyon Bilgileri sayfasindadir (partner.trendyol.com/account/info sayfasindaki Entegrasyon Bilgileri sekmesi). Buradan Satıcı ID (sellerId / supplierId), API Key ve API Secret Key alınır. Dikkat: bu ekranı yalnızca hesabin yetkili (master) kullanicisi gorebilir. Alt kullanicilar bu sayfayi acamaz.

3. Kimlik dogrulama ve User-Agent basligini kurun

Trendyol servisleri HTTP Basic Authentication kullanir: API Key ve API Secret Key ikilisi Base64 kodlanip Authorization basliginda gönderilir, satıcı ID ise adres yolunun icinde yer alir. Ikinci zorunlu baslik User-Agent'tir ve formati sabittir: entegrasyon firmasi üzerinden calisiyorsaniz {SellerId} - {EntegrasyonFirmaAdi}, kendi yazdiginiz entegrasyonu kullaniyorsaniz {SellerId} - SelfIntegration. Firma adi alfanumerik ve en fazla 30 karakter olmalidir. Bu baslik dogru gonderilmezse istekler reddedilir; sahada en sık goz ardi edilen ayrinti budur.

4. Kategori, marka ve ozellik (attribute) eslestirmesini yapin

Trendyol'da her kategorinin kendi zorunlu ozellik seti vardir. Kendi sitenizdeki kategori agacini Trendyol kategori ID'lerine, marka adlarinizi Trendyol marka ID'lerine, renk/beden gibi varyant alanlarinizi da kategorinin attribute ID'lerine eslemeniz gerekir. Bu eşleştirme bir kez dogru kurulursa sonraki tum ürün gonderimleri sorunsuz ilerler; yanlis kurulursa urunler surekli reddedilir.

5. Urunleri toplu gonderin ve batch sonucunu okuyun

Ürün gönderimi asenkrondur. Istek kabul edildiginde Trendyol size bir batchRequestId doner; urunun gercekten acilip acilmadigini bu numarayla sorgulanan batch sonucundan ogrenirsiniz. Yalniz HTTP 200 gordugu için ürün acildi varsayan entegrasyonlar, reddedilen urunleri fark etmez. Dogru akis: gonder, batchRequestId'yi kaydet, sonucu sorgula, hatali kalemleri raporla.

6. Stok ve fiyat senkronunu devreye alin

Urunler onaylandiktan sonra stok ve fiyat servisi barkod bazında çalışır. Bu servis urunun icerigini değiştirmez; yalnızca adet, satış fiyatı ve liste fiyatı gunceller. Ilk gun senkronu tek yönlü (site to Trendyol) baslatip dogruluk teyit edildikten sonra çift yönlü calistirmak en guvenli yontemdir.

7. Sipariş, iade ve fatura akislarini acin

Sipariş servisi paketleri ceker, durum güncellemesi (Picking, Invoiced, Shipped vb.) aynı servis grubundan yapilir. İade tarafinda claim servisi çalışır. Fatura tarafinda ya fatura baglantisi (link) gönderilir ya da fatura dosyası yüklenir. Bu uc akis genelde en sona birakilir cunku muhasebe tarafiyla mutabakat gerektirir.

8. Once test ortaminda dogrulayin

Trendyol'un ayrı bir stage ortami vardir: https://stageapigw.trendyol.com ve panel olarak stagepartner.trendyol.com. Test ortaminda IP yetkilendirmesi zorunludur; sunucu IP adresiniz Trendyol tarafindan tanimlanmadan yapilan istekler 503 doner. Test hesabi bilgileri canli hesaptan tamamen farklidir ve Trendyol destek hattindan talep edilir.

Entegrasyonun kaderini belirleyen tek alan vardir: barkod. Trendyol tarafinda ürün kimligi barkod üzerinden kurulur, stok ve fiyat guncellemeleri de barkod ile yapilir. Bu yuzden eşleştirme kurgusu bastan dogru olmalidir.

Mevcut urunleriniz Trendyol'da zaten aciksa sifirdan ürün gondermeniz gerekmez. Dogru yontem, Trendyol'daki urunleri ürün listeleme servisiyle cekip barkod veya stok kodu üzerinden kendi katalogunuzla eslestirmek, ardindan yalnızca stok ve fiyat senkronunu acmaktir. RapiSoft'ta bu adım toplu eşleştirme ekraniyla yapilir; eslesmeyen kalemler ayrı listede birakilir, korlemesine ürün acilmaz.

Cift yönlü senkron ifadesi cogu zaman yanlis anlasilir. Trendyol tarafinda gerçekte iki farkli akis vardir:

• Site to Trendyol (yazma): Stok adedi ve fiyat, stok-fiyat servisi ile Trendyol'a yazılır. Bu akis sizin kontrolunuzdedir.
• Trendyol to Site (okuma): Sipariş, iade, ürün onay durumu, komisyon ve hakediş verisi Trendyol'dan çekilir. Trendyol'da olusan satış, sitenizdeki stoğu düşer.

Yani stok pratikte tek havuzdan yönetilir: Trendyol'dan gelen sipariş merkezi stoğu dusurur, dusen stok bir sonraki yazma turunda Trendyol'a geri yansir. RapiSoft'ta calisma periyotlari magazanin ürün adedine ve sipariş hacmine göre ayarlanir; varsayilan olarak kurulan duzen sudur:

Bu degerler sabit bir kural degil, baslangic ayaridir. Trendyol servis limitleri asilmadigi surece periyotlar kisaltilabilir; çok yuksek ürün adedi olan kataloglarda ise limitler nedeniyle daha uzun periyot daha saglikli çalışır.

Trendyol, API kullanimini iki katmanda sinirlar. Birincisi genel kural: Trendyol dokumantasyonuna göre aynı uc noktaya 10 saniye icinde en fazla 50 istek gonderilebilir, asildiginda 429 hatasi dondurulur. Ikincisi servis grubu bazli dakikalik limitlerdir ve satıcı seviyesine göre degisir. Duyurulan degerlerden bazilari:

Limit grup bazında uygulanir. Trendyol'un kendi ornegiyle: ürün yazma grubunda dakikada 200 istek limiti varsa, ürün aktarma + ürün guncelleme + ürün silme servislerinden aynı dakika icinde toplamda en fazla 200 istek yapilabilir. Bu yuzden ciddi bir entegrasyonda kuyruk, geri cekilme (exponential backoff) ve toplu istek mantigi zorunludur; her ürün için tek tek istek atan bir kurgu büyük katalogda hizla 429'a takilir.

Sipariş akisi

Trendyol'da sipariş birimi paket (shipment package)tir. Bir musteri siparisi birden fazla pakete bolunmus olabilir. Entegrasyon paketleri ceker, kendi sipariş ekraninizda gosterir ve durum guncellemelerini geri yazar. Paket durumu Trendyol tarafinda gecerli olan sirayla ilerler; sirayi atlayan guncellemeler kabul edilmez.

Paket bolme ve tedarik edememe

Paketteki kalemlerden birini gonderemiyorsaniz iki secenek vardir: paketi barkod veya adet bazında bolup gonderilebilir kismi sevk etmek, ya da tedarik edememe bildirimi yapmak. Ikisi de API'de ayrı servislerdir; elle panelden yapilan islemler entegrasyondaki sipariş kaydiyla uyumsuzluk yaratabilir.

Kargo etiketi

Kargo firmasi Trendyol tarafinda paket ile birlikte gelir. Kutu bilgisi guncelleme, kargo firmasi degistirme, anlasmali teslim tarihini uzatma gibi islemler paket servisinde ayrı uc noktalardir. Etiket basimi için Trendyol'un ortak etiket servisleri kullanilir ve bu grubun dakikada 100 istek limiti vardir; toplu sevkiyat gunlerinde etiket basimini kuyruga almak gerekir.

İade ve RMA

İade talepleri claim servisinden çekilir. İade kalem bazında onaylanir, yani aynı iade icindeki iki urunden birini onaylayip digerine itiraz kaydi acabilirsiniz. İade onaylama servisinin limiti oldukca dusuktur (dakikada 5 istek), bu nedenle toplu onay işlemleri yavas ve kontrollu calistirilmalidir. RapiSoft tarafinda iadeler kendi sipariş kaydinizla eslestirilerek gosterilir; stok iadesi ve muhasebe kaydi buna bagli çalışır.

Trendyol komisyon oranlarını kategori bazında kendisi belirler; hicbir entegrasyon bu orani degistiremez. Entegrasyonun yaptigi is, komisyon ve kesinti kalemlerinin okunmasi ve siparişle eslestirilmesidir. Trendyol bunun için ayrı finansal servisler sunar:

• Settlement (hakediş) servisi: Odeme donemine ait hakediş kalemlerini dondurur.
• Diger finansal islemler servisi: Kesinti, iade, duzeltme gibi hakediş disi kalemler.
• Kargo faturasi servisi: Kargo bedeli detaylari.
• Tazminat talepleri servisi: Kayip/hasar kaynaklı tazminat kayitlari.

Fatura tarafinda iki yontem vardir: fatura baglantisi (link) gondermek veya fatura dosyasini yuklemek. Trendyol ayrica kendi e-Faturam cozumunu sunar; kendi e-fatura entegratorunuzu kullaniyorsaniz fatura numarasi ve baglantisi API ile Trendyol'a iletilir. RapiSoft'ta sipariş, hakediş ve fatura aynı kayit uzerinde birlestirildigi için "bu siparisten net ne kaldi" sorusu tek ekrandan cevaplanir.

RapiSoft, STools Digital tarafindan gelistirilen çok kanalli e-ticaret altyapisidir. Trendyol entegrasyonu ayrı bir eklenti degil, altyapinin pazaryeri katmanindaki modullerinden biridir; aynı panelde kendi e-ticaret siteniz, pazaryeri kanallariniz, odeme, kargo ve e-fatura akislari birlikte çalışır.

• Sabit paket kademesi yok. Onceden belirlenmis Baslangic / Profesyonel / Kurumsal kademeleri yerine, kullandiginiz modül ve entegrasyon sayısına göre teklif verilir.
• Kurulum ücreti alınmaz. Trendyol baglantisinin kurulmasi, kategori ve marka eslestirmesinin yapilandirilmasi için ayrica kurulum bedeli talep edilmez.
• Satış komisyonu alınmaz. RapiSoft, sitenizden veya Trendyol'dan yaptiginiz cirodan pay almaz. Trendyol'un kendi komisyonu ve hizmet bedelleri dogal olarak Trendyol'a aittir.
• Eslestirme once, gonderim sonra. Mevcut Trendyol katalogunuz once okunur ve eşleştirilir; korlemesine toplu ürün acilmaz.
• Hata gorunur olur. Reddedilen ürün, basarisiz stok güncellemesi ve limit kaynaklı beklemeler kayit altina alınır; sessizce kaybolmaz.
• Tek pazaryeriyle sinirli degil. Trendyol yaninda diger pazaryeri kanallari da aynı katalog ve stok havuzu üzerinden yonetilebilir.

Kapsam ve teklif için: info@rapisoft.com

Mantikli olan durumlar:

• Ayni ürünü hem kendi sitenizde hem Trendyol'da satiyorsaniz ve stok cakismasi yasiyorsaniz.
• Varyantli ürün sayiniz yuzlerle ifade ediliyorsa; elle guncelleme surdurulebilir degildir.
• Kampanya donemlerinde fiyat degisikligini iki panelde ayrı ayrı yapmak zorunda kaliyorsaniz.
• Siparisleri ERP veya muhasebe sistemine elle giriyorsaniz.
• Hakediş mutabakatini Excel indirip elle eslestirerek yapiyorsaniz.

Acele etmeye gerek olmayan durumlar:

• Yalnizca Trendyol'da satiyorsaniz ve kendi siteniz yoksa; bu durumda once satış kanalini oturtmak daha oncelikli olabilir.
• Ürün sayiniz çok az ve nadiren degisiyorsa; entegrasyonun getirdigi otomasyon kazanci sinirli kalir.
• Katalog verisi (barkod, stok kodu, varyant yapisi) henuz duzenli degilse; once veri temizligi yapilmali, entegrasyon dagink veriyi duzeltmez, hizlica cogaltir.

Trendyol entegrasyonu için Trendyol'a ayrica ucret oduyor muyum?

Trendyol Satıcı API'sine erisim, onayli bir satıcı hesabinin parcasidir; API kullanimi için ayrı bir yazılım lisansi satin almanız gerekmez. Trendyol'a odediginiz sey kategori bazli komisyon ve varsa hizmet bedelleridir. Entegrasyon yazilimi bundan ayrı bir kalemdir. RapiSoft tarafinda kurulum ücreti ve satış komisyonu alınmaz; teklif kullandiginiz modül sayısına göre verilir.

API anahtarimi tam olarak nereden aliyorum?

Trendyol satıcı panelinde Hesap Bilgilerim bolumundeki Entegrasyon Bilgileri sayfasindan. Burada Satıcı ID, API Key ve API Secret Key yer alir. Önemli ayrinti: bu sayfayi yalnızca hesabin yetkili (master) kullanicisi gorebilir, alt kullanicilar acamaz. Anahtarlari paylasirken yetkili kullanicidan almanız gerekir.

Trendyol'da zaten acik olan urunlerimi silip yeniden mi gondermem gerekiyor?

Hayir, gerekmez ve onerilmez. Dogru yontem, ürün listeleme servisiyle Trendyol'daki mevcut urunleri cekip barkod veya stok kodu üzerinden kendi katalogunuzla eslestirmektir. Eslestirme tamamlandiktan sonra yalnızca stok ve fiyat senkronu acilir. Sifirdan ürün gönderimi, ürün puanlarinizi ve yorum gecmisini riske atar.

Ayni ürün hem sitemde hem Trendyol'da satilirsa stok cakismasi olur mu?

Stok tek havuzdan yonetildigi surece olmaz. Trendyol'dan gelen sipariş merkezi stoğu dusurur, dusen stok bir sonraki yazma turunda Trendyol'a yansir. Risk, senkron periyodunun uzun tutulmasindan dogar. Cok hizli tukenen urunlerde sipariş çekme periyodunu kisaltmak ve satış sonrasi anlik stok yazma tetiklemek gerekir.

Fiyati Trendyol panelinden elle degistirirsem entegrasyon uzerine yazar mi?

Fiyat yazma akisi acikken evet, bir sonraki senkronda sitenizdeki fiyat gecerli olur. Bu yuzden fiyat yonetiminin hangi tarafta olacagina bastan karar verilmelidir. Trendyol'a ozel fiyat uygulamak istiyorsaniz, kanal bazli fiyat tanimi kullanilmali; boylece site fiyatı ile pazaryeri fiyatı birbirini ezmez.

Kargo etiketini kendi panelimden basabilir miyim?

Evet. Kargo firmasi Trendyol tarafinda paket ile birlikte gelir; kutu bilgisi guncelleme ve kargo firmasi degistirme işlemleri paket servisinden yapilir, etiket basimi ise Trendyol'un ortak etiket servisleriyle yürür. Bu servis grubunun dakikada 100 istek limiti oldugu için yogun sevkiyat gunlerinde etiket basimi kuyruga alinarak calistirilir.

İade geldiginde ne oluyor?

İade talepleri claim servisinden çekilir ve kendi sipariş kaydinizla eşleştirilir. İade kalem bazında onaylanir; aynı iade icindeki bir ürünü onaylayip digerine itiraz kaydi acabilirsiniz. İade onaylama servisi dakikada 5 istekle sinirlidir, bu nedenle toplu onaylar kuyrukta kontrollu ilerletilir.

e-Fatura Trendyol'a otomatik gidiyor mu?

Trendyol fatura entegrasyonu iki yol sunar: fatura baglantisi (link) gondermek veya fatura dosyasini yuklemek. Kendi e-fatura entegratorunuzu kullaniyorsaniz olusan faturanin numarasi ve baglantisi API ile Trendyol'a iletilir. Trendyol'un kendi e-Faturam cozumunu kullanan saticilar için akis farklidir; hangi yolun kullanilacagi kurulumda belirlenir.

Kurulum ne kadar surer?

Sure, ürün sayisindan çok katalog verisinin duzenliligine baglidir. Barkodlar, stok kodlari ve varyant yapisi tutarliysa baglanti ve eşleştirme kisa surede tamamlanir. Kategori-marka-attribute eslestirmesi eksikse ya da aynı ürün için farkli barkodlar kullanilmissa sure uzar. Bu yuzden kurulumun ilk adımı her zaman veri kontroludur.

Trendyol disinda başka pazaryerlerini de aynı anda baglayabilir miyim?

Evet. RapiSoft çok kanalli calisacak şekilde kurgulanmistir; Trendyol yaninda diger pazaryeri kanallari aynı katalog ve stok havuzu üzerinden yonetilebilir. Her pazaryerinin kendi API kurallari, alan zorunluluklari ve limitleri oldugu için her kanal ayrı modül olarak yapilandirilir. Hangi kanallarin dahil olacagi teklif kapsamini belirler.

API limitini asarsam ne olur?

Trendyol 429 hatasi dondurur. Genel kural, aynı uc noktaya 10 saniye icinde en fazla 50 istektir; ayrica servis grubu bazında dakikalik limitler vardir (ornegin ürün yazma grubunda 200-600 istek/dakika araliginda, satıcı seviyesine göre). Duzgun bir entegrasyon bu durumda istegi kuyruga alip artan bekleme suresiyle yeniden dener, veri kaybolmaz.

Once test ortaminda deneyebilir miyim?

Evet, Trendyol'un ayrı bir stage ortami var: stageapigw.trendyol.com ve stagepartner.trendyol.com. Test hesabinin bilgileri canli hesaptan tamamen farklidir ve destek hattindan talep edilir. Önemli nokta, test ortaminda IP yetkilendirmesinin zorunlu olmasidir; sunucu IP adresiniz tanimlanmadan yapilan istekler 503 doner.

Varyantli urunlerde (renk, beden) eşleştirme nasıl kuruluyor?

Trendyol'da her varyant kendi barkoduyla ayrı satirdir; aynı urunun varyantlari productMainId alani ile tek ürün kartinda birlestirilir. Renk ve beden gibi alanlar kategoriye ozel attribute ID'leriyle gönderilir. Bu yuzden varyant yapinizin sitenizde de tutarli olmasi gerekir; aynı tisortun iki farkli ürün karti olarak durdugu kataloglar once birlestirilmelidir.