Kısa cevap: Pazaryeri entegrasyonu, Trendyol ve Hepsiburada gibi pazaryerlerindeki mağazanızın ürün, stok, fiyat ve sipariş verisini kendi web sitenizle ya da stok sisteminizle otomatik olarak eşitlemesidir. Ürün bir kez girilir, stok tek yerde tutulur, siparişler tek listeye düşer. Böylece bir kanalda satılan ürün diğerlerinde de düşer ve elde olmayan ürün satılmaz.
Pazaryeri entegrasyonu nedir?
Pazaryeri entegrasyonu, satıcının kendi sistemi ile pazaryerinin satıcı altyapısı arasında veri alışverişini otomatikleştiren bağlantıdır. Panel panel dolaşıp stok yazmak yerine, bilgiler bir merkezden pazaryerine gider; siparişler de pazaryerinden merkeze gelir.
Bu bağlantı iki yönlüdür. Sizden pazaryerine ürün bilgisi, stok ve fiyat gider. Pazaryerinden size sipariş, iptal, iade ve kargo durumu gelir. Biri eksik kalırsa entegrasyon yarım çalışır: stok gönderip siparişi almayan bir kurulum, satışın ardından diğer kanallardaki stoku düşüremez.
Entegrasyon tek başına bir satış stratejisi değildir; çok kanallı satışın altyapısıdır. Mağaza, site ve pazaryerini tek stokta yönetme fikrinin tamamını omnichannel e-ticaret yazımızda anlattık. Bu yazı, o fikrin pazaryeri bacağına odaklanıyor.
Pazaryeri entegrasyonu hangi yöntemlerle yapılır?
Pazaryeri entegrasyonu üç yoldan kurulur: pazaryerinin API'sine doğrudan bağlanmak, XML ürün beslemesi ile toplu aktarım yapmak ya da arada bir entegratör yazılımı kullanmak. Hangisinin uygun olduğunu katalog büyüklüğü, kanal sayısı ve ekibinizin teknik gücü belirler.
| Yöntem | Nasıl çalışır | Uygun olduğu durum | Dikkat edilecek |
|---|---|---|---|
| Doğrudan API | Sisteminiz pazaryerinin servislerine kendisi istek atar | Kendi yazılımı olan, büyüyen markalar | Geliştirme ve bakım sizde; servis sürümleri değişir |
| XML besleme | Siteniz ürün listesini dosya olarak yayınlar, belli aralıklarla okunur | Küçük ve az değişen katalog | Anlık değildir; siparişi geri getirmez |
| Entegratör | Ara yazılım pazaryerlerine bağlanır, sizi tek panelden yönetir | Birden çok pazaryerinde satan işletmeler | Aylık bedel, ürün eşleştirme kalitesi, destek |
| Tek panel altyapı | Site, mağaza kasası ve pazaryeri aynı veritabanını okur | Fiziksel mağazası da olan markalar | Geçiş planı ve veri aktarımı gerekir |
XML yöntemi çoğu zaman tek yönlüdür: ürünü ve stoku taşır, siparişi geri getirmez. Bu yüzden XML'i tek başına "entegrasyon" saymak yanıltıcı olabilir. Birçok entegratör yazılımı sitenizin XML çıktısını kaynak olarak okur, pazaryerine ise API ile yazar.
Entegrasyonla hangi veriler senkronize edilir?
Sağlıklı bir pazaryeri entegrasyonu ürün, stok, fiyat, sipariş, kargo, iade ve fatura verisini eşitler. Aşağıdaki tablo, her verinin hangi yönde aktığını ve neden önemli olduğunu özetliyor.
| Veri | Yön | Neden önemli |
|---|---|---|
| Ürün kartı (ad, açıklama, görsel, özellik) | Sizden pazaryerine | Kategori özellikleri eksikse ürün onaylanmaz |
| Barkod ve SKU | Sizden pazaryerine | Bütün eşleştirme bu iki alana dayanır |
| Stok | Sizden pazaryerine | Stoksuz satışı ve iptali önler |
| Fiyat | Sizden pazaryerine | Kanal bazlı fiyat kuralları buradan çalışır |
| Sipariş | Pazaryerinden size | Satış diğer kanallarda stoku düşürür |
| Kargo ve paket durumu | İki yönlü | Gecikme ve müşteri soruları azalır |
| İade ve iptal | Pazaryerinden size | İade dönen ürün yeniden satışa açılır |
| Fatura | Sizden pazaryerine | Sipariş kapanışı ve muhasebe |
Pek çok işletme entegrasyonu yalnızca stok ve fiyat olarak düşünür. Oysa sipariş ve iade akışı gelmezse stok yine elle düzeltilir. Entegrasyonu değerlendirirken önce "satış olduğunda öteki kanaldaki stok kendiliğinden düşüyor mu?" sorusunu sorun.
Trendyol entegrasyonu nasıl kurulur?
Trendyol entegrasyonu, satıcı panelinden alınan API bilgileriyle kurulur ve ürün, stok-fiyat, sipariş, fatura ile müşteri soruları servislerini kapsar. Adımlar, Trendyol'un geliştirici belgelerine göre şöyledir:
- Satıcı panelinde "Hesap Bilgilerim" altındaki "Entegrasyon Bilgileri" sekmesinden satıcı ID, API key ve API secret alınır. Trendyol'a göre bu bilgiler yalnızca admin rolündeki ana kullanıcıya görünür.
- İstekler bu bilgilerle "basic authentication" yöntemiyle yetkilendirilir. Her istekte User-Agent başlığı da gönderilir; başlığı olmayan istekler engellenir.
- Kategori ve kategori özellikleri çekilir, ürünler zorunlu özellikleriyle birlikte aktarılır ve onay beklenir.
- Onaylanan ürünlerin stok ve fiyatı toplu olarak gönderilir; işlemin sonucu ayrı bir servisten kontrol edilir.
- Siparişler düzenli sorgulama ya da webhook ile alınır, paket durumu (toplanıyor, faturalandı, kargoda) geri bildirilir.
- Fatura dosyası ya da bağlantısı siparişe iletilir, iadeler aynı akışla işlenir.
Trendyol'un yetkilendirme belgesine göre entegrasyonu bir aracı firma yapıyorsa User-Agent başlığına "Satıcı ID - firma adı", kendi yazılımınızsa "Satıcı ID - SelfIntegration" yazılır. Bu ayrıntı küçük görünür ama atlandığında bütün istekler reddedilir.
Zamanlama açısından önemli bir not: Trendyol geliştirici sitesinde ürün ve sipariş servislerinin V2 sürümlerine geçişin 15 Ekim 2026'ya kadar yapılması gerektiğini, V1 servislerinin bu tarihte kapatılacağını duyurdu. Kendi yazdığı entegrasyonu kullanan satıcıların bu geçişi kontrol etmesi gerekiyor; entegratör kullananlar ise firmalarına sürümü sormalı.
Stok ve fiyat senkronu ne kadar hızlı çalışır?
API ile kurulan entegrasyonda stok ve fiyat eş zamana yakın güncellenir; ama işlem sıraya alınır ve sonucu ayrıca doğrulanmalıdır. "Gönderdim, oldu" varsayımı en sık yapılan hatadır.
Trendyol'un stok ve fiyat servisi bilgileri "eş zamana yakın" günceller ve tek istekte en fazla 1.000 ürün (SKU) kabul eder. İstek bir işlem numarası döndürür; ürünlerin gerçekten güncellenip güncellenmediği bu numarayla ayrı bir servisten sorgulanır. Aynı isteği değişiklik yapmadan 15 dakika içinde tekrar göndermek hata verir; yani sistem yalnızca değişen stok ve fiyatları göndermelidir.
Trendyol'un servis limitleri sayfası, 14 Eylül 2026'dan itibaren istek sınırlarının servis grupları bazında ortak uygulandığını ve aynı barkod için dakikada 30'dan fazla fiyat güncellemesinin hata alacağını belirtiyor. Fiyatı sık değiştiren otomatik kurallar bu sınıra takılabilir.
Hepsiburada tarafında da benzer bir mantık var: listing fiyat ve stok güncellemeleri ayrı servislerle gönderilir, isteklerin başarılı olup olmadığı Hepsiburada geliştirici belgelerinde tarif edilen sorgulama servisleriyle kontrol edilir. İki pazaryerinde de sonuç kontrolü, kurulumun parçası olmalı.
Komisyon ve fiyat stratejisi entegrasyonda nasıl yönetilir?
Komisyon oranları kategoriye ve pazaryerine göre değişir; bu yüzden aynı ürünü her kanalda aynı fiyata satmak, her kanalda aynı kârı bırakmaz. Entegrasyonun işi, kanal bazlı fiyat kurallarını merkezden uygulamaktır.
Güncel komisyon oranları satıcı panelinde ve sözleşmede yer alır; kategoriye göre farklıdır ve zaman içinde değişebilir. Fiyat kuralı kurarken şu kalemleri birlikte hesaplayın:
- Kategori komisyonu ve varsa hizmet bedeli
- Kargo maliyeti ve ücretsiz kargo eşiği
- İade oranının yarattığı ek kargo ve ambalaj gideri
- Kampanya ve indirim katılımlarının marja etkisi
- Kendi sitenizdeki ödeme altyapısı komisyonu
Pratikte çoğu marka "kendi sitemizde en iyi fiyat" ya da "pazaryerinde komisyonu fiyata yansıt" gibi bir kural seçer. Hangisi seçilirse seçilsin, kural her ürüne elle değil, merkezden ve yüzde ya da tutar farkı olarak uygulanmalı.
Pazaryeri entegrasyonunda en sık yapılan hatalar nelerdir?
En sık hatalar barkod ve SKU tutarsızlığı, sonucu kontrol edilmeyen güncellemeler ve tampon stok bırakılmamasıdır. Çoğu sessiz hatadır: sistem çalışıyor görünür, sorun bir müşteri iptal talebinde ortaya çıkar.
- Barkod ve SKU'nun kanallarda farklı olması. Eşleştirme bu alanlarla yapılır. Aynı ürün sitede bir kodla, pazaryerinde başka kodla duruyorsa stok iki ayrı ürün gibi işlenir.
- Varyantların yanlış kurulması. Beden ve renk ayrı barkod taşımalıdır. Tek barkodla açılan varyantlar stoku birbirine karıştırır.
- Güncelleme sonucunun kontrol edilmemesi. Toplu işlem kabul edildi diye ürünlerin güncellendiği anlamına gelmez. Hata dönen satırlar raporlanmalıdır.
- Sipariş akışının polling aralığına bırakılması. Siparişler seyrek çekilirse aradaki sürede öteki kanalda aynı ürün satılabilir. Webhook desteği varsa kullanılmalıdır.
- Tampon stok bırakılmaması. Son birkaç ürünü bütün kanallarda aynı anda açık tutmak, eşzamanlı siparişlerde stoksuz satış riski doğurur.
- Mağaza satışının sisteme girmemesi. Fiziksel mağazadaki satış kasadan online stoka düşmüyorsa entegrasyon yarım kalır.
- Servis sürümlerinin takip edilmemesi. Pazaryerleri eski servisleri belli tarihlerde kapatır. Takip edilmeyen bir değişiklik, bir sabah bütün aktarımın durması demektir.
Entegratör mü, kendi yazılımınız mı, tek panel mi?
Tek pazaryerinde ve küçük katalogla satıyorsanız hazır bir entegratör çoğu zaman yeterlidir; birden çok pazaryeri, kendi siteniz ve fiziksel mağaza bir aradaysa tek veritabanından çalışan bir altyapı daha az hata üretir. Kendi API entegrasyonunuzu yazmak ise en esnek ama bakımı en ağır seçenektir.
Karar verirken şu soruları sorun: Kaç kanalda satıyorsunuz ve bir yıl içinde kaç kanal olacak? Mağaza kasası aynı stoktan düşmeli mi? Ürün kartlarını kim, nerede giriyor? Pazaryeri servisleri değiştiğinde güncellemeyi kim yapacak?
Etic Ajans'ta bu sorunun cevabı için Omnipanel'i geliştirdik. Omnipanel'de Trendyol, Hepsiburada ve Amazon listeleri aynı katalogdan beslenir, siparişler tek havuza düşer, mağaza kasasındaki satış aynı stoktan düşer. Kurulumu ve mevcut kataloğun aktarımını biz yapıyoruz, pazaryeri hesapları markada kalıyor. Kendi sisteminize özel bir bağlantı gerekiyorsa bunu web yazılımları tarafında ayrı bir proje olarak ele alıyoruz.
Mağazanızı, sitenizi ve pazaryeri hesaplarınızı tek stokta toplamak istiyorsanız bize yazın, mevcut kurulumunuza birlikte bakalım.
Sık sorulan sorular
Pazaryeri entegrasyonu için yazılım bilmek gerekir mi?
Hazır bir entegratör ya da tek panel altyapı kullanıyorsanız gerekmez; pazaryerinden aldığınız API bilgilerini panele girmeniz yeterlidir. Doğrudan API entegrasyonu yazmak ise yazılım geliştirme ve sürekli bakım gerektirir.
Trendyol API bilgileri nereden alınır?
Trendyol satıcı panelinde "Hesap Bilgilerim" altındaki "Entegrasyon Bilgileri" sekmesinden alınır. Satıcı ID, API key ve API secret burada yer alır ve yalnızca admin rolündeki ana kullanıcıya görünür. Bu bilgileri herkese açık bir yerde paylaşmayın.
XML entegrasyonu ile API entegrasyonu arasındaki fark nedir?
XML entegrasyonu ürün ve stok listesini belli aralıklarla dosya olarak aktarır ve çoğu zaman tek yönlüdür. API entegrasyonu ise anlık ya da anlığa yakın çalışır ve siparişi, kargo durumunu, iadeyi de geri getirir.
Stok senkronu kaç dakikada bir yapılmalı?
Stok değişikliği olduğu anda gönderilmeli, sipariş ise mümkünse webhook ile anında alınmalıdır. Sabit aralıkla çalışan kurulumlarda aralık ne kadar uzunsa aynı ürünün iki kanalda satılma riski o kadar artar.
Trendyol V1 servisleri kapanınca ne olacak?
Trendyol, ürün ve sipariş servislerinin V1 sürümlerinin 15 Ekim 2026'da kapatılacağını duyurdu. Bu tarihten sonra V1 kullanan entegrasyonlar ilgili işlemleri yapamaz; kendi yazılımını kullananlar V2'ye geçmeli, entegratör kullananlar firmalarından geçişi teyit etmelidir.
Pazaryeri hesaplarım entegrasyon firmasına mı geçer?
Geçmemelidir. Entegrasyon, sizin hesabınızın API bilgileriyle bağlanır; hesap ve satış geçmişi sizde kalır. Sözleşmede bu konuyu ve bağlantıyı sonlandırdığınızda verinin nasıl teslim edileceğini açıkça sorun.