Netsis REST API: nasıl çalışır, ne zaman NetOpenX yerine tercih edilir?

Netsis REST API nedir?

Netsis REST API, Logo Netsis’in sipariş, stok, cari ve fatura işlemlerini HTTP üzerinden JSON ile açan servis katmanıdır. Uygulamanız önce bir oturum jetonu alır, sonra her isteği bu jetonla gönderir. Kayıtlar Netsis’in kendi iş kuralları çalıştırılarak oluşur; yani veritabanına doğrudan yazmanın aksine stok, maliyet ve muhasebe zinciri eksiksiz işler.

Kimlik doğrulama akışı

Netsis tarafındaki servis, klasik jeton akışını izler. Bizim kurduğumuz ara katman servisin görevi bu jetonu yönetmek ve dış uygulamaları Netsis’ten yalıtmaktır:

1. Oturum aç: Netsis kullanıcı adı, şifre ve şirket/dönem bilgisiyle jeton istenir.
2. Jetonu sakla: Jeton yalnızca uygulama sunucusunda tutulur; tarayıcıya veya el terminaline hiçbir zaman inmez.
3. İstekleri imzala: Sonraki her çağrı Authorization: Bearer <jeton> başlığıyla gönderilir.
4. Süre dolunca yenile: Jetonun ömrü dolduğunda ara katman sessizce yeniler; çağrıyı yapan uygulama bunu görmez.

Not: Uç nokta adları ve alan setleri Netsis sürümüne ve yüklü servis paketine göre değişir. Aşağıdaki örnek, kurduğumuz ara katman servisinin dış uygulamalara sunduğu sözleşmedir; Netsis tarafındaki tam uç nokta listesi için kurulumunuzun kendi servis dokümanı esas alınır.

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

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

{
  "cariKod": "120.01.0042",
  "belgeNo": "WEB-2026-000118",
  "tarih": "2026-08-24",
  "depoKodu": "01",
  "satirlar": [
    { "stokKodu": "MTL-4512", "miktar": 240, "birim": "AD", "birimFiyat": 18.75 },
    { "stokKodu": "MTL-4519", "miktar":  60, "birim": "AD", "birimFiyat": 42.10 }
  ]
}

Ara katman bu isteği aldığında sırayla şunları yapar: cari risk limitini ve açık bakiyeyi okur, stok kodlarını ve depo koduna göre kullanılabilir miktarı doğrular, fiyatı cari iskonto kurallarına göre yeniden hesaplar ve ancak bundan sonra Netsis’e kaydı yazar. Dönen cevap, Netsis’in ürettiği belge numarasını taşır:

{
  "durum": "kaydedildi",
  "netsisBelgeNo": "SIP2026000004417",
  "uyarilar": [
    { "stokKodu": "MTL-4519", "mesaj": "Talep 60, serbest stok 45. Kalan 15 adet termine bağlandı." }
  ]
}

Kritik nokta cevabın uyarilar kısmıdır: sipariş reddedilmez ama eksik stok sessizce yutulmaz da. Portaldaki bayi ekranında bu uyarı doğrudan gösterilir, böylece “sipariş geçti ama gelmedi” telefonu hiç doğmaz.

Hata durumunda ne olur?

Netsis tarafı bir kaydı reddettiğinde ara katman hatayı olduğu gibi geri döner ve isteği yeniden denenebilir biçimde kuyruğa alır. Aynı belgeNo ile gelen ikinci istek yeni sipariş açmaz, mevcut kaydın durumunu döner — ağ koptuğunda çift sipariş oluşmasını engelleyen tek koruma budur.

Endüstriyel Üretimde Netsis’in Rolü ve Özel Yazılım İhtiyacı

Metal, plastik, gıda ve kimya sektöründeki birçok üretim tesisi, operasyonunun kalbinde Logo Netsis 3 Standard veya Enterprise çalıştırır.

Netsis’in güçlü maliyetlendirme ve resmi muhasebe yeteneklerine rağmen, modern üretim tesislerinde şu ihtiyaçlar doğmaktadır:

• Fabrika İçi Dokunmatik Kiosk Ekranları: Ağır eldivenle çalışan operatörlerin Netsis’in küçük butonlu masaüstü ekranlarını kullanamaması.
• Dinamik Üretim Planlama & Gantt Şemaları: Sipariş terminlerine ve makine doluluklarına göre sürükle-bırak çizelgeleme.
• Saha Montaj & Servis Takibi: Fabrika dışındaki montaj ekiplerinin Netsis’e doğrudan erişiminin güvenlik ve lisans nedeniyle kısıtlı olması.

Netsis Entegrasyon Teknolojileri: NetOpenX vs. REST API vs. Veritabanı

En Sık Kurulan Netsis Özel Entegrasyon Senaryoları

Netsis Entegrasyonunda Dikkat Edilmesi Gereken Kritik Noktalar

---

NDI (Netsis Dinamik Kodlama) ve Güvenli Olay Tetikleyicileri

Netsis’in kendine has en güçlü özelliklerinden biri NDI (Netsis Dinamik Kodlama) altyapısıdır. Harici bir sistemden Netsis’e veri aktarılırken yalnızca statik kayıtlar oluşturulmaz; şirketin fabrika içi özel kuralları da işletilebilir:

• Dinamik Fiyat ve İskonto Kontrolü: İrsaliye kaydedilmeden önce NDI betiği çalışarak müşterinin son 30 günlük alım ortalamasını kontrol eder ve izin verilenden yüksek iskonto varsa işlemi bloke eder.
• Tezgâh Kapasite Kilidi: Üretim iş emri NetOpenX üzerinden oluşturulurken, hedeflenen tezgâhın o günkü planlı bakımda olup olmadığı NDI doğrulamasıyla teyit edilir.
• Çift Yönlü Webhook Tetikleme: Netsis’te bir faturanın durumu muhasebe tarafından “Onaylandı” yapıldığında, SQL trigger yerine güvenli bir servis tetikleyicisi dış sisteme (CRM veya B2B portalına) anlık webhook fırlatır.

---

1. Seri / Lot ve Depo Kodu Eşleşmeleri: Üretimden depoya veya sevkiyata aktarılan her kalemin Netsis’teki seri/lot parametreleriyle birebir örtüşmesi gerekir.
2. Kullanıcı Lisansı Optimizasyonu: Sahadaki 50 işçinin her biri için ayrı Netsis lisansı almak yerine, tek bir API köprüsü üzerinden yüzlerce terminal güvenle konuşturulabilir.
3. Audit Trail (Değişiklik Kaydı): Netsis’e yazılan her kaydın hangi dış kullanıcı ve cihaz tarafından tetiklendiği özel veritabanında saklanmalıdır.

Başka bir program kullanıyorsanız aynı köprü mantığını Logo, Mikro, DİA Web Servis API, SAP Business One Service Layer, Nebim V3 Entegratör ve Paraşüt API yazılarında o programın gerçekleriyle anlattık.

Netsis Altyapınızı KodDelta ile Güçlendirin

Netsis ERP yatırımınızı korurken sahadaki veri girişini kaynağına taşımak için Entegrasyon Merkezimizi inceleyebilir veya Hemen Teklif İsteyebilirsiniz.

Sıkça sorulan sorular

Netsis REST API nedir?

Netsis REST API, Logo Netsis'in sipariş, stok, cari ve fatura işlemlerini HTTP üzerinden JSON ile açan servis katmanıdır. Kayıtlar Netsis'in kendi iş kuralları çalıştırılarak oluşturulduğu için, arayüzden elle girilmiş bir kayıtla aynı denetim ve muhasebe davranışına sahiptir.

Netsis REST API'de kimlik doğrulama nasıl yapılır?

Jeton (token) tabanlıdır: uygulama önce Netsis kullanıcı adı, şifre ve şirket/dönem bilgisiyle bir oturum açar, dönen jetonu saklar ve sonraki her isteği bu jetonla gönderir. Jetonun süresi dolduğunda yenilenir. Jeton uygulama sunucusunda tutulur; tarayıcıya veya mobil cihaza asla inmez.

Netsis REST API mi NetOpenX mi kullanmalıyım?

Web portalı, mobil uygulama ve dış sistem entegrasyonlarında REST API daha pratiktir; HTTP konuşan her platformdan çağrılabilir. Buna karşılık REST servislerinin kapsamadığı bir Netsis ekranı veya alan varsa NetOpenX nesne katmanı gerekir. Uygulamada çoğu proje ikisini birlikte kullanır: gövde REST, kalan uçlar NetOpenX.

Netsis veritabanına doğrudan yazmak neden sakıncalıdır?

Netsis bir kaydı oluştururken stok hareketi, maliyet, cari bakiye ve muhasebe fişi gibi bağlı kayıtları da üretir. Tabloya doğrudan INSERT yapıldığında bu zincir çalışmaz ve tablolar sessizce tutarsızlaşır. Doğrudan SQL yalnızca okuma (rapor, Power BI, kokpit) için kullanılır.

Netsis REST API'nin uç nokta listesini nereden bulurum?

Uç nokta adları ve alan setleri Netsis sürümüne ve yüklü servis paketine göre değişir; tek doğru kaynak kurulumunuzdaki servis dokümanıdır. Bu yüzden entegrasyon projesine başlarken ilk iş, hedef sürümün servis listesini çıkarıp kapsanmayan uçları NetOpenX'e ayırmaktır.

Netsis entegrasyon projesi ne kadar sürede tamamlanır?

Tek yönlü sipariş veya stok aktarımı 2-3 haftada, çift yönlü kapsamlı üretim ve depo sevkiyat entegrasyonu 2-4 haftada devreye alını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?
• Nebim V3 Entegratör REST API: perakende ERP'nizi dış sistemlere nasıl bağlarsınız?

Hizmet sayfası: Entegrasyon hizmeti