Dijital Ürün Scripti ile Stok Tedarikçi Webhook'u: Gece Üçte Biten Stoğun Müşteri Fark Etmeden Nasıl Kendini Doldurduğunu Anlatan Teknik Rehber

Stok tükenmesi, dijital ürün satan bir işletmenin en sinsi kayıp kalemidir. Fiziksel üründe raf boşaldığında görürsün; dijitalde ise sistem sessizce "stokta yok" yazar, müşteri geri gider ve sen bu kaybı hiçbir raporda göremezsin. Çoğu satıcı bunu "tedarikçiden mal gelmedi" diye açıklar. Gerçek sebep genellikle bu değildir.

Gerçek sebep, e-pin scripti ile tedarikçi arasındaki bilgi akışının insan hızında çalışmasıdır. Birisi sabah bakacak, kalan adedi görecek, tedarikçiye yazacak, dosya gelecek, yüklenecek. Bu zincirdeki her halka en az birkaç saat gecikme üretir ve talebin yoğunlaştığı anlar tam da bu gecikmelerin en pahalı olduğu anlardır. Bu yazıda, o zinciri tamamen ortadan kaldıran webhook tabanlı stok mimarisini adım adım kuruyoruz.

Webhook ile sorgulama arasındaki fark ne anlama geliyor?

Klasik yöntemde senin sistemin tedarikçiye belirli aralıklarla "stok var mı?" diye sorar. Bu yönteme sorgulama denir ve iki sorunu vardır: sıklığı artırırsan tedarikçinin servisini yorarsın ve genellikle limite takılırsın, azaltırsan güncel veriden uzaklaşırsın. Her iki durumda da elindeki rakam gerçeğin biraz gerisindedir.

Webhook bu ilişkiyi tersine çevirir. Artık sen sormazsın, tedarikçi bir şey değiştiğinde sana haber verir. Yeni parti yüklendi, fiyat değişti, bir kod iptal edildi. Trafik yüz kat azalır, veri tazeliği yüz kat artar. Ancak bu kolaylığın bedeli vardır: gelen isteği doğrulamak, tekrarlananları ayıklamak ve sırayı korumak artık senin sorumluluğundadır.

Gelen webhook'u nasıl güvenli hale getirirsin?

Webhook uç noktan internete açık bir kapıdır. İmza doğrulaması yoksa herkes sana "stoğa 5000 kod eklendi" diyebilir. Bu yüzden her kurulumda üç katman zorunludur: paylaşılan gizli anahtarla üretilen imzanın doğrulanması, isteğin geldiği IP aralığının sınırlanması ve her isteğe ait tekil kimliğin kaydedilerek tekrarların reddedilmesi.

Üçüncü madde en çok atlanan ve en pahalıya patlayan olanıdır. Tedarikçi sistemleri yanıt alamadığında aynı bildirimi tekrar gönderir. Tekrar koruması yoksa aynı kod partisi iki hatta üç kez stoğa eklenir ve elinde olmayan malı satmaya başlarsın. Sağlam bir dijital ürün satış scripti bu koruma katmanını varsayılan olarak açık tutar.

Çift satış neden hâlâ oluyor?

Aynı kodun iki müşteriye gitmesi, dijital üründeki en ağır operasyonel hatadır. Teknik sebebi neredeyse her zaman aynıdır: kod seçimi ile kodun "satıldı" olarak işaretlenmesi arasında geçen mikro saniyelerde ikinci bir siparişin aynı kaydı okuması. Tek başına yüksek trafikte bile nadir görünür ama kampanya anlarında kaçınılmaz hale gelir.

Çözüm, kod seçimini kilitli bir işlemle yapmaktır. Kod okunurken satır düzeyinde kilitlenir, atama yapılır ve kilit ancak kayıt tamamlandığında bırakılır. Buna ek olarak her sipariş için üretilen tekil bir anahtar, aynı isteğin tekrar işlenmesini engeller. Bu iki mekanizma birlikte çalışmadığı sürece çift satış riski asla sıfırlanmaz. Konuyu daha derinlemesine ele alan bir e-pin satış yazılımı karşılaştırması yaparken ilk sorman gereken şey de budur.

Tedarikçi webhook göndermiyorsa ne yapacaksın?

Türkiye'deki tedarikçilerin bir kısmı hâlâ yalnızca sorgulanabilir servis sunuyor, bazıları ise dosya tabanlı çalışıyor. Bu durumda karma model kurmak gerekir: webhook destekleyen kaynaklar anlık, desteklemeyenler kısa aralıklı akıllı sorgulama ile beslenir. Akıllı sorgulamanın anlamı, sabit aralık yerine satış hızına göre değişen aralık kullanmaktır. Saatte iki satan ürün on beş dakikada bir kontrol edilir; saatte iki yüz satan ürün kırk saniyede bir.

Bu yaklaşım hem servis limitlerini korur hem de kritik ürünlerde neredeyse anlık tazelik sağlar. Ayrıca her kaynak için bir yedek tanımlaman gerekir; birincil tedarikçi yanıt vermediğinde sistem otomatik olarak ikincil kaynağa geçmeli ve maliyet farkını sipariş kaydına yazmalıdır.

Kurulumu canlıya almadan önce neleri test etmelisin?

Webhook mimarisinin en tehlikeli tarafı, hatalarının sessiz olmasıdır. Bir bildirim kaybolduğunda sistem çökmez, sadece stok yanlış kalır. Bu yüzden test aşamasında normal senaryoyu değil, bozuk senaryoları denemelisin: gecikmiş bildirim, sırası karışmış bildirim, tekrarlanan bildirim, yarım kalan istek.

Bu yapıyı kurmanın gerçek getirisi ne?

En görünür getiri kaçan siparişlerin geri kazanılmasıdır, ama asıl kazanç başka yerdedir: zihinsel yük. Stok takibini otomatikleştiren bir işletme sahibi, gecenin bir yarısı panele bakma alışkanlığından kurtulur. Enerjisini yeni ürün ailesi eklemeye, tedarikçi pazarlığına ve pazarlamaya ayırır. Operasyon kendini yönetmeye başladığında büyüme de tesadüf olmaktan çıkar.

Pinova bu akışı hazır olay tipleriyle ve kilit mekanizmasıyla birlikte sunar; yani webhook altyapısını sıfırdan yazmak zorunda kalmazsın. Hangi paketin hangi kaynak sayısını desteklediğini fiyat bölümünde, teknik ayrıntıları ise özellikler bölümünde bulabilirsin.

Stok otomasyonu, dışarıdan bakıldığında teknik bir ayrıntı gibi görünür ama müşterinin gözünde doğrudan güvenilirlik demektir. Aradığı kodu her seferinde bulabilen kullanıcı, fiyat farkına rağmen sana döner. Olay tiplerinin panelde nasıl göründüğünü ve stok ekranının nasıl çalıştığını görmek için canlı demo üzerinden kendi tedarikçi senaryonu kurgulayarak başlayabilirsin.