Nebim V3 Entegrasyonu: E-Ticaret ve Pazaryerinde Stok, Fiyat, Sipariş

Nebim V3 entegrasyonu hangi yoldan kurulur?

Nebim V3 entegrasyonu, üreticinin kendi entegrasyon ürünü olan Nebim V3 Entegratör üzerinden kurulur. Nebim'in resmî sitesine göre bu ürünün REST servisleri platform ve cihaz bağımsız, gerçek zamanlı entegrasyon sağlıyor; bunun yanında Nebim V3 ERP ile veritabanı üzerinden içe ve dışa aktarım yolu da sunuluyor. Nebim aynı sayfada B2C ve B2B e-ticaret ile entegrasyonu açıkça sayıyor.

Üreticinin sitesindeki bir beyan bu yolu özellikle değerli kılıyor: bu REST servisleriyle kurulan entegrasyonların, Nebim V3 sürüm değiştirdiğinde geriye dönük uyumlu kalmasının sağlanabileceği yazıyor. Bu bir ürün tanıtım cümlesi, sözleşmesel bir garanti değil; kapsamı yetkili Nebim iş ortağınızla teyit edilir. Yine de doğrudan tabloya yazan bir entegrasyonun bu beyanın dışında kalacağı açık; bu bizim çıkarımımız.

Belgeler kapalıysa önce keşif neden şart?

Keşif şarttır, çünkü Nebim'in herkese açık bir geliştirici dokümantasyonunu bulamadık ve uç nokta listesini önceden göremeden verilen her takvim tahmindir. Resmî bir entegrasyon ürünü ve uyumluluk beyanı var; ama hangi işlemin hangi servisle yapılabildiği, hangi alanların zorunlu olduğu ve kimlik doğrulamanın nasıl çalıştığı kurulumda ve yetkili iş ortağınız üzerinden netleşir.

Lisans tarafı da keşfin konusudur. Nebim V3 Lisans Kuralları belgesinde, hareket için gerekli olan Nebim V3 lisansının kontrol edildiği ve lisans yoksa hareket oluşturulmasına izin verilmediği birebir yazılı. Yani entegrasyonun sipariş ya da transfer hareketi oluşturabilmesi lisansa bağlıdır. Hangi işlem tipinin hangi lisansa bağlı olduğu belge tarafından listelenmediği için iş ortağınızla teyit edilir.

Keşfin çıktısı yazılı bir belgedir ve şu soruları cevaplar:

• Kurulumda Nebim'in entegrasyon ürünü var mı, hangi servisler açık?
• Sipariş, transfer ve iade hareketleri için gereken lisanslar mevcut mu?
• Ürün, renk ve beden kırılımı Nebim'de nasıl tanımlı, barkod her varyant için var mı?
• Hangi depo ve mağazaların stoğu online satışa açılacak?
• Site ve pazaryerleri hangi altyapıda, siparişleri hangi biçimde veriyor?

Bu belge bizimle devam etmeseniz de sizde kalır; başka bir geliştiriciyle çalışırsanız da işe yarar.

Varyant eşleştirme: beden ve renk kırılımı nasıl taşınır?

Varyant eşleştirmede kural, Nebim'deki her ürün-renk-beden kombinasyonunun site ve pazaryerinde tek ve değişmeyen bir anahtara karşılık gelmesidir. Perakende ve tekstilde bu anahtar çoğunlukla varyant barkodudur. Trendyol'un geliştirici belgesi de fiyat güncelleme sınırını barkod bazında tanımlıyor; yani pazaryeri tarafında ürünü tanıyan anahtar barkoddur.

Sorunlar genellikle anahtarda değil, anahtarın etrafındaki farklarda çıkar:

Eşleme tablosu kodun içine gömülmez; ürün sorumlusunun bir ekrandan düzenleyebileceği bir yerde tutulur. Yeni sezonda yüzlerce varyant eklendiğinde bu iş geliştirici beklememelidir. İlk yüklemede Nebim'deki tüm varyantlar bu tablodan geçirilir ve eşleşmeyenler bir listeye çıkarılır; o liste kapanmadan otomatik stok gönderimi açılmaz.

Satılabilir stok ve fiyat nasıl hesaplanır?

Siteye ve pazaryerine gönderilecek rakam fiziksel stok değil, satılabilir stoktur. Fiziksel stoktan açık siparişlerde ayrılan miktar, güvenlik payı ve satılamaz durumdaki ürünler düşülür. Hangi depo ve mağazaların stoğunun online satışa açılacağı ise işletmenin kararıdır.

Örnek senaryo: diyelim ki bir ürünün M bedeninden merkez depoda 12, iki mağazada 3 ve 2 adet var.

Rezervasyon: sipariş düştüğü an stok ayrılır

Sipariş site ya da pazaryerinden geldiği anda o miktar satılabilir stoktan düşülmelidir; sevkiyatı beklemek, aynı ürünün o arada başka kanalda satılmasına yol açar. Rezervasyonun Nebim tarafında mı yoksa entegrasyon katmanında mı tutulacağı, kurulumunuzdaki sipariş akışına ve Nebim'in sunduğu servislere göre keşifte belirlenir. İptal edilen siparişin rezervi aynı hızla geri bırakılır.

Güvenlik payı kanal bazında farklı olabilir. Pazaryerinde iptal, mağaza puanını etkilediği için pazaryerine biraz daha temkinli bir rakam göndermek mantıklıdır. Son birkaç adette ürünü yalnızca kendi sitenizde satmak da bir seçenektir.

Fiyat akışı: hangi fiyat hangi kanala?

Mağaza fiyatı, site fiyatı ve pazaryeri fiyatı çoğu zaman aynı değildir; pazaryeri komisyonu ve kampanyalar bu farkı doğurur. Entegrasyonda her kanalın Nebim'deki hangi fiyat listesinden besleneceği yazılı kurala bağlanır. Fiyatı entegrasyon katmanında hesaplamak yerine Nebim'de kanal bazlı fiyat listesi tutmak, fiyatın tek bir yerden yönetilmesini sağlar.

Pazaryeri tarafının da sınırları var. Trendyol'un geliştirici belgesine göre aynı barkod için dakikada 30'dan fazla fiyat güncelleme isteği hata döndürür ve sonuç toplu işlem sonucu servisinde raporlanır; 14 Eylül 2026 itibarıyla stok ve fiyat yazma istekleri için satıcı kademesine göre dakikalık sınırlar da tanımlı. Bu yüzden fiyat değişiklikleri biriktirilip partiler hâlinde gönderilir ve her partinin sonucu ayrıca kontrol edilir.

Sipariş Nebim'e nasıl geri döner?

Site ve pazaryeri siparişi, Nebim'in REST servisleri üzerinden Nebim'e sipariş olarak yazılır ve pazaryerinin paket ya da sipariş numarası Nebim'deki kayıtta izlenebilir biçimde taşınır. Her gönderimden önce bu numarayla kontrol yapılır; zaman aşımı yaşanan bir gönderim doğrudan tekrarlanmaz, önce Nebim'de var olup olmadığı sorgulanır. Böylece ağ kesintisi aynı siparişi iki kez oluşturmaz.

Siparişle birlikte üç akış daha tasarlanır:

• İptal: Pazaryerinde iptal edilen sipariş Nebim'de de kapatılır ve rezervi bırakılır.
• İade: İade gelen ürün önce kontrol bekleyen bir duruma alınır; satılabilir stoğa ancak kontrol sonrası döner.
• Hata kuyruğu: Eşleşmeyen barkod, lisans nedeniyle reddedilen hareket ya da eksik müşteri bilgisi sessizce kaybolmaz; sebebiyle birlikte sorumlunun önüne düşer.

Faturalama tarafında Nebim'in resmî sitesi e-Fatura, e-Arşiv ve e-İrsaliye için mevcut entegrasyonlarını listeliyor. Pazaryeri siparişinin faturasının nerede ve hangi belge tipiyle kesileceği, komisyon faturasının nasıl kaydedileceği gibi konular mali müşavirinizle belirlenir; entegrasyon bu kararı uygular.

Hazır bağlantı mı, özel Nebim entegrasyonu mu?

Akışınız standartsa hazır bir bağlantı çoğu zaman daha hızlı ve daha ucuz bir başlangıçtır. Bazı e-ticaret altyapıları ve pazaryeri entegrasyon firmaları Nebim V3 için hazır bağlantı sunduğunu duyuruyor; tek depodan satış yapan, varyant yapısı sade ve kanal sayısı az bir marka için bu yeterli olabilir.

Özel geliştirme şu durumlarda anlam kazanır:

• Mağaza stoğunun bir kısmı online satışa açılacak ve mağazadan gönderim yapılacaksa
• Kanal bazında farklı güvenlik payı ve fiyat listesi kuralları varsa
• Hazır bağlantının desteklemediği bir pazaryeri ya da B2B bayi kanalı varsa
• Rezervasyon, iade kontrolü ve hata kuyruğu üzerinde tam görünürlük isteniyorsa

İki durumda da sorulacak üç soru aynıdır: kayıt Nebim'e hangi yoldan yazılıyor, Nebim güncellendiğinde bağlantının bakımını kim üstleniyor, ürün ve sipariş verisi nerede tutuluyor. Üreticinin resmî entegrasyon yolunun dışında doğrudan tabloya yazan bir bağlantı, üreticinin uyumluluk beyanının kapsamı dışında kalır.

Sıkça Sorulan Sorular

Nebim V3'ün e-ticaret entegrasyonu için API'si var mı?

Evet. Nebim V3 Entegratör, üreticinin kendi entegrasyon ürünüdür ve REST servisleri sunar; Nebim bunu platform ve cihaz bağımsız, gerçek zamanlı entegrasyon olarak tanımlıyor ve B2C ile B2B e-ticareti entegrasyon alanları arasında sayıyor. Uç nokta listesi ve teknik ayrıntılar için kamuya açık bir kaynak bulamadık; bunlar kurulumda resmî kaynağından alınır.

Nebim pazaryeri entegrasyonunda stok neden tutmaz?

En sık sebep, kanallara fiziksel stoğun gönderilmesidir. Açık siparişlerde ayrılan miktar düşülmezse aynı ürün iki kanalda birden satılır. İkinci sebep, beden ve renk eşlemesindeki hatalardır; tek barkodun iki varyanta verilmesi ya da barkodsuz varyantlar stoğu yanlış ürüne yazar.

Mağaza stoğunu internetten satışa açmalı mıyız?

Bu bir operasyon kararıdır. Mağazadan gönderim, toplama ve paketleme yapılabiliyorsa mağaza stoğunu açmak satılabilir stoğu artırır. Mağazada aynı ürünün o gün satılma ihtimali yüksekse daha yüksek bir güvenlik payıyla açmak ya da yalnızca belirli mağazaları açmak daha güvenlidir.

Entegrasyon için ek Nebim lisansı gerekir mi?

Nebim V3 Lisans Kuralları belgesine göre hareket için gereken lisans kontrol edilir ve lisans yoksa hareket oluşturulmaz. Sipariş, transfer ya da iade hareketi için hangi lisansın gerektiği belgede listelenmediği için keşifte yetkili Nebim iş ortağınızla teyit edilir. Bu teyit yapılmadan takvim ve fiyat vermiyoruz.

Nebim güncellendiğinde entegrasyon bozulur mu?

Nebim'in sitesindeki beyana göre resmî REST servisleriyle kurulan entegrasyonların sürüm değişiminde geriye dönük uyumlu kalması sağlanabiliyor; bu bir ürün beyanıdır, sözleşmesel garanti değildir. Resmî yoldan kurulan entegrasyonun kendiliğinden kırılma ihtimali daha düşüktür. Yine de her güncellemeden sonra birkaç örnek siparişle kısa bir doğrulama turu yapılmalıdır.

Nebim V3 ile kanallarınızı tek stokta buluşturmak için

Nebim V3'ü değiştirmeden sitenizi ve pazaryerlerinizi aynı satılabilir stoğa bağlamak istiyorsanız işe kurulumunuzu, kanallarınızı ve varyant yapınızı netleştiren keşifle başlıyoruz. Nebim'in iş ortağı ya da bayisi değiliz; lisans, kurulum ve uyarlama yetkili iş ortağınızda kalır, biz üreticinin resmî servisleri üzerinden çalışan entegrasyonu yazarız. Hazır bir bağlantı yetiyorsa bunu açıkça söyleriz. Fiyat keşif sonrası sabit verilir ve sözleşmede yazılır; teslim sonrası 15 gün içinde çıkan hataları ücretsiz düzeltiriz. Ücretsiz online keşif görüşmesi için iletişime geçin; isterseniz WhatsApp'tan da yazabilirsiniz.