Pazaryeri Entegrasyonu Nedir? Stok, Fiyat ve Sipariş
Yapay zeka destekli taslak; yayından önce baştan sona okunur ve iddialar birincil kaynaklara karşı kontrol edilir. İçerik üretim sürecimiz

Pazaryeri entegrasyonu, kendi e-ticaret sitenizdeki ya da stok programınızdaki ürün, stok, fiyat ve sipariş bilgisinin Trendyol, Hepsiburada gibi pazaryerleriyle otomatik olarak eşitlenmesidir. Ürün bir kez tanımlanır, stok ve fiyat tek yerden güncellenir, pazaryerinden gelen sipariş aynı panele düşer. Böylece aynı ürün iki kanalda elle takip edilmez ve stokta olmayan ürün satılma riski azalır.
Entegrasyon bir eklenti kurmaktan ibaret görünse de asıl iş verinin hazırlanmasıdır. Barkodu, varyantı ya da kategorisi eksik bir ürün kataloğu, hangi yazılım bağlanırsa bağlansın pazaryerine düzgün aktarılmaz. Bu yüzden entegrasyonun neyi eşitlediğini, hangi yolla kurulduğunu ve hangi veri kurallarına takıldığını bilmek, entegratör seçiminden önce gelir.
Pazaryeri entegrasyonu neyi eşitler?
Pazaryeri entegrasyonu beş veri akışını eşitler: ürün kartı, stok, fiyat, sipariş ve iade. Her akışın yönü farklıdır. Ürün, stok ve fiyat sizden pazaryerine gider. Sipariş ve iade ise pazaryerinden size gelir.
Trendyol'un geliştirici belgelerindeki entegrasyon servislerine genel bakış bu kapsamı açıkça sayar: Partner Programı'na katılan firmalar API servisleri üzerinden mağazalarını kendi e-ticaret sistemlerine bağlayarak ürün aktarımı, stok ve fiyat güncellemesi, sipariş işlemleri, fatura gönderimi ve müşteri soruları işlemleri yapabilir. Belgede webhook entegrasyonu da ayrı bir başlık olarak yer alır.
| Akış | Yön | Ne zaman tetiklenir | Aksarsa ne olur |
|---|---|---|---|
| Ürün kartı | Sizden pazaryerine | Yeni ürün açıldığında, içerik değiştiğinde | Ürün onaya düşmez ya da eksik görünür |
| Stok | Sizden pazaryerine | Her satışta, depo girişinde | Stokta olmayan ürün satılır, iptal gerekir |
| Fiyat | Sizden pazaryerine | Kampanya, maliyet değişikliği | Kanallar arasında fiyat farkı oluşur |
| Sipariş | Pazaryerinden size | Müşteri satın aldığında | Sipariş görülmez, kargo gecikir |
| İade | Pazaryerinden size | Müşteri iade talebi açtığında | Para iadesi ve stok düzeltmesi gecikir |
Tablodaki beş akışın hepsi her entegrasyonda bulunmaz. Bazı yazılımlar yalnızca stok ve fiyat eşitler, siparişi pazaryerinin kendi panelinde bırakır. Teklif alırken hangi akışların kapsamda olduğunu tek tek sormak, sonradan "sipariş de gelir sanıyordum" sürprizini önler.
Stok ve fiyat eşitlemesi nasıl çalışır?
Stok ve fiyat eşitlemesi, sizin sisteminizdeki değerin belirli aralıklarla ya da her değişiklikte pazaryerine gönderilmesiyle çalışır. Pazaryeri bu değeri satılabilir stok olarak kabul eder ve satış olduğunda kendi tarafında düşer.
Trendyol'un stok ve fiyat güncelleme belgesi bu akışın ayrıntılarını verir. Belgeye göre gönderilen stok satılabilir stok bilgisidir ve sipariş alındığında ya da satıcı yeniden stok gönderdiğinde güncellenir. Tek istekte en fazla 1000 ürün (SKU) güncellenebilir. Değişiklik yapılmadan aynı istek tekrar gönderilirse "15 dakika boyunca aynı isteği tekrarlı olarak atamazsınız!" hatası döner ve belge yalnızca değişen stok ve fiyatların gönderilmesini ister.
Bu kuralların işletme açısından anlamı şudur: entegrasyon yazılımı "her dakika bütün kataloğu gönder" mantığıyla kurulmuşsa pazaryeri tarafında hata üretir. Doğru kurgu, yalnızca değişen kayıtları gönderen bir kuyruktur. Teklif aşamasında yazılımın değişiklik bazlı mı yoksa toplu mu çalıştığı sorulmalıdır.
Belgede iki fiyat alanı ayrı tanımlanır: liste fiyatı (satış fiyatı düşük olduğunda üstü çizili görünen fiyat) ve satış fiyatı. Kendi sitenizde tek fiyat alanı varsa, entegrasyon kurulmadan önce hangi alanın pazaryerinde hangi alana eşleneceği kararlaştırılmalıdır. Aksi hâlde kampanya döneminde üstü çizili fiyat yanlış görünebilir.
Sipariş ve kargo akışı nasıl işler?
Sipariş akışı, pazaryerinde oluşan siparişin sizin sisteminize çekilmesi, hazırlanması ve kargo bilgisinin pazaryerine geri bildirilmesiyle işler. Sipariş çekme belirli aralıklarla sorgu atarak ya da pazaryerinin sizi haberdar ettiği webhook modeliyle yapılır.
Trendyol'un sipariş süreci akışı belgesindeki şema bu adımları sıralar: satıcı siparişi sipariş paketlerini çekme servisinden ya da webhook modelinden alır, "Picking" (toplama) statüsünü bildirir, isteğe bağlı olarak "Invoiced" (faturalandı) statüsünü bildirir ve paket mevcut kargo takip numarasıyla gönderilir. Tedarik edilemeyen ürün için paketin tamamına ya da bir kısmına iptal isteği gönderilebilir. Kısmi iptalde mevcut paket bozulur ve aynı sipariş numarası altında yeni bir paket oluşur.
Bu son ayrıntı, entegrasyonun neden yalnızca "siparişi göster" düzeyinde kalmaması gerektiğini anlatır. Kısmi iptal sonrası oluşan yeni paket numarası sizin sisteminize yansımazsa kargo etiketi eski pakete basılır. Kargo tarafının kendi kuralları da vardır. Kendi sitenizdeki gönderimlerin kargo firmasıyla nasıl bağlandığını kargo entegrasyonunun kurulum sırası ele alır, pazaryeri siparişlerinde ise etiket ve takip numarası pazaryerinin akışına göre üretilir.
Entegrasyon hangi yollarla kurulur?
Pazaryeri entegrasyonu üç yoldan biriyle kurulur: e-ticaret altyapısının kendi modülü, bağımsız bir entegratör yazılımı ya da pazaryerinin API'sine doğrudan yazılan özel bağlantı.
| Yol | Nasıl çalışır | Uygun olduğu durum | Dikkat edilecek nokta |
|---|---|---|---|
| Altyapının modülü | Hazır e-ticaret paketinin panelinden açılır | Ürünler zaten o altyapıda, kanal sayısı az | Modülün hangi akışları kapsadığı |
| Entegratör yazılımı | Site, pazaryerleri ve bazen muhasebe arasında aracı panel | Birden fazla pazaryeri, tek stok | Aylık ücret, veri sahipliği, çıkış yolu |
| Doğrudan API | Pazaryeri API'sine özel kod yazılır | Kendi yazılımı olan, özel iş kuralı gereken işletme | Bakım yükü, API sürüm değişiklikleri |
Doğrudan API yolunun bakım yükü küçümsenmemelidir. Trendyol geliştirici portalının açılış sayfası, 21 Kasım 2026'da okunduğunda ürün ve sipariş servislerinin V2 sürümlerinin yayında olduğunu ve V1 servislerinin 15 Ekim 2026 itibarıyla kullanıma kapatılacağını duyuruyordu. Kendi yazdığınız bağlantı bu tür sürüm geçişlerinde güncellenmezse sipariş akışı bir gün sessizce durur. Hazır modül ya da entegratör kullanılıyorsa bu güncellemeyi sağlayıcı yapar, ama yaptığını teyit etmek yine sizin işinizdir.
Hangi yolun seçileceği, ürünlerin bugün nerede tutulduğuna bağlıdır. Kendi siteniz henüz yoksa önce kanal kararını vermek gerekir. Bu kararın ölçütlerini pazaryeri mi kendi e-ticaret sitesi mi karşılaştırması tablo hâlinde verir. Site varsa ve altyapı seçimi yeniden düşünülüyorsa entegrasyon desteği altyapı karşılaştırmasının ölçütlerinden biri olur.
Servis limitleri entegrasyonu nasıl etkiler?
Servis limitleri, entegrasyonun dakikada kaç istek gönderebileceğini belirler ve büyük katalogda güncellemelerin gecikmesine yol açabilir. Limit aşıldığında istekler reddedilir. Yazılım bunu yönetmiyorsa stok güncellemesi kaybolur.
Trendyol'un servis limitleri belgesi, 14 Eylül 2026'dan itibaren geçerli ürün servis limitlerini satıcının ürün listeleme limiti seviyesine göre tablo hâlinde verir. Limitler tekil servis bazında değil servis grupları bazında ortak uygulanır. Örneğin belgedeki örnekte "Product Integration Write" grubu için dakikada 200 istek limiti varsa ürün aktarma, ürün güncelleme ve ürün silme istekleri bu 200'ü birlikte paylaşır. Belge ayrıca aynı barkod için dakikada 30'dan fazla fiyat güncelleme isteği gönderilirse o barkod için hata döneceğini yazar.
Küçük bir katalogda bu sınırlara takılmak zor görünür. Sorun kampanya günlerinde çıkar: yüzlerce ürünün fiyatı aynı anda değişir, stok hızla düşer ve entegrasyon aynı dakikada çok sayıda istek gönderir. Entegratöre sorulacak soru basittir: limit aşıldığında istekler kuyrukta bekletiliyor mu, yoksa düşürülüyor mu?
Ürün verisi entegrasyondan önce nasıl hazırlanır?
Ürün verisi, her ürünün benzersiz bir barkodu ya da stok kodu, doğru varyant yapısı, pazaryerinin kategori ağacına eşlenmiş kategorisi ve eksiksiz özellik alanlarıyla hazırlanır. Entegrasyon bu veriyi taşır, eksik veriyi tamamlamaz.
Hazırlık için kontrol listesi:
- Barkod ve stok kodu: Her varyantın (beden, renk) kendi barkodu olmalıdır. Aynı barkodun iki üründe kullanılması stok karışıklığının en temel kaynağıdır.
- Varyant yapısı: Ana ürün ve varyantları sizin sisteminizde nasıl gruplanıyorsa pazaryerinde de öyle gruplanmalıdır. Trendyol'un ürün aktarma belgesi varyantlama işlemlerini ayrıca anlatır.
- Kategori eşlemesi: Sizin kategori adlarınız pazaryerinin kategori ağacıyla aynı değildir. Her kategori için bir eşleme tablosu kurulur.
- Özellik alanları: Pazaryerleri kategoriye göre zorunlu özellik ister (malzeme, ölçü, renk). Bu alanlar boşsa ürün onaya düşmeyebilir.
- Görseller: Görsel adresleri erişilebilir olmalı, ürünle eşleşmeli.
- Fiyat alanları: Liste fiyatı ile satış fiyatının hangi alandan okunacağı belirlenir.
Bu listenin ilk iki maddesi kendi sitenizin de temelidir. Ürün verisini düzgün tutan bir katalog, Google'ın alışveriş yüzeylerine gönderilen ürün beslemesinde de işe yarar. Aynı verinin Google tarafında nasıl kullanıldığını Google Merchant Center'ın ne işe yaradığını anlatan yazı açıklar.
Stok tek kaynaktan nasıl yönetilir?
Stok, bütün kanalların okuduğu tek bir ana kayıttan yönetilir. Bu ana kayıt kendi siteniz, bir stok programı ya da entegratör paneli olabilir. Önemli olan, stok değerinin yalnızca tek yerde değiştirilmesidir.
İki yerde stok tutulduğunda şu senaryo yaşanır: depodan bir ürün satılır, kendi sitede stok düşülür, ama pazaryeri paneline elle de bir giriş yapılır. Entegrasyon bir sonraki eşitlemede sitedeki değeri pazaryerine gönderir ve elle yapılan giriş kaybolur. Ya da tersi olur. Kural tektir: entegrasyon kurulduktan sonra pazaryeri panelinde stok elle değiştirilmez.
Ana kaydın nerede tutulacağı, depo yapınıza ve satış hacminize göre değişir. Site, pazaryeri ve fiziksel depo arasında stok senkronunun nasıl kurulduğunu e-ticarette stok takibini işleyen yazı adım adım verir. Pazaryeri entegrasyonu bu yapının bir parçasıdır, tek başına stok yönetimi değildir.
Stok tamponu da bir karardır. Bazı işletmeler pazaryerine gerçek stoktan birkaç adet eksik gönderir, böylece eşitleme gecikse bile son ürünün iki kanalda birden satılma ihtimali düşer. Bu bir yazılım özelliği değil, işletmenin vereceği bir karardır ve entegrasyon ayarlarında tanımlanabilir olmalıdır.
Entegrasyon sonrası hangi hatalar çıkar?
Entegrasyon sonrası çıkan hatalar dört grupta toplanır: ürün onayına düşmeyen kayıtlar, eşitlenmeyen stok, yanlış eşlenen fiyat ve görünmeyen sipariş. Her birinin kaynağı farklıdır.
| Belirti | Olası kaynak | İlk kontrol |
|---|---|---|
| Ürün pazaryerinde görünmüyor | Eksik zorunlu özellik, kategori eşlemesi | Ürün aktarma sonucunun hata mesajı |
| Stok güncellenmiyor | Aynı isteğin tekrarı, limit aşımı, barkod uyuşmazlığı | Toplu işlem sonucu sorgusu |
| Üstü çizili fiyat yanlış | Liste fiyatı ile satış fiyatı alanları ters eşlenmiş | Alan eşleme tablosu |
| Sipariş panele düşmüyor | Sipariş çekme aralığı, API sürüm değişikliği | Son başarılı sipariş çekme zamanı |
| İade stoku geri gelmiyor | İade akışı kapsam dışı | Entegrasyon kapsam listesi |
Trendyol'un stok ve fiyat belgesi, bu yöntemle yapılan işlemlerin durumunun ayrı bir toplu işlem kontrol servisi üzerinden kontrol edilmesi gerektiğini vurgular. Pratikte bu, isteğin gönderilmiş olmasının işlemin başarılı olduğu anlamına gelmediği demektir. İyi bir entegrasyon paneli bu sonuçları okur ve başarısız kayıtları listeler. Paneliniz yalnızca "gönderildi" diyorsa hatalar sessizce birikir.
Hataların bir kısmı satışı doğrudan etkiler. Stokta olmayan ürün satıldığında sipariş iptal edilir ve pazaryerleri iptal oranını satıcı performansının bir parçası olarak izler. Bu yüzden entegrasyonun ilk haftası, günlük olarak hata listesine bakılan bir deneme dönemi olarak planlanmalıdır.
Kendi siteniz ile pazaryeri arasında hangi kararlar verilir?
Entegrasyon kurulurken teknik ayarların yanında üç ticari karar verilir: hangi ürünlerin hangi kanalda satılacağı, fiyatın kanallar arasında aynı mı farklı mı olacağı ve sipariş önceliği.
Ürün seçimi: Bütün kataloğu her kanala göndermek zorunlu değildir. Pazaryeri komisyonu yüksek kategorilerde bazı ürünler yalnızca kendi sitede kalabilir.
Fiyat politikası: Pazaryeri komisyonu ve kargo koşulları kendi sitenizinkinden farklıdır. Entegrasyon yazılımlarının bir kısmı kanal bazında fiyat kuralı (örneğin pazaryerine yüzde ekleyerek gönderme) tanımlamaya izin verir. Bu kural yoksa iki kanalda aynı fiyat zorunlu hâle gelir.
Sipariş önceliği: Son ürün için iki kanaldan aynı anda sipariş geldiğinde hangisinin karşılanacağı önceden belirlenmelidir.
Bu kararlar kendi sitenizin satış payını da etkiler. Pazaryeri trafiği hazırdır, kendi siteniz ise trafiği kendisi çekmek zorundadır. Kendi siteye ziyaretçi getirmenin yolları e-ticaret SEO'sunun kategori ve ürün sayfası tarafı ile başlar, reklamla desteklenir.
Entegrasyon kurulumunda kim neyi yapar?
Entegrasyon kurulumunda işin bir kısmı satıcıda, bir kısmı entegratörde ya da altyapı sağlayıcısında kalır. Sınırı baştan yazmak, bir hata çıktığında kimin bakacağını belirler.
Satıcının işi: pazaryeri satıcı panelinden API bilgilerini almak ve paylaşmak, ürün verisini hazırlamak, kategori eşlemesini onaylamak, fiyat politikasını belirlemek ve ilk hafta hata listesini takip etmek. Entegratörün ya da geliştiricinin işi: bağlantıyı kurmak, alan eşlemesini yapmak, limitleri ve hata yönetimini ayarlamak, API sürüm değişikliklerini izlemek.
API bilgilerinin paylaşılması ayrıca dikkat ister. Pazaryeri API anahtarı mağazanız üzerinde işlem yapma yetkisi verir. Bu bilgi e-postada düz metin olarak dolaşmamalı, entegrasyon sona erdiğinde yenilenmelidir. Trendyol'un geliştirici portalında canlı ve test ortamları için IP yetkilendirmesine ayrılmış bir başlık da bulunur. Entegratör test ortamında deneme yapmadan canlı mağazaya bağlanmamalıdır.
Test ortamı yalnızca bağlantının çalıştığını göstermek için değil, iş kurallarını denemek için de kullanılır. Trendyol'un sipariş entegrasyonu başlığı altında test siparişi oluşturma ve test siparişlerinde statü güncellemeleri için ayrı belgeler bulunur. Canlıya geçmeden önce en az şu dört senaryo denenmelidir: tek ürünlü sipariş, çok ürünlü sipariş, ürünlerden biri tedarik edilemediği için kısmi iptal ve müşterinin iade talebi. Her senaryoda stokun doğru düştüğü, kargo bilgisinin pazaryerine geri gittiği ve iptal edilen ürünün stoğa geri eklendiği kontrol edilir. Bu dört deneme, canlıda ilk kampanya gününde yaşanacak sorunların önemli bir kısmını önceden gösterir.
Kendi siteniz henüz kurulmadıysa ürün verisi yapısını en baştan pazaryeri entegrasyonuna uygun tasarlamak, sonradan veri düzeltmekten daha az iş çıkarır. Siteyi bir ajansa yaptırırken bu konuyu brief'e eklemenin yolu e-ticaret sitesi hazırlık dosyasında yer alır. Ürün verisinin kurulum aşamasında şema ve besleme dosyalarıyla birlikte hazırlanması, e-ticaret sitesi kurulumu işinin bir parçasıdır.
Entegrasyonu değerlendirirken bakılacak ölçü bağlantının kurulmuş olması değil, ilk ay sonunda iptal edilen sipariş sayısı ve elle düzeltilen stok kaydı sayısıdır. İki sayı da sıfıra yaklaşıyorsa entegrasyon işini yapıyordur. Düşmüyorsa sorun yazılımın kendisinden önce veride ya da iki yerde tutulan stokta aranmalıdır.
Sıkça Sorulan Sorular
Pazaryeri entegrasyonu nedir?
Pazaryeri entegrasyonu, kendi e-ticaret sitenizdeki ya da stok programınızdaki ürün, stok, fiyat ve sipariş bilgisinin Trendyol, Hepsiburada gibi pazaryerleriyle otomatik olarak eşitlenmesidir. Ürün bir kez tanımlanır, stok ve fiyat tek yerden güncellenir, pazaryerinde oluşan sipariş aynı panele düşer. Amaç aynı ürünü iki kanalda elle takip etmemek ve stokta olmayan ürünün satılmasını önlemektir.
Trendyol entegrasyonu nasıl yapılır?
Trendyol entegrasyonu, satıcı panelinden alınan API bilgileriyle e-ticaret altyapınızın modülü, bir entegratör yazılımı ya da özel yazılan bir bağlantı üzerinden kurulur. Trendyol'un geliştirici belgeleri ürün aktarımı, stok ve fiyat güncellemesi, sipariş işlemleri ve fatura gönderimini API servisleri olarak tanımlar. Kurulumdan önce barkod, varyant ve kategori eşlemesi hazırlanmalı, ilk denemeler test ortamında yapılmalıdır.
Pazaryeri entegrasyonu ücretsiz yapılabilir mi?
Bazı e-ticaret altyapıları pazaryeri modülünü paket içinde sunar, bazı entegratörler ise aylık ücret alır. Pazaryerlerinin API servisleri satıcılara açıktır, ama doğrudan API bağlantısı yazmak geliştirme ve bakım emeği ister. Bu yüzden ücretsiz görünen yolun maliyeti yazılım lisansının yanında kurulum, veri hazırlığı ve API sürüm değişikliklerinde takip gereken zamanda ortaya çıkar.
Entegrasyon varken pazaryeri panelinde stok değiştirilir mi?
Değiştirilmemelidir. Entegrasyon kurulduktan sonra stok yalnızca ana kayıtta, yani sitenizde, stok programınızda ya da entegratör panelinde güncellenir. Pazaryeri panelinde elle yapılan değişiklik bir sonraki eşitlemede ana kayıttaki değerle ezilir. Bu da gerçek stokla pazaryerinde görünen stok arasında fark doğurur ve stokta olmayan ürünün satılmasına yol açabilir.
Entegrasyonda stok güncellemesi neden gecikir?
Gecikmenin üç olası kaynağı servis limitleri, aynı isteğin tekrar gönderilmesi ve barkod uyuşmazlığıdır. Trendyol belgeleri limitleri servis grupları bazında ortak uyguladığını, değişmeyen isteğin 15 dakika içinde tekrarını reddettiğini ve aynı barkod için dakikalık fiyat güncelleme sınırı olduğunu yazar. Entegrasyonun yalnızca değişen kayıtları göndermesi ve başarısız işlemleri listelemesi gecikmeyi azaltır.