Netsis NetOpenX Nedir? Netsis Entegrasyonuna Teknik Giriş

Netsis'in MS SQL Veri Mimarisi ve Logo Tiger'dan Kritik Farkı

Netsis arka planda Microsoft SQL Server kullanır. Veritabanı şemasında tüm tablolar "TBL_" öneki ile başlar. Ancak Logo Tiger veya Logo Go'dan farklı olarak firma numarası ve dönem numarası tablo adına gömülmez.

Örnek vermek gerekirse, Logo Tiger'da stok kartları LG_001_ITEMS gibi bir tabloda tutulurken (001 firma numarası), Netsis'te tek bir TBL_STOK_KARTLARI tablosu vardır. Firma ayrımı ISLETME_KODU ve SUBE_KODU kolonları ile yapılır.

Bu fark, sorgu tasarımını doğrudan etkiler:

Logo Tiger sorgusu (firma/dönem tablo adında):

SELECT * FROM LG_001_01_ITEMS WHERE CODE = 'URUN123'

Netsis sorgusu (firma/dönem kolon filtresi):

SELECT * FROM TBL_STOK_KARTLARI 
WHERE ISLETME_KODU = 1 
  AND SUBE_KODU = 1 
  AND STOK_KODU = 'URUN123'

Bu mimari fark üç pratik sonuç doğurur:

1. Sorgu performansı: Tüm firmalar aynı tabloda olduğu için index tasarımı kritik.
2. Multi-branch senaryoları: Şubeler arası stok sorgularında JOIN yerine UNION kullanmanız gerekebilir.
3. Migration: Logo'dan Netsis'e geçişte tablo eşleme haritası hazırlamanız şart — birebir uyum yok.

Tablo İsimlendirme Mantığı ve Kurulum Kontrolü

Netsis kurulumunuza göre tablo adları değişebilir. Standart isimlendirme TBL_STOK_KARTLARI, TBL_CARI_HESAPLAR, TBL_FATURALAR şeklinde olsa da bazı versiyonlarda ön ekler veya modül kodları eklenebilir.

Bu yüzden entegrasyona başlamadan önce Netsis Data Inspector aracıyla veya SQL Server Management Studio (SSMS) ile veritabanına bağlanıp şemayı görselleştirmenizi öneririz. Tablo adlarını varsayıma dayalı yazmayın — kurulumda doğrulayın.

Sık karşılaşılan bir durum: Netsis özelleştirilmiş bir distribütör tarafından kurulmuş ve tablo önekleri TBL_ yerine NS_ ile başlıyor. Dokümantasyondaki isimleri aynen kullanan sorgular boş döner. Şema kontrolü ile bu tür farklar hızlıca tespit edilebilir.

NetOpenX Nedir ve Neden Kullanılır?

NetOpenX, Netsis'in resmi veri erişim katmanıdır. Amacı, iş mantığını (hesaplama kuralları, stok rezervasyon mantığı, cari hesap bakiye güncellemesi gibi) bozmadan kayıt aktarma ve veri alma işlemlerini sağlamaktır.

Doğrudan SQL sorgusuyla Netsis veritabanına yazmak teknik olarak mümkün, ancak risk çok yüksek:

• Fatura kaydederken ilgili stok hareketini, cari hesap bakiyesini ve muhasebe fişini de tetiklemeniz gerekir.
• Trigger'lar, stored procedure'ler ve Netsis'in kendi validasyon katmanı bu işlemleri yönetir.
• SQL INSERT ile sadece TBL_FATURALAR tablosuna satır eklerseniz, stok güncellemesi olmaz.

NetOpenX bu riski ortadan kaldırır: Bir fatura gönderdiğinizde, Netsis'in kendi iş katmanı (business layer) devreye girer ve tüm ilişkili kayıtlar otomatik oluşturulur.

NetOpenX'in Sağladığı Güvenlik ve Tutarlılık

Tipik bir senaryo: B2B portal entegrasyonunda, başlangıçta "SQL'e direkt yazalım, hızlı olsun" yaklaşımı düşünülür. Sorgular yazılır, test ortamında siparişler kaydedilir. İlk bakışta her şey çalışıyor gibi görünür. Ancak muhasebe departmanı kontrol ettiğinde ortaya çıkar: siparişler Netsis'te görünüyor ama stok rezervasyonu yapılmamış, sevkıyat takibi yok.

Neden? Çünkü Netsis sipariş kaydederken arka planda 5 farklı tabloya yazıyor, stok modülüne sinyal gönderiyor, eğer CRM modülü aktifse müşteri ilişki geçmişine not düşüyor. Bunları manuel SQL ile simüle etmek hem zaman kaybı hem de hata riski.

NetOpenX kullanıldığında iş mantığı bozulmaz, sevkiyat takibi çalışır, muhasebe fişleri doğru kesilir.

NetOpenX REST API: Windows Servisi ve Swagger Desteği

NetOpenX'in REST API versiyonu (NetOpenX REST), IIS kurulumu gerektirmez. Doğrudan Windows servisi olarak çalışır ve Swagger UI ile birlikte gelir.

Bu iki özellik, entegrasyon geliştirme sürecini hızlandırır:

1. IIS gerektirmemesi: Klasik API'ler IIS üzerinde yayınlanır, bu da sunucu yapılandırması, uygulama havuzu ayarları, SSL sertifikası gibi ekstra işlemler gerektirir. NetOpenX REST, Netsis sunucusunda bir Windows servisi olarak başlatılır ve belirlediğiniz portta (varsayılan 9200) yayına girer.

2. Swagger entegrasyonu: Swagger, API endpoint'lerini, parametreleri ve örnek yanıtları görselleştirir. Entegrasyon geliştiricisi olarak dokümantasyon okumak yerine tarayıcıdan "Try it out" diyerek canlı istek gönderebilirsiniz.

Örneğin stok listesi çekmek için:

GET http://netsis-sunucu:9200/api/StokKartlari?isletmeKodu=1&subeKodu=1

Swagger arayüzünden bu endpoint'i seçip "Execute" dediğinizde JSON yanıtı anında görürsünüz.

Kurulum ve Lisans Doğrulaması

NetOpenX REST'i kurmadan önce lisans ve modül durumunu mutlaka doğrulayın. Netsis'te satın aldığınız modüller (Stok, Cari, Üretim, CRM vb.) NetOpenX erişimini etkiler. Örneğin CRM modülünüz yoksa /api/CrmKayitlari endpoint'i 403 hatası döner.

Kurulum adımları (genel hatlarıyla):

1. Netsis sunucusunda NetOpenX REST kurulum dosyasını çalıştırın.
2. Servis ayarlarında bağlantı dizesini (SQL Server), port numarasını ve lisans bilgilerini girin.
3. Windows servisi olarak başlatın.
4. Tarayıcıda http://localhost:9200/swagger adresine giderek Swagger UI'yi kontrol edin.

Yaygın bir sorun senaryosu: Netsis lisansı "Temel Modül" ile sınırlı, Üretim ve İleri Stok Takibi modülleri yok. NetOpenX üzerinden yarı mamul transferi yapmak istendiğinde endpoint erişim hatası alınır. Netsis bayisi ile görüşüp lisansın güncellenmesi gerekir. Başlangıçta modül durumunun teyit edilmesi, proje süresini önemli ölçüde kısaltır.

Okuma ve Yazma İşlemlerinde Farklı Yaklaşımlar

NetOpenX ile okuma (GET) ve yazma (POST/PUT) işlemleri farklı dikkat gerektiriyor.

Okuma İşlemleri (Veri Çekme)

Okuma işlemleri genellikle güvenlidir. NetOpenX REST üzerinden /api/StokKartlari, /api/CariHesaplar, /api/Faturalar gibi endpoint'lerden veri çekebilirsiniz.

Dikkat edilmesi gereken noktalar:

• Filtreleme: Büyük veritabanlarında tüm kayıtları çekmek performans sorunu yaratır. isletmeKodu, subeKodu, tarih aralığı gibi filtreler kullanın.
• Sayfalama: Binlerce ürün varsa, API yanıtını sayfalara bölün (örneğin 100'er kayıt).
• İlişkisel veriler: Stok kartı çekerken, ilişkili birim seti, KDV oranı, depo bilgisi gibi verileri ayrı endpoint'lerden almanız gerekebilir.

Örneğin e-ticaret sitenizde stok miktarını göstermek istiyorsunuz. Her sayfa yüklendiğinde tüm stok kartlarını çekmek yerine, sadece o sayfada görünen ürünlerin kodlarını parametre olarak gönderin:

POST /api/StokKartlari/Filtrele
{
  "isletmeKodu": 1,
  "subeKodu": 1,
  "stokKodlari": ["URN001", "URN002", "URN003"]
}

Yazma İşlemleri (Veri Gönderme)

Yazma işlemleri daha hassastır. Fatura, sipariş, stok hareketi gibi kayıtlar gönderirken zorunlu alanları ve veri formatlarını tam olarak bilmeniz gerekir.

NetOpenX POST isteklerinde genellikle JSON body kullanılır:

{
  "isletmeKodu": 1,
  "subeKodu": 1,
  "cariKodu": "CRI001",
  "faturaTarihi": "2025-01-15",
  "satirlar": [
    {
      "stokKodu": "URN001",
      "miktar": 10,
      "birimFiyat": 150.00,
      "kdvOrani": 20
    }
  ]
}

Kritik uyarılar:

• Tarih formatı: ISO 8601 (YYYY-MM-DD) kullanın. Türkçe tarih formatı (15.01.2025) hata verir.
• Ondalık ayırıcı: Nokta (.) kullanın, virgül (,) değil.
• Zorunlu alanlar: Swagger dokümantasyonunda required işaretli alanları atlarsanız 400 Bad Request hatası alırsınız.
• İş mantığı kısıtları: Netsis'te tanımlı olmayan cari/stok kodu gönderirseniz işlem reddedilir.

Tipik bir entegrasyon hatası: otomatik sipariş gönderen sistemde bazı siparişler reddediliyor. Log'lara bakıldığında KDV oranı alanının zorunlu olduğu, ancak kaynak sistemin bu alanı göndermediği görülüyor. Varsayılan KDV oranı eklenerek sorun çözülür.

Netsis Data Inspector: Resmi Uyarlama ve Kontrol Aracı

Netsis Data Inspector, Netsis'in resmi veri görüntüleme ve kontrol aracıdır. Entegrasyon geliştirme sürecinde şu amaçlarla kullanılır:

1. Tablo ve kolon yapılarını inceleme: Hangi tabloda hangi alanların olduğunu görmek.
2. Örnek kayıtları görüntüleme: Bir faturanın Netsis'te nasıl saklandığını anlamak.
3. İlişkisel bağlantıları keşfetme: Hangi tablolar birbirine foreign key ile bağlı?
4. Veri tipi ve kısıtları doğrulama: Bir alan VARCHAR(50) mi yoksa NVARCHAR(100) mü?

Data Inspector kullanmadan entegrasyona başlamak, karanlıkta yol almaya benzer. Özellikle özelleştirilmiş Netsis kurulumlarında (sektörel uyarlamalar, eklenti modüller) standart dokümantasyon yetersiz kalır.

Örnek senaryo: Üretim modülü entegrasyonunda reçete (ürün ağacı) verileri çekilmesi gerekiyor. Netsis dokümantasyonunda TBL_URETIM_RECETE tablosu yazıyor, ancak veritabanında böyle bir tablo yok. Data Inspector ile şema tarandığında TBL_RECETE_ANA ve TBL_RECETE_DETAY olarak iki ayrı tabloda tutulduğu görülüyor. Data Inspector kullanılmasaydı, bu bulguyu elde etmek günler alırdı.

SUBE_KODU ve ISLETME_KODU ile Sorgu Tasarımı

Netsis'te firma ve şube ayrımı ISLETME_KODU ve SUBE_KODU kolonlarıyla yapılır. Her kayıtta bu iki alan mutlaka bulunur.

ISLETME_KODU: Yasal şirket (tüzel kişilik) numarası. Örneğin grup bünyesinde üç ayrı şirket varsa, her birinin farklı işletme kodu vardır.

SUBE_KODU: Aynı işletme içindeki fiziksel veya operasyonel şube. Örneğin İstanbul ve Ankara şubelerinin ayrı kodları olabilir.

Sorgu yazarken her iki kolon da filtre edilmelidir:

SELECT STOK_KODU, STOK_ADI, MIKTAR 
FROM TBL_STOK_HAREKETLERI
WHERE ISLETME_KODU = 1 
  AND SUBE_KODU = 2
  AND HAREKET_TARIHI >= '2025-01-01'

Eğer SUBE_KODU filtresini unutursanız, tüm şubelerin kayıtları gelir ve veri karışıklığı oluşur.

Çoklu Şube Senaryoları

Bir perakende zinciri 10 şube ile çalışıyorsa ve merkez sistemde tüm şubelerin stok durumunu görmek istiyorsanız:

SELECT SUBE_KODU, STOK_KODU, SUM(MIKTAR) AS TOPLAM_STOK
FROM TBL_STOK_HAREKETLERI
WHERE ISLETME_KODU = 1
GROUP BY SUBE_KODU, STOK_KODU

Ya da NetOpenX REST ile:

GET /api/StokDurumu?isletmeKodu=1&tumSubeler=true

Şube bazlı filtreleme, özellikle franchise modelleri ve bölgesel dağıtım merkezleri için kritik. Örnek durum: her mağazanın kendi stok havuzu var, e-ticaret siparişi geldiğinde en yakın mağazadan sevkıyat yapılıyor. SUBE_KODU ile filtreleme yapılmazsa, yanlış lokasyondan sevkiyat planlanabilir.

Entegrasyon Öncesi Kontrol Listesi

Netsis entegrasyonuna başlamadan önce şu adımları tamamlayın:

• Netsis versiyonunu öğrenin: V5, V6, V7 gibi versiyonlar arasında API farklılıkları var.
• Lisans ve modül durumunu teyit edin: Hangi modüller aktif? NetOpenX lisansı var mı?
• Veritabanı bağlantısını test edin: SQL Server'a erişim var mı? Tablo adlarını görüntüleyebildiniz mi?
• NetOpenX REST kurulumu: Windows servisi çalışıyor mu? Swagger UI açılıyor mu?
• Data Inspector kurulumu: Şema haritasını çıkardınız mı?
• Test ortamı: Canlı veriye yazmadan önce test veritabanında deneme yapın.
• Yedekleme planı: Entegrasyon öncesi veritabanı yedeği alın.

Yaygın Hatalar ve Çözümleri

Hata: "Authentication failed" — NetOpenX REST'e bağlanırken yetkilendirme hatası. Çözüm: Netsis kullanıcı adı/şifre doğru mu? API erişim hakkı var mı?

Hata: "Table not found" — Sorgu yazdığınız tablo adı veritabanında yok. Çözüm: Data Inspector ile tablo adını doğrulayın.

Hata: "Constraint violation" — Foreign key hatası. Çözüm: İlişkili tablolarda referans kayıt var mı? Örneğin yeni fatura satırı eklerken STOK_KODU mevcut mu?

Hata: "Timeout" — Sorgu çok uzun sürüyor. Çözüm: Filtreleme ekleyin, tarih aralığını daraltın, index kullanımını kontrol edin.

Sıkça Sorulan Sorular

Netsis entegrasyonu ne kadar sürer ve maliyeti nedir?

Proje süresi ve maliyet, entegre edilecek modüllere, veri hacmine ve özelleştirme ihtiyacına göre değişkenlik gösterir. Basit bir stok senkronizasyonu (e-ticaret ↔ Netsis) ile çift yönlü sipariş-fatura-muhasebe entegrasyonu aynı maliyette olmaz.

D'Cloud Software olarak keşif görüşmesinde ihtiyacınızı dinliyor, mevcut sistemlerinizi inceliyor ve sabit fiyat teklifi sunuyoruz. Sözleşmede yazılı fiyatın dışında ek maliyet çıkmaz. Ayrıca teslim sonrası 15 gün boyunca ücretsiz hata düzeltme garantisi veriyoruz — bu sürede tespit edilen entegrasyon hatalarını ek ücret ödemeden gideriyoruz.

Genellikle orta ölçekli bir entegrasyon projesi 3-6 hafta arasında tamamlanır, ancak kesin süreyi ihtiyaç analizi sonrası netleştiriyoruz.

NetOpenX kullanmadan doğrudan SQL sorgusuyla veri aktarımı yapabilir miyim?

Teknik olarak mümkün, ancak şiddetle önermiyoruz. Netsis'in iş mantığı (stok rezervasyonu, cari hesap bakiyesi, muhasebe fişi oluşturma, trigger'lar vb.) doğrudan SQL yazma ile devre dışı kalır.

Örneğin bir fatura INSERT edip sadece TBL_FATURALAR tablosuna satır eklerseniz:

• Stok miktarı güncellenmez
• Cari hesap borç/alacak bakiyesi değişmez
• Muhasebe entegrasyonu (Mali Müşavir yazılımı) kopuk kalır
• Sevkıyat/depo süreçleri tetiklenmez

NetOpenX bu iş mantığını korur. Sadece okuma (raporlama, analiz) için SQL sorgusu yazabilirsiniz, ancak yazma işlemleri mutlaka NetOpenX üzerinden yapılmalıdır.

SUBE_KODU ve ISLETME_KODU ne zaman önemli hale gelir?

Tek bir tüzel kişilikle (bir şirket) ve tek lokasyonda çalışıyorsanız, genellikle ISLETME_KODU=1 ve SUBE_KODU=1 sabit kalır. Ancak:

• Birden fazla şube açtığınızda (franchise, bölge ofisi vb.)
• Farklı şirketleri tek Netsis veritabanında yönettiğinizde
• Depo/mağaza bazlı stok takibi yaptığınızda

Bu kolonlar kritik hale gelir. Sorgu yazarken bu iki alanı filtre etmeyi unutursanız, yanlış şubenin verilerini çekebilir veya veri karışıklığı yaşayabilirsiniz.

Örnek senaryo: İstanbul ve Ankara'da iki ayrı şube ile çalışan bir firma, e-ticaret entegrasyonunda SUBE_KODU filtresini unutmuş. İstanbul deposundan sipariş alındığında, Ankara deposunun stoğu da görünüyor. Müşteri, Ankara'da olmayan ürünü İstanbul siparişi olarak onaylıyor. Sevkıyat aşamasında stok bulunamıyor. Filtre eklenerek sorgular şubeye özel hale getiriliyor.

Netsis Data Inspector olmadan entegrasyon yapabilir miyim?

Yapabilirsiniz, ancak işiniz çok zorlaşır. Data Inspector, Netsis veritabanının haritasını çıkarır. Hangi tablolarda hangi veriler var, kolonlar arası ilişkiler nasıl, veri tipleri ne — bunları görselleştirir.

Data Inspector olmadan çalışmak, GPS olmadan bilinmeyen bir şehirde yol bulmaya benzer. Netsis dokümantasyonuna güvenebilirsiniz, ancak özelleştirilmiş kurulumlar (sektörel uyarlamalar, eklenti modüller) dokümantasyonda olmayabilir.

Alternatif olarak SQL Server Management Studio (SSMS) ile veritabanına bağlanıp şemayı manuel inceleyebilirsiniz. Ancak Data Inspector, Netsis'e özel ilişki haritalarını ve iş mantığı notlarını da gösterdiği için daha pratiktir.

Örnek durum: CRM modülü entegrasyonunda Data Inspector kullanılmamış. Dokümantasyona göre TBL_CRM_FIRSATLAR tablosu olması gerekiyor, ancak veritabanında yok. SSMS ile kontrol edilince TBL_SATIS_FIRSATLARI olarak özelleştirilmiş olduğu görülüyor. Data Inspector kullansaydık, bu ilk 5 dakikada fark edilirdi.

NetOpenX REST ve klasik NetOpenX (SOAP) arasındaki fark nedir?

NetOpenX'in iki versiyonu var:

1. NetOpenX SOAP (klasik): IIS üzerinde yayınlanır, SOAP protokolü kullanır, WSDL dosyası ile yapılandırılır. Eski sistemlerle uyumlu, ancak kurulum ve yapılandırma daha karmaşık.

2. NetOpenX REST: Windows servisi olarak çalışır, JSON ile veri alışverişi yapar, Swagger UI ile birlikte gelir. Modern web/mobil uygulamalar için daha uygun.

Günümüzde yeni entegrasyon projelerinde NetOpenX REST tercih edilir. Daha hızlı kurulur, test edilmesi kolay (Swagger sayesinde), JSON formatı yazılım geliştiriciler için tanıdık.

Ancak bazı eski sistemler (örneğin .NET Framework 3.5 ile yazılmış eski ERP modülleri) SOAP protokolünü gerektirebilir. Bu durumda klasik NetOpenX kullanılır.

Örnek senaryo: bir lojistik firmasında nakliye takip yazılımı .NET 3.5 ile yazılmış ve sadece SOAP destekliyor. NetOpenX SOAP kurulur, ancak yeni geliştirilen mobil uygulama için NetOpenX REST de paralel çalıştırılır. İki versiyon aynı Netsis veritabanına erişebildiği için sorun çıkmaz.

E-ticaret sitemi Netsis ile entegre etmek istiyorum, nereden başlamalıyım?

İlk adım ihtiyaç analizi. Şu soruları yanıtlayın:

• Hangi verileri senkronize etmek istiyorsunuz? (Stok, fiyat, sipariş, fatura, cari hesap...)
• Senkronizasyon tek yönlü mü, çift yönlü mü? (Örneğin sadece Netsis'ten stok çekip e-ticarete aktarmak tek yönlü; sipariş bilgisini de Netsis'e göndermek çift yönlü)
• Ne sıklıkla senkronize edilmeli? (Anlık, saatlik, günlük...)
• E-ticaret platformunuz nedir? (WooCommerce, Shopify, özel yazılım...)
• Netsis versiyonunuz ve modülleriniz neler?

Bu soruların cevaplarıyla D'Cloud Software'e ücretsiz online keşif görüşmesi için başvurabilirsiniz. Görüşmede mevcut altyapınızı inceliyor, entegrasyon senaryosunu tasarlıyor ve sabit fiyat teklifi sunuyoruz.

Keşif görüşmesi tamamen ücretsiz ve yükümlülük gerektirmiyor. Sadece ihtiyacınızı anlamak ve doğru çözümü sunmak için teknik bir analiz yapıyoruz. WhatsApp hattımızdan veya web sitemizdeki iletişim formundan randevu alabilirsiniz.

Sonuç: Netsis Entegrasyonunda Başarı İçin Teknik Temeller

Netsis, güçlü bir ERP sistemi, ancak veri mimarisi Logo Tiger'dan farklı. Tablo adlarına firma/dönem numarası gömülmez, SUBE_KODU ve ISLETME_KODU kolonlarıyla ayrım yapılır. Bu fark, sorgu tasarımınızı doğrudan etkiler.

NetOpenX REST, IIS gerektirmeden Windows servisi olarak çalışır ve Swagger UI ile gelir — entegrasyon geliştirmeyi hızlandırır. Ancak doğrudan SQL sorgusu yazmak yerine NetOpenX kullanmanız, iş mantığını korur ve veri tutarlılığını sağlar.

Data Inspector ile tablo şemasını görselleştirmek, lisans/modül durumunu teyit etmek, okuma ve yazma işlemlerini ayırmak — bunlar entegrasyon projesinin sağlam temeller üzerine kurulmasını sağlar.

D'Cloud Software olarak 3 kıtada hizmet veren, Mersin merkezli bir Türk dijital ajansız. Netsis, Logo, Mikro gibi ERP sistemleriyle entegrasyonlarda 15 yıllık deneyimimiz var. Sözleşmede yazılı sabit fiyat, 15 gün ücretsiz hata düzeltme garantisi ve teknik destek ile yanınızdayız.

Netsis entegrasyonunuz için ücretsiz keşif görüşmesi almak, mevcut altyapınızı analiz etmek ve somut çözüm önerisi duymak isterseniz bizimle iletişime geçin. WhatsApp hattımız veya web sitemizdeki iletişim formu üzerinden randevu alabilirsiniz. Projenizi birlikte değerlendirelim.

Yazar: Doğuhan Bulut
Kategori: Entegrasyonlar & GİB
Tarih: 2025