Logo ve Netsis entegrasyon rehberi: REST API, Objects ve özel web/mobil arayüz köprüsü

Türkiye’deki imalat ve toptan dağıtım şirketlerinin en büyük bilişim yatırımı genellikle Logo (Tiger, Go 3) veya Netsis ERP sistemleridir. Bu sistemler şirketin resmî muhasebesini, genel mizanını, cari hesaplarını ve vergi beyannamelerini mükemmel yönetir.

Ancak sahaya veya tozlu fabrika koridorlarına inildiğinde büyük bir duvarla karşılaşılır:

• Fabrikadaki pres veya kaynak operatörünün önüne karmaşık Logo masaüstü ekranını koyamazsınız; 50 ayrı kutucuk içeren pencereler veri girişini durdurur.
• Sahadaki teknik servis elemanına müşteri kapısında laptop açtırıp Netsis ekranından irsaliye kestiremezsiniz.
• Şirketin 60 personeline tek tek masaüstü ERP kullanıcı lisansı satın almak yüzbinlerce liralık ek lisans ve yıllık LEM faturası demektir.

Bu rehber; mevcut Logo veya Netsis sisteminizi çöpe atmadan, üzerine modern web ve mobil arayüzler inşa ederek çift yönlü entegrasyonu nasıl kuracağınızı teknik ve operasyonel detaylarıyla açıklar.

---

1. Ölümcül Hata: Doğrudan SQL Veritabanına Yazmak (Direct DB Write)

Yazılım yaptırmak isteyen şirketlerin veya tecrübesiz yazılımcıların düştüğü en tehlikeli tuzak şudur:
“ERP’nin arkasında zaten MS SQL Server çalışıyor; basit bir form yapalım, kaydet deyince doğrudan SQL’deki LG_XXX_INVOICE veya TBLFATUIRS tablosuna INSERT atsın.”

Bu yaklaşım neden bir şirket felaketidir?

1. İş Kurallarının Atlanması: Logo veya Netsis arayüzünden bir fatura kestiğinizde arka planda sadece tek bir tabloya kayıt atılmaz. Cari bakiye güncellenir, ortalama vade hesaplanır, stok fişi üretilir, KDV ayrıştırılır ve muhasebe fişi bağlanır. SQL’e doğrudan yazdığınızda bu iş mantığı çalışmaz; envanterinizle resmi faturanız birbirini tutmaz.
2. Kilitlenmeler (Deadlock): Muhasebe personeli ay sonu mizanı alırken dışarıdan doğrudan SQL tablolarına müdahale etmek veritabanı kilitlenmelerine ve sistemin kilitlenmesine yol açar.
3. Resmî Destek ve Garantinin Bitmesi: Üretici firma (Logo Yazılım) veritabanına doğrudan müdahale edildiğini tespit ettiğinde veritabanı garanti desteğini anında keser.

---

2. Doğru Mimari: Resmî API Katmanları ve Staging Mimarisi

Güvenli ve sürdürülebilir bir entegrasyon, ERP’nin kendi sunduğu resmî iş mantığı katmanları (business layer) ve güvenli bir ara kuyruk mimarisi üzerinden çalışmalıdır:

[ Mobil Cihaz / PWA / Tablet ]
              │ (HTTPS / JSON)
              ▼
[ KodDelta Entegrasyon Köprüsü ]
              │
              ├──► [ Staging / Kuyruk Tablosu (Redis / PostgreSQL) ]
              │             │ (Asenkron İşleme & Hata Denetimi)
              │             ▼
              ├──► [ Logo REST / Objects ] ──► [ Logo Tiger / Go ]
              └──► [ Netsis NetOpenX ]     ──► [ Netsis Enterprise ]

Logo Entegrasyonu: Logo Objects ve REST Servisi

• Logo Objects: Logo’nun masaüstünde yaptığı tüm kontrolleri (stok yetersizse uyarma, risk limiti aşıldıysa siparişi onaya gönderme vb.) çalıştıran resmî COM kütüphanesidir.
• Logo REST Service: Modern web uygulamalarının JSON formatında sipariş, irsaliye, fatura ve cari kart gönderebilmesini sağlayan servis katmanıdır.

Netsis Entegrasyonu: NetOpenX ve REST API

• NetOpenX: Netsis çekirdek motorudur. Dış yazılımlar NetOpenX DLL’leri veya REST API uç noktaları üzerinden Netsis’e irsaliye, ambar fişi veya üretim iş emri oluşturur.

---

3. Kuyruk ve Hata Yönetimi (Staging & Exponential Backoff)

ERP sunucuları bazen yoğun yedekleme veya mizan çalıştırma sırasında yavaşlayabilir. Eğer mobil cihazdan gönderilen servis formu ERP’ye anlık bağlanamazsa veri asla kaybolmamalıdır:

1. Staging Havuzu: Mobil cihazdan gelen sipariş veya servis fişi önce güvenli bir ara havuza (pending_sync) kaydedilir.
2. Üstel Geri Çekilme (Exponential Backoff): ERP servisi o anda meşgulse sistem 5 saniye, 15 saniye ve 1 dakika aralıklarla kaydı tekrar dener.
3. İki Aşamalı Mutabakat: Logo veya Netsis’ten başarılı işlem referans numarası (Örn: INVOICE_LOGICALREF: 89412) dönene kadar işlem açık kalır.

---

4. Somut Saha Senaryoları

Senaryo A: Saha Servis ve Bakım Mobil Uygulaması

• Sorun: 15 saha teknisyeni müşteride asansör/makine bakımı yapıyor; servis formlarını kâğıda yazıyor. Akşam ofisteki sekreter bunları tek tek Netsis’e servis fişi olarak giriyor. 3 gün gecikme ve kayıp faturalar yaşanıyor.
• Çözüm: Teknisyenlerin cep telefonuna özel mobil PWA ekranı kurulur. Teknisyen QR kodu okutur, harcanan parçayı seçer ve müşteriye ekrandan imza attırır.
• Sonuç: Servis bittiği anda arka plandaki entegrasyon köprüsü Netsis’e anında irsaliye ve servis faturası kaydeder. Sıfır kâğıt, sıfır gecikme.

Senaryo B: Fabrika İçi Tabletle Barkodlu Depo Sevkiyatı

• Sorun: Depocu Logo ekranlarını kullanamıyor; hangi raftan hangi lotu alacağını kâğıt listeden takip ediyor. Yanlış parti veya SKT’si geçmiş ürün sevk ediliyor.
• Çözüm: El terminaline veya tablete büyük butonlu özel depo arayüzü verilir. Depocu sadece barkod okutur.
• Sonuç: Logo’daki satış siparişi ile eşleşme sağlanır; doğru ürün okutulunca irsaliye Logo’da otomatik oluşur.

Senaryo C: B2B Bayi Sipariş Portalı

• Sorun: Bayiler telefonla veya WhatsApp’la sipariş veriyor; plasiyerler siparişleri Logo Go’ya elle girerken fiyat veya iskonto hataları yapıyor.
• Çözüm: Bayilere özel B2B web portalı açılır. Bayi sadece kendi cari risk limitini, açık faturalarını ve kendine özel iskonto oranını görür.
• Sonuç: Bayi siparişi onayladığı an Logo’ya onaylı satış siparişi olarak düşer.

---

5. Lisans Maliyeti Optimizasyonu: Yüzbinlerce Liralık Tasarruf

Orta ölçekli bir imalat veya saha şirketinde:

• 40 teknisyen veya operatör için ek masaüstü ERP lisansı almak: Yaklaşık 40 × 30.000 ₺ = 1.200.000 ₺ başlangıç maliyeti ve yıllık %15 LEM bedeli (180.000 ₺/yıl) gerektirir.
• Özel Entegrasyon Modeliyle: Sadece tek bir Logo Objects / NetOpenX lisansı veya servis kullanıcısı kullanılır. Sahadaki 40 kişi özel mobil arayüz üzerinden ücretsiz ve sınırsız çalışır. Şirket tek bir projede 1 milyon liranın üzerinde lisans tasarrufu sağlar.

Şirketinizde kullanılan Logo Tiger, Go 3 veya Netsis sisteminin sürümünü inceleyelim; hangi süreçlerin güvenli bir REST köprüsüyle web ve mobile açılabileceğini 30 dakikalık ücretsiz mimari keşif görüşmesinde planlayalım.

Sıkça sorulan sorular

Logo veya Netsis SQL veritabanına doğrudan veri yazmak neden tehlikelidir?

Logo ve Netsis veritabanlarında tek bir fatura veya irsaliye kaydedildiğinde arka planda onlarca tablo, muhasebe fişi, stok ekstresi ve vergi tablosu tetiklenir (trigger & business logic). Doğrudan SQL ile tabloya yazmak mali kayıtların bozulmasına, envanterin tutmamasına ve resmî denetimlerde ceza yenmesine yol açar.

Logo Objects nedir, REST API ile farkı nedir?

Logo Objects, Logo'nun tüm iş kurallarını (fatura kontrolleri, cari bakiye kısıtlamaları, stok hareketleri) işleten resmî COM nesnesidir. REST Service ise bu iş kurallarını modern web ve mobil uygulamaların HTTP JSON istekleriyle konuşabilmesini sağlayan servis katmanıdır.

Netsis NetOpenX nedir?

NetOpenX, Netsis ERP'nin iş kurallarını dış dünyaya açan uygulama programlama arayüzüdür (API). Dışarıdan sipariş, irsaliye, fatura veya cari kart açılırken tüm kural ve kontroller NetOpenX üzerinden güvenle işletilir.

Tüm fabrika çalışanlarına Logo veya Netsis lisansı almak zorunda mıyız?

HAYIR. Depo görevlisine, makine operatörüne veya sahadaki montajcıya pahalı masaüstü ERP lisansı almak yerine; KodDelta'nın geliştirdiği özel mobil PWA arayüzü kurulur. Personel sahada sade ekranları kullanır; veriler arka planda tek bir servis kullanıcısı üzerinden Logo/Netsis'e otomatik aktarılır.

Entegrasyon projesi ortalama ne kadar sürer?

Odaklı bir entegrasyon köprüsü (örneğin e-ticaret siparişlerini Logo'ya aktarma veya sahadan Netsis'e servis fişi yazma) ortalama 2 ile 4 hafta içinde canlıya alınır.

İlgili rehberler

• 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?
• Paraşüt API: kendi yazılımınızdan fatura kesmek ve e-faturayı tetiklemek

Hizmet sayfası: Entegrasyon hizmeti