11 Eylül 2026

Pazaryeri ile Kendi E-Ticaret Siteniz Arasında Stok Senkronizasyonu Nasıl Yapılır?

Türkiye'de 2025 yılında 634 bin 611 işletme e-ticaret faaliyetinde bulundu ve genel e-ticaret hacmi bir önceki yıla göre yüzde 11,2 büyüyerek 4,57 trilyon TL'ye ulaştı (T.C. Ticaret Bakanlığı, Türkiye'de E-Ticaretin Görünümü Raporu 2025). Bu işletmelerin büyük kısmı tek bir kanalda değil, hem kendi web sitesinde hem de en az bir pazaryerinde satış yapıyor. Sorun tam da burada başlıyor: aynı ürünün stok bilgisi iki farklı sistemde ayrı ayrı tutulduğunda, er ya da geç bir müşteri stokta olmayan bir ürünü sipariş ediyor ya da tam tersi, aslında satılabilir bir ürün sitede "tükendi" görünmeye devam ediyor.

Bu yazıda pazaryeri ile kendi e-ticaret siteniz arasında stok senkronizasyonunu nasıl kuracağınızı, hangi yöntemin ne zaman işe yaradığını ve Türkiye'deki büyük pazaryerlerinin (Trendyol, Hepsiburada, Amazon) API'lerinin gerçekte hangi kısıtlarla geldiğini somut şekilde anlatıyoruz.

Türkiye E-Ticaretinde 2025 Büyüme Görünümü

Stok Senkronizasyonu Tam Olarak Ne Anlama Gelir?

Stok senkronizasyonu, bir üründen kaç adet satılabilir olduğu bilgisinin, o ürünün satıldığı her kanalda (kendi siteniz, Trendyol, Hepsiburada, Amazon, varsa fiziksel mağaza) aynı anda ve doğru şekilde görünmesini sağlayan sistemdir. Teknik olarak üç parça var: bir merkezi stok kaynağı (genellikle ERP, muhasebe programı ya da e-ticaret altyapınızın kendi veritabanı), bu kaynaktan her kanala giden bir aktarım mekanizması (API çağrısı, dosya aktarımı ya da orta katman yazılımı) ve bir de tetikleyici (satış olduğunda, stok girişi yapıldığında ya da belirli aralıklarla çalışan bir zamanlayıcı).

Burada kritik olan nokta şu: senkronizasyon tek yönlü değil, çift yönlü çalışmak zorunda. Sadece "sitede stok değişince pazaryerine bildir" yeterli değil; "pazaryerinde satış olunca siteye de bildir" adımı olmadan sistem yarım kalır. Aksi halde pazaryerinde satılan bir ürün, siz elle güncelleyene kadar sitenizde satılabilir görünmeye devam eder.

Manuel Takibin Gerçek Maliyeti

Ürün sayısı 30-40'ı geçen bir mağazada stok takibini elle (Excel, panel panel giriş) yapmak matematiksel olarak sürdürülemez hale gelir. Örnek bir senaryo düşünelim: günde 15 farklı üründen toplam 40 adet satan bir mağaza, hem kendi sitesinde hem Trendyol'da hem Hepsiburada'da listelenmiş 200 SKU'ya sahip. Her satış sonrası üç panele elle giriş yapılması gerekiyorsa, günde en az 120 manuel işlem demektir; bunun bir kısmının o gün içinde atlanması ya da geç yapılması kaçınılmazdır.

Bu gecikmenin somut sonucu "fazla satış"tır (overselling): elinizde 3 adet kalan bir ürün aynı anda hem sitenizden hem pazaryerinden sipariş alır, elinizde 2 tane fazladan sipariş kalır. Bunun faturası doğrudan paraya çevrilebilir bir zarar değil ama pazaryeri tarafında performans puanınızı düşürür; Trendyol ve Hepsiburada gibi platformlarda düşük performans puanı, ürünlerinizin arama sonuçlarında daha aşağıda gösterilmesi ya da satıcı hesabının kısıtlanması anlamına gelebilir. Tersi durum, yani aslında satılabilir bir ürünün sitede "tükendi" görünmesi de doğrudan kaybedilmiş bir satış demektir; o müşteri büyük ihtimalle sayfayı kapatıp başka bir satıcıya gider.

Senkronizasyonu Kurmanın Üç Yolu

1. Doğrudan API Entegrasyonu

Her büyük pazaryeri kendi geliştirici dokümantasyonunu yayınlıyor: Trendyol'un entegrasyon dokümantasyonu developers.trendyol.com adresinde, Hepsiburada'nınki ise developers.hepsiburada.com adresinde. Bu yöntemde kendi e-ticaret sisteminiz (ya da yazılım ekibiniz) doğrudan pazaryerinin API'sine bağlanır; stok, fiyat ve sipariş bilgisi ilgili uç noktalar (endpoint) üzerinden karşılıklı akar. Yazılım ekibi olan, birden fazla pazaryerinde satış hacmi yüksek ve özel iş kuralları olan (örneğin bazı ürünleri belirli kanallarda göstermeme) işletmeler için en esnek yöntem budur. Dezavantajı, her pazaryeri için ayrı bir entegrasyon kodu yazmak ve bunu platformlar API'lerini güncelledikçe bakımda tutmak gerektiğidir.

2. Hazır Entegratör / Orta Katman Kullanımı

Kendi API entegrasyonu yazmak istemeyen ya da buna kaynak ayıramayan işletmeler için, sitenizin altyapısı (Ticimax, İdeasoft, İkas, WooCommerce, Shopify gibi) ile pazaryerleri arasında köprü kuran hazır entegratör yazılımları var. Bu araçlar stok, fiyat ve sipariş senkronizasyonunu tek bir panelden yönetmenizi sağlar; teknik bakım yükünü entegratör firma üstlenir. Küçük ve orta ölçekli mağazaların çoğu için pratik başlangıç noktası budur.

3. ERP veya Merkezi Stok Sistemi Üzerinden Yönetim

Fiziksel mağazası da olan, birden fazla depoyla çalışan ya da toptan satış da yapan işletmeler için tek doğru kaynak (single source of truth) bir ERP ya da merkezi stok yazılımı olmalı. Bu modelde e-ticaret sitesi ve tüm pazaryerleri, stok bilgisini doğrudan birbirinden değil, hep aynı merkezi kaynaktan alır. Karmaşıklığı en yüksek ama en az hataya açık kurulum budur; çünkü hiçbir kanal bir diğerinin "gerçek" stok bilgisini tutmaz, hepsi aynı merkeze bakar.

Trendyol, Hepsiburada ve Amazon: API Kısıtları Birbirinden Farklı

Burada çoğu rehberin atladığı bir nokta var: pazaryerlerinin API'leri sınırsız hızda çağrı kabul etmiyor, her birinin kendi hız sınırı (rate limit) ve toplu işlem kuralı var. Bu kısıtları bilmeden kurulan bir entegrasyon, yoğun satış günlerinde (kampanya, indirim günü) sessizce hata vermeye başlayabilir.

Hepsiburada'nın resmî geliştirici dokümantasyonuna göre, listeleme güncelleme uç noktasında aynı anda bekleyen (pending) istek sayısı 5'i geçemiyor ve tek bir istekte en fazla 4000 SKU güncellenebiliyor; ayrıca her satıcının günlük toplu güncelleme limiti, o satıcının listeleme sayısının 10 katıyla sınırlı (örneğin 100 ürünü olan bir satıcı günde en fazla 1000 listeleme güncellemesi yapabiliyor). Bu sınırın aşılması durumunda API 429 hata kodu döndürüyor, yani "çok fazla istek" uyarısı. Pratik sonucu şu: stok güncellemelerini ürün başına tek tek değil, toplu (batch) istekler halinde göndermek ve bir kuyruk mekanizmasıyla hız sınırına takılmadan sırayla işlemek gerekiyor. Trendyol tarafında da entegrasyon, satıcı panelinden alınan API anahtarı ve gizli anahtarla temel kimlik doğrulama (Basic Auth) üzerinden kuruluyor; kimlik doğrulama başlıkları ve servis adresleri zaman içinde güncellenebildiği için entegrasyona başlamadan önce güncel dokümantasyonun kontrol edilmesi öneriliyor.

Bu kısıtlar, "her satış anında anlık senkronizasyon kurayım" diyen bir işletmenin, yüksek trafikli bir kampanya gününde beklenmedik şekilde hız sınırına takılıp güncellemelerin gecikmesiyle karşılaşabileceği anlamına geliyor. Entegrasyonu kuran ekibin bunu baştan bir kuyruk (queue) ve yeniden deneme (retry) mantığıyla tasarlaması, sonradan yama yapmaktan çok daha ucuza mal oluyor.

Pazaryeri Depoları Devredeyken Senkronizasyon Nasıl Değişir?

Burada Türkiye pazarına özgü, çoğu genel rehberin hiç değinmediği bir katman var: büyük pazaryerleri artık sadece satış kanalı değil, aynı zamanda depolama ve kargo hizmeti de sunuyor. Trendyol'un kendi deposu üzerinden depolama, paketleme ve kargo işlemlerini üstlendiği fulfillment modeli ile Hepsiburada'nın benzer hizmeti, satıcının ürününü önceden pazaryerinin deposuna göndermesini ve o andan itibaren stoğun fiziksel olarak iki ayrı yerde (kendi deponuz ve pazaryeri deposu) bulunmasını gerektiriyor.

Bu durumda "tek doğru kaynak" mantığı bozuluyor: aynı üründen bir kısmı sizin elinizdeki depoda, bir kısmı pazaryerinin deposunda duruyorsa, senkronizasyon sisteminin bu ikisini TOPLAMDA değil AYRI AYRI stok havuzları olarak tanıması gerekiyor. Aksi halde, pazaryeri deposundaki adedi de kendi sitenizde satılabilir gibi göstermeye devam edip, sitenizden gelen bir siparişi elinizde olmayan bir üründen karşılamaya çalışırsınız. Birden fazla pazaryerinin fulfillment hizmetini birlikte kullanan mağazalar için bu, entegrasyon kurulurken en baştan tasarlanması gereken bir kuraldır; sonradan eklenecek bir yama değil.

Gerçek Zamanlı mı, Periyodik mi Senkronize Etmeli?

İdeal senaryo her satışın saniyeler içinde tüm kanallara yansımasıdır ama bu her işletme için gerekli ya da mümkün değil. Günde birkaç yüz siparişin üzerindeki, stok derinliği düşük (ürün başına 1-5 adet gibi) mağazalar için gerçek zamanlı (webhook tabanlı) senkronizasyon neredeyse zorunludur; aksi halde fazla satış riski çok yüksektir. Buna karşılık stok derinliği yüksek (ürün başına onlarca-yüzlerce adet) ve sipariş hacmi görece düşük mağazalarda, 15-30 dakikada bir çalışan periyodik senkronizasyon çoğu zaman yeterlidir ve API hız sınırlarını zorlamadan daha kararlı çalışır.

Doğru sıklığı belirlerken tek bir kural yok; ürün başına ortalama stok adedini ve günlük sipariş hacmini birlikte değerlendirmek gerekiyor. Örneğin elinde tekil, sınırlı sayıda el yapımı ürün satan bir mağaza için 30 dakikalık gecikme bile fazla satışa yol açabilirken, geniş stoklu bir tekstil mağazası için bu gecikme pratikte hiç fark yaratmayabilir.

Sık Yapılan Hatalar

Stok senkronizasyonu kurulumlarında tekrar eden birkaç hata var. Birincisi, SKU (stok kodu) eşleşmesinin gözden kaçırılmasıdır; sitedeki ürün kodu ile pazaryerindeki barkod veya ürün kodu birebir eşleşmezse sistem hangi ürünün hangi ürün olduğunu anlayamaz ve yanlış ürünün stoğunu günceller. İkincisi, negatif stok durumunun ele alınmamasıdır; eşzamanlı iki siparişten kaynaklanan kısa süreli negatif stok, sistem tarafından otomatik olarak sıfıra çekilip ilgili sipariş iptal/iade akışına yönlendirilmelidir, aksi halde müşteri hizmetleri elle temizlemek zorunda kalır. Üçüncüsü, varyantlı ürünlerde (farklı beden, renk gibi) her varyantın ayrı bir stok kalemi olduğunun unutulmasıdır; "ürün" bazında değil "varyant" bazında senkronizasyon kurulmazsa belirli bir beden veya renk tükendiğinde bu bilgi diğer kanala yansımaz. Dördüncüsü, entegrasyon hata verdiğinde (API zaman aşımı, hız sınırı, geçici bağlantı sorunu) bunun sessizce yutulmasıdır; bir hata bildirim mekanizması (e-posta, panel uyarısı) olmadan günler boyunca fark edilmeyen bir senkronizasyon kopukluğu, birikimli şekilde çok sayıda hatalı siparişe dönüşebilir. Beşincisi, kampanya günleri için ayrı bir stok kuralı düşünülmemesidir; indirim günlerinde sipariş hacmi kat kat arttığı için, normal günlerde yeterli olan senkronizasyon sıklığı kampanya gününde yetersiz kalabilir ve fazla satış riski o gün için katlanarak büyür. Bu yüzden yüksek trafik beklenen günler öncesinde senkronizasyon sıklığının geçici olarak artırılması ya da düşük stoklu ürünlerin kampanya öncesi elle kontrol edilmesi, birçok işletmenin uyguladığı basit ama etkili bir önlemdir.

Doğru Kurulumu Seçerken Nelere Bakılmalı

Hangi yöntemin doğru olduğu işletmenin büyüklüğüne, ürün sayısına ve kaç kanalda satış yaptığına göre değişir. Tek pazaryeri ve düşük ürün sayısıyla başlayan bir mağaza için hazır entegratör çözümü genellikle yeterlidir; kanal sayısı ve sipariş hacmi büyüdükçe API tabanlı özel entegrasyona ya da merkezi bir stok sistemine geçmek gerekir. Bu kararı verirken sadece bugünkü hacme değil, önümüzdeki 12-18 aydaki büyüme planına göre de düşünmek, ileride sistemi baştan kurmak zorunda kalmamak açısından önemlidir.

Biz Upjen olarak, hangi entegrasyon yönteminin doğru olduğuna karar vermekten API bağlantısının kurulmasına, hız sınırı ve hata yönetimi kurallarının tanımlanmasına kadar sürecin tamamını /hizmetler/pazaryeri-danismanligi kapsamında yönetiyoruz. Çünkü bu konuda en çok karşılaşılan sorun teknik bir eksiklik değil, kurulumun baştan yanlış ölçeklenmesi oluyor; az ürünlü bir mağazaya gereğinden karmaşık bir ERP entegrasyonu ya da yüksek hacimli bir mağazaya yetersiz kalacak basit bir entegratör önerilmesi, ikisi de sonradan pahalıya mal oluyor.

Sıkça Sorulan Sorular

Stok senkronizasyonu kurmak ne kadar sürer? Hazır entegratör kullanılan bir kurulumda birkaç gün içinde çalışır hale gelebilir. Özel API entegrasyonu ya da ERP bağlantısı gerektiren daha karmaşık kurulumlarda, kanal sayısına ve mevcut altyapının durumuna göre bu süre birkaç haftaya kadar uzayabilir.

Tek bir pazaryerinde satış yapıyorum, yine de senkronizasyona ihtiyacım var mı? Evet, kendi sitenizle tek bir pazaryeri arasında bile senkronizasyon kurulmazsa aynı fazla satış ve stok tutarsızlığı riskleri geçerlidir. Kanal sayısı arttıkça risk büyür ama iki kanal bile elle takip için yeterince kırılgandır.

Senkronizasyon fiyat bilgisini de kapsıyor mu? Stok senkronizasyonu ile fiyat senkronizasyonu genellikle aynı altyapı üzerinden, aynı API uç noktaları kullanılarak yürütülür; ikisini ayrı sistemlerde tutmak yerine tek bir entegrasyon kapsamında yönetmek karmaşıklığı azaltır.

Senkronizasyon hata verirse ne olur, siparişler kaybolur mu? Doğru kurulmuş bir sistemde entegrasyon geçici olarak hata verse bile sipariş verileri kaybolmaz; API yeniden deneme (retry) mekanizmaları ve kuyruklama, geçici bağlantı sorunlarını telafi eder. Riskli olan, bu hataların fark edilmeden uzun süre devam etmesidir; bu yüzden bir uyarı/bildirim mekanizması kurmak kritik önem taşır.

Pazaryerinin kendi deposunu (fulfillment) kullanıyorsam senkronizasyon farklı mı kurulmalı? Evet. Ürününüzün bir kısmı pazaryerinin deposunda, bir kısmı kendi deponuzda duruyorsa, bu iki stok havuzu ayrı ayrı izlenmeli ve toplanmamalıdır; aksi halde pazaryeri deposundaki adet kendi sitenizde de satılabilir gibi görünüp elinizde olmayan bir üründen sipariş almanıza yol açabilir. Bu senaryoyu kullanan mağazaların entegrasyon kurulumunda bu ayrımı en baştan tanımlaması gerekir.

Sonuç

Pazaryeri ile kendi siteniz arasındaki stok senkronizasyonu, ürün sayısı ve kanal sayısı arttıkça elle yönetilemeyecek bir noktaya kaçınılmaz şekilde ulaşır. Doğru yöntem işletmenin ölçeğine göre değişir: küçük ölçekte hazır entegratör yeterliyken, büyüyen ve çok kanallı bir yapıda API tabanlı özel entegrasyon ya da merkezi bir stok sistemi gerekir. Hangi yöntem seçilirse seçilsin, pazaryerlerinin kendi API kısıtlarını (hız sınırı, toplu işlem limiti) bilmeden kurulan bir sistem, tam da en çok satış yapılan yoğun günlerde sessizce aksamaya başlar. Bu yüzden kurulum aşamasında sadece "stok nasıl aktarılır" sorusuna değil, "hata anında ne olur" sorusuna da net bir cevap olması gerekir.