Bir e-pin sitesinde en can sıkıcı an, müşteri ödemeyi yapıp kodu beklerken ürünün aslında tedarikçide tükenmiş olduğunun anlaşılmasıdır. Panelde "stokta" yazan bir ürün gerçekte yoksa, ortada tek bir sorun var demektir: site ile tedarikçi arasındaki stok bilgisi senkron değil. Bu yazıda çift yönlü stok senkronizasyonunun ne anlama geldiğini, nasıl kurulduğunu ve e-pin işinde neden tek yönlü çözümlerin er ya da geç sorun çıkardığını anlatıyoruz.
Stok Senkronizasyonu Olmayan Bir E-Pin Sitesinde Gerçekte Ne Kaybedilir?
E-pin ve dijital ürün satışında stok, fiziksel bir depo gibi görünmez ama tıpkı fiziksel stok gibi anlık olarak değişir. Turkpin, Pinabi gibi tedarikçilerin envanteri saniyeler içinde tükenebilir, fiyat farkları oluşabilir, bazı ürünler geçici olarak satışa kapatılabilir. Site tarafında bu değişiklikleri takip eden bir mekanizma yoksa, iki yönde de zarar oluşur.
- Müşteri ödeme yapar, ürün tedarikçide yoktur; sipariş iptal/iade sürecine girer ve güven kaybı yaşanır.
- Tedarikçide stok varken site eski fiyatla satış yapmaya devam eder; kâr marjı erir veya zarara satış yapılır.
- Destek ekibi, "ödedim ama kod gelmedi" taleplerine elle cevap vermek zorunda kalır — bu da operasyonel yükü artırır.
- Google ve müşteri yorumlarında "stokta yazıyor ama satmıyor" şikâyetleri birikir, bu da SEO ve marka güvenine zarar verir.
Kısacası stok senkronizasyonu, e-pin sitesinde sadece teknik bir detay değil; doğrudan müşteri güveni ve kâr marjıyla bağlantılı bir konudur.
Tek Yönlü mü, Çift Yönlü mü? Fark Nerede Başlıyor?
Tek yönlü senkronizasyon, sitenin belirli aralıklarla tedarikçiye "stok var mı?" diye sorup cevabı panele yansıtmasıdır. Bu, temel bir çözüm gibi görünse de eksiktir; çünkü sadece tedarikçiden siteye doğru bilgi akar. Çift yönlü senkronizasyon ise iki tarafın da birbirini beslediği bir yapıdır:
- Tedarikçiden siteye: stok miktarı, fiyat, ürün durumu (aktif/pasif) anlık veya kısa aralıklarla çekilir.
- Siteden tedarikçiye: bir sipariş oluştuğunda rezervasyon/satın alma isteği anında tedarikçiye iletilir, tedarikçinin stoğu da bu işlemle güncellenir.
Bu ikinci yön özellikle kritik: eğer site sadece stok bilgisini okuyup kendi içinde "sattım" diye işaretliyor ama bu bilgiyi tedarikçiye geri bildirmiyorsa, aynı ürün başka bir kanaldan da satılabilir ve iki farklı müşteriye aynı kod gitme riski doğar. Çift yönlü akış, bu riski ortadan kaldırır çünkü satın alma anında tedarikçi sisteminde de rezervasyon/düşüm gerçekleşir.
Turkpin ve Pinabi API'leri Stokla Nasıl Konuşur?
Türkiye'deki e-pin tedarikçilerinin çoğu (Turkpin, Pinabi ve benzerleri) REST tabanlı API'ler sunar. Bu API'ler genellikle şu uç noktaları içerir: ürün listesi + güncel stok/fiyat, tekil ürün sorgusu, sipariş oluşturma (satın alma) ve sipariş durumu sorgulama. Bir e-pin scripti bu API'lerle çalışırken üç temel işlemi otomatikleştirmelidir:
- Katalog senkronu: tedarikçideki ürün listesi düzenli aralıklarla çekilir, yeni ürünler otomatik eklenir, kaldırılanlar pasife alınır.
- Fiyat/stok senkronu: her ürünün güncel stok adedi ve maliyet fiyatı belirli aralıklarla (örneğin 1-5 dakika) sorgulanır; site üzerindeki satış fiyatı, tanımlı kâr marjına göre otomatik hesaplanır.
- Sipariş iletimi: müşteri ödeme yaptığında, site arka planda tedarikçiye gerçek satın alma isteği gönderir ve dönen kodu/kredi bilgisini şifreli şekilde müşteriye teslim eder.
Pinova bu üç işlemi tek bir tedarikçi entegrasyon katmanında birleştirir; farklı tedarikçilerin API farklılıkları (kimlik doğrulama yöntemi, veri formatı, hata kodları) script içinde standart bir yapıya dönüştürülür. Böylece yeni bir tedarikçi eklemek, sıfırdan kod yazmak yerine mevcut entegrasyon şablonunu uyarlamak anlamına gelir.
Stok Tükenince veya Fiyat Değişince Site Bunu Nasıl Anlar?
Burada iki yaklaşım var: polling (site belirli aralıklarla tedarikçiye sorar) ve webhook (tedarikçi bir değişiklik olduğunda siteye bildirim gönderir). E-pin tedarikçilerinin büyük çoğunluğu webhook desteklemediği için pratikte polling ana yöntemdir, ancak polling'in doğru kurgulanması gerekir.
- Yüksek hacimli/popüler ürünler (Steam cüzdan kodu, Google Play, Valorant VP gibi) daha sık — örneğin 1-2 dakikada bir — sorgulanmalı.
- Düşük hacimli ürünler 10-15 dakikada bir sorgulanarak tedarikçi API'sine gereksiz yük bindirilmemeli.
- Sipariş anında ise polling beklenmeden, o ürün için "canlı" bir stok teyidi yapılmalı — yani müşteri ödeme ekranına geldiğinde sistem son bir kez tedarikçiye sorup emin olmalı.
- Stok sıfırlandığında ürün otomatik olarak "stokta yok" durumuna alınmalı ve sepete eklenmesi engellenmeli.
Bu katmanlı yaklaşım, hem API maliyetini/oran sınırlarını kontrol altında tutar hem de kritik anda (ödeme sırasında) yanlış bilgiyle satış yapılmasını önler.
Ödeme ekranına gelen her siparişte tedarikçiye "son teyit" sorgusu atmak, arka plandaki periyodik senkrona güvenmekten çok daha güvenlidir. Bu tek ekstra istek, iade/iptal maliyetinden çok daha ucuzdur ve müşteri güvenini korur.
Çoklu Tedarikçi ve Eşzamanlı Siparişlerde Çakışma Nasıl Önlenir?
Birçok e-pin sitesi tek bir ürünü birden fazla tedarikçiden temin edebilir — biri stok bittiğinde diğerine geçmek için. Bu durumda senkronizasyon biraz daha karmaşıklaşır çünkü sistem hem hangi tedarikçinin daha uygun fiyatlı/stoklu olduğuna karar vermeli hem de aynı anda gelen birden fazla siparişte çakışma yaşanmamalı.
- Öncelik sıralaması: her ürün için tedarikçiler fiyat/güvenilirlik sırasına göre tanımlanır; birinci tercih stok vermezse otomatik olarak ikinciye geçilir.
- Rezervasyon kilidi (lock): bir sipariş işleme alındığı anda, aynı ürün için ikinci bir sipariş aynı stok biriminden karşılanmaya çalışılmaz — sistem kısa süreli bir kilit koyar, işlem bitince kilidi kaldırır.
- Hata durumunda geri alma: tedarikçiden hata dönerse (stok yokmuş, API zaman aşımı gibi) sipariş otomatik olarak bekletilir veya alternatif tedarikçiye yönlendirilir, müşteriye net bir bilgi mesajı gösterilir.
Bu mekanizmalar kurulmadan çoklu tedarikçi kullanmak, aslında riski azaltmak yerine artırabilir; çünkü senkron olmayan iki kaynak arasında çelişkili stok bilgisi oluşur.
| Süreç | Manuel / Elle | Pinova ile |
|---|---|---|
| Tedarikçi stok kontrolü | Panele elle girip saatte bir bakma | API ile 1-5 dakikada bir otomatik sorgu |
| Ürün tükendiğinde | Sipariş geldikten sonra fark edilir, iade süreci başlar | Ürün anında "stokta yok" işaretlenir, sepete eklenemez |
| Fiyat değişikliği | Excel'den elle güncelleme, saatlerce gecikme | Tedarikçi fiyatı değişince kâr marjına göre otomatik güncellenir |
| Birden fazla tedarikçi | Ayrı ayrı takip, çakışma ve çifte satış riski | Tek panelde öncelik sıralı çoklu tedarikçi + otomatik yedekleme |
| Bayi paneline yansıma | Panel yenilenmeden bayi eski stok/fiyatı görür | Bayi paneli merkezi stokla aynı anda güncellenir |
Bayi Panelleri Stok Senkronizasyonuna Nasıl Dahil Edilir?
Çok seviyeli bayi sistemi olan e-pin sitelerinde senkronizasyon bir adım daha karmaşıklaşır: artık sadece "site-tedarikçi" arasında değil, "tedarikçi-site-bayi" üçgeninde tutarlılık gerekir. Bir bayi panelden ürün satarken, o an tedarikçide stok olup olmadığını, güncel maliyet fiyatına göre ne kadar komisyon kazanacağını doğru görmelidir.
- Merkezi stok tablosu tek kaynak (single source of truth) olmalı; hem site vitrini hem bayi paneli aynı tablodan okumalı, ayrı ayrı önbellek tutmamalı.
- Bayi bakiyesiyle yapılan satın alma işlemleri de aynı rezervasyon/kilit mekanizmasından geçmeli — böylece bir bayinin siparişi, sitedeki normal bir müşteri siparişiyle aynı anda çakışmaz.
- Fiyat değişikliklerinde bayi özel fiyat/komisyon oranları da otomatik yeniden hesaplanmalı, elle güncelleme gerektirmemeli.
Pinova'da bayi sistemi ile tedarikçi entegrasyonu aynı stok çekirdeğini paylaştığı için, bir üründe yaşanan stok/fiyat değişikliği hem vitrine hem bayi panellerine aynı anda yansır. Bu, ayrı ayrı senkron mekanizması kurmak zorunda kalmadan tutarlılığı garanti eder.
Bu Senkronizasyonu Sıfırdan mı Kuracaksınız?
Pinova ile tedarikçi API entegrasyonu, stok/fiyat senkronu, rezervasyon kilidi ve bayi paneli aynı çekirdek üzerinde hazır geliyor — kendi sunucunuza kurup elinizdeki tedarikçi hesaplarıyla kısa sürede canlıya alabilirsiniz.
Çift yönlü senkronizasyon tam olarak ne anlama gelir?
Tedarikçiden siteye stok/fiyat bilgisinin akması ve sipariş anında sitenin de bu bilgiyi tedarikçiye geri bildirip stoğu gerçekten düşürmesidir. Tek yönlü sistemlerde sadece okuma olur, bu da çifte satış riskini doğurur.
Turkpin/Pinabi API'si olmadan senkronizasyon yapılabilir mi?
Tedarikçi bir API sunmuyorsa gerçek zamanlı senkron mümkün olmaz; stok elle veya dosya aktarımıyla güncellenir ki bu da gecikme ve hata riskini artırır. API destekli tedarikçilerle çalışmak otomasyonun ön koşuludur.
Senkronizasyon gecikmesi ne kadar olmalı?
Yüksek hacimli ürünlerde 1-2 dakika, düşük hacimli ürünlerde 10-15 dakika makul bir aralıktır. Ödeme anında ise mutlaka anlık bir son teyit sorgusu yapılmalıdır.
Pinova stok senkronizasyonunu nasıl yönetiyor?
Pinova, tedarikçi API'lerini standart bir entegrasyon katmanında birleştirir; periyodik stok/fiyat senkronu, sipariş anında rezervasyon kilidi ve bayi paneline anlık yansıma aynı çekirdek üzerinden çalışır.