Sorun giderme ve SSS
Belirti → neden → çözüm tablosu ve sık sorulan sorular. Herkes için
Önce belirtiyi tabloda bulun; neden ve çözüm yanında yazar. Çözemezseniz tanı bilgilerini toplayıp destek ekibine iletin.
#Kernel ve panel
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Kernel açılmıyor; "4750 numaralı port başka bir uygulama tarafından kullanılıyor" | Port dolu (kernel zaten çalışıyor ya da başka program kullanıyor). | Çakışan uygulamayı kapatın. Portu değiştirmek zorundaysanız .env içindeki PORT'u değiştirin ve tüm kasalardaki sunucu adresini güncelleyin. Kernel portu kendiliğinden değiştirmez. |
| Panelin üstünde "Lisans süresi doldu" uyarısı; satışlar Mikro'ya gitmiyor, kasada "Kernel lisansının süresi dolmuş" | Lisansın bitiş tarihi (ve 7 günlük ek süre) geçti ya da lisans askıda. | Lisans sağlayıcınızla süreyi uzattırın, sonra Sistem ▸ Lisans ▸ Lisansı yenile. Bekleyen satışlar kendiliğinden Mikro'ya yazılır. → Lisans ve yenileme |
| Lisansı yenilerken "Lisans sunucusuna ulaşılamadı" | Kernel bilgisayarının internet erişimi yok ya da güvenlik duvarı pos.nemra.net:443 çıkışını engelliyor. | Sunucuda tarayıcıdan https://pos.nemra.net adresini açabildiğinizi doğrulayın; proxy/güvenlik duvarı kuralını düzeltin. Kernel çevrimdışıyken son lisansla çalışmaya devam eder. |
| "Lisansınız N terminali kapsıyor" / yeni terminal eklenemiyor | Aktif terminal sayısı lisanstaki sınıra ulaştı. | Kullanılmayan bir terminali pasife alın ya da lisansınızı yükseltin. → Limit aşıldığında |
| Panel başka bilgisayardan açılmıyor | Güvenlik duvarı portu engelliyor ya da kernel yalnızca 127.0.0.1 dinliyor. | Sunucuda TCP 4750 gelen kuralı ekleyin; HOST=0.0.0.0 olduğundan emin olun. |
| Panele girişte "Çok fazla hatalı deneme" | 5 yanlış şifre sonrası 1 dakikalık kilit. | Bir dakika bekleyin. Şifre unutulduysa başka bir yöneticiden Panel Kullanıcıları'ndan yeni şifre isteyin. |
| Panel sürekli giriş ekranına atıyor | Oturum 12 saatte biter; ya da config.json imza anahtarı değişti. | Yeniden giriş yapın. Anahtarı yanlışlıkla sildiyseniz tüm oturumlar düşer (veri etkilenmez ama kayıtlı Mikro şifresi yeniden girilmelidir). |
| "Oturum jetonu doğrulanamadı" (403) | Sayfa uzun süre açık kalıp oturum yenilenmiş. | Sayfayı yenileyip işlemi tekrarlayın. |
#Mikro bağlantısı ve senkron
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Bağlantı testi başarısız | Sunucu/örnek adı, port, kullanıcı/şifre ya da veritabanı adı yanlış; SQL Server uzaktan bağlantıya kapalı. | SSMS ile aynı bilgilerle bağlanmayı deneyin. SQL Server Configuration Manager'da TCP/IP'yi açın, SQL ve Windows kimlik doğrulamasını (karma) etkinleştirin, 1433 portuna izin verin. Adlandırılmış örnekte SUNUCU\ORNEK yazın. |
| Genel Bakış'ta senkron hata | Mikro'ya ulaşılamıyor (SQL kapalı, ağ, şifre değişti). | Hata mesajını okuyun, Mikro Bağlantısı'ndan testi yeniden çalıştırın. Düzelince Senkron'dan Şimdi çalıştır. Başarısız senkron zaten 30 sn sonra kendi kendine tekrar dener. |
| Ürün/barkod kasada yok | Ürün pasif/iptal, POS'ta gizli, ya da henüz senkronlanmadı. Koli barkodu aktarılmaz. | Ürünler'de arayıp durumuna bakın; Gizli · göster yapın; katalog senkronunu çalıştırıp kasada Şimdi Senkronize Et'e basın. |
| Fiyat kasada yanlış / eski | Yanlış fiyat listesi seçili; kasa henüz güncellemedi; liste KDV dahil/hariç karışıklığı; fiyat dövizli. | Mikro Bağlantısı ▸ Satış fiyat listesi'ni kontrol edin; senkron ve kasada senkronu çalıştırın. Fiyat ve KDV. |
| Stok kasada/panelde Mikro'dan farklı | Stok senkronu 2 dakikalık; Mikro'da yeni hareket. | Senkron'dan Stok'u çalıştırın. |
| Yeni cari bulunamıyor | Cari senkronu 30 dakikalık. | Cariler senkronunu çalıştırın. |
| Depo kasiyer/terminal listesinde yok | Depo POS'ta kullanılabilir değil ya da Mikro'da iptal. | Depolar'dan etkinleştirin. |
#Satışlar ve Mikro'ya aktarım
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Satışlar Kuyrukta kalıyor | Aktarım duraklatılmış; otomatik senkron kapalı; Mikro erişilemiyor. | Senkron'da Duraklatıldı mı bakın → Devam ettir; zamanlamada Otomatik senkron açık olsun; Mikro bağlantısını test edin; Şimdi aktar. |
| Satış Hata: Cari Mikro'da bulunamadı veya iptal | "Perakende Müşteri"/terminal carisi Mikro'da yok ya da iptal. | Mikro Bağlantısı'nda cariyi düzeltin, cari senkronu çalıştırın, satışta Yeniden dene. |
| Satış Hata: Mikro'da stok kartı bulunamadı | Satılan ürünün stok kartı Mikro'dan silinmiş. | Kartı Mikro'da yeniden açın / doğru kartla düzeltin; sonra Yeniden dene. |
| Satış Hata: … tahsilat için kasa/banka kodu tanımlı değil | Ödeme tipi bilinen satışta kasa/banka hesabı girilmemiş. | Mikro Bağlantısı ▸ Tahsilat (veya terminalde) kasa/banka kodunu girin; Yeniden dene. |
| Satış Onay bekliyor | İzinsiz/sınır aşan indirim ya da onaysız sıfır fiyat. | İnceleyin; uygunsa Onayla ve Mikro'ya aktar. Tekrar olmaması için kasiyer yetkilerini ve satış politikasını gözden geçirin. |
| Kasadan satış yaptım, panelde yok | Kasa çevrimdışı; satış kasanın kuyruğunda; ya da farklı tarih filtresi. | Kasanın Çevrimiçi rozetine bakın; bağlantı gelince gönderilir. Panelde tarih aralığını genişletin. → Çevrimdışı çalışma |
| Mikro'da tahsilat yok, cari bakiyesi açık | Mevcut POS ödeme tipini göndermiyor; ayar "Tahsilat yazma". | Bilinen sınırlar'daki seçeneklerden birini uygulayın. |
#POS (kasa)
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Kurulumda "Sunucuya ulaşılamadı" | Adres/port yanlış; kernel kapalı; güvenlik duvarı; farklı ağ. | Kasanın tarayıcısında http://adres:4750/api/health açılıyor mu? Açılmıyorsa ağ/güvenlik duvarı sorunudur. |
| "Cihaz anahtarı hatalı" | Anahtar yanlış/eksik kopyalandı ya da yenilendi/iptal edildi. | Panelde terminal sayfasından güncel anahtarı kopyalayın. |
| "Bu cihaz henüz backoffice'te bir POS Terminaline bağlanmamış" | Anahtar için terminal tanımlı değil. | Terminaller'den terminal oluşturun; kasada senkron düğmesine basın. |
| "Bu terminale henüz bir depo atanmamış" | Terminalde satış deposu boş. | Terminal sayfasında depo seçin; kasada senkronlayın. |
| "Bu depoda yetkili kasiyer tanımlanmamış" | Hiçbir aktif kasiyer bu depoya atanmamış. | Kasiyerler'de depo atayın. |
| Terminal Pasif ekranı | Terminal panelden pasifleştirilmiş. | Panelde Terminal aktif yapın; kasada Şimdi Senkronize Et (yeniden başlatmaya gerek yok). |
| "PIN hatalı" / "Çok fazla hatalı PIN" | PIN yanlış; 5 hatadan sonra 1 dk kilit. | Bekleyin, PIN'i doğrulayın; unutulduysa panelden yeni PIN verin. |
| "Sunucuya ulaşılamadı ve PIN bu cihazda yerelde doğrulanamadı" | Kasiyer bu kasaya hiç çevrimiçiyken girmemiş. | Bağlantı gelince bir kez girin; sonra çevrimdışı da girebilir. |
| "Ürün bulunamadı" (barkod) | Barkod katalogda yok. | Ürün Ara ile adla arayın; yoksa Mikro'da barkod tanımlayıp senkronlayın. |
| "Sıfır fiyatlı ürün satışına izin verilmiyor" | Ürünün satış fiyatı 0 ve politika izin vermiyor. | Mikro'da fiyatı girin; ya da politikayı ayarlayın. |
| "Maksimum indirim yetkiniz %X" / "İndirim yapma yetkiniz yok" | Kasiyer yetkisi yok/sınır aşıldı. | Daha düşük indirim girin ya da yönetici yetkiyi artırsın. |
| "Perakende Müşteri carisi henüz bu terminale hiç senkronlanmadı" | İlk senkron internetsizken yapıldı ya da cari panelde seçilmedi. | İnternet varken bir kez girip bekleyin; panelde Perakende Müşteri carisini seçin. |
| Satış tamamlanmıyor, ÖKC hatası | Pavo kapalı/ağda değil; kağıt yok; IP/port yanlış. | Cihazı ve POS Ayarları ▸ ÖKC değerlerini kontrol edin. Acil durumda yönetici onayıyla ÖKC olmadan devam et (dikkat). |
| Fiş çıkmıyor | Fiş yazdırma kapalı; yazıcı seçili değil/çevrimdışı. | POS Ayarları ▸ Fiş Yazdırma: açık mı, doğru yazıcı seçili mi, Windows'ta yazıcı hazır mı. |
| Kasa çekmecesi açılmıyor | Ayar kapalı ya da yazıcıda çekmece çıkışı yok. | Ayarda çekmeceyi de aç'ı açın; kabloyu kontrol edin. |
| Terazi okunmuyor | Yanlış port/baud değeri; kablo; terazi etkin değil. | POS Ayarları ▸ Terazi değerlerini terazi kılavuzuna göre girin, Bağlantıyı Test Et. |
| Müşteri ekranı boş/çıkmıyor | İkinci monitör yok ya da ayar kapalı. | POS Ayarları ▸ Müşteri Ekranı'nı açın; ikinci monitörün bağlı olduğundan emin olun. |
| Çevrimdışı rozeti kalmıyor | Sunucu/ağ erişilemiyor. | Ağı ve kernel'i kontrol edin; Şimdi Senkronize Et. |
#Sık sorulan sorular
#İnternet kesilirse satış yapabilir miyim?
Evet. Satışlar kasada saklanır ve bağlantı gelince gönderilir. Bkz. Çevrimdışı çalışma.
#Mikro kapalıyken satış yapılabilir mi?
Evet. Kasalar yalnızca kernel'le konuşur. Satışlar kernel'de kuyruklanır ve Mikro açılınca yazılır.
#Aynı satış iki kez faturalanır mı?
Hayır. Her satışın benzersiz kimliği vardır; hem kernel hem Mikro tarafında çift kayıt engellenir.
#Mikro'daki fiyatı değiştirdim, kasaya ne zaman yansır?
Katalog senkronu 10 dakikada bir çalışır; ardından kasa da 10 dakikada bir alır. Hemen için panelde Senkron ▸ Ürün/fiyat/barkod ▸ Şimdi çalıştır ve kasada Şimdi Senkronize Et.
#Bir kasiyer işten ayrıldı, ne yapmalıyım?
Kasiyeri silmeyin, pasif yapın; geçmiş satışlar adıyla korunur. → Kasiyerler
#Kasayı değiştirdim; ne yapmalıyım?
Yeni bilgisayara POS'u kurup terminalin anahtarını girin. Fiş sayacı yeni bilgisayarda baştan başlar; bunu istemiyorsanız yeni terminal (yeni fiş öneki) tanımlayın. Eski bilgisayarda bekleyen satış kalmadığından emin olun.
#Sunucuyu başka bir bilgisayara taşıyabilir miyim?
Evet: data/ klasörünü (özellikle kernel.db ve config.json) ve .env'i yeni sunucuya kopyalayın, kernel'i başlatın, kasalardaki adresi güncelleyin (IP aynı kalacaksa gerekmez). Önce eski sunucuda bekleyen satışların Mikro'ya yazıldığından emin olun.