Toptancı Online Stok Listesi Nasıl Paylaşılır? Excel, WhatsApp, Bayi Paneli, XML/JSON Feed ve API Karşılaştırması

Stok bilgisini kurulumcuya sunmanın beş temel yolu

Toptancının elindeki stok bilgisini kurulumcuya taşımanın beş yaygın yolu vardır: günlük Excel/PDF listesi, WhatsApp ile liste veya fotoğraf, bayi paneli, XML/JSON feed ve API. Bu yöntemler birbirinin alternatifi olduğu kadar aşamasıdır; çoğu toptancı Excel ve WhatsApp ile başlar, sipariş hacmi büyüdükçe panele ve otomatik beslemeye geçer.

Hangi yöntemin seçileceğini belirleyen üç ölçüt vardır: stok bilgisinin ne kadar güncel olduğu, hata ihtimali ve toptancının yönetim emeği. Kurulumcu açısından ise soru basittir: bu rakama güvenip müşterisine teslim tarihi söyleyebilir miyim?

Güncellik burada ölçülebilir bir kavramdır. Bir stok bilgisinin yaşı, son dışa aktarma ile kurulumcunun o bilgiye baktığı an arasındaki farktır. Sabah 09:00'da hazırlanan bir Excel öğleden sonra 15:00'te açıldığında altı saatlik bayat veridir; bu sürede kaç satış olduğu ise listede görünmez.

Yöntemlerin güncellik, hata ve yönetim maliyeti karşılaştırması

Her yöntemin güçlü ve zayıf yanı farklı yerdedir; aşağıdaki liste her birini güncellik, hata ve yönetim emeği açısından özetler.

• Günlük Excel/PDF: Güncellik günde bir (çoğu zaman) olur. Dosya kopyalanıp iletildiği için eski sürüm dolaşımda kalır; PDF'te ise veri aranamaz, kurulumcu satırı elle yeniden yazar. Yönetim emeği düşük ama her gün tekrarlanan, unutulunca sessizce bozulan bir iştir.
• WhatsApp listesi veya fotoğraf: Güncellik listeyi atan kişinin sıklığına bağlıdır; eski mesaj sohbetin içinde kalır ve hangi listenin geçerli olduğu belirsizleşir. Hata kaynağı elle yazma ve yanlış sürümdür. Anlık sorular için pratiktir, kayıtlı ve aranabilir bir stok kaynağı değildir.
• Bayi paneli (web): Stok doğrudan toptancının sisteminden okunursa güncellik dakika düzeyine iner; elle girilen panelde ise güncelleyen kişinin disiplinine bağlıdır. Kurulumcu aynı yerden arayıp filtreleyebilir. Yönetim emeği orta düzeydedir: kullanıcı yetkisi, yedekleme ve destek gerektirir.
• XML/JSON feed: Toptancı belirli bir adreste stok dosyasını yayımlar, alıcı sistem düzenli aralıklarla çeker. Güncellik çekme aralığı kadardır (örneğin 5–30 dakika). Biçim sabit olduğu için elle yazma hatası kalkar; buna karşılık alan eşleştirmesi bozulursa tüm liste yanlış okunabilir.
• API: Alıcı, tek ürün veya ürün grubu için anlık sorgu yapar; değişiklikler istenirse bildirimle (webhook) iletilir. En güncel ve en az elle müdahaleli yöntemdir. Kimlik doğrulama, istek sınırı, sürüm yönetimi ve hata izleme gerektirdiği için kurulum ve bakım emeği en yüksek olandır.

Stok rakamı tek sayı değildir: gerçek, rezerve, yolda ve sipariş üzerine

Kurulumcuya gösterilecek doğru rakam, depodaki fiziksel adet değil satılabilir adettir. Depoda 20 ürün görünse bile 8'i başka müşteriye ayrılmışsa gerçekte satışa açık olan 12'dir; kalan 8'i stok olarak göstermek aynı ürünün iki kişiye verilmesine yol açar.

Bu yüzden stok verisi en az dört durumda tutulmalıdır. Aşağıdaki tanımlar, ürün sayfalarında kullanılan stok durumu mantığıyla (ör. Google Merchant Center'daki in_stock, out_of_stock, preorder ve backorder değerleri: sipariş alınan/alınamayan, çıkmamış ürün için ön sipariş, geri gelecek ürün için ileri tarihli sipariş) uyumludur.

• Gerçek (fiziksel) stok: Rafta sayılabilen, hasarlı veya karantinada olmayan adet.
• Rezerve stok: Onaylanmış sipariş, teklif tutma veya proje kaydı nedeniyle başkasına ayrılmış adet. Süresi dolan rezervasyon otomatik düşmelidir.
• Yoldaki stok: İthalat ya da tedarikçi sevkiyatı çıkmış, depoya henüz girmemiş adet. Tahmini varış tarihiyle birlikte gösterilmeli, stok gibi sayılmamalıdır.
• Sipariş üzerine: Depoda tutulmayan, talep gelince tedarikçiden istenen ürün. Teslim süresi aralığı yazılmalıdır.
• Satılabilir stok formülü: satılabilir = fiziksel stok − rezerve − hasarlı/karantina. Yoldaki adet bu formüle girmez; ayrı sütunda tarihle gösterilir.

XML, JSON ve API ile paylaşımda veri formatı ve hafif güncelleme

XML ve JSON, stok verisini makine tarafından okunabilir biçimde taşıyan iki metin biçimidir. XML 1.0 (W3C, Beşinci Baskı, 26 Kasım 2008) tek bir kök öğe ve düzgün iç içe geçmiş etiketler ister; bu kuralları sağlayan belge “well-formed” sayılır ve varsayılan karakter kodlaması UTF-8'dir. JSON ise RFC 8259'da tanımlıdır; dize, sayı, mantıksal değer, null, nesne ve dizi türlerinden oluşur ve kapalı bir ekosistem dışında sistemler arası değişimde UTF-8 ile kodlanması zorunludur. Türkçe karakterli ürün adlarının bozulmaması için iki biçimde de UTF-8 kullanılmalıdır.

Binlerce ürünlük dosyayı her seferinde baştan indirmek yerine yalnızca son çekimden bu yana değişen satırları veren bir fark (delta) listesidir; bunun yanında günde bir kez tam liste de yayımlanmalı ki kaçan değişiklikler düzeltilsin.

HTTP üzerinden yayımlanan dosyada ETag veya Last-Modified doğrulayıcıları kullanılırsa alıcı koşullu istek (If-None-Match / If-Modified-Since) gönderebilir. İçerik değişmemişse sunucu RFC 9110'daki 304 Not Modified yanıtını gövdesiz döner ve alıcı elindeki kopyayı kullanır. Bu, sık çekimi ucuzlatır ve güncelliği artırır.

API tarafında tek ürün sorgusu (sepette canlı kontrol) ile toplu sorgu (katalog senkronu) ayrılmalıdır. Çekim boş, hatalı ya da zaman aşımlı dönerse alıcı sistem eski değeri “var” diye göstermeye devam etmemeli, veriyi bayat işaretlemelidir.

Feed'in kalitesi biçimden çok alan tasarımına bağlıdır. Her ürün satırında aşağıdaki alanların bulunması, alıcı tarafında eşleştirme hatasını azaltır.

• Benzersiz ürün anahtarı: Üretici model kodu ve varsa barkod/GTIN. Yalnızca ürün adıyla eşleştirme, “DS-2CD2143G2-I” gibi yakın kodlarda hata üretir; model kodu standardı için katalog verisi düzenleme rehberine bakılabilir.
• Miktar alanları ayrı: fiziksel, rezerve, satılabilir ve yoldaki adet ayrı alanlarda gelmeli; tek bir “stok” alanı hangi anlama geldiği belirsiz olduğu için riskli bir kısayoldur.
• Durum kodu: stokta, sınırlı, yolda, sipariş üzerine, tükendi gibi sayıdan bağımsız bir kod. Sayı gizlenecekse bile durum doğru iletilir.
• Güncellenme zamanı: Her ürün veya dosya için ISO 8601 biçiminde zaman damgası (örn. 2026-10-26T09:30:00+03:00). Alıcı, bayat veriyi bu alandan ayırt eder.
• Birim ve ondalık kuralı: adet, metre (kablo makarası) ya da koli birimi açıkça belirtilmeli; ondalık ayracı nokta olarak sabitlenmelidir.
• Depo/şube kodu: Birden çok depo varsa miktar depo bazında verilmeli.

Kritik stok eşiği nasıl gösterilir?

Kurulumcuya tam adet göstermek zorunlu değildir; eşik bazlı gösterim hem rekabet bilgisini korur hem de kararı kolaylaştırır. Örneğin “10+ adet”, “Az kaldı (1–3)”, “Tükendi” gibi kademeler, ikili “var/yok”tan daha bilgilidir.

Eşiğin dayanağı yeniden sipariş noktasıdır. Standart envanter formülü şöyledir: yeniden sipariş noktası = günlük ortalama satış × tedarik süresi (gün) + emniyet stoku. Örneğin günde ortalama 2 adet satan ve tedariği 10 gün süren üründe, emniyet stoku 6 adet ise nokta 2 × 10 + 6 = 26 adettir; stok bu rakamın altına inince “az kaldı” durumu devreye girer ve satın alma tetiklenir.

Gösterimde iki kural işe yarar: teslim güvencesi olmayan adedi göstermemek (rezerve adet hesaba katılmaz) ve proje alımlarında gerçek adedi sormak. Toplu alımda “10+” yazısı 40 adetlik bir iş için yeterli bilgi değildir; bunun için stok teyidi ve teslim süresi sorma yöntemi ayrıca izlenir.

Eşik kademelerini ürün grubuna göre ayırmak gerekir: günde onlarca satan bir adaptör ile ayda iki adet satan bir NVR aynı eşikle gösterilmemelidir. Devir hızı hesabı için stok devir hızı rehberine bakılabilir.

Çok kanallı satışta stok çakışması: aynı ürün iki kişiye satıldı

Stok çakışması, aynı fiziksel adedin iki farklı kanalda aynı anda satılmasıdır. Telefon, WhatsApp, kendi paneli, pazar yeri ve perakende kanalı aynı stoktan beslendiğinde, her kanal kendi kopyasına baktığı sürece çakışma kaçınılmazdır.

Önlemin temeli tek stok kaynağıdır: tüm kanallar aynı kayıttan okur ve aynı kayıttan düşer. Düşüm işleminin ise “önce oku, sonra yaz” yerine tek adımda yapılması gerekir. Veritabanı mantığıyla: “stok = stok − n, koşul: stok ≥ n” biçiminde tek komut, iki eşzamanlı siparişin ikisinin de son adedi almasını engeller; koşul sağlanmazsa ikinci sipariş reddedilir ya da bekleme listesine alınır.

• Süreli rezervasyon: Sepete ya da teklife alınan adedi 15–60 dakika gibi sınırlı bir süre tutmak, ödeme veya onay gelmezse serbest bırakmak.
• Kanal payı: Çok kritik ürünlerde her kanala sabit bir pay ayırmak yerine ortak havuz ve ortak rezerve tercih edilir; sabit pay, boşta kalan stoğa yol açar.
• Satış sonrası geri bildirim: İptal, iade ve hasar durumunda adedin stok kaynağına geri yazılması.
• Telefon ve WhatsApp siparişi: Bu kanallardaki siparişin de aynı gün içinde sisteme girilmesi; düzen için WhatsApp ve telefon siparişi rehberine bakılabilir.
• Çakışmada açık iletişim: Satılamayan siparişi sessizce geciktirmek yerine kurulumcuya hemen bildirmek ve alternatif ürün/teslim tarihi önermek.

Güncelleme sıklığı ve yanlış stok gösteriminin güven maliyeti

Yanlış stok gösterimi, kurulumcu için doğrudan iş kaybıdır: müşterisine “yarın montaj” demiş ve ürünü bulamayan kurulumcu, bir daha o listeye bakmaz. Bu güven kaybı tek bir yanlışın bile ardından görülür ve düzelmesi uzun sürer; kurulumcu stoklu olmayan ürünü stokta göstermeyi yanlış fiyat gibi ciddiye alır.

Güncelleme sıklığı, ürünün hareket hızına göre seçilmelidir. Hızlı dönen ürünler (kablo, konnektör, adaptör, hard disk, popüler kamera modelleri) için dakika–saat düzeyi gerekir; yavaş dönen ürünlerde günlük güncelleme yeterli olabilir. Pratik bir sınır: bayatlık süresi, o ürünün tipik satış aralığından uzun olmamalıdır.

Hatayı azaltan alışkanlıklar şunlardır: her listede veya ürün satırında “son güncelleme” zamanını göstermek, güncelleme başarısız olursa listeyi bayat olarak işaretlemek, sayım farkı çıkan ürünü hemen düzeltmek ve stok doğruluğunu düzenli sayımla (döngüsel sayım) ölçmek. Doğruluk oranı = sistemdeki adet ile sayılan adedin eşleştiği ürün sayısı ÷ sayılan ürün sayısı olarak izlenebilir.

Bu konunun fiyat tarafı için de aynı ilke geçerlidir; fiyat ve yeni ürün duyurularında kanal ve zaman seçimi fiyat listesi güncelleme rehberinde ele alınır.

Hangi yöntem hangi toptancıya uyar? Adım adım geçiş

Küçük toptancı için doğru yöntem çoğu zaman en basit olandır; amaç hemen teknik entegrasyon kurmak değil, güncelliği ve doğruluğu adım adım artırmaktır. Aşağıdaki sıra, birçok toptancının izlediği yoldur.

• 1. Adım, tek liste: Önce stok, fiyat ve ürün kodunu tek bir tabloda toplayın; Excel’de tek sürüm ve tarih damgası kullanın.
• 2. Adım, ayrıştırma: Fiziksel, rezerve, yoldaki ve sipariş üzerine alanlarını ayırın; satılabilir stoğu formülle hesaplayın.
• 3. Adım, ön yazılımdan çıkış: Stok ön muhasebe veya ERP programında tutuluyorsa listeyi oradan dışa aktarın; ön muhasebe ve ERP seçimi bu noktada belirleyicidir.
• 4. Adım, panel veya otomatik dışa aktarma: Bayiler için aranabilir bir görünüm kurun ya da XML/JSON dosyasını zamanlanmış üretin.
• 5. Adım, API: Sipariş hacmi ve alıcı sayısı artınca anlık sorgu ve rezervasyonlu API’ye geçin; geçiş sırasında eski kanalı kısa bir süre paralel tutun.
• 6. Adım, izleme: Son güncelleme zamanı, hata sayısı ve stok doğruluğu için haftalık kontrol yapın.

Bayifi gibi platformlarda stok listeleme mantığı ve bu rehberle ilişkisi

Toptancı ve kurulumcuyu aynı yerde buluşturan platformların çoğu, stoğu ürün bazında ve toptancı tarafından işaretlenen bir “stokta var” bilgisiyle listeler; talep gönderilirken de yalnızca o ürünü stokta gösteren toptancılara iletilir. Bu yapı, stok bilgisinin güncel tutulmasını doğrudan satış fırsatına bağlar. Yöntem seçimi (elle giriş, toplu yükleme ya da otomatik besleme) platformdan platforma değişir; ölçüt yukarıdaki dört başlıktır: güncellik, hata, emek ve çakışma güvenliği.

Bayifi'de toptancı olarak ürün ve stok listelemek için /pazar bölümüne bakabilir, firmanızı kaydol sayfasından ekleyebilirsiniz; bölgenizdeki kurulumcuları ise bayiler dizininde il il bulabilirsiniz. Toptancıya yeni katılan kurulumcunun ilk sipariş sürecini bayi kaydı ve karşılama rehberi anlatır.