Tedarikçi API Entegrasyonu ile E-Pin Stok Otomasyonu: Manuel Kod Girişini Bırak, Stoklar Kendi Kendine Dolsun

Bir e-pin bayisi olarak günün kaç saatini "stok güncelleme" ekranına bakarak geçiriyorsun? Tedarikçiden gelen Excel'i açıp, kodları tek tek panele yapıştırıp, hangi ürünün bittiğini gözünle kontrol ederek satış yapıyorsan, aslında bir mağaza değil, tam zamanlı bir veri giriş bürosu işletiyorsun demektir. Ve bu büronun en acı tarafı şu: sen uyurken müşteri sipariş veriyor, kod stokta yok, para hesabına giriyor ama teslimat yapılamıyor. Sabah uyandığında seni bekleyen şey satış değil, iade talebi ve bir yıldızlık yorum oluyor.

İşte bu noktada çoğu bayinin duyduğu ama tam olarak nasıl işlediğini bilmediği bir kavram devreye giriyor: tedarikçi API entegrasyonu. Kulağa "yazılımcı işi" gibi gelen bu üç kelime, gerçekte senin gece 03.00'te bile otomatik teslimat yapan, stoğu kendi kendine güncelleyen ve tükenen ürünü otomatik pasife alan bir sistem demek. Bu yazıda API entegrasyonunun perde arkasını, neyi otomatikleştirdiğini ve manuel çalışan bir bayinin bu geçişi yaparken nelere dikkat etmesi gerektiğini teknik ama anlaşılır bir dille açacağız.

Tedarikçi API'si aslında ne yapıyor?

API'yi iki yazılımın birbiriyle konuştuğu ortak bir dil olarak düşün. Tedarikçinin sisteminde binlerce e-pin kodu, fiyat ve stok bilgisi var. Sen bu bilgiyi görmek için ya panele girip bakarsın ya da bir dosya indirirsin. API entegrasyonunda ise senin satış yazılımın, belirlediğin aralıklarla doğrudan tedarikçinin sunucusuna sorar: "Steam 20 TL kodu var mı, kaç adet, fiyatı ne?" Tedarikçi anında cevap verir, yazılım da bu cevabı senin vitrinine yansıtır. Arada insan yok, Excel yok, kopyala-yapıştır yok.

Bu konuşma iki yönlüdür. Müşteri senden bir kod aldığında, yazılım tedarikçiye "bu üründen bir adet ver" diye bir istek gönderir; tedarikçi kodu döner, müşteriye saniyeler içinde teslim edilir ve stok otomatik bir azalır. Buna gerçek zamanlı teslimat denir ve bir e-pin işinin gece de para kazanmasının tek yoludur. Manuel bir bayide bu döngünün her adımı senin elinle döner; API'de ise hepsi milisaniyeler içinde, sen fark bile etmeden tamamlanır. İşin güzel tarafı, bu akış hem tek bir siparişte hem de aynı anda gelen yüzlerce siparişte tıkanmadan çalışır; yazılım sırayı otomatik yönetir, aynı kodun iki kişiye gitmesini teknik olarak imkânsız hale getirir.

Stok senkronizasyonu neden manuel takiple kıyaslanamaz?

Manuel çalışan bir bayide stok bilgisi her zaman geçmiştedir. Sabah 09.00'da güncellediğin stok, öğlen 13.00'te çoktan yanlıştır çünkü hem sen satmışsındır hem tedarikçinin havuzu değişmiştir. API senkronizasyonu bu boşluğu kapatır: yazılım belirlenen periyotta (örneğin her 60 saniyede) tedarikçiyi tarar ve senin vitrinindeki adedi tedarikçinin gerçek stoğuna eşitler. Tedarikçide biten ürün, senin sitende de otomatik "tükendi" olur. Böylece "sattım ama kod yokmuş" krizi kökten biter. Aynı mekanizma fiyat için de çalışır: tedarikçi maliyeti değişince yazılım senin satış fiyatını belirlediğin kâr marjına göre otomatik güncelleyebilir, böylece bir gece içinde artan alış fiyatı yüzünden zararına satış yapmazsın. Manuel takipte bu iki riski (yanlış stok ve eski fiyat) aynı anda yönetmek neredeyse imkânsızken, senkron bunu senin yerine sessizce halleder.

Webhook mu, çekme (polling) mi? İkisi arasındaki fark ne?

Entegrasyonun iki temel mantığı vardır. Polling, senin yazılımının belli aralıklarla tedarikçiye "yeni bir şey var mı?" diye sürekli sorması demektir; basit ve güvenilirdir ama sorgu aralığı kadar gecikme olur. Webhook ise tersidir: tedarikçide bir değişiklik olduğu anda tedarikçi senin sistemine haber uçurur, yani bilgi seni bulur. Webhook daha anlıktır ama tedarikçinin bu özelliği desteklemesi gerekir. İyi bir satış yazılımı her iki yöntemi de kaldırabilmeli ki tedarikçin hangisini sunuyorsa ona uyum sağlayasın.

Farklı entegrasyon yöntemleri pratikte nasıl ayrışıyor?

Her tedarikçi aynı teknolojiyi sunmaz. Bazısı modern bir REST API verir, bazısı hâlâ CSV dosyası, bazısı da eski usul XML besleme kullanır. Doğru satış yazılımı bu yöntemlerin hepsini tek panelde toplayabilmeli. Aşağıdaki tablo, sık karşılaşılan entegrasyon tiplerini pratik açıdan kıyaslıyor.

Bir tedarikçi entegrasyonunu bağlamadan önce neleri kontrol etmelisin?

Entegrasyon işini "bağla gitsin" diye görmek en büyük hatadır. Yanlış eşlenen bir fiyat kolonu ya da kontrol edilmemiş bir zaman aşımı ayarı, seni zararına satışa sürükleyebilir. Kuruluma başlamadan önce aşağıdaki maddeleri tek tek geçmen, ileride yaşanacak onlarca sorunu baştan yok eder.

Entegrasyon çöktüğünde işin durmasın diye ne yapmalı?

API'ler mükemmel değildir; tedarikçinin sunucusu bakıma girer, bağlantı zaman aşımına uğrar, anahtar süresi dolar. Profesyonel bir kurulumun manuel çalışmadan tek farkı budur: hata anında ne olacağını önceden planlamak. İyi bir sistem, entegrasyon kopunca ilgili ürünü otomatik pasife alır, sana bildirim gönderir ve mümkünse tanımladığın yedek tedarikçiye geçer. Böylece bir sağlayıcının sorunu, senin bütün mağazanı yere sermez. Bir başka önemli detay da idempotency, yani aynı isteğin yanlışlıkla iki kez gönderilse bile tek bir sonuç üretmesidir; bu sayede bağlantı titrediğinde müşteriye çift kod gitmez ya da hesabından iki kez düşülmez. Bu tür güvenlik ağları, "çalışıyorsa dokunma" mantığıyla kurulan amatör entegrasyonlarda bulunmaz ve genellikle en yoğun satış gününde, en kötü anda kendini belli eder. Profesyonel bir yazılım bu senaryoları daha ilk günden hesaba katarak kurulur.

Manuel bayilikten otomatik bayiliğe geçiş neyi değiştirir?

Bu geçiş sadece bir kolaylık değil, iş modelinin değişmesidir. Manuel bayi, satış hacmini kendi el hızıyla sınırlar; günde ne kadar kod yapıştırabiliyorsa o kadar satar. API ile çalışan bayinin ise satış tavanı yoktur çünkü ikinci satış da bininci satış da yazılım tarafından aynı saniyede işlenir. Sen artık kod girmez, işin stratejisiyle, reklamıyla ve müşteri memnuniyetiyle ilgilenirsin. Pinova bu geçişi tek panelde toplayarak, farklı tedarikçilerini aynı yerden yönetmeni ve stoğunu tümüyle otomatiğe almanı sağlar.

Manuel stok takibi, e-pin işinin görünmeyen tavanıdır; onu kaldırmadan büyümek mümkün değildir. Tedarikçi API entegrasyonu bu tavanı kırar ve seni operasyoncu olmaktan çıkarıp işletmeci yapar. Sistemin nasıl çalıştığını kendi gözünle görmek istersen canlı demo üzerinden dene, sunduğumuz özellikleri ve fiyat seçeneklerini incele, hazır olduğunda panelden başla.