Netsis API ve ERP Entegrasyonu: REST API, Web Servis ve Veritabanı Rehberi

Netsis ERP, Logo Yazılım bünyesinde Türkiye'nin en köklü ve en yaygın kullanılan kurumsal kaynak planlama sistemlerinden biridir. Özellikle orta ve büyük ölçekli işletmelerde tercih edilen Netsis, güçlü finansal yönetim, üretim planlama ve ticaret modülleriyle öne çıkar. Ancak modern iş dünyasının gereksinimleri, Netsis'in tek başına karşılayamayacağı alanlara kadar genişlemiştir. Bu noktada Netsis ERP entegrasyonu, işletmelerin dijital altyapısını bütünleştirmek ve operasyonel mükemmelliğe ulaşmak için kritik bir adımdır.

Netsis entegrasyonu, depo yönetim sistemleri, e-ticaret platformları, iş zekası araçları, CRM yazılımları ve sektörel uygulamalar gibi farklı sistemlerin Netsis ile sorunsuz ve güvenilir şekilde veri alışverişi yapmasını sağlar. Bu rehberde Netsis ERP entegrasyonunun teknik yöntemlerini, uygulama adımlarını ve en iyi pratiklerini detaylı şekilde ele alacağız.

Kısa cevap

Netsis API nedir? Logo Netsis ERP'nin dış sistemlerle konuşmasını sağlayan arayüzdür: klasik NetOpenX kütüphanesi ve yeni nesil REST (JSON) servis katmanı. Stok kartı, cari, sipariş, irsaliye ve fatura kayıtları bu API ile okunur ve oluşturulur; her kayıt Netsis'in kendi iş kurallarından geçtiği için veritabanına doğrudan yazmaya göre çok daha güvenlidir. Aşağıda kimlik doğrulama akışı, ürün/sipariş entegrasyonu ve yöntem seçimini adım adım anlatıyoruz.

Netsis ERP'nin Teknik Altyapısı

Netsis ERP, istemci-sunucu mimarisi üzerine inşa edilmiştir ve Microsoft SQL Server veritabanı kullanır. Bu teknik altyapı, farklı entegrasyon yaklaşımları için çeşitli imkanlar sunar. Netsis'in veritabanı yapısı, ana tablolar (master data) ve hareket tabloları (transaction data) olmak üzere iki ana kategoride organize edilmiştir.

Netsis'in Enterprise sürümü, daha gelişmiş entegrasyon altyapısı sunar. Web servisleri, API desteği ve esnek veri yapıları sayesinde dış sistemlerle entegrasyon daha kolay ve güvenilir şekilde gerçekleştirilebilir. Standard sürümde ise entegrasyon seçenekleri daha sınırlıdır ve genellikle veritabanı düzeyinde entegrasyon tercih edilir.

Netsis Veritabanı Yapısı

Netsis veritabanında temel tablolar arasında TBLSTSABIT (stok kartları), TBLCASTABIT (cari hesap kartları), TBLSTHAREKET (stok hareketleri), TBLCAHAREKET (cari hesap hareketleri), TBLSIPARIS (siparişler) ve TBLIHRACAT/TBLITHALAT (dış ticaret) yer alır. Her tablo kendi içinde karmaşık ilişkiler ve iş kuralları barındırır.

Netsis'te özellikle dikkat edilmesi gereken nokta, birçok tablonun firma kodu bazlı çoklu firma desteği sunmasıdır. Entegrasyon sorgularında firma kodu filtresinin doğru uygulanması, veri tutarlılığı açısından kritik önem taşır.

Netsis Entegrasyon Yöntemleri

1. Netsis Web Servis Entegrasyonu

Netsis Enterprise sürümü, SOAP tabanlı web servisleri üzerinden entegrasyon imkanı sunar. Bu web servisleri aracılığıyla stok kartı oluşturma, cari hesap yönetimi, sipariş girişi, fatura kesme ve stok hareketi kaydetme gibi temel işlemler programatik olarak gerçekleştirilebilir.

Web servis entegrasyonunun en büyük avantajı, Netsis'in kendi iş kurallarının web servis katmanında uygulanmasıdır. Bir fatura web servis üzerinden oluşturulduğunda, KDV hesaplaması, muhasebe fişi oluşturma, stok düşümü ve cari hesap hareketi gibi tüm bağlantılı işlemler Netsis tarafından otomatik olarak gerçekleştirilir. Bu durum, veritabanı düzeyinde entegrasyonun getirdiği tutarlılık risklerini ortadan kaldırır.

Netsis web servislerinin sınırlamaları da mevcuttur. Bazı gelişmiş senaryolar web servisleri üzerinden desteklenmeyebilir, performans yoğun işlemlerde web servis yanıt süreleri uzayabilir ve sürüm güncellemelerinde web servis şemalarında değişiklikler olabilir.

2. Netsis Veritabanı Entegrasyonu

Netsis veritabanına doğrudan SQL Server bağlantısı üzerinden erişim, en esnek entegrasyon yöntemidir. Her türlü veriye erişim imkanı sağlar ve özellikle raporlama, veri okuma ve analiz senaryolarında tercih edilir. SmartRapor gibi iş zekası araçları, genellikle bu yöntemi kullanarak Netsis verilerini çeker ve anlamlı raporlara dönüştürür.

Veritabanı düzeyinde yazma işlemleri ise çok daha dikkatli ele alınmalıdır. Netsis'in iş kuralları, tetikleyicileri ve stored procedure'leri son derece karmaşıktır. Doğrudan INSERT veya UPDATE işlemleri, Netsis'in iç tutarlılığını bozabilir. Bu nedenle yazma işlemleri için Netsis'in kendi mekanizmalarının kullanılması veya Netsis'e özgü stored procedure'lerin geliştirilmesi tercih edilmelidir.

3. Netsis REST API Entegrasyonu

Netsis'in yeni nesil sürümleri, klasik NetOpenX entegrasyon kütüphanesinin üzerine REST tabanlı, JSON formatında çalışan bir servis katmanı sunar. Logo'nun kendi e-ticaret ve pazaryeri bağlayıcıları da bu katmanı kullanır. Web servis yaklaşımının "iş kuralları Netsis tarafında uygulanır" güvencesini korurken, modern web ve mobil uygulamalarla çok daha kolay konuşur; platform bağımsızdır ve Windows/COM bağımlılığı gerektirmez.

Netsis REST API ile Entegrasyon Nasıl Yapılır?

Sürümden sürüme uç nokta adları değişebilse de akış hep aynıdır. Aşağıdaki adımlar, Netsis API ile yapılan tipik bir entegrasyonun iskeletidir:

Kimlik doğrulama: Netsis kullanıcı adı, şifre, şirket (veritabanı adı), şube ve mali dönem bilgisiyle oturum açılır; servis bir erişim token'ı döner. Token'ın süresi dolduğunda yenilenir.
Master veriyi okuma: Stok kartları, cari hesaplar, fiyat listeleri, depo tanımları ve KDV oranları GET istekleriyle çekilir. Büyük veri setlerinde sayfalama (paging) ve "son değişiklik tarihi" filtresi kullanılarak yalnızca değişen kayıtlar alınır.
Kayıt oluşturma: Sipariş, irsaliye veya fatura JSON gövdesiyle POST edilir. Netsis, kaydı kendi kurallarıyla işler: KDV hesaplar, stok hareketini oluşturur, cari bakiyeyi günceller, gerekiyorsa muhasebe fişini keser.
Yanıtı işleme: Servis, oluşan belge numarasını ve varsa hata mesajını döner. Belge numarası dış sistemde saklanır; böylece aynı sipariş ikinci kez gönderilmez (idempotency).
Geri senkronizasyon: Her hareket sonrası depo miktarları ve cari bakiye tekrar okunarak dış sistem güncellenir.

Örnek olarak bir satış siparişi gönderimi, sadeleştirilmiş haliyle şu yapıdadır (alan adları sürüme göre farklılık gösterebilir):

POST /api/v2/Siparis
Authorization: Bearer <token>
Content-Type: application/json

{
  "CariKod": "120.01.0042",
  "Tarih": "2026-09-01",
  "Depo": 1,
  "Kalemler": [
    { "StokKod": "STK-10021", "Miktar": 12, "Fiyat": 245.00, "KdvOrani": 20 },
    { "StokKod": "STK-10485", "Miktar": 3,  "Fiyat": 1890.00, "KdvOrani": 20 }
  ]
}

Netsis Ürün ve Sipariş Entegrasyonu (E-Ticaret ve Pazaryeri)

Netsis API'nin en yaygın kullanım alanı, e-ticaret sitesi veya pazaryeri ile ürün ve sipariş entegrasyonudur. Ürün tarafında Netsis'teki stok kartları, fiyat listeleri ve depo bazlı miktarlar belirli aralıklarla (genellikle 5–15 dakikada bir) okunup dış platforma aktarılır; böylece sitede stokta olmayan ürün satılmaz. Sipariş tarafında ise platformda oluşan sipariş, müşteri bilgisi Netsis'teki cari hesapla eşleştirildikten (yoksa otomatik açıldıktan) sonra satış siparişi olarak Netsis'e yazılır. Sevkiyat tamamlanınca irsaliye ve e-fatura/e-arşiv yine API üzerinden kesilir, kargo takip numarası platforma geri yazılır.

Bu senaryoda en sık karşılaşılan üç sorun şunlardır: birden fazla kanaldan gelen aynı ürünün farklı barkod/SKU ile tanımlanması, kampanya ve fiyat listesi uyuşmazlıkları ve iptal/iade akışının Netsis'e geri yansıtılmaması. Entegrasyon tasarımında bu üç akış en baştan planlanmalıdır; detaylar için e-ticaret depo yönetimi yazımıza bakabilirsiniz.

Hangi Yöntem Ne Zaman Seçilmeli?

Kayıt oluşturma (sipariş, irsaliye, fatura): REST API veya web servis. Netsis iş kuralları uygulanır, tutarlılık korunur.
Yalnızca okuma ve raporlama: Doğrudan SQL Server erişimi. Daha hızlı ve esnektir; SmartRapor gibi iş zekası araçları bu yolu kullanır.
Yüksek hacimli toplu aktarım (ilk yükleme, migrasyon): NetOpenX veya Netsis'in kendi içe aktarma araçları; API'yi tek tek kayıtla yormak yerine.
Veritabanına doğrudan yazma: Yalnızca Netsis'i çok iyi bilen bir ekiple ve stored procedure üzerinden; aksi halde kaçınılmalıdır.

Netsis ile Depo Yönetimi Entegrasyonu

Netsis ERP'nin en sık entegrasyon ihtiyacı duyulan alanı depo yönetimidir. Netsis'in standart stok modülü temel stok takibi ve envanter yönetimi yapabilse de, gelişmiş depo yönetim sistemi (WMS) fonksiyonları sunmaz. Barkodlu işlemler, el terminali desteği, dalga planlama, putaway optimizasyonu ve gerçek zamanlı depo görünürlüğü için harici bir WMS gerekir.

UBS Bilişim'in ExtraDepo çözümü, Netsis ERP ile tam entegre çalışan bir depo yönetim sistemidir. Bu entegrasyonda kritik veri akışları şunlardır:

Master data senkronizasyonu: Netsis'teki stok kartları, cari hesaplar, birim tanımları ve depo tanımları ExtraDepo ile senkronize edilir. Netsis'te yeni bir stok kartı açıldığında, bu kart otomatik olarak ExtraDepo'ya aktarılır.
Satınalma ve mal kabul: Netsis'teki satınalma siparişleri ExtraDepo'ya iletilir. Mal kabul sırasında barkod ve el terminali ile kontrol yapılır. Onaylanan mal kabul, Netsis'te stok girişi ve satınalma irsaliyesi oluşturur.
Satış ve sevkiyat: Netsis'teki satış siparişleri ExtraDepo'ya aktarılır. Toplama, paketleme ve sevkiyat süreçleri ExtraDepo'da yönetilir. Sevkiyat tamamlandığında Netsis'te irsaliye ve fatura otomatik kesilir.
Stok hareketleri: Depolar arası transfer, fire, sarf ve düzeltme gibi tüm stok hareketleri çift yönlü olarak senkronize edilir.
Stok sayım: ExtraDepo ile yapılan sayım sonuçları Netsis'teki stok kayıtlarıyla karşılaştırılır ve onay sonrası düzeltme fişleri oluşturulur.

Netsis ERP ile ExtraDepo entegrasyonu, 200'den fazla işletmede başarıyla uygulanmıştır. Entegrasyon sonrasında müşterilerimizin stok doğruluğu ortalama %97'ye yükselmiş, sipariş işleme süresi %65 kısalmış ve hatalı sevkiyat oranı %0.5'in altına düşmüştür.

Netsis ile E-Ticaret Entegrasyonu

E-ticaret kanallarının hızla büyümesi, Netsis ERP ile e-ticaret platformları arasında güçlü bir entegrasyon ihtiyacı doğurmuştur. Trendyol, Hepsiburada, Amazon, N11 gibi pazar yerlerinden ve kendi web sitesinden gelen siparişlerin Netsis'e aktarılması, stok senkronizasyonu, fiyat güncelleme ve kargo entegrasyonu bu kapsamın temel bileşenleridir.

E-ticaret entegrasyonunda gerçek zamanlı stok senkronizasyonu kritik öneme sahiptir. Birden fazla satış kanalında aynı stok havuzu paylaşıldığında, herhangi bir kanalda yapılan satışın diğer kanallardaki stok bilgisine anında yansıması gerekir. Gecikme, aşırı satış (overselling) riskine yol açar. Netsis'ten ExtraDepo'ya, ExtraDepo'dan e-ticaret platformlarına kesintisiz stok bilgisi akışı sağlanmalıdır.

Çok Kanallı Sipariş Yönetimi

Birden fazla satış kanalından gelen siparişlerin merkezi olarak yönetilmesi, Netsis entegrasyonunun en karmaşık senaryolarından biridir. Her satış kanalının farklı sipariş formatı, farklı ürün kodu yapısı ve farklı kargo gereksinimleri vardır. Entegrasyon katmanının tüm bu farklılıkları yönetmesi ve Netsis'te tutarlı bir sipariş yapısı oluşturması gerekir.

Netsis ile Raporlama ve İş Zekası Entegrasyonu

Netsis ERP'de biriken veri, doğru analiz edildiğinde işletme için paha biçilmez içgörüler sunar. Ancak Netsis'in standart raporlama modülü, gelişmiş analitik ihtiyaçları karşılamakta yetersiz kalabilir. İnteraktif dashboardlar, trend analizleri, tahminleme modelleri ve otomatik rapor dağıtımı için harici bir iş zekası platformuna ihtiyaç vardır.

UBS Bilişim'in SmartRapor çözümü, Netsis veritabanına doğrudan bağlanarak gerçek zamanlı iş zekası raporları sunar. Satış performansı, stok devir hızı, cari hesap yaşlandırma, karlılık analizi, depo KPI'ları ve tedarikçi performansı gibi kritik metrikler otomatik olarak hesaplanır ve görselleştirilir.

Netsis Çoklu Firma Entegrasyonu

Türkiye'deki birçok işletme grubu, farklı tüzel kişilikler altında birden fazla Netsis firması kullanmaktadır. Bu firmalar arasında fatura transferi, sipariş aktarımı ve stok senkronizasyonu gibi süreçler genellikle manuel olarak yürütülür ve ciddi zaman kaybına neden olur.

UBS Bilişim'in Kopylon çözümü, birden fazla Netsis firması arasında otomatik veri senkronizasyonu sağlar. Bir firmada kesilen satış faturası, diğer firmada otomatik olarak alış faturasına dönüştürülür. Depolar arası transfer belgeleri eşzamanlı oluşturulur. Cari hesap mutabakatı otomatik yapılır.

Netsis Entegrasyonunda Sık Karşılaşılan Sorunlar

Performans ve Ölçeklenebilirlik

Netsis veritabanı üzerinde yoğun entegrasyon sorguları çalıştırmak, ERP kullanıcılarının performansını olumsuz etkileyebilir. Bu sorunu çözmek için sorgu optimizasyonu, indeksleme stratejileri, read replica kullanımı ve entegrasyon sorgularının mesai saatleri dışına planlanması gibi yöntemler uygulanmalıdır.

Veri Tutarlılığı ve Hata Yönetimi

Netsis entegrasyonunda veri tutarlılığı en kritik konulardan biridir. Ağ kesintileri, veritabanı kilitleri, eşzamanlı işlemler ve sürüm farklılıkları veri tutarsızlığına neden olabilir. Bu sorunları yönetmek için transaction yönetimi, idempotent tasarım, otomatik yeniden deneme mekanizmaları ve günlük mutabakat raporları kullanılmalıdır.

Sürüm Geçişleri

Netsis sürüm güncellemeleri, veritabanı şemasında ve web servis yapısında değişikliklere yol açabilir. Her sürüm geçişinden önce entegrasyon testlerinin yenilenmesi ve gerekli adaptasyonların yapılması gerekir. Ara katman mimarisi, bu tür değişikliklerin dış sistemlere etkisini minimize eder.

Netsis Entegrasyonunda En İyi Uygulamalar

Kapsamlı analiz yapın: Entegrasyondan önce mevcut süreçleri, veri akışlarını ve ihtiyaçları detaylı şekilde analiz edin. Kapsam belirsizliği, proje başarısızlığının en büyük nedenidir.
Test ortamı oluşturun: Üretim ortamında doğrudan geliştirme yapmayın. Netsis'in test lisansıyla ayrı bir ortam kurun.
Aşamalı devreye alın: Tüm entegrasyonu tek seferde canlıya almak yerine, modül modül devreye alın. Önce okuma entegrasyonlarını, sonra yazma entegrasyonlarını aktifleştirin.
Detaylı loglama yapın: Her veri transferi işlemini, başarılı ve başarısız tüm denemeleri loglar. Sorun analizinde bu loglar hayat kurtarır.
Mutabakat mekanizmaları kurun: Günlük veya haftalık mutabakat raporlarıyla her iki sistemdeki verilerin tutarlılığını doğrulayın.
Güvenlik öncelikli tasarlayın: Minimum yetki prensibi uygulayın, bağlantıları şifreleyin ve erişim loglarını tutun.
Performans izleyin: Entegrasyon işlemlerinin süresini ve kaynak tüketimini sürekli izleyin. Performans bozulmalarını erken tespit edin.
Deneyimli partner seçin: Netsis entegrasyonu uzmanlık gerektiren bir alandır. 18 yılı aşkın ERP entegrasyon deneyimine sahip UBS Bilişim gibi uzman bir partnerle çalışın.

Netsis Entegrasyonunun İşletmeye Katkıları

Doğru planlanan ve uygulanan bir Netsis ERP entegrasyonu, işletmeye somut ve ölçülebilir katkılar sağlar. Manuel veri girişi %90 oranında azalır. Sipariş işleme süresi yarıdan fazla kısalır. Stok doğruluğu %97'nin üzerine çıkar. Gerçek zamanlı raporlama ve karar destek altyapısı kurulur. Müşteri memnuniyeti artar ve operasyonel maliyetler düşer.

Sık Sorulan Sorular

Netsis API nedir?

Netsis API, Logo Netsis ERP'nin dış uygulamalarla veri alışverişi yapmasını sağlayan programlama arayüzüdür. Klasik NetOpenX entegrasyon kütüphanesi ve yeni nesil REST (JSON) servis katmanı olmak üzere iki ana bileşeni vardır. Stok kartı, cari hesap, sipariş, irsaliye ve fatura gibi kayıtlar bu API üzerinden okunup oluşturulabilir.

Netsis REST API nasıl kullanılır?

Önce Netsis kullanıcı adı, şifre, şirket (veritabanı) ve şube bilgisiyle kimlik doğrulama yapılıp bir erişim token'ı alınır. Sonraki her istekte bu token header'da gönderilir; veriler JSON formatında GET (okuma) ve POST (kayıt oluşturma) istekleriyle alınıp gönderilir. Her kayıt Netsis'in kendi iş kurallarından (KDV, muhasebe fişi, stok hareketi) geçtiği için veritabanına doğrudan yazmaya göre çok daha güvenlidir.

Netsis ile ürün ve sipariş entegrasyonu nasıl yapılır?

Ürün tarafında Netsis'teki stok kartları, fiyat listeleri ve depo miktarları API ile periyodik olarak okunup e-ticaret sitesine veya pazaryerine aktarılır. Sipariş tarafında ise dış sistemde oluşan sipariş, cari hesap eşleştirmesi yapıldıktan sonra Netsis'e satış siparişi olarak POST edilir; sevkiyat sonrası irsaliye ve fatura yine API ile oluşturulur. Stok miktarı her hareket sonrası geri senkronize edilir.

Netsis entegrasyonu için API mi, web servis mi, veritabanı mı seçilmeli?

Kayıt oluşturma (sipariş, fatura, irsaliye) için REST API veya web servis tercih edilmelidir; çünkü Netsis'in iş kuralları uygulanır. Yalnızca okuma ve raporlama senaryolarında (iş zekası, dashboard) doğrudan SQL Server veritabanı erişimi daha hızlı ve esnektir. Veritabanına doğrudan yazmaktan kaçınılmalıdır.

Netsis Standard sürümde API kullanılabilir mi?

Entegrasyon imkanları sürüme ve lisansa göre değişir; Enterprise sürümde web servis ve API desteği en geniştir. Standard sürümde entegrasyon çoğunlukla NetOpenX veya veritabanı düzeyinde yapılır. Projeye başlamadan önce mevcut sürüm, lisans kapsamı ve Logo Yazılım'ın güncel entegrasyon dokümantasyonu kontrol edilmelidir.

Sonuç

Netsis ERP entegrasyonu, işletmelerin dijital altyapısını güçlendiren ve operasyonel mükemmelliğe giden yolda kritik bir adımdır. REST API, web servis veya veritabanı yöntemiyle gerçekleştirilebilen bu entegrasyon, doğru planlama ve deneyimli bir ekiple hayata geçirildiğinde kısa sürede yatırım getirisine ulaşır.

UBS Bilişim olarak Netsis ERP entegrasyonlarında kapsamlı deneyime sahibiz. ExtraDepo, SmartRapor ve Kopylon çözümlerimiz Netsis ile tam entegre çalışarak, ERP'nizin yapamadığını yapar. Daha fazla bilgi için ERP Entegrasyonu Neden Önemli? yazımızı okuyabilir, farklı ERP entegrasyonlarını karşılaştırmak için Mikro ERP Entegrasyon Kılavuzu ve Logo ERP Entegrasyonu rehberlerimize göz atabilirsiniz.