Trendyol ve Hepsiburada Entegrasyonu: Stok ve Sipariş Senkronizasyonu

Cuma akşamı, tek kalan ürün iki kez satıldı#

Ev tekstili satan bir firma. Depoda o renkten tek bir nevresim takımı kaldı. Saat 20:14’te Trendyol’dan sipariş düşüyor, 20:21’de Hepsiburada’dan aynı ürün için ikinci sipariş geliyor. Stok senkronizasyonu 30 dakikada bir çalışıyor. İkinci sipariş girdiğinde sistem hâlâ “1 adet var” diyor.

Pazartesi sabahı depo ekibi ikinci siparişi hazırlayamıyor. Sipariş iptal ediliyor. İptal, satıcı kaynaklı olarak kaydediliyor ve mağaza puanı düşüyor, o ürünün kategori sıralaması geriliyor, kampanya başvurusu reddediliyor. Müşteri olumsuz yorum bırakıyor.

Kaybedilen şey 400 ₺’lik bir sipariş değil. Kaybedilen şey, o kategoride iki ay boyunca üstte kalmayı sağlayan görünürlük.

Bu senaryonun can sıkıcı tarafı, firmanın aslında bir entegrasyona sahip olmasıdır. Sistem çalışıyordu, stoklar akıyordu, panelde yeşil tikler vardı. Sorun entegrasyonun varlığında değil, hangi mantıkla kurulduğundaydı.

Bu neden oluyor?#

Aşırı satışın teknik sebepleri birkaç başlıkta toplanıyor ve hemen hepsi mimari tercihten kaynaklanıyor.

Periyodik tarama gecikmesi. Sistem 15 veya 30 dakikada bir tüm ürünlerin stoğunu pazaryerlerine gönderir. İki tarama arasındaki boşluk kördür. Hızlı satan üründe o boşluk yeterlidir.

Webhook kaçırma. Trendyol ve Hepsiburada sipariş olaylarını anlık bildirim olarak gönderebilir. Sunucunuz o an yanıt vermezse, 500 hatası dönerse ya da yanıt süresi aşılırsa bildirim kaybolur. Yeniden deneme davranışı sınırlıdır ve sonsuz değildir. Kaçan tek bir webhook, düşmeyen bir stok demektir.

Birden fazla doğruluk kaynağı. Stok bilgisi hem ERP’de, hem kendi e-ticaret sitenizde, hem de her pazaryerinin panelinde ayrı ayrı tutuluyorsa hangisinin doğru olduğu sorusunun cevabı yoktur. Depo sayımı yapan kişi ERP’yi, kampanya açan kişi paneli günceller ve iki rakam birbirinden uzaklaşır.

Hız sınırı (rate limit). Pazaryeri API’leri dakikada belirli sayıda isteğe izin verir. 8.000 ürünü tek seferde güncellemeye çalışan bir sistem sınıra takılır, istekler reddedilir ve kuyruk yoksa o güncellemeler kaybolur.

Elle yapılan düzeltmeler. Panelden tek bir ürünün stoğu elle değiştirildiğinde, bir sonraki senkronizasyon o değişikliği ezer. Bu döngü depo ekibiyle yazılım arasında sürekli bir güvensizlik üretir.

Doğru mimari dört parçadan oluşur#

Bu dördü bir arada olduğunda sistem, sağlayıcı tarafındaki kesintilere dayanıklı hale gelir. Trendyol API’si 20 dakika yanıt vermese bile kuyruk birikir, servis ayağa kalktığında sıradaki her mesaj işlenir ve stok doğru yerine oturur.

Buna iki mekanizma daha eklenir. Birincisi, webhook’a ek olarak çalışan mutabakat taraması: 10–15 dakikada bir tüm aktif ürünlerin stoğu pazaryerinden okunur, kendi kaydınızla karşılaştırılır ve fark varsa düzeltilir. İkincisi, emniyet payı: hızlı tükenen ve tek haneli stoğa düşen ürünlerde 1–2 adetlik tampon bırakmak, kalan gecikme riskini pratikte ortadan kaldırır.

Kendi altyapınızı kurarken bu bileşenleri sıfırdan yazmak zorunda değilsiniz; API entegrasyonları tarafında kuyruk, tekrar deneme ve loglama zaten standart mimarinin parçası olarak geliyor. N11 veya Çiçeksepeti gibi üçüncü bir kanal eklendiğinde de değişen tek şey o pazaryerinin API adaptörü olur; stok mantığına, kuyruğa ve fatura akışına dokunulmaz.

Müşteri tarafındaki soru ve iade yazışmalarının da aynı havuzda toplanması gerekir; bu kısım çoğu zaman entegrasyon kapsamı dışında kalır ve CRM’e bağlanır. Neyin CRM’e ait olduğuna karar vermek için CRM nedir, hangi işletmeye gerekli yazısı işinizi görür.

Hazır entegratör mü, özel geliştirme mi?#

Aşağıdaki rakamlar 2026 üçüncü çeyreğinde Türkiye’deki pazaryeri entegratörlerinin yayınlanmış paket fiyatlarından ve aynı dönemde alınan yazılım ajansı tekliflerinden derlenmiştir. KDV hariçtir.

Net görüşüm: aylık sipariş sayısı 500’ün altındaki firmaların özel entegrasyon yazdırması kaynak israfıdır. 9.000 ₺’lik aylık abonelik üç yılda 324.000 ₺ eder, evet, ama o üç yılda entegratör sizin yerinize her API değişikliğini takip eder ve yeni pazaryeri eklendiğinde ek geliştirme faturası çıkarmaz.

Tek bir pazaryerinde satıyorsanız ve günlük sipariş adediniz 10’un altındaysa entegrasyon almayın. Trendyol panelinden elle yönetmek daha hızlı, daha ucuz ve daha az hatalıdır. Entegrasyon, ikinci kanal açıldığında ya da elle giriş günde bir saati geçtiğinde anlamlı olur.

Özel geliştirmeye geçtiğiniz noktada entegrasyonun ERP tarafıyla birlikte tasarlanması gerekir; bu ikisini ayrı projeler gibi yürütmek en sık yapılan planlama hatasıdır. Kurumsal yazılım ve ERP tarafını hiç kurmadıysanız önce KOBİ’ler için ERP nedir yazısını okuyun.

Devreye alma: sekiz adım#

1. Ürün eşleştirme. Kendi stok kodunuz ile pazaryerindeki barkod arasında birebir eşleşme kurun. Eşleşmeyen ürün senkronize edilmez.
2. Test ortamı. Trendyol ve Hepsiburada’nın sandbox ortamlarında sipariş, iptal, iade ve stok güncelleme senaryolarını uçtan uca çalıştırın.
3. Tek yönlü başlangıç. İlk hafta yalnızca sipariş çekin, stok göndermeyin. Veri akışının doğruluğunu izleyin.
4. Pilot ürün grubu. 30–50 ürünle stok göndermeye başlayın. Tüm katalogla başlamak, hatayı 8.000 üründe birden yaşamak demektir.
5. Paralel kontrol. İki hafta boyunca her sabah pazaryeri panelindeki stok ile ERP’deki stoğu karşılaştırın. Fark çıkan ürünleri not edin.
6. Tam açılış. Fark oranı binde birin altına indiğinde tüm kataloğu açın.
7. Fatura akışı. Sipariş kesinleştiğinde GİB e-fatura veya e-arşiv belgesinin otomatik üretilmesini ve pazaryerine yüklenmesini bağlayın.
8. Uyarı kurulumu. Kuyrukta 100’den fazla bekleyen mesaj, art arda 5 başarısız API çağrısı ve 10 dakikadan uzun süren stok gecikmesi için bildirim tanımlayın.

Bu sekiz adımın atlanmaya en meyilli olanı dördüncüsüdür. Herkes tüm katalogla başlamak ister, çünkü pilot aşama zaman kaybı gibi görünür; oysa 8.000 ürünlük yanlış bir fiyat gönderimini geri almak, pilot aşamada harcanacak beş günün kat kat üzerinde maliyet çıkarır.

Komisyon, kargo ve mutabakat#

Entegrasyonun en çok ihmal edilen tarafı muhasebe tarafıdır. Pazaryeri size sipariş tutarını değil, komisyon ve hizmet bedelleri düşülmüş net tutarı öder.

Bu beş kalem otomatik eşleşmiyorsa ay sonunda muhasebe ekibi elle Excel birleştirmek zorunda kalır. 2.000 siparişlik bir ayda bu iş iki tam gün sürer ve hata payı yüksektir. Entegrasyonun hakediş raporlarını da çekmesini isteyin; çoğu firma bunu kapsam dışı bırakıp altı ay sonra ek proje olarak yaptırıyor.

İzleme olmadan entegrasyon yoktur#

Kurulan entegrasyonun sessizce bozulması, hiç kurulmamış olmasından daha tehlikelidir. Çünkü kimse kontrol etmez.

İzlenmesi gereken dört gösterge: kuyruktaki bekleyen mesaj sayısı, son başarılı stok güncellemesinin üzerinden geçen süre, başarısız API çağrısı oranı ve pazaryeri ile kendi kaydınız arasındaki stok farkı. Bunların hepsi tek bir panelde görünmeli ve eşik aşıldığında telefonunuza bildirim düşmeli.

Haftada bir kez rastgele 20 ürün seçip stoğu elle doğrulayın. Beş dakikalık bu alışkanlık, üç ay sonra ortaya çıkacak sistematik bir eşleştirme hatasını ilk haftasında yakalar.

Bildirimlerin kime gideceği de baştan yazılı olsun. “Sistem uyarı veriyordu ama kimse bakmıyordu” cümlesi, entegrasyon kazalarının en sık duyulan açıklamasıdır; uyarının bir sahibi yoksa uyarı yok demektir. Depo sorumlusu, muhasebe ve yazılım tarafı için ayrı eşikler tanımlayın.

Karar kuralı#

Şu üç soruya evet diyorsanız entegrasyon yatırımı kendini öder: ikiden fazla satış kanalınız var mı, elle sipariş ve stok girişi günde bir saatten fazla sürüyor mu, son üç ayda stok kaynaklı en az bir iptal yaşadınız mı? Üçüne de hayır diyorsanız bu projeyi erteleyin ve parayı dijital reklam yönetimi ya da ürün fotoğrafı tarafına harcayın.

Kanal sayısı arttıkça entegrasyonun getirisi doğrusal değil, üstel büyür; çünkü hata olasılığı kanal sayısıyla birlikte artarken, tek doğruluk kaynağı bu olasılığı sabit tutar.

Mevcut kurulumunuzun hangi noktada sızdırdığını birlikte çıkarmak için iletişim sayfasından yazın. Diğer hizmetlerimize, sık gelen sorular için SSS sayfasına, benzer karar rehberleri için blog bölümüne bakabilirsiniz.