İstanbul yazılım firması · 12 yıllık deneyim

Pazaryeri entegrasyonu nedir, nasıl yapılır?

Pazaryeri entegrasyonu, ürün, stok, fiyat ve sipariş bilgilerinizi Trendyol, Hepsiburada ya da Amazon gibi pazaryerleriyle kendi sisteminiz arasında otomatik eşitleyen yazılım bağlantısıdır. Bağlantı, pazaryerinin satıcıya verdiği API bilgileriyle kurulur. Böylece bir kanalda satılan ürünün stoğu diğerlerinde de düşer, siparişler tek ekrana gelir, kargo ve fatura bilgisi pazaryerine geri gider. Bunu hazır bir entegrasyon programıyla ya da kendi yazılımınızı pazaryerinin API’sine bağlatarak yapabilirsiniz.

Pazaryeri entegrasyonu nedir, nasıl yapılır?

İstanbul Yazılım · · 12 dk okuma

Yapay zeka ile özetle:ChatGPTGeminiPerplexityClaude

İçindekiler
  1. Pazaryeri entegrasyonu ne işe yarar?
  2. API, webhook ve XML: Entegrasyon nasıl çalışır?
  3. Üç yol: Panel, entegrasyon programı ya da özel entegrasyon
  4. Trendyol entegrasyonu nasıl yapılır?
  5. Amazon ve diğer pazaryerleri
  6. Entegrasyon programı seçerken sorulacaklar
  7. Maliyet neye göre değişir?
  8. Sık yapılan hatalar
  9. Kendi siteniz de aynı stoktan beslenmeli
  10. Sık sorulan sorular

Pazaryerine özgü kuralları Kasım 2026 itibarıyla Trendyol’un ve Amazon’un geliştirici dokümanlarından kontrol ettik. Pazaryerleri bu kuralları sık değiştiriyor; örneğin Trendyol, ürün servislerinin istek limitlerini 14 Eylül 2026’da yeniledi, sipariş servisinde de 15 Ekim 2026’dan itibaren yeni sürümü zorunlu kıldı. Kurulumdan önce ilgili pazaryerinin güncel dokümanına bakın.

Pazaryeri entegrasyonu ne işe yarar?

Aynı ürünü kendi sitenizde, Trendyol’da ve bir pazaryerinde daha sattığınızı düşünün. Stok tek bir depoda duruyor ama üç ayrı panelde görünüyor. Panelleri elle güncellediğinizde son ürün iki kanalda birden satılabilir ve siparişlerden birini iptal etmek zorunda kalırsınız. Fiyat değişikliğini her panelde ayrı yaparsınız, siparişleri üç ayrı yerden toplarsınız.

Entegrasyon bu işi tek bir kaynaktan yürütür. Stokun ve fiyatın doğrusu sizin sisteminizde durur, pazaryerleri oradan beslenir. Siparişler ters yönde akar ve pazaryerinden sizin sisteminize gelir. Hangi bilginin hangi yöne aktığı şöyle:

Bilgi Yön Ne zaman akar?
Ürün bilgisi (ad, açıklama, görsel, kategori özellikleri) Sizden pazaryerine Ürün açılırken ve bilgisi değişince
Stok ve fiyat Sizden pazaryerine Satış, stok girişi ya da fiyat değişikliğinde
Sipariş Pazaryerinden size Sipariş oluşunca
Sipariş durumu ve kargo takip numarası Sizden pazaryerine Toplama, faturalama ve kargoya verme adımlarında
Fatura Sizden pazaryerine Fatura düzenlenince
İade talepleri ve müşteri soruları Pazaryerinden size, cevap sizden Talep ya da soru gelince

Her çözüm bu satırların hepsini kapsamaz. Bazıları yalnızca stok ve siparişi eşitler; ürün açmak, fatura iletmek ya da iadeye cevap vermek için yine panele girersiniz. Teklif alırken hangi satırların dahil olduğunu tek tek sorun.

API, webhook ve XML: Entegrasyon nasıl çalışır?

API, pazaryerinin satıcılara açtığı programlama arayüzüdür. Yazılımınız, pazaryerinin verdiği kimlik bilgileriyle “bu ürünün stoğu 12 oldu” ya da “son bir saatin siparişlerini gönder” gibi istekler yapar. Trendyol’da bu istekler Satıcı ID, API Key ve API Secret bilgileriyle, temel kimlik doğrulama (basic authentication) yöntemiyle yetkilendirilir.

Webhook, ters yönlü bir bildirimdir. Sipariş oluştuğunda ya da durumu değiştiğinde pazaryeri sizin belirlediğiniz bir adrese haber verir; yazılımınızın sürekli “yeni sipariş var mı?” diye sorması gerekmez. Trendyol sipariş paketleri için webhook sunuyor, ancak dokümanında webhook ile gönderimin her zaman mümkün olmadığını belirtip siparişlerin düzenli sorgularla da eşitlenmesini öneriyor. Aynı bildirim birden fazla kez gelebildiği için karşılayan sistem, aynı siparişi iki kez işlemeyecek şekilde kurulmalıdır.

XML entegrasyonu tek yönlü bir ürün dosyasıdır. Tedarikçiniz ya da e-ticaret altyapınız ürünleri, stokları ve fiyatları bir adreste XML dosyası olarak yayımlar; entegrasyon programı bu dosyayı belirli aralıklarla okuyup pazaryerine aktarır. Tedarikçinin ürünlerini satanlar için pratiktir. Ancak XML siparişleri geri taşımaz ve stok, dosyanın okunma sıklığı kadar gecikmeyle güncellenir.

Üç yol: Panel, entegrasyon programı ya da özel entegrasyon

Pazaryeri paneli Entegrasyon programı Özel API entegrasyonu
Nasıl çalışır? Her pazaryerinde elle Pazaryerlerini tek panelden yöneten hazır hizmet Siteniz, ERP’niz ya da depo yazılımınız pazaryerine doğrudan bağlanır
Kurulum Yok API bilgilerini girmek, ürünleri ve kategorileri eşlemek Analiz, geliştirme, test ortamında deneme
Gider Personel zamanı Programın paket ve kullanım ücreti Geliştirme bedeli ve bakım
Esneklik Panelin izin verdiği kadar Programın sunduğu kadar İş kurallarınız kadar
Uygun olduğu durum Tek kanal, az ürün Birkaç kanal, standart süreç Kendine özgü stok, fiyat ya da depo kuralları

Hazır bir e-ticaret altyapısı kullanıyorsanız bir seçenek daha var: altyapının kendi pazaryeri uygulaması. Örneğin ikas’ın entegrasyonlar sayfası Trendyol, Hepsiburada ve Amazon için siparişlerin ve stokların ikas ile senkronize tutulduğunu yazıyor; Trendyol ve Hepsiburada uygulamaları “Ücretli” etiketiyle listeleniyor. Mağazanız zaten bir altyapıdaysa en kısa yol budur, ama ürün açma, fiyat ve fatura gibi işlemlerin kapsama girip girmediğini altyapının yardım sayfasından kontrol edin.

Hangisini seçmeli?

  • Tek pazaryeri ve az ürün: Panel yeterli olabilir. Bu ölçekte entegrasyonun kurulum emeği ve ücreti, kazandırdığı zamandan fazla olabilir.
  • Kendi siteniz ve iki üç pazaryeri: Süreçleriniz standartsa entegrasyon programı ya da altyapınızın uygulaması işinizi görür.
  • Stok bir ERP’de ya da depo yazılımında duruyorsa: Pazaryerine göre farklı fiyat, birden fazla depo, paket bölme gibi kurallarınız varsa ya da programın ücreti hacminizle birlikte büyüyorsa özel entegrasyonu düşünün.

Karar, genel olarak özel yazılım mı, hazır yazılım mı sorusuyla aynı mantığa dayanır: Hazır programın sunduğu süreç sizinkine ne kadar uyuyor?

Trendyol entegrasyonu nasıl yapılır?

Adımları Trendyol’un herkese açık geliştirici dokümanı (developers.trendyol.com) üzerinden anlatıyoruz. Hazır program kullansanız bile bu adımları bilmek, programın sizin yerinize neyi yaptığını anlamanızı sağlar.

1. API bilgilerini alın

Satıcı panelinde sağ üstteki mağaza adınıza tıklayıp Hesap Bilgilerim bölümündeki Entegrasyon Bilgileri sayfasına girin. Satıcı ID, API Key ve API Secret burada yer alır; Trendyol’a göre bu bilgiler yalnızca ana kullanıcıyla (admin rolü) giriş yapıldığında görünür. Tüm entegrasyon işlemleri bu bilgilerle yapıldığı için Trendyol, bunların GitHub gibi açık platformlarda paylaşılmaması uyarısını yapıyor. Yazılımcınıza ya da entegratörünüze iletirken bilgileri e-posta zincirlerinde ve mesaj gruplarında bırakmayın.

2. Bağlantıyı kimin kurduğunu bildirin

Trendyol her istekte User-Agent başlığı ister; bu başlığı taşımayan istekler 403 hatasıyla engellenir. Bir entegrasyon firmasıyla çalışıyorsanız başlık “Satıcı ID - Firma Adı”, entegrasyon yazılımı size aitse “Satıcı ID - SelfIntegration” biçiminde gönderilir. Yani Trendyol, isteğin sizin yazılımınızdan mı yoksa aracı bir firmadan mı geldiğini ayırt eder.

3. Test ortamında deneyin

Trendyol’un canlı ortamdan ayrı bir test ortamı var ve test hesabının bilgileri canlı bilgilerden tamamen farklı. Test ortamına erişmek için uygulamanın çalıştığı sunucunun çıkış IP adresi Trendyol’a bildirilip yetkilendirilmelidir; talep, Trendyol çağrı merkezi üzerinden satıcı bildirimi oluşturularak yapılır. Canlı ortamda IP yetkilendirmesi gerekmiyor. Test ortamında test siparişi oluşturmak için ayrı bir servis de bulunuyor; sipariş, kargo ve fatura akışını gerçek bir müşteriye dokunmadan burada deneyebilirsiniz.

4. Ürünleri eşleyin

Ürün açmadan önce Trendyol’un marka, kategori, kategori özelliği ve özellik değeri listeleri çekilir; sizin kategorileriniz ve özellikleriniz bunlarla eşlenir. Entegrasyonun en çok emek isteyen kısmı çoğu zaman burasıdır: Sizin sisteminizde serbest metin olan “Renk: Lacivert” bilgisi, Trendyol tarafında genellikle özelliğin değer listesindeki bir karşılıkla eşleştirilir. Dokümandaki başlıca kurallar şunlar:

  • Bir istekte en çok 1.000 ürün gönderilir.
  • Ürün adı en çok 100 karakterdir.
  • Görseller https adresli olmalıdır. Barkod başına en çok 8 görsel eklenir ve Trendyol 1200x1800 boyut, 96 dpi istiyor.
  • Beden ve renk gibi varyantlar aynı model kodu (productMainId) altında gruplanır.
  • Barkodda özel karakter olarak yalnızca nokta, tire ve alt çizgi kullanılabilir. Stok ve fiyat güncellemeleri de bu barkodla yapılır.
  • KDV oranı 0, 1, 10 ya da 20 gibi bir sayı olarak gönderilir.
  • Liste fiyatı satış fiyatından düşük olamaz.

Aktarım anında sonuçlanmaz. Dönen toplu işlem numarasıyla (batchRequestId) sonucun ayrıca sorgulanması gerekir. Başarılı aktarımdan sonra ürünler onay sürecine girer; onay bekleyen ya da reddedilen ürünler yayına çıkmaz.

5. Stok ve fiyatı eşitleyin

Stok ve fiyat tek istekte en çok 1.000 ürün (SKU) için güncellenir; bu işlemin sonucu da toplu işlem numarasıyla kontrol edilir. Değişmemiş bir isteği tekrar gönderirseniz Trendyol, aynı isteğin 15 dakika boyunca tekrarlanamayacağını söyleyen bir hata döndürür. Bu yüzden entegrasyon her şeyi topluca değil, yalnızca değişen stok ve fiyatları göndermelidir. Gönderdiğiniz miktar satılabilir stok kabul edilir ve sipariş geldiğinde ya da yeni stok gönderdiğinizde güncellenir. Ürün başına en fazla 20 bin adet stok tanımlanabilir.

6. Siparişleri alın

Siparişler webhook ile anında, sipariş paketlerini çekme servisiyle de düzenli aralıklarla alınır; Trendyol ikisinin birlikte kullanılmasını öneriyor. Bu serviste 15 Ekim 2026’dan itibaren yeni sürüm (v2) zorunlu. Yeni sürümde sayfalamayla erişilebilen kayıt sayısı 10.000 paketle sınırlı ve bir istekte en çok 200 paket dönüyor. Trendyol ayrıca erişilebilen veri kapsamının son bir ayla sınırlandırılacağını duyuruyor. Pratik sonucu şu: Sipariş geçmişinizi pazaryerine bırakmayın, her siparişi geldiği anda kendi sisteminize kaydedin.

Ödeme onayı bekleyen siparişler Awaiting statüsünde görünür. Trendyol bu siparişlerle yalnızca stok işlemi yapılmasını, Created (gönderime hazır) statüsüne geçmeden başka işlem yapılmamasını istiyor; bu statüdeki siparişi kargolarsanız yaşanabilecek iptallerden sorumluluk kabul etmiyor. Sonraki adımlar Picking (toplanıyor), Invoiced (faturalandı), Shipped (kargoda) ve Delivered (teslim edildi) statüleriyle izlenir.

7. Faturayı iletin

Satış faturasını kendi e-Fatura ya da e-Arşiv sisteminizde siz düzenlersiniz. Trendyol’a iletmenin iki yolu var: PDF’i siparişe özel üretilen şifreli e-posta adresine göndermek ya da fatura bağlantısını API ile iletmek. Trendyol, bu bağlantıların hukuki zorunluluk gereği 10 yıl boyunca erişilebilir kalması gerektiğini yazıyor. Fatura sağlayıcınızı değiştirdiğinizde eski bağlantıların kırılmamasına dikkat edin. Faturanın siparişten otomatik kesilmesi için e-fatura entegrasyonu yazımıza bakın.

İstek limitleri

Trendyol her isteği sınırlar. Genel kurala göre aynı uca 10 saniyede en çok 50 istek atılabilir, fazlasında 429 hatası döner. 14 Eylül 2026’dan itibaren ürün servislerinde limitler, satıcının ürün listeleme limitine göre servis grubu bazında uygulanıyor. Örneğin 50.000 ürün listeleme limiti olan bir satıcı için ürün aktarma, güncelleme ve silme gibi yazma servislerinin toplamı dakikada 200, stok ve fiyat güncellemeleri dakikada 350 istekle sınırlı. Aynı barkodun fiyatı dakikada en çok 30 kez güncellenebiliyor.

Sınırlar asıl büyük kataloglarda önem kazanır: Güncellemeler 1.000’lik paketlerle gönderilmeli, 429 hatası alındığında beklenip yeniden denenmelidir. Hazır programda bunu program yapar; özel entegrasyonda kuyruk ve yeniden deneme düzeni baştan kurulmalıdır.

Amazon ve diğer pazaryerleri

Amazon’da entegrasyon Selling Partner API (SP-API) ile yapılır ve Amazon’un Türkiye mağazası, Avrupa bölgesinin uç noktasından (sellingpartnerapi-eu.amazon.com) hizmet alır. Yalnızca kendi şirketinizin mağazasını bağlayacaksanız Seller Central’da Apps and Services altındaki Develop Apps menüsünden geliştirici profilini “private developer” olarak doldurursunuz. Profilde iletişim bilgileri, hangi verilere ihtiyaç duyduğunuz, kullanım senaryoları ve güvenlik önlemleri sorulur. Amazon başvuruyu değerlendirir, ek bilgi ya da belge isteyebilir; beş gün içinde yanıt verilmezse talep kapanır. Erişim kararında Amazon’un kabul edilebilir kullanım ve veri koruma politikalarına uyum da dikkate alınır.

Hepsiburada, n11 ve diğer pazaryerlerinin de kendi API’leri, kimlik bilgisi alma yöntemleri ve limitleri var. Bunlar pazaryerine göre değiştiği için ayrıntıları ilgili pazaryerinin geliştirici dokümanından ve satıcı destek kanalından teyit edin. Bir entegratörün “tüm pazaryerlerini destekliyoruz” demesi yeterli değildir; her pazaryerinde hangi işlemleri desteklediğini ayrı ayrı sorun.

Entegrasyon programı seçerken sorulacaklar

  • Kapsam: Hangi pazaryerleri ve her birinde hangi işlemler? Ürün açma, stok ve fiyat, sipariş, kargo, fatura, iade ve müşteri soruları için ayrı ayrı cevap alın.
  • Hız: Stok kaç dakikada bir eşitleniyor? Siparişler webhook ile mi geliyor, düzenli sorguyla mı?
  • Eşleme: Kategori, özellik ve varyant eşlemesi nasıl yapılıyor? Reddedilen bir ürünün sebebi nerede görünüyor?
  • Fiyat kuralları: Pazaryerine göre farklı fiyat, örneğin komisyon farkını yansıtan bir fiyat tanımlanabiliyor mu?
  • Fatura: E-fatura sağlayıcınızla bağlantısı var mı, fatura bağlantısını pazaryerine kendisi gönderiyor mu?
  • Güncellik: Pazaryerlerinin API değişikliklerini ne kadar sürede uyguluyor? Trendyol’un 15 Ekim 2026’da zorunlu hale gelen yeni sipariş servisi iyi bir test sorusu.
  • Verinin taşınabilirliği: Ürün eşleşmelerini ve sipariş geçmişini dışa aktarabiliyor musunuz? Program değiştirdiğinizde eşlemeyi baştan yapmak istemezsiniz.
  • Güvenlik ve KVKK: Program, müşterilerinizin ad, adres ve telefon bilgilerini işler. Kişisel Verilerin Korunması Kanunu’na göre veri sorumlusu, verilerin kendi adına başka bir kişi tarafından işlenmesi halinde gerekli tedbirlerin alınmasından o kişiyle birlikte müştereken sorumludur (KVKK’nın açıklaması). Verinin nerede tutulduğunu ve kimlerin erişebildiğini sorun, güvenlik yükümlülüklerini sözleşmeye yazdırın.
  • Ücret: Kurulum, aylık ücret, kanal ya da sipariş başına ücret ve ek modüller yazılı olsun.

Maliyet neye göre değişir?

Pazaryeri entegrasyonunun tek bir fiyatı yoktur. Tutarı şu kalemler belirler:

  • Kanal sayısı: Kaç pazaryerine bağlanacağınız ve kendi sitenizin de dahil olup olmadığı.
  • Katalog: Ürün ve varyant sayısı, kategori eşlemesinin ne kadarının elle yapılacağı.
  • Stokun kaynağı: E-ticaret altyapısı, muhasebe programı, ERP ya da depo yazılımı.
  • Diğer bağlantılar: Fatura, kargo ve muhasebe.
  • Özel kurallar: Pazaryerine göre fiyat, birden fazla depo, paket bölme, kampanya.
  • Bakım: Pazaryerleri API’lerini değiştirdikçe entegrasyonun da güncellenmesi. Trendyol’un 2026’daki limit ve sipariş servisi değişiklikleri bunun örneği.

Hazır programda bu kalemler programın paket ve ücret yapısına, özel entegrasyonda geliştirme ve bakım bedeline yansır. İki teklifi karşılaştırırken ikisine de aynı kapsam listesini verin.

Sık yapılan hatalar

  • Stok payı bırakmamak: Eşitleme hızlı olsa bile iki kanaldan aynı anda gelen siparişler son ürünü iki kez sattırabilir. Az kalan ürünlerde pazaryerine gerçek stoktan birkaç adet eksik göndermek bu riski azaltır.
  • Barkodu sonradan değiştirmek: Trendyol stok ve fiyat güncellemelerini ürünün aktarıldığı barkodla eşler. Barkodu kendi sisteminizde değiştirirseniz güncellemeler eşleşmez.
  • Hataları kimsenin görmemesi: Reddedilen ürün, başarısız stok güncellemesi ya da sisteme düşmeyen sipariş kimseye bildirilmiyorsa sorun müşteri şikâyetiyle ortaya çıkar. Hataların bir kişiye ulaştığı bir ekran ya da e-posta akışı kurun.
  • İki programı aynı anda çalıştırmak: Program değiştirirken eskisi ve yenisi aynı anda stok gönderirse birbirinin üzerine yazar. Geçiş gününde eskisinin stok göndermesini kapatın.

Kendi siteniz de aynı stoktan beslenmeli

Pazaryerlerinin yanında kendi sitenizde de satış yapıyorsanız site de aynı stoktan beslenmelidir. Sıfırdan bir mağaza kuruyorsanız bunu baştan planlamak en ucuz yoldur: E-ticaret sitesi yaptırma hizmetimizde ürün yapısını (barkod, model kodu, varyant ve kategori özellikleri) pazaryerlerine aktarılabilecek şekilde kuruyoruz. Stoğunuz bir ERP’de ya da depo yazılımında duruyorsa ya da hazır programların karşılamadığı kurallarınız varsa özel yazılım geliştirme tarafında pazaryeri API’lerini kendi sistemlerinize bağlıyoruz; kuyruk, yeniden deneme ve hata bildirimleri bu işin parçasıdır.

Sık sorulan sorular

Pazaryeri entegrasyonu ücretsiz mi?

Ücret, kullandığınız programdan ya da geliştirmeden doğar; buna kurulum ve eşleme emeği ile bakım eklenir. Ücretsiz diye sunulan bir programda hangi pazaryerlerinin ve hangi işlemlerin (fatura, iade, müşteri soruları) pakete dahil olduğunu kontrol edin. Altyapıların kendi uygulamaları da ücretli olabilir; örneğin ikas, Trendyol ve Hepsiburada uygulamalarını “Ücretli” olarak listeliyor.

Trendyol API bilgileri nerede?

Satıcı panelinde sağ üstteki mağaza adınıza tıklayın ve Hesap Bilgilerim bölümündeki Entegrasyon Bilgileri sayfasını açın. Satıcı ID, API Key ve API Secret buradadır. Bilgiler yalnızca ana kullanıcıyla (admin rolü) giriş yapıldığında görünür.

XML entegrasyonu ile API entegrasyonu arasındaki fark nedir?

XML, ürün ve stok bilgisini bir dosya olarak yayımlar ve tek yönlüdür; dosya belirli aralıklarla okunur. API iki yönlüdür: Stok, fiyat ve ürün bilgisini gönderir; siparişleri, iadeleri ve soruları geri alır. Tedarikçiden ürün almak için XML yeterli olabilir, sipariş yönetimi için API gerekir.

Entegrasyon programını değiştirirsem ürünlerim silinir mi?

Ürünler programda değil, pazaryerindeki mağaza hesabınızda durur. Değişiklikte asıl iş, yeni programda ürün ve kategori eşlemelerini yeniden kurmak ve eski programın stok göndermeyi bıraktığından emin olmaktır.

Pazaryeri siparişlerinin faturasını kim keser?

Satış faturasını satıcı keser. Trendyol’da fatura satıcının kendi e-Arşiv ya da e-Fatura sisteminde düzenlenir, ardından PDF olarak siparişe özel e-posta adresine ya da bağlantı olarak API ile iletilir. Trendyol’un satıcıya kestiği kargo faturaları ise ayrı belgelerdir ve ayrıntıları da API’den alınabilir.

Kendi e-ticaret sitem olmadan entegrasyon yapılır mı?

Evet. Stok bir muhasebe programında, ERP’de ya da depo yazılımında tutuluyorsa entegrasyon programı ya da özel bir yazılım pazaryerlerini bu kaynaktan besleyebilir. Önemli olan, stokun tek bir doğru kaynağının olmasıdır.

Bu yazı genel bilgi verir; pazaryeri kuralları sık değiştiği için kurulumdan önce ilgili pazaryerinin güncel dokümanını kontrol edin.

Projenizi anlatın, kapsamı ve fiyatı yazılı olarak iletelim.

İlk görüşme ücretsizdir. Fikriniz henüz net değilse de yazın; neyin yapılmaya değer olduğunu birlikte çıkarırız.