Nebim V3 Entegratör REST API: perakende ERP'nizi dış sistemlere nasıl bağlarsınız?

Nebim V3 ve Entegratör: perakendenin ERP’si dışarıya nasıl açılıyor?

Nebim V3, hazır giyim, ayakkabı, mobilya, halı, optik ve zücaciye gibi perakende sektörlerinin ERP’si. Mağaza, depo, toptan ve e-ticaret aynı ürün ağacında — model, renk ve beden matrisinde — buluşur. Dışarıdan bağlanmanın resmi yolu Nebim V3 Entegratör: Nebim’in kendi ifadesiyle, Entegratör’ün sunduğu REST API servisleri sayesinde platform ve cihazdan bağımsız, gerçek zamanlı entegrasyon çözümleri geliştirilebilir ve entegrasyonlar V3’ün sürüm değişimlerinde geriye dönük uyumlu kalabilir. İkinci yol, Nebim V3 ve veri ambarıyla veritabanı içe/dışa aktarım işlemleri.

Bu yazıdaki Nebim’e ait ifadeler nebim.com.tr’deki “Harici Sistemlerle Entegrasyon” sayfasından 2 Eylül 2026’da doğrulandı. Uç nokta adları, alan setleri ve kimlik doğrulama ayrıntıları kamuya açık değil; kurulumunuzun Entegratör dokümanı esastır. Aşağıdaki örnekler, bizim kurduğumuz ara katmanın dış uygulamalara sunduğu sözleşmedir.

Nebim’in hazır listelediği bağlantılar

Özel entegrasyona karar vermeden önce Nebim’in zaten çözdüğü alanları bilmek gerekir; aynı işi ikinci kez yazmak para ve zaman kaybıdır.

Alan	Nebim'in listelediği bağlantılar
E-fatura, e-arşiv, e-irsaliye	Doğan e-Dönüşüm, Sabancı (Edoksis), QNB eFinans
Açık bankacılık	Finrota, Kayaport
Ödeme kaydedici cihazlar	Hugin, Ingenico, Verifone
Müşteri sadakati	Hopi, Paro, Chippin, Zubizu
Kargo	Aras, MNG, Sürat, UPS, Yurtiçi ve diğer kargo firmaları
Tax Free	Global Blue, Planet Payment ve diğerleri
E-ticaret, iş akışı, analitik	E-ticaret altyapıları, eBA, IBM SPSS, toplu SMS ve e-posta

Bu listede olan bir işi Nebim’in kendi bağlantısıyla çözersiniz. Özel entegrasyon şu durumlarda başlar: listede olmayan bir uygulama, listedeki bağlantının kapsamadığı bir iş kuralı, ya da birden çok sistemi tek akışta birleştirme ihtiyacı.

Üç yol: REST API, içe/dışa aktarım, doğrudan okuma

Perakendeye özgü zorluk: renk-beden matrisi

Nebim’de ürün tek satır değildir; model, renk ve beden birleşimi her biri ayrı stok tutan varyantlar üretir. Dış sistemler — pazaryeri, B2B portal, saha satış — çoğunlukla düz SKU ister. Entegrasyonun görünmeyen işi bu eşlemedir:

• Barkod tek anahtar. Varyant eşlemesi ad veya kodla değil barkodla yapılır; barkodu olmayan varyant senkrona girmez, eksik listesine düşer.
• Fiyat listesi ve kampanya. Perakende fiyatı, toptan fiyatı ve mağaza kampanyası ayrı kaynaklardır; portal fiyatı Nebim’den okur, kendi hesaplamaz.
• Mağaza bazlı stok. “Stok var” cevabı depo veya mağaza kırılımı olmadan yanlıştır; hangi noktadan sevk edileceği sipariş anında belirlenir.
• Sezon ve koleksiyon. Geçen sezonun varyantları listelerden düşer ama açık siparişlerde yaşamaya devam eder; köprü kapanmış varyantı silmez, pasife alır.

Örnek: toptan B2B portaldan gelen siparişin Nebim’e yazılması

POST /kopru/v1/siparis
Authorization: Bearer <jeton>
Content-Type: application/json

{
  "cariKod": "TPT-00417",
  "belgeNo": "B2B-2026-002231",
  "sevkNoktasi": "DEPO-MERKEZ",
  "satirlar": [
    { "barkod": "8690000123451", "miktar": 24 },
    { "barkod": "8690000123468", "miktar": 12 }
  ]
}

Ara katman önce barkodları Nebim’deki varyantlarla eşler, sevk noktasındaki serbest stoğu okur, cari için geçerli toptan fiyat listesini ve açık bakiyeyi kontrol eder; ancak bundan sonra Entegratör üzerinden siparişi yazar. Dönen cevap Nebim’in ürettiği belge numarasını ve eksik stok uyarısını taşır:

{
  "durum": "kaydedildi",
  "nebimBelgeNo": "TS-2026-000891",
  "uyarilar": [
    { "barkod": "8690000123468", "mesaj": "Talep 12, serbest stok 8. Kalan 4 adet bekleyen siparişe alındı." }
  ]
}

Aynı belgeNo ile gelen ikinci istek yeni sipariş açmaz, mevcut kaydın durumunu döner. Ağ koptuğunda çift siparişi engelleyen tek koruma budur ve Nebim’e yazılan her belge için bu kimlik saklanır.

En sık kurulan Nebim V3 entegrasyon senaryoları

Bayi portalının ERP’den bağımsız kuralları B2B bayi portalı yazısında; Logo, Netsis, Mikro, DİA ve SAP Business One tarafındaki karşılıkları entegrasyon sayfasında topladık.

Entegrasyonda dikkat edilecek noktalar

1. Doküman ve test ortamı ilk hafta. Entegratör dokümanı, test veritabanı ve servis kullanıcısı elde olmadan takvim verilmez; projelerin uzamasının bir numaralı sebebi budur.
2. Sözleşme testi. Kullanılan her uç için örnek istek ve beklenen cevap saklanır; V3 sürüm yükseltmesinden sonra testler çalıştırılır, fark canlıya alınmadan raporlanır.
3. Barkodsuz varyant yok. Eşlemede ad veya açıklama kullanılmaz; barkodu eksik ürün senkrona girmez, listeye düşer.
4. Fiyat Nebim’den. Portal ya da uygulama fiyatı kendisi hesaplamaz; kampanya değiştiğinde eski fiyattan satış olmaz.
5. Denetim izi. Nebim’e yazılan her kaydın hangi dış kullanıcı ve cihazdan tetiklendiği kendi veritabanınızda tutulur.

Bütçe ve süre

Nebim köprüsü kendi sisteminizin yanına ek modül olarak kurulur: kapsama göre 8.000 - 45.000 ₺ bandında, tek yönlü ürün-stok-fiyat okuma veya sipariş aktarımı 2-3 haftada, çift yönlü sipariş, sevkiyat ve tahsilat akışı 2-4 haftada devreye girer. Bantların tamamı fiyat sayfasında; Entegratör lisansı Nebim ile sizin aranızdaki sözleşmeye göre ayrıca işler.

Hangi V3 sürümünü kullandığınızı, Entegratör lisansınızın olup olmadığını ve dışarı açmak istediğiniz süreci yazın; teklif formundan başlayalım.

---

İlgili Bayi ve Sipariş Rehberleri

• B2B Bayi Sipariş Portalı Fiyatları 2026 — Toptancı ve distribütör bayi portalları maliyet analizi.
• Elle İş Maliyeti Hesaplayıcı — Manuel sipariş girişi ve mutabakat için harcanan yıllık emek kaybını hesaplayın.
• En İyi B2B Bayi Portalı Yazılımları 2026 — T-Soft, Ticimax, Logo ve özel bayi portalı incelemesi.
• Saha Satış ve Plasiyer Programı Fiyatları — Plasiyer mobil sipariş ve cari takip sistemleri.

Sıkça sorulan sorular

Nebim V3 Entegratör nedir?

Nebim V3 ERP'nin dış sistemlerle konuşmasını sağlayan katmandır. Nebim'in kendi sayfasına göre Entegratör'ün sunduğu REST API servisleriyle platform ve cihaz bağımsız, gerçek zamanlı entegrasyon çözümleri geliştirilebilir. Veritabanı içe/dışa aktarım işlemleri de ayrı bir yol olarak sunulur.

Nebim V3 REST API dokümanı herkese açık mı?

Hayır. Nebim uç nokta listesini ve alan setlerini kamuya açık yayımlamıyor; doküman, Entegratör lisansına sahip kurulumlara ve çözüm ortaklarına verilir. Bu yüzden projeye başlamadan üç şey netleşir: Entegratör lisansı var mı, hangi V3 sürümü kullanılıyor, doküman ve test ortamı kimden gelecek.

Nebim'in hazır e-ticaret bağlantısı varken özel entegrasyon ne zaman gerekir?

Nebim, e-ticaret, e-dönüşüm, kargo, ÖKC, sadakat ve açık bankacılık gibi alanlarda hazır bağlantılar listeliyor. Özel entegrasyon, bu listede olmayan bir uygulama söz konusu olduğunda gerekir: kendi B2B toptan portalınız, mağaza ekibinin stok sorgu uygulaması, saha satış, franchise raporlama veya fason üretim takibi gibi.

Nebim V3 veritabanına doğrudan yazılır mı?

Yazılmaz. Nebim'in kendi sunduğu iki yol REST API ve veritabanı içe/dışa aktarımıdır; doğrudan tabloya kayıt açmak stok, fiyat ve muhasebe zincirini atlar. Doğrudan veritabanı bağlantısı yalnız okuma ve raporlama için, o da yetkili bir kullanıcıyla kullanılır.

Nebim V3 sürüm yükseltmesinde entegrasyon bozulur mu?

Nebim, Entegratör üzerinden yapılan entegrasyonların V3 sürüm değişimlerinde geriye dönük uyumlu kalmasının sağlanabildiğini belirtiyor. Biz buna bir kural ekleriz: köprünün her ucu için bir sözleşme testi tutulur; yükseltme sonrası testler çalıştırılır ve fark varsa canlıya alınmadan raporlanır.

Nebim V3 entegrasyon projesi ne kadar sürer?

Tek yönlü ürün-stok-fiyat okuma veya sipariş aktarımı 2-3 haftada, çift yönlü sipariş, sevkiyat ve tahsilat akışı 2-4 haftada devreye alınır. Süreyi belirleyen, Entegratör dokümanının ve test ortamının ilk hafta elde olmasıdır.

İlgili rehberler

• Logo ve Netsis entegrasyon rehberi: REST API, Objects ve özel web/mobil arayüz köprüsü
• DİA Web Servis API: kendi yazılımınızı DİA'ya nasıl bağlarsınız?
• Paraşüt API: kendi yazılımınızdan fatura kesmek ve e-faturayı tetiklemek

Hizmet sayfası: Entegrasyon hizmeti