Mikro El Terminali ve Netsis: Barkodlu Depoda Kayıt Nasıl Geçer?

Önce hazır seçeneğe bakın: Mikro ve Netsis için terminal uygulaması var mı?

Evet, her iki taraf için de hazır seçenekler bulunuyor ve standart akışınız varsa ilk durak bunlar olmalıdır. Mikro'nun API değişiklik kayıtlarında Nitrogen Depo Yönetimi bir dikey çözüm olarak anılıyor ve raf takibi kontrollerinden söz ediliyor. App Store'daki Nitrogen tanıtımı da uygulamanın Run, Jump ve Fly ile entegre çalıştığını söylüyor. Logo'nun 7 Ocak 2026 tarihli depo yönetimi fiyat listesi ise Logo WMS'i Netsis ile entegre olarak tanımlıyor ve 9.0.34 ve üzeri sürüm bekliyor; Logo'nun ekosistem sayfasında Netsis 3 ile çalışan üçüncü taraf bir depo ürünü de listeleniyor.

Hazır uygulamanın üç avantajı vardır: uyumu ürünü sunan firma takip eder, bayi destek verebilir, kurulum genellikle daha kısadır. Özel uygulama ancak şu durumlarda gündeme gelmelidir: akışınız standart ekrana oturmuyor, kayıt programın dışında başka bir sisteme de gidiyor ya da hazır ürün çevrimdışı çalışma ihtiyacınızı karşılamıyor. Depo yönetim sistemi kararını bu ayrımla vermek, sonradan çıkacak bir yeniden yazımı önler.

El terminalinden kayıt programa hangi adımlardan geçer?

Sağlam bir akış beş adımdan oluşur: okutma, doğrulama, cihaz kuyruğu, ara katman ve resmî arayüz. Her adımın ayrı bir sorumluluğu vardır; bu yüzden biri bozulduğunda hangisinin sorun çıkardığı görülebilir.

1. Okutma: Operatör ürün, lokasyon ve miktarı okutur. Ekran işlemi cihazdaki ürün listesiyle kontrol eder.
2. Yerel kayıt: İşlem önce cihaza yazılır ve tekil bir işlem numarası alır. Ağ olmasa da iş durmaz.
3. Aktarım kuyruğu: Bağlantı gelince bekleyen kayıtlar, oluşma sırasıyla ara katmana gider.
4. Ara katman: Kod eşleme, firma ve şube bilgisi, kural kontrolleri burada yapılır. Terminal programın ayrıntılarını bilmez.
5. Resmî arayüz: Kayıt Mikro Desktop API ya da NetOpenX üzerinden yazılır. Sonuç ara katmana, oradan terminale döner.

Ara katmanı atlayıp terminali doğrudan programa bağlamak ilk bakışta kısa görünür. Ama kimlik bilgileri cihaza iner, eşleme kuralları her cihazda ayrı güncellenir ve kuyruğu izleyecek bir yer kalmaz. Bu yüzden depoda birden fazla terminal varsa ara katmanı baştan kurmak daha sağlıklıdır.

Mikro ve Netsis'te el terminali kaydı nasıl yazılır?

İki programda da kayıt üreticinin resmî arayüzünden yazılır; arayüzün adı, kimlik doğrulaması ve kurulum ayrıntıları farklıdır.

Mikro tarafı: Desktop API

Mikro'da yazma yolu Mikro Desktop API'dir; serbest SQL ucunu üretici yalnızca SELECT için belgeliyor. API bir Windows servisi olarak çalışır, istekleri JSON'dur ve varsayılan port sürüme göre değişir: V17'de 8094, V16'da 8084. Kimlik bilgileri V2 ve V3 uç noktalarında her isteğin gövdesinde taşınır, bu yüzden çok firmalı yapıda ara katman firma ve çalışma yılını istek başına üretir.

Üreticinin değişiklik kayıtlarında depo akışını ilgilendiren uçlar görünüyor: DahiliStokHareketKaydetV2 (stok virman fişi dâhil), TransferSiparisKaydetV2, IrsaliyeDuzeltV2, IrsaliyedenFaturaOlusturmaV2 ve EIrsaliyeGonderV2. Bu liste tam değildir ve erişim API Key kapsamına bağlıdır. İrsaliye kaydını açan ucun adını yayımlı sayfalarda doğrulayamadık; uç nokta listesi üreticinin Postman koleksiyonunda ve API başvuru sürecinde netleşir.

Belgedeki üç ayrıntı projeyi doğrudan etkiler:

• Erişim: API Key dikey çözüm kullananlara otomatik atanıyor, firmaya özel yazılımda manuel lisansla veriliyor.
• Test: Demo kurulumda 100 kayda kadar deneme yapılabiliyor; lisanslı kullanıcılar test veritabanı isteyebiliyor. Canlı veriyi deneme alanı yapmayın.
• Alan sınırı: ath_Guid gibi bazı alanlar API'den yazılamıyor. Tekil işlem numarasını bu alanlara dayandırmayın.

Netsis tarafı: NetOpenX

Netsis'te yazma yolu NetOpenX ya da NetOpenX Rest'tir. NetOpenX'in amacı, kaydı programın iş mantığını bozmadan almak ve veri okumaktır. Rest sürümü IIS gerektirmeden kendi servisiyle çalışır ve Swagger arayüzüyle gelir; hangi uç noktaların açık olduğu kurulumun kendisinde görülür.

Netsis tarafında uç nokta adlarını bir yazıdan ezberlemek doğru değildir. Kullanılacak metot kurulumun Swagger arayüzünden ve yetkili bayinizden teyit edilir; arayüz sürümle genişleyebildiği için bu kontrol her yükseltmede yenilenir.

Netsis'te en sık atlanan konu şube ve işletme bilgisidir. SUBE_KODU ve ISLETME_KODU kolonları satır içinde durur, firma ve dönemin fiziksel ayrımı kurulumda doğrulanır. Terminal kaydına hangi işletme ve şubenin yazılacağı ara katmanda kural olmalıdır; operatörün elle seçmesine bırakılırsa kayıt yanlış işletmeye düşebilir.

Hangi depo işlemi hangi kayda karşılık gelir?

Her depo işlemi programda bir kayıt türüne karşılık gelir ve bu eşleme projede en başta yazılır. Aşağıdaki tablo genel bir çerçevedir. Kayıt türü, muhasebe kurgunuza göre mali müşavirinizle birlikte belirlenir.

Sayım farkını terminalin kendiliğinden yazması önerilmez. Fark önce sorumluya düşer, onaylanırsa kayda geçer. Barkodlu stok takip programı kurulumlarında en çok tartışılan kayıtlar bunlardır, çünkü mali etkisi vardır.

Yinelenen kayıt ve hatalı kayıt nasıl yönetilir?

İkisi de terminalin değil ara katmanın işidir: biri aynı işlemin iki kez yazılmasını, diğeri reddedilen kaydın kaybolmasını önler.

Yinelenen kayıt nasıl engellenir?

Yinelenen kayıt, her terminal işlemine bir kez üretilen tekil numara verilip ara katmanda kontrol edilerek engellenir. Tipik durum şudur: ara katman isteği gönderir, program kaydı yazar, ama cevap dönerken ağ kesilir. Terminal "gitmedi" sanıp tekrar gönderirse iki irsaliye oluşur.

Mikro'nun yayımlanmış belgelerinde tekrar gönderime karşı bir idempotency anahtarı bulamadık; bu kurulumda teyit edilir. Bu yüzden kontrolü kendi ara katmanımıza koyuyoruz. Akış şöyle işler:

• Terminal işlemi tekil numarayla gönderir.
• Ara katman numarayı kendi tablosunda arar. Kayıt daha önce başarılıysa programa tekrar gitmez, önceki sonucu döner.
• Numara "gönderildi, sonuç bilinmiyor" durumundaysa kayıt programda açıklama alanındaki dış referansla aranır.
• Sonuç hâlâ belirsizse kayıt elle kontrol kuyruğuna alınır. Belirsizlikte otomatik tekrar yapılmaz.

Dış referansın programda hangi alanda duracağı ürün ve sürüme göre belirlenir. Bu alanın kullanıcı tarafından değiştirilmemesi gerektiği de eğitimde söylenir.

Hata geri dönüşü: reddedilen kayıt nereye gider?

Reddedilen kayıt, gerekçesiyle bir düzeltme kuyruğuna düşer; sessizce silinmez ve operatörün ekranında kaybolmaz. Geçici hata ile kalıcı hata ayrıdır. Program kapalıysa ya da Mikro API 429 döndürüyorsa aktarım bekleyip yeniden dener. Ürün kodu tanımsızsa ya da depo miktarı yetmiyorsa yeniden denemek işe yaramaz, bir insan bakmalıdır.

Üç ekran bu işi yönetilebilir kılar:

• Terminalde: Bekleyen kayıt sayısı ve son aktarım zamanı.
• Depo sorumlusunda: Reddedilen kayıtlar, gerekçe, düzeltip yeniden gönderme.
• Yöneticide: Gün sonunda aktarılmamış kayıt listesi.

Operatöre teknik hata metni göstermek yerine ne yapacağını söyleyin. "Bu ürün programda tanımlı değil, depo sorumlusuna bildirin" yeterlidir. Aktarılmamış kayıt varken gün sonu kapatılırsa program ile raf arasındaki fark yine başlar.

Sürüm yükseltme el terminali akışını nasıl etkiler?

Sürüm yükseltmesi el terminali akışını port, uç nokta ve davranış değişikliği yoluyla etkileyebilir; bu yüzden yükseltme öncesi kontrol şarttır. Mikro'da V16'dan V17'ye geçişte port değişir. Değişiklik kayıtları ise yetenek ve düzeltmeleri aynı listede verir: örneğin 17.06d sürümünde IrsaliyeDuzeltV2 ucunda ikinci satır gönderiminde oluşan bir hatanın giderildiği yazıyor, 17.08a'da alım satım evraklarında tutar ve miktar değişikliklerinin kaydedilmemesi sorunu düzeltilmiş.

Netsis tarafında da NetOpenX Rest üzerindeki uç noktalar ve alanlar sürümle değişebilir. Yükseltmeyi yetkili bayiniz yönetir; bizim işimiz entegrasyonun o geçişi kaldıracak durumda olmasıdır.

Önlem listesi kısadır:

• Port, uç nokta sürümü ve kimlik bilgileri koda gömülmez, yapılandırmada tutulur.
• Her yükseltmeden önce test ortamında mal kabul, sevkiyat ve sayım akışları denenir.
• Yükseltme gününde kuyruk boşaltılır; yeni sürüm doğrulanmadan aktarım açılmaz.
• Bu kontrol bakım anlaşması konusudur. Teslim sonrası 15 gün ücretsiz hata düzeltme yazılım hatalarını kapsar, sürüm takibini kapsamaz.

Sıkça Sorulan Sorular

Mikro el terminali için özel yazılım şart mı?

Hayır. Mikro ekosisteminde depo uygulamaları bulunuyor ve standart akışınız varsa önce bunları değerlendirin. Özel uygulama, akışınız bu ürünlere oturmuyorsa ya da kayıt başka bir sisteme de gidecekse anlamlıdır. Keşif görüşmesinde bu ayrımı açıkça yapıyoruz.

Netsis el terminali kayıtları doğrudan veritabanına yazılabilir mi?

Teknik olarak mümkün olsa da yapmıyoruz. NetOpenX'in amacı kaydı iş mantığını bozmadan almaktır; arayüzü atlamak programın kontrollerini de atlamaktır. Okuma için veritabanı kullanılabilir, yazma resmî arayüzden yapılır.

Terminal ağsız kaldığında kayıtlar kaybolur mu?

Doğru tasarlanmış bir uygulamada kaybolmaz. Kayıt önce cihaza yazılır, bağlantı gelince sırayla aktarılır ve operatör bekleyen sayıyı görür. Çevrimdışı çalışma ilk gün verilen bir karardır; sonradan eklemek veri katmanını yeniden yazmak anlamına gelir.

Aynı irsaliyenin iki kez oluşmasını nasıl önlersiniz?

Her terminal işlemine tekil numara verilir ve ara katman bu numarayı programa göndermeden önce kontrol eder. Sonuç bilinmeyen kayıtlar otomatik tekrar edilmez, elle kontrole düşer. Dış referans alanı kurulumda belirlenir.

Mikro'yu V17'ye yükseltirsek terminal çalışmaz mı?

Port koda sabit yazıldıysa çalışmaz, çünkü varsayılan port V16'da 8084, V17'de 8094'tür. Yapılandırmadan okunuyorsa geçiş kolaylaşır ama uç nokta davranışları yine test edilmelidir. Yükseltmeden önce test ortamında kontrol turu yapılır.

Mikro ya da Netsis bayisi misiniz?

Hayır. D'Cloud Software hiçbir yazılım üreticisinin bayisi değildir. Lisans, API Key başvurusu ve ürün desteği sizin hesabınızda ve yetkili bayinizde yürür. Biz bu süreci teknik olarak destekler, entegrasyon kodunu yazarız.

Depo akışınızı birlikte çizelim

Hangi programı ve sürümü kullandığınızı, depoda hangi işlemlerin elle döndüğünü ücretsiz online keşif görüşmesinde konuşabiliriz. Hazır uygulama yetiyorsa bunu açıkça söyleriz; özel akış gerekiyorsa Mikro entegrasyonu ya da Netsis entegrasyonu kapsamını yazılı çıkarırız. En geç 24 saat içinde dönüş yaparız. Görüşme için iletişime geçin ya da WhatsApp'tan yazın.