Shopify Nebim entegrasyonu, Türkiye'nin en yaygın perakende ERP'si olan Nebim ile Shopify mağazası arasında ürün kataloğu, stok, sipariş, fatura ve müşteri verilerinin çift yönlü olarak senkronize edildiği bir sistem entegrasyonudur. Nebim, özellikle tekstil, hazır giyim ve çok kanallı perakende sektöründe faaliyet gösteren Türk işletmelerinde yaygın biçimde kullanılır; Shopify ile entegrasyonu ise bu işletmelerin e-ticaret operasyonunu ERP merkezi üzerinden yönetmesini sağlar. Bu rehber; entegrasyon mimarisini, hangi verilerin nasıl aktığını, middleware seçeneklerini ve Türkiye'ye özgü e-fatura/e-arşiv süreçlerini teknik düzeyde ele alır.
Nebim Nedir ve Shopify ile Neden Entegre Edilir?
Nebim, İstanbul merkezli Nebim Bilgisayar Hizmetleri tarafından geliştirilen, Türkiye'de özellikle moda ve perakende sektöründe yaygın kullanılan bir ERP sistemidir. Stok yönetimi, satın alma, mağaza yönetimi (POS), CRM, e-fatura ve pazaryeri entegrasyonu modüllerini tek platform altında toplar.
Shopify ile entegrasyon ihtiyacı genellikle şu senaryolardan doğar: işletme zaten Nebim kullanıyor ve Shopify mağazası açıyor; ya da var olan Shopify mağazası büyüyünce manuel veri girişi sürdürülemez hale geliyor ve ERP ihtiyacı ortaya çıkıyor. Her iki durumda da iki sistem arasındaki veri köprüsü kurulmadan stok tutarsızlıkları, sipariş gecikmeleri ve muhasebe hataları kaçınılmaz olur.
Entegrasyonun çözdüğü temel sorunlar:
- Shopify'da satılan ürünün stoğu Nebim'da düşmezse aynı ürün fiziksel mağazada da satılır; çift satış ve iade krizi oluşur.
- Sipariş bilgilerini Shopify'dan Nebim'e manuel girmek günlük 50-100 sipariş hacminde 2-3 saatlik çalışma yükü yaratır.
- E-fatura kesimi için sipariş verilerinin Nebim'e aktarılmış olması gerekir; manuel aktarım hem geciktirmez hem de hata riskini artırır.
- Trendyol, Hepsiburada gibi pazaryerlerini Nebim'in kendi entegrasyon modülünden yönetenler, Shopify'ı da bu merkezi yapıya dahil etmek ister.
Shopify Nebim Entegrasyonunun Teknik Mimarisi
Shopify ile Nebim doğrudan birbirine bağlanmaz; aralarında bir middleware (ara katman) çalışır. Bu middleware, her iki sistemin API'larıyla konuşur, veriyi dönüştürür ve senkronizasyonu yönetir.
Temel mimari şema:
Shopify Admin API (REST/GraphQL)
↕
Middleware / Entegrasyon Katmanı
↕
Nebim API (REST veya SOAP)
Shopify tarafında kullanılan başlıca API endpoint'leri:
- GET /products.json — ürün kataloğu çekme
- POST /inventory_levels/set.json — stok güncelleme
- GET /orders.json — yeni sipariş sorgulama
- Webhook: orders/create, orders/updated — gerçek zamanlı sipariş bildirimi
Nebim tarafında entegrasyon, Nebim'in sunduğu ERP API servisleri üzerinden yürür. Nebim'ın API altyapısı REST veya SOAP formatında hizmet verebilir; mevcut Nebim versiyonu ve lisans tipi hangi endpoint'lerin açık olduğunu belirler. Bu nedenle entegrasyon başlamadan önce Nebim danışmanınızdan aktif API modüllerini ve versiyon notlarını alın.
Middleware Seçenekleri: Hazır vs. Özel Geliştirme
Nodus Works olarak gözlemledik ki, Türkiye'deki Shopify + Nebim projelerinde en sık sorun hazır SaaS middleware'in Nebim'in güncellenmiş API versiyonlarıyla gecikmeli uyum sağlamasından kaynaklanıyor. Nebim büyük versiyon güncellemelerinde (ör. 7.x → 8.x) bazı endpoint formatları değişiyor; middleware güncellenmeden entegrasyon sessizce bozuluyor ve hata ancak stok tutarsızlığı fark edilince ortaya çıkıyor. Bu nedenle özellikle 500+ SKU ve günlük 100+ sipariş hacminde özel middleware geliştirmeyi tercih ediyoruz.
Senkronize Edilen Veriler ve Akış Yönleri
Shopify-Nebim entegrasyonunda hangi verinin hangi yönde aktığını doğru tanımlamak, hem mimari tasarım hem de hata ayıklama açısından kritiktir.
Stok senkronizasyonunda kritik karar: Gerçek zamanlı (webhook tabanlı) mı, yoksa periyodik (polling) mi?
Gerçek zamanlı senkronizasyon, webhook ile tetiklendiği için stok değişimi anında Shopify'a yansır. Ancak Nebim tarafında webhook desteğinin mevcut olması gerekir; eski Nebim versiyonlarında bu yoksa middleware'in Nebim'i düzenli aralıklarla sorgulaması (polling) tek seçenektir. 15 dakikalık polling aralığı, günlük 200-300 sipariş hacmine kadar yeterlidir; daha yüksek hacimde veya flash sale dönemlerinde stok uçurumu riski oluşabilir.
Kritik Not: Çok lokasyonlu stok yapısında (merkez depo + mağaza depoları) Shopify'ın inventory location mantığı ile Nebim'in depo yapısı eşleştirilmelidir. Bu eşleştirme yapılmadan sadece toplam stok aktarılırsa Shopify, hangi depodan gönderileceğini bilemez ve fulfillment hatası oluşur.
Ürün Kataloğu Senkronizasyonu: Dikkat Edilmesi Gereken Noktalar
Nebim'dan Shopify'a ürün aktarımı, en karmaşık ve en sık hata üreten adımdır. Nebim'in ürün veri modeli ile Shopify'ın ürün modeli birbirine tam olarak karşılık gelmez.
Varyant eşleştirme: Nebim'de beden ve renk kombinasyonları ayrı SKU olarak tutulur. Shopify'da ise tek bir ürün altında varyant olarak listelenir. Middleware, Nebim'in ayrı SKU'larını Shopify'ın product_id + variant_id yapısına dönüştürmelidir. Bu dönüşümde beden/renk kombinasyonlarını doğru eşleştiren bir mapping tablosu zorunludur.
Görseller: Nebim, ürün görsellerini dosya yolu referansı olarak tutar; Shopify ise görselin CDN URL'sine ihtiyaç duyar. Görsel aktarımı için ya Nebim'deki görsel dosyaları Shopify'ın Files API'sine yüklenir, ya da harici bir CDN üzerinden URL referansı kullanılır.
Ürün açıklamaları ve SEO alanları: Nebim'ın ürün açıklama alanları genellikle lojistik odaklıdır (malzeme kodu, tedarikçi kodu gibi). Shopify'daki SEO açıklaması ve meta başlığı için ya Nebim'e ek alanlar eklenir ya da Shopify tarafında manuel zenginleştirme yapılır. Nodus Works olarak tercih ettiğimiz yaklaşım: temel ürün verisi Nebim'den gelsin, SEO optimizasyonu Shopify Admin'de yapılsın ve bu alanlar entegrasyon tarafından üzerine yazılmasın.
İpucu: Entegrasyon başlamadan önce Nebim'deki ürün veri kalitesini denetleyin. Eksik barkod, tutarsız kategori kodları veya boş ürün açıklamaları entegrasyona taşınır ve Shopify'da da aynı sorunlara neden olur. Veri temizliği entegrasyon kurulumunun bir parçası, sonrası değil.
E-Fatura ve E-Arşiv Entegrasyonu
Türkiye'de GİB'in e-fatura ve e-arşiv zorunlulukları, Shopify-Nebim entegrasyonunu yalnızca operasyonel değil yasal açıdan da zorunlu kılar. Nebim, GİB onaylı e-fatura entegratörü üzerinden e-fatura kesebilir; Shopify'daki sipariş Nebim'e aktarıldığında bu süreç tetiklenebilir.
Sürecin işleyişi:
- Shopify'da ödeme tamamlanır → webhook tetiklenir
- Middleware, sipariş verisini Nebim formatına dönüştürür: müşteri adı, vergi no (B2B siparişlerde), ürün listesi, fiyat, KDV
- Nebim, siparişi sisteme kaydeder
- Nebim'in e-fatura modülü GİB onaylı e-fatura entegratörüne bağlanarak faturayı keser
- E-fatura PDF'i ve UBL-TR XML'i müşteriye otomatik iletilir
B2B müşteriler için kritik ek adım: Shopify checkout'unda vergi kimlik numarası (VKN) toplayan özel bir alan zorunludur. Shopify'ın standart checkout'unda bu alan yoktur; Checkout Extensibility (Plus) veya özel bir uygulama ile eklenir. Nodus Works olarak gözlemledik ki B2B sipariş alan Shopify mağazalarının yaklaşık %60'ı bu alanı checkout'a eklemeyi ihmal ediyor ve her siparişte müşteriyle ayrıca iletişim kurarak VKN alıyor bu hem müşteri deneyimini bozuyor hem de faturalamayı geciktiriyor.
Pazaryeri Entegrasyonu: Nebim Üzerinden Omnichannel Yönetim
Nebim'ın pazaryeri entegrasyon modülü, Trendyol, Hepsiburada, n11 ve Amazon gibi platformlarla doğrudan bağlantı kurabilir. Bu yapıda Shopify da Nebim'e bağlı bir satış kanalı olarak eklenir ve tüm kanalların stok, sipariş ve fatura yönetimi tek merkezden yapılır.
Omnichannel yapının avantajı: Bir Trendyol siparişinde stok düştüğünde bu değişiklik Nebim'e yansır ve Nebim üzerinden Shopify stoku da güncellenir. Kanallar arası stok çakışması ortadan kalkar.
Dikkat: Pazaryeri entegrasyonunu Nebim üzerinden değil, Shopify üzerinden kuranlar (ör. Shopify'ın Trendyol entegrasyon uygulamalarıyla) çift kaynak sorunuyla karşılaşır. Shopify ve Nebim aynı anda birbirinden bağımsız Trendyol sipariş çekmeye çalışırsa stok ve sipariş verileri çakışır. Bu nedenle mimari kararı net vermek gerekir: Nebim master sistem mi, Shopify master sistem mi?
Nodus Works olarak gözlemledik ki Türkiye'deki çok kanallı perakendecilerin büyük çoğunluğunda Nebim doğal master sistem konumundadır stok gerçeği orada tutulur. Bu yapıda Shopify, Nebim'in önündeki bir satış kanalı olarak konumlandırılır; tüm iş kuralları Nebim'de çalışır.
Entegrasyon Kurulum Süreci: 4 Aşama
Aşama 1: Analiz ve Veri Haritalama (1-2 hafta)
- Nebim versiyon ve lisans denetimi: hangi API modülleri aktif?
- Ürün veri modelinin analizi: kaç SKU, kaç varyant, hangi özel alanlar?
- Stok lokasyon yapısı: tek depo mu, çok depo mu?
- Sipariş akışı: kargo firması entegrasyonu Nebim üzerinden mi, Shopify üzerinden mi?
- E-fatura zorunluluğu var mı? B2B sipariş var mı?
Aşama 2: Middleware Geliştirme veya Yapılandırma (2-4 hafta)
Hazır middleware seçildiyse: API anahtarları yapılandırılır, alan eşleştirmeleri (field mapping) tanımlanır, test ortamında veri akışı doğrulanır.
Özel geliştirme seçildiyse: API entegrasyon katmanı, hata yönetimi ve yeniden deneme (retry) mekanizması, loglama sistemi kurulur.
Aşama 3: Test ve Veri Doğrulama (1-2 hafta)
- Ürün aktarım testi: Nebim'deki 50-100 ürün Shopify'a doğru aktarıldı mı?
- Stok senkronizasyon testi: Nebim'de stok değişince Shopify güncelleniyor mu?
- Sipariş döngüsü testi: Shopify'da test siparişi → Nebim'e düşüyor mu? → E-fatura kesiliyor mu?
- Yük testi: aynı anda 50 sipariş geldiğinde sistem davranışı
Aşama 4: Canlıya Geçiş ve İzleme (1 hafta)
- Kademeli geçiş: önce düşük hacimlerde canlı trafikle test
- İlk 30 gün günlük log denetimi
- Stok sapma raporu: Nebim ve Shopify stok değerleri günlük karşılaştırılır
- Hata bildirimi: kritik hatalar (sipariş aktarılamadı, stok güncellenemedi) için anlık alarm
Yaygın Hatalar ve Çözümleri
1. Ürün ID uyumsuzluğu
Nebim'deki ürün kodu ile Shopify'daki product_id farklı formatlarda olabilir. Middleware, bu eşleştirmeyi kendi veri tabanında tutmalıdır. Ürün silinip yeniden oluşturulduğunda eşleştirme bozulursa stok güncellemeleri yanlış ürüne yazılır.
2. Stok sıfırlama hatası
Bağlantı kopukluğu sonrası middleware yeniden başladığında "başlangıç stok senkronizasyonu" tüm Shopify stoklarını sıfıra çekebilir. Retry mekanizmasında "sıfır stok gönderme" için ayrı bir koruma katmanı zorunludur.
3. Fiyat güncelleme gecikmeleri
Nebim'de sezon sonu indirim uygulandığında fiyatların Shopify'a yansıması saatler alabilir. Yüksek frekanslı periyodik sync veya Nebim tarafında webhook ile bu gecikme minimuma çekilir.
4. Çift sipariş oluşturma
Aynı Shopify siparişi ağ zaman aşımı nedeniyle iki kez Nebim'e gönderilebilir. Her entegrasyon isteğinde sipariş numarasını idempotency key olarak kullanmak bu hatayı önler.
SSS
Shopify ile Nebim nasıl entegre edilir?
Doğrudan bağlantı yoktur; aralarında bir middleware çalışır. Middleware, Shopify Admin API ve Nebim API'larıyla konuşarak ürün, stok, sipariş ve fatura verilerini çift yönlü senkronize eder. Hazır SaaS middleware veya özel geliştirme seçenekleri mevcuttur; seçim sipariş hacmine ve özelleştirme ihtiyacına göre yapılır.
Shopify Nebim entegrasyonu ne kadar sürer?
Hazır middleware ile 2-4 hafta, özel geliştirme ile 6-10 hafta arasında değişir. Süreyi etkileyen en kritik faktörler: Nebim versiyonu ve API erişim durumu, ürün kataloğunun karmaşıklığı, e-fatura ve pazaryeri entegrasyonu gereklilikleri.
Nebim'dan Shopify'a stok gerçek zamanlı güncellenir mi?
Nebim'in webhook desteğine bağlıdır. Destekleniyorsa stok değişikliği saniyeler içinde Shopify'a yansır. Desteklenmiyorsa middleware periyodik sorgu (polling) yapar; güncelleme 5-15 dakika aralıklı olur. Flash sale dönemlerinde gerçek zamanlı senkronizasyon zorunludur.
Shopify'daki siparişler otomatik olarak e-faturaya dönüşür mü?
Evet, doğru yapılandırılmış entegrasyonda Shopify siparişi Nebim'e aktarılır ve Nebim'in e-fatura modülü GİB entegratörü üzerinden faturayı otomatik keser. B2B siparişlerde müşterinin VKN bilgisinin Shopify checkout'unda toplanması gerekir.
Nebim ve Trendyol'u aynı anda kullanıyorum, Shopify'ı nasıl entegre ederim?
Nebim'i master sistem olarak konumlandırın. Trendyol ve Shopify, Nebim'e bağlı iki ayrı satış kanalı olarak çalışır. Stok ve sipariş yönetimi Nebim üzerinden yürür. Shopify için ayrı bir Trendyol entegrasyon uygulaması kullanmayın çakışan veri kaynakları stok tutarsızlığına yol açar.
Shopify Nebim entegrasyonu hangi Nebim versiyonlarında çalışır?
Entegrasyon, Nebim'ın API modülünün aktif olduğu versiyonlarda uygulanabilir. Nebim 7.x ve üzeri genellikle REST API desteği sunar; eski versiyonlarda SOAP servisleri kullanılır. Projeye başlamadan önce Nebim danışmanınızdan aktif API endpoint'lerini ve versiyon belgelerini alın.
Shopify'da Nebim stok senkronizasyonu nasıl çalışır?
Middleware, Nebim'ın stok API'sini sorgular ve değişiklikleri Shopify'ın inventory_levels/set.json endpoint'ine gönderir. Gerçek zamanlı için webhook tabanlı tetikleyici, webhook yoksa periyodik polling kullanılır. Çok lokasyonlu yapıda her Nebim deposu, Shopify'ın ilgili inventory location'ına eşlenmelidir.
Shopify Nebim entegrasyonu için hangi API endpoint'leri gereklidir?
Shopify tarafında: products, variants, inventory_levels, orders, refunds endpoint'leri. Nebim tarafında: ürün listeleme, stok sorgulama/güncelleme, sipariş oluşturma ve e-fatura tetikleme servisleri. Gereken endpoint'ler Nebim lisans paketine ve versiyonuna göre değişir.
Shopify'dan Nebim'e sipariş aktarımında hangi veriler gereklidir?
Sipariş numarası, sipariş tarihi, müşteri bilgileri (ad, adres, e-posta), ürün SKU'ları ve miktarları, fiyat ve KDV bilgisi, kargo adresi ve seçilen kargo yöntemi. B2B siparişlerde müşteri VKN'si zorunludur.
Sonuç
Shopify Nebim entegrasyonu, doğru mimari kurulmadığında stok uçurumu, çift sipariş ve fatura gecikmesi gibi kritik operasyonel sorunlara zemin hazırlar. Doğru kurulduğunda ise sipariş başına harcanan manuel iş süresini neredeyse sıfıra indirir ve çok kanallı satışı merkezi bir ERP üzerinden yönetmeyi mümkün kılar.
Nebim + Shopify entegrasyonunuzu tasarlamak, mevcut entegrasyonunuzdaki hataları çözmek veya middleware mimarisini yeniden yapılandırmak için Nodus Works ile görüşün. Nebim'in API altyapısını ve Shopify'ın entegrasyon gereksinimlerini yerinde değerlendirerek doğru teknik kararı birlikte alalım.
