﻿RoxOKCinPos — KULLANIM KILAVUZU
RoxPos kablolu inPOS (GMP3) kasa programı
=========================================================================

İÇİNDEKİLER
 1. Bu program hangi durumda gerekir?
 2. Nasıl çalışır?
 3. Gereksinimler
 4. RoxPos panel ayarları (alan alan)
 5. Kurulum (kasa bilgisayarı)
 6. Cihazı bilgisayara eşleme
 7. İlk açılış ve giriş
 8. Günlük kullanım
 9. Ödeme tipleri, kısımlar, fiş altı bilgisi
10. Fiş limiti ve fatura bilgi fişi
11. Para güvenliği (elektrik, kapanma, bağlantı kopması)
12. Bekleyen iş, iptal, cihazda yarım fiş
13. Ana pencere, simge renkleri, bildirimler
14. Teknik ekran ve günlükler
15. Güncelleme
16. Kaldırma
17. Birden çok kasa / cihaz, sanal makine
18. Sorun giderme (belirti > neden > çözüm)
19. Destek

Kısaltmalar: ÖKC = yazarkasa POS (inPOS M530). GMP3 = kablolu bağlantı
protokolü. TSM = inPOS'un kablosuz (bulut) yönetim sistemi.


=========================================================================
1. BU PROGRAM HANGİ DURUMDA GEREKİR?
=========================================================================

inPOS RoxPos'a iki yolla bağlanır. Bağlantı tipi panelde terminal başına
seçilir (Ayarlar > Entegrasyon > POS Entegrasyonu > inPOS).

A) Kablosuz (TSM) — bu program GEREKMEZ
   - Kasiyer adisyonu RoxPos'ta "POS'a Gönder" ile gönderir; cihaz
     adisyonu inPOS TSM üzerinden RoxPos'tan kendisi çeker ve
     listesinde gösterir. Bilgisayar ve program gerekmez.
   - Ödeme tipi: RoxPos'ta nakit, yemek kartı ya da havale seçilirse
     cihaz fişi o tiple keser (tutar ödenmiş gider); kart seçilirse ya da
     tip seçilmezse tahsilatı cihaz yapar. "Ödeme tipi zorunlu" ayarı
     isteğe bağlıdır (varsayılan kapalı).
   - Online sipariş fişi KENDİLİĞİNDEN KESİLMEZ: elle gönderilir, kasiyer
     siparişi cihazın listesinden seçip keser.
   - Cihazın inPOS TSM'de RoxPos'a lisanslı olması gerekir.

B) Kablolu (GMP3) — bu program GEREKİR
   - Kasa bilgisayarına bu program kurulur; RoxPos'tan gelen fişi cihaza
     yerel ağ üzerinden basar.
   - Ödeme tipi RoxPos'ta seçilir ve ZORUNLUDUR (nakit, kart, yemek
     kartı). Kart cihazda çekilir.
   - Online sipariş fişi KENDİLİĞİNDEN KESİLEBİLİR: online sipariş
     otomasyonunda "POS'a Otomatik Gönder (Fiş)" açıksa RoxPos sunucusu
     fiş işini programın kuyruğuna koyar, program basar. Elle de
     gönderilebilir.
   - Fiş limitinin üstünde yalnız fatura bilgi fişi kesilir (bölüm 10).

Kablolu Ingenico / PAX için bu program değil "RoxOKCingenico" kullanılır.
Bir bilgisayarda ikisi birlikte çalışabilir; her biri kendi cihazına
bakar.


=========================================================================
2. NASIL ÇALIŞIR?
=========================================================================

  RoxPos web panel / mobil uygulama / online sipariş
        |
        | (internet)  fiş işi, cihazın sicil no'suna sıraya girer
        v
  RoxPos sunucusu  <---- program internetten sürekli "iş var mı?" sorar
                                         |
                              RoxOKCinPos (kasa bilgisayarı)
                                         ^
                                         |  yerel ağ, TCP port 59000
                                         |  (CİHAZ BİLGİSAYARA BAĞLANIR)
                                    inPOS M530

- Program RoxPos'a internetten kendisi bağlanır. Modemde port açmak ya
  da dışarıdan erişim gerekmez. Yerel ağda yalnız cihazın bilgisayara
  bağlanabilmesi gerekir (güvenlik duvarı izni, bölüm 5).
- inPOS'ta yön terstir: program bilgisayarda bir portu dinler, cihaz bu
  bilgisayarın IP:port'una bağlanır. Cihaz bu adrese bir kez eşlenir
  (bölüm 6). (Kablolu Ingenico'da tersi: program cihaza bağlanır.)
- Fiş web panelden, garson telefonundan (mobil), Hızlı Satış'tan ya da
  online siparişten gelebilir; hepsi aynı programa ve cihaza gider.
- Program aynı anda tek fiş basar. Masa fişi önce gelir; masa işi yoksa
  bekleyen online sipariş fişi alınır.
- Fiş basılınca fiş no, Z no ve EKÜ no RoxPos'a yazılır; ödemeler
  adisyona işlenir.


=========================================================================
3. GEREKSİNİMLER
=========================================================================

Bilgisayar
- Windows 10 ya da 11 (32 ya da 64 bit). Program 32 bit çalışır, çünkü
  inPOS'un kitaplığı yalnız 32 bittir. .NET Framework 4.8 (Windows 10 /
  11'de genellikle hazırdır).
- Microsoft Visual C++ 2010 x86 VE 2013 x86 çalışma zamanları. 64 bit
  Windows'ta da "x86" olanlar gerekir. Taze Windows'ta ikisi de yoktur;
  gereksinimleri-kur.bat ya da programdaki "Gerekenleri kur" düğmesi
  kurar (bölüm 5).
- Program YEREL DİSKTE olmalı (ör. C:\RoxOKCinPos).
- İnternet (RoxPos'a bağlanmak ve gereksinimleri kurmak için).
- SABİT IP: cihaz her zaman aynı IP:port'a bağlanır. Bilgisayarın IP'si
  değişirse cihaz bilgisayarı bulamaz.

Ağ
- Kasa bilgisayarı ve cihaz aynı yerel ağda (aynı modem / switch).
- Windows güvenlik duvarında programa gelen bağlantı izni.

Cihaz
- inPOS M530, GMP3 kablolu bağlantıya uygun, ağ kablosu takılı ve ağdan
  IP almış (cihaz ekranında bağlantı simgesi görünmeli).
- Eşleme için cihazın Servis menüsüne girilir. Servis girişi, inPOS
  yetkili servisinin cihaz için ürettiği tek seferlik anahtarla yapılır:
  eşlemeyi cihazı aldığınız yer / inPOS yetkili servisiyle birlikte
  yapın.
- Uygulama no: cihazda RoxPos'u tanıtan numara. Test cihazlarında 1;
  canlı cihazda kullanılacak numarayı RoxPos destekten öğrenin. Eşlemede
  yazılan no ile programın kullandığı no aynı olmalıdır.

RoxPos
- RoxPos kullanıcısı (kasa için ayrı bir kullanıcı önerilir).
- Panelde inPOS terminali "Kablolu (GMP3)" olarak tanımlı (bölüm 4).


=========================================================================
4. ROXPOS PANEL AYARLARI (ALAN ALAN)
=========================================================================

Yer: Ayarlar > Entegrasyon > POS Entegrasyonu > inPOS
(inPOS bölümü açık olmalı; kapalıysa program "RoxPos'ta inPOS
entegrasyonu kapalı" der.)

Terminal (her cihaz için bir satır; şubeye göre):
- Bağlantı tipi ........ "Kablolu (GMP3)".
- Kasa bilgisayarının IP adresi
                         Programın çalıştığı bilgisayarın IP'si.
                         CİHAZIN IP'Sİ DEĞİL! Bulmak için kasa
                         bilgisayarında: Başlat > "cmd" > ipconfig >
                         "IPv4 Adresi" (ör. 192.168.1.20).
- Port ................. 59000 önerilir. Boş bırakılırsa 59000
                         kaydedilir. Eşlemede yazılan portla aynı olmalı.
                         (7500 Ingenico'nun portudur, inPOS'ta kullanmayın.)
- Terminal Kodu ........ Cihazı tanıyacağınız kısa ad (ör. KASA-1).
                         Programın "Cihaz seç" listesinde görünür.
- Cihaz sicil no ....... Cihazın sicil numarası (12 karakter; cihazın
                         arkasındaki etikette "S/N"). Program bağlanınca
                         cihazdan okuduğu sicil no ile bunu karşılaştırır;
                         farklıysa fiş basmaz.

Kaydettikten sonra terminalin altında programın durumu görünür:
"Program bağlı — <bilgisayar adı>", "Cihazla eşleşti: <sicil>",
"Program sürümü …". Program hiç bağlanmadıysa "inPOS kasa programı bu
cihaz için henüz bağlanmadı" yazar.

Ödeme tipleri (Ayarlar > Ödeme Tipleri) — ayrıntı bölüm 9:
- Nakit ve Kredi Kartı olduğu gibi kullanılır.
- Yemek kartı tiplerinin adında firma adı geçmeli (ör. "Multinet",
  "Sodexo", "Edenred", "Setcard", "MetropolCard").
- Havale / EFT gibi diğer tipler kablolu inPOS'ta cihaza gönderilemez.
- "ÖKC'ye bağlı değil" işaretli tipler hiçbir zaman cihaza gitmez.

Kısımlar (KDV): kalem, ürün grubunun ÖKC bölüm (kısım) no'suyla gider
(Ayarlar > ÖKC Grupları). Kısmın KDV'si ürününkiyle tutmazsa program
KDV'si tutan kısmı kendisi seçer (bölüm 9).


=========================================================================
5. KURULUM (KASA BİLGİSAYARI)
=========================================================================

5.1 Sabit IP
    Kasa bilgisayarına sabit IP verin: modem arayüzünde bu bilgisayara
    IP ayırın (DHCP rezervasyonu) ya da Windows ağ ayarlarından elle
    sabit IP girin. Bilmiyorsanız ağınızı kuran kişiden isteyin.

5.2 Klasörü kopyalayın
    Zip'teki RoxOKCinPos klasörünü yerel diske çıkarın, örneğin
    C:\RoxOKCinPos. Bütün dosyalar aynı klasörde kalmalı. Ağ
    sürücüsünden, paylaşımdan ya da İndirilenler'den çalıştırmayın
    (program ağ sürücüsünü fark edip uyarır).

5.3 Gereksinimler (Visual C++)
    gereksinimleri-kur.bat'a çift tıklayın. winget ile Visual C++ 2010
    x86 ve 2013 x86 kurulur (internet gerekir; Windows izin sorabilir,
    "Evet" deyin). Sonunda kitaplık denetimi çalışır.
    - winget yoksa betik Microsoft'un indirme sayfasını açar: "Visual
      Studio 2010 (VC++ 10.0) SP1" ve "Visual Studio 2013 (VC++ 12.0)"
      bölümlerinden x86 paketlerini (vcredist_x86.exe) kurun.
    - Aynı işi programın ana penceresindeki "Gerekenleri kur" düğmesi de
      yapar (düğme yalnız bir şey eksikse görünür).

5.4 Denetim
    kitaplik-denetimi.bat cihaza dokunmadan kurulumu denetler. Sonuç
    klasördeki RoxOKCinPos-kitaplik-denetimi.txt dosyasındadır: her
    DLL'in yüklenip yüklenmediği ve nedeni yazar. Son satır
    "SONUÇ: kurulum tamam" olmalı. "SORUN VAR" yazıyorsa yukarıdaki
    satırlar nedenini söyler (genellikle Visual C++ eksiktir).

5.5 Güvenlik duvarı
    guvenlik-duvari-izni.bat'a sağ tıklayın > "Yönetici olarak
    çalıştır". Windows güvenlik duvarına "RoxOKCinPos (inPOS)" adlı,
    bu klasördeki RoxOKCinPos.exe için gelen bağlantı izni eklenir.
    İzin programın YOLUNA bağlıdır: klasörü taşırsanız betiği yeni
    klasörde yeniden çalıştırın. Bilgisayarda başka bir güvenlik
    yazılımı (antivirüs güvenlik duvarı) varsa onda da izin verin.

5.6 Eşleme
    Bölüm 6.

5.7 Programı açın
    Bölüm 7.


=========================================================================
6. CİHAZI BİLGİSAYARA EŞLEME
=========================================================================

Ne zaman yapılır?
- Kasa bilgisayarı başına BİR KEZ.
- Yeniden gerekir: bilgisayarın IP'si, port ya da uygulama no
  değişirse; cihaz değişir, sıfırlanır ya da servis eşlemeyi
  kapatırsa; kasa bilgisayarı değişir ya da Windows yeniden kurulursa.
- Program güncellemesinde, yeniden başlatmada, elektrik kesintisinde
  GEREKMEZ.

Hazırlık
- RoxOKCinPos KAPALI olmalı: saatin yanındaki simge > sağ tık > Çıkış >
  Evet. (Eşleme aracı aynı portu kullanır.)
- Bilgisayarın IP'sini, portu (59000), cihazın sicil no'sunu ve
  uygulama no'yu not edin.
- Cihaz açık, ağa bağlı ve kasiyer giriş ekranında olsun.

Bilgisayarda
1. eslestirme\inposgmp3.exe'yi açın.
2. Alanlar: IP = bu bilgisayarın IP'si, Port = 59000 (panelle aynı),
   Sicil no = cihazın sicil no'su, Uygulama no = bölüm 3'teki no.
   Henüz "Eşle"ye basmayın.

Cihazda
3. Kasiyer giriş ekranında "Servis"e girin. Servis girişini inPOS
   yetkili servisinizin vereceği anahtarla yapın.
4. 0.Diğer > 3.Harici Uygulamalar.
   Aynı uygulama no ile eski bir eşleme varsa önce "3.Uygulama Kapat".
5. 1.Uygulama Eşle > uygulama no > bilgisayarın IP'si > port.
6. Ekranda "Harici uygulama ile eşleme için giriş tuşuna basınız"
   çıkar.

Birlikte
7. Önce cihazda Giriş tuşuna, HEMEN ARDINDAN bilgisayarda "Eşle"ye
   basın.
8. Cihazda "Eşleme başarılı", bilgisayarda "Eşleme başarılı" görünmeli.
9. Kontrol: cihazda 4.Uygulama Bilgileri'nde ip:port ve "etkin"
   görünmeli.

Olmazsa
- "Eşleme hatası: 1012" (cihazdan 30 sn veri gelmedi): adım 7'yi bir kez
  daha deneyin; ilk denemede sık görülür.
- Başka hata: IP, port ve uygulama no'yu iki tarafta da kontrol edin;
  güvenlik duvarı izni (5.5) verilmiş mi bakın; cihaz ve bilgisayar aynı
  ağda mı bakın.
- inPOS'un kendi anlatımı: eslestirme\Gmp3-Esleme-Protokolu.txt

Eşlemeden sonra inposgmp3.exe'yi kapatıp RoxOKCinPos'u açın.


=========================================================================
7. İLK AÇILIŞ VE GİRİŞ
=========================================================================

1. RoxOKCinPos.exe'yi açın. "Windows bilgisayarınızı korudu" uyarısı
   çıkarsa: "Ek bilgi" > "Yine de çalıştır".
2. "RoxPos'a giriş yap": RoxPos kullanıcı adı / e-posta ve şifre. Şube
   sorulursa bu kasanın şubesini seçin. Kasa için ayrı bir kullanıcı
   önerilir; fişte kasiyer adı olarak bu kullanıcı yazılır.
3. Cihaz seçimi: girişten sonra "Bu bilgisayarın cihazı" penceresi
   açılır; bu bilgisayara eşlenmiş cihazı seçip "Seç"e basın. Listede
   kasa bilgisayarı IP'si bu bilgisayarın olmayan satırlarda "(bu
   bilgisayarın IP'si değil)" yazar. (Panelde bu şubede tek kablolu
   inPOS varsa program onu kendisi de seçer.)
4. Program cihazı bekler: "Cihaz bekleniyor: program <IP>:59000
   adresinde dinliyor…". Cihaz bağlanınca: "Bağlı — inPOS <sicil no>"
   ve yeşil "Hazır".
5. Pencereyi kapatın; program saatin yanındaki simgede çalışmaya devam
   eder. Windows 11 yeni simgeleri "^" okunun içine gizler: simgeyi bir
   kez görev çubuğuna sürükleyip sabitleyin. Simgeye tek ya da çift
   tıklayınca pencere yeniden açılır.

Program ilk açılışta kendini Windows başlangıcına ekler (o Windows
kullanıcısı için; yönetici izni gerekmez). Kasa bilgisayarı açılıp bu
kullanıcı Windows'a girince program kendiliğinden başlar. Şifre Windows
şifrelemesiyle o Windows kullanıcısına bağlı saklanır; başka bir Windows
kullanıcısıyla açılırsa program yeniden giriş ister.


=========================================================================
8. GÜNLÜK KULLANIM
=========================================================================

Masa / Hızlı Satış fişi
1. RoxPos'ta (web ya da mobil) "Ödeme Al"da ödeme tipini seçin: nakit,
   kart ya da yemek kartı. Kablolu inPOS'ta tip seçmek zorunludur.
2. Gönderin. Parçalı ödemede her parçayı ekleyin; ödemeler fiş tutarını
   karşılayınca fiş cihaza gider ("kalan … TL için ödeme alın").
3. Kartta: müşteri kartı cihaza okutur / şifresini girer.
4. Fiş basılınca ödeme ile fiş no, Z no, EKÜ no RoxPos'a yazılır. Masa,
   panelde "Ödeme tamamlanınca masayı otomatik kapat" açıksa kapanır;
   değilse elle kapatılır.

Online sipariş fişi
- Otomatik: online sipariş otomasyonunda "POS'a Otomatik Gönder (Fiş)"
  açıksa fiş kendiliğinden programın kuyruğuna gider. Elle de sipariş
  detayından gönderilebilir.
- Online sipariş fişi cihazda nakit ödemeyle basılır; RoxPos'ta ayrıca
  tahsilat oluşmaz. Fişin altına "ONLINE: …" satırı basılır.
- Masa fişi her zaman önce basılır.

Gün sonu
- Program kendiliğinden Z raporu ALMAZ. Z raporunu cihazdan alın.
- Cihaz Z raporu isterse fiş basılmaz; program "Cihaz Z raporu (gün
  sonu) istiyor" der. Z'yi alıp fişi yeniden gönderin.

Satış sırasında cihaz tuşları kilitlenir (inPOS önerisi); iş bitince
açılır. Program açılışta da bir kez açar.

Program kapalıyken gönderilen fiş
- RoxPos "inPOS kasa programı şu an bağlı değil; fiş program bağlanınca
  basılır" der. Fiş sırada bekler; program açılıp cihaza bağlanınca
  basılır. Müşteri gittiyse ve fiş artık basılmasın istiyorsanız masa
  ekranındaki "Kablolu inPOS" kutusundan "İptal et"e basın (bölüm 12).


=========================================================================
9. ÖDEME TİPLERİ, KISIMLAR, FİŞ ALTI BİLGİSİ
=========================================================================

RoxPos ödeme tipi           Cihazda
--------------------------  ---------------------------------------------
Nakit (nakit grubu)         Nakit. Para üstü yalnız nakitte verilir.
Kredi Kartı (kart grubu)    Kart: cihazın banka uygulaması açılır, müşteri
                            kartı okutur. Slipleri cihaz basar.
Yemek kartı grubu           Yemek kartı: firması tipin adından bulunur.
                            Tanınan adlar: MetropolCard, Multinet,
                            Setcard, Sodexo (Pluxee), Edenred (Ticket),
                            TokenFlex, Paycell, iWallet. Cihazda o
                            firmanın yemek kartı uygulaması açık olmalı.
Diğer (havale, EFT …)       Kablolu inPOS'ta YOK. Program fişi cihaza
                            göndermeden reddeder ("… ödeme tipi yok").
                            Başka bir tip seçin.

Kurallar
- Parçalı ödeme olur (ör. kart + nakit). Program kart / yemek kartını
  önce, nakdi en son gönderir; tutar tamamlanınca satış kendiliğinden
  biter.
- Kart / yemek kartı tutarı fiş tutarını aşamaz (para üstü yalnız
  nakitte).
- Kart reddedilirse ya da cihazda vazgeçilirse: daha önce kart / yemek
  kartı alınmadıysa satış iptal edilir, fiş basılmaz, yeniden
  gönderilebilir. Daha önce kart alındıysa satış cihazda açık kalır;
  kalan ödemeyi cihazdan alın ya da satışı cihazdan iptal edin (kart
  iadesi için cihaz kart ister).
- Kart işleminde program yaklaşık 3 dakika bekler; süre dolarsa iş
  "yarıda" kalır ve program cihaza sorarak sürdürür.
- Sepet (adisyon) indirimi fişe toplam indirimi olarak basılır. Cihazın
  tahsil edeceği tutar RoxPos toplamıyla aynı değilse fiş iptal edilir.

Kısımlar (KDV)
- Cihazda 8 kısım vardır, her birinin bir KDV oranı vardır. Program
  kısım tablosunu cihazdan okur (bağlanınca ve Z değişince).
- Kalem, ürün grubunun ÖKC bölüm no'suyla gider. O kısmın KDV'si
  ürününkiyle aynı değilse ya da kısım tanımlı değilse KDV'si tutan ilk
  kısım kullanılır (sonuca not düşülür).
- Cihazda ürünün KDV oranında hiç kısım yoksa fiş gönderilmez:
  "Cihazda %X KDV'li kısım yok". Cihazın kısımlarını yetkili servise
  düzelttirin ya da ürünün KDV'sini / grubunu kontrol edin.
- Kesirli adet (1,5 porsiyon) tek kalem olarak "1,5 x Ürün" adıyla
  basılır.

Fiş altı bilgisi
- Kasiyer adı: programa giriş yapan RoxPos kullanıcısı (e-postaysa
  @ işaretinden önceki kısım).
- Masa, adisyon no, online sipariş bilgisi fişin altına satır satır
  basılır.


=========================================================================
10. FİŞ LİMİTİ VE FATURA BİLGİ FİŞİ
=========================================================================

- Cihazın bir FİŞ LİMİTİ vardır (yasal sınır; tutarı yıllara göre
  değişir). Limitin üstündeki tutar fişle kesilemez.
- Program limiti cihazdan okur ve RoxPos'a bildirir. RoxPos (web, mobil
  ve sunucu) tutar limiti aşınca "Fiş" seçeneğini kaldırır ve şunlar
  girilmeden göndermez:
    * VKN (10 hane) ya da TCKN'li (11 hane) cari,
    * Belge tipi: e-Arşiv, e-Fatura ya da Fatura bilgi fişi,
    * Belge no: en çok 16 karakter, Türkçe karakter olmadan.
- Fatura bilgi fişi ne demek? Fatura cihazda değil, e-Arşiv / e-Fatura
  yazılımınızda (ya da kağıt fatura olarak) kesilir. Cihaz o faturanın
  numarasıyla "faturalı satış bilgi fişi" basar.
- Yalnız cari seçmek yetmez; belge tipi "Fiş" kalırsa fiş sayılır.
- Limit altındaki tutarda da belge tipi seçilerek bilgi fişi
  basılabilir.
- Limit üstü bir iş yine de programa ulaşırsa program cihaza gitmeden
  reddeder: "Fiş tutarı … cihazın satış limitini … aşıyor". Fiş
  açılmaz, para alınmaz. RoxPos'ta belge tipini seçip yeniden gönderin.
- Cihazın limitini RoxPos ödeme ekranındaki uyarı gösterir.


=========================================================================
11. PARA GÜVENLİĞİ (ELEKTRİK, KAPANMA, BAĞLANTI KOPMASI)
=========================================================================

Program bir fişi basarken her adımı cihaza göndermeden ÖNCE diske yazar
(C:\ProgramData\RoxOKCinPos\acik-is.json). Kurallar:

- Elektrik kesilirse, bilgisayar ya da program kapanırsa: program
  yeniden açılınca yarım işi bulur, cihaza durumu SORAR ve kaldığı
  yerden sürdürür. Ekranda "Yarım kalan fiş sürdürülüyor…" görünür.
- Sonucu belirsiz bir komut (bağlantı koptu, cihaz geç yanıt verdi)
  körlemesine yeniden gönderilmez. Kalem sayısı, alınan ödeme ve fiş
  bilgisi cihazdan okunur; komut yalnız cihaz "işlemedim" diyorsa bir
  kez yeniden gönderilir. Böylece çift kalem, çift ödeme, çift fiş
  olmaz.
- Ödeme komutu gittikten sonra "fiş basılmadı" ancak cihazdan kanıtla
  söylenir. Kanıt yoksa iş "Dikkat" olur: kasiyer cihazdaki son fişe
  bakar.
- Bağlantı koparsa program yaklaşık 1 dakika yeniden bağlanmayı dener;
  olmazsa iş "yarıda" kalır, bağlantı gelince sürer.
- Kağıt biterse: "Cihaz yazıcısı hata veriyor / kağıt bitti — kağıt
  takın, fiş kaldığı yerden sürecek." Program 10 dakikaya kadar bekler.
- Aynı anda tek açık iş vardır. Aynı iş ikinci kez gelirse fiş yeniden
  basılmaz; eski sonuç RoxPos'a yeniden bildirilir (son 500 sonuç
  saklanır).
- Cihazda bu işe ait olmayan açık satış bulunursa: ödemesizse program
  iptal eder; ödeme alınmışsa dokunmaz, "Dikkat" verir — kasiyer
  cihazdan tamamlar.
- Kartla ödeme alınmış satış program tarafından iptal edilmez (iptal
  cihazda kart okutmayı gerektirir); kasiyere bırakılır.

UYARI: Yarım iş varken C:\ProgramData\RoxOKCinPos\acik-is.json dosyasını
silmeyin; program yarım fişi o dosyadan sürdürür.


=========================================================================
12. BEKLEYEN İŞ, İPTAL, CİHAZDA YARIM FİŞ
=========================================================================

RoxPos masa ekranındaki "Kablolu inPOS" kutusu işin durumunu gösterir:
- "ödeme bekleniyor (kalan …)": parçalı ödemenin kalanı bekleniyor.
- "programa gönderiliyor": iş hazır, program henüz almadı.
- "fiş cihazda basılıyor": program işi aldı.
- "cihazda yarım fiş — cihazda tamamlayın": bölüm 11'deki "Dikkat".

Düğmeler
- "İptal et": fiş henüz cihaza gitmediyse GÜVENLİDİR. İş iptal edilir,
  planlanan ödemeler düşer, kalemler yeniden ödenebilir.
- "Zorla bırak": program işi almışsa görünür. Cihazda fiş basılmış ya
  da kart çekilmiş olabilir; ÖNCE CİHAZI KONTROL EDİN. Bırakırsanız
  RoxPos'ta ödeme düşer; cihazda basılmış fiş için iade gerekebilir.
  Yetki ister.

Sonuç türleri
- Basıldı: ödeme ve fiş bilgisi RoxPos'a yazılır.
- Basılamadı: cihaza hiç gidilmedi ya da satış iptal edildi; para
  alınmadı. Nedeni düzeltip yeniden gönderin.
- Dikkat (cihazda yarım fiş): cihazda yarım satış ya da sonucu kesin
  olmayan fiş var. Cihazdaki son fişe bakın:
    * basıldıysa RoxPos'ta ödendi olarak kapatın,
    * basılmadıysa (kart çekildiyse iadesini yapıp) yeniden gönderin.
- Yarıda kaldı: bağlantı koptu; program bağlantı gelince kendisi sürer.


=========================================================================
13. ANA PENCERE, SİMGE RENKLERİ, BİLDİRİMLER
=========================================================================

Ana pencere satırları
- RoxPos ... giriş durumu ("Bağlı — kullanıcı / şube").
- Cihaz .... "Bağlı — inPOS <sicil>" ya da beklenen adres / hata.
- Durum .... "Fiş bekleniyor.", "Fiş basılıyor…", hata açıklaması.
- Son fiş .. son işin saati, sonucu ve fiş no'su.

Düğmeler
- "RoxPos'a giriş yap" / "Kullanıcıyı değiştir".
- "Cihaz seç": panelde bu şubeye tanımlı kablolu inPOS'lardan bu
  bilgisayarınkini seçer. Paneldeki adres değiştiyse program yeni
  bilgiyi bu seçimle de alır.
- "Gerekenleri kur": yalnız Visual C++ eksikse görünür.
- "Yeniden bağlan": cihaz bağlantısını kapatıp yeniden bekler.
- "Teknik ekran": yalnız RoxPos ekibinin girişiyle açılır (bölüm 14).

Simge ve başlık renkleri
- Gri ....... Başlıyor.
- Yeşil ..... Hazır (RoxPos'a ve cihaza bağlı, fiş bekleniyor).
- Sarı ...... Çalışıyor (fiş basılıyor, cihaz bekleniyor, yarım iş
              sürdürülüyor).
- Kırmızı ... Dikkat (giriş yok, cihaz bağlanmıyor, adres yanlış,
              Visual C++ eksik ya da son fiş basılamadı). Ayrıntı ana
              penceredeki satırlardadır.

Köşe bildirimleri: "Cihaz bağlantısı", "Fiş basılamadı", "Cihazda yarım
fiş", "RoxPos girişi". Bildirime tıklayınca ana pencere açılır.

Pencereyi açmak: simgeye tek ya da çift tıklayın (ya da sağ tık > Aç).
Program açıkken RoxOKCinPos.exe'ye yeniden tıklarsanız ikinci kopya
açılmaz; açık programın penceresi öne gelir. Pencere ekran dışında
kalmışsa (ekran, çözünürlük ya da ölçek değişti) ekranın ortasında açılır.
Simgenin üstüne gelince program adı ve durum görünür.

Programdan çıkış: simge > sağ tık > Çıkış > "Evet". Program kapalıyken
bu cihaza fiş basılmaz (fişler sırada bekler).


=========================================================================
14. TEKNİK EKRAN VE GÜNLÜKLER
=========================================================================

Teknik ekran
- Şifresi yoktur; programa e-postası @roxpos.com ile biten bir RoxPos
  ekibi kullanıcısıyla giriş yapılmışsa açılır. İşletme kullanıcısıyla
  açılmaz. RoxPos destek uzaktan bağlandığında kendi kullanıcısıyla
  girer; iş bitince kasanın kullanıcısıyla yeniden giriş yapılmalıdır.
- Sekmeler: Bağlantı (geçici dinleme IP / port), Cihaz (kısımlar, KDV,
  banka ve yemek kartı uygulamaları, satış limiti), Test fişi (GERÇEK
  mali fiş basar; RoxPos'a bildirilmez), Günlük, Ayarlar (uygulama no,
  Windows açılınca başlat).

Veri klasörü: C:\ProgramData\RoxOKCinPos
(ProgramData gizli klasördür; Dosya Gezgini'nin adres çubuğuna yazın.)
- ayarlar.json ......... giriş (şifre şifreli), seçilen cihaz, adres.
- gunluk\ .............. program günlüğü, her gün bir dosya
                         (YYYY-AA-GG.log); 30 günden eskiler silinir.
- sdk-gunluk\ .......... inPOS kitaplığının günlükleri
                         (libinposext_*.txt); 20 MB'ı aşan eski dosya
                         açılışta silinir.
- acik-is.json ......... yarım iş (varsa). SİLMEYİN.
- sonuclar.json ........ son 500 işin sonucu.

Program klasöründe oluşabilecek dosyalar
- RoxOKCinPos-kitaplik-denetimi.txt (kitaplık denetimi sonucu),
  pencere-denemesi\ (pencere denemesi sonucu), libinposext_*.txt
  (inPOS kitaplığının denetim sırasında yazdığı günlük). Silinebilir.

Destek isterken: ana penceredeki kırmızı satırın ekran görüntüsü +
gunluk\ içindeki günün dosyası.


=========================================================================
15. GÜNCELLEME
=========================================================================

inPOS'ta programın dosyasına bağlı bir "hash" YOKTUR: cihaz RoxPos'u
uygulama no ile tanır. Bu yüzden her sürümde exe dahil bütün dosyalar
değişebilir ve güncellemeden sonra yeniden eşleme GEREKMEZ.

1. Simge yeşil "Hazır" iken (basılan fiş yokken) programdan çıkın:
   simge > sağ tık > Çıkış > Evet.
2. Yeni zip'teki dosyaları AYNI klasöre kopyalayıp eskilerin üstüne
   yazın (ör. C:\RoxOKCinPos).
3. RoxOKCinPos.exe'yi açın. Ayarlar, giriş ve cihaz seçimi
   C:\ProgramData\RoxOKCinPos'ta durduğu için korunur.
4. Panelde terminalin altında yeni "Program sürümü" görünür.

Başka klasöre koyarsanız: yeni exe'yi bir kez açın (Windows başlangıç
kaydı yeni yere döner) ve guvenlik-duvari-izni.bat'ı yeni klasörde
yönetici olarak yeniden çalıştırın. Eski klasörü sonra silin.

Yarım iş varken güncellenirse yeni sürüm yarım işi kaldığı yerden
sürdürür; yine de güncellemeyi yeşil ışıkta yapın.


=========================================================================
16. KALDIRMA
=========================================================================

1. Programdan çıkın (simge > sağ tık > Çıkış > Evet). Yarım fiş
   olmadığından emin olun (bölüm 12).
2. Program klasörünü silin (ör. C:\RoxOKCinPos).
3. Windows başlangıcından kaldırın: Görev Yöneticisi > Başlangıç
   uygulamaları > RoxOKCinPos > Devre dışı bırak.
4. Güvenlik duvarı izni: Yönetici komut isteminde
     netsh advfirewall firewall delete rule name="RoxOKCinPos (inPOS)"
5. İsterseniz veri klasörünü silin: C:\ProgramData\RoxOKCinPos
   (günlükler ve ayarlar gider).
6. RoxPos panelinde terminali Kablosuz (TSM) yapın ya da kaldırın.
7. Cihazdaki harici uygulama eşlemesini yetkili servis kapatabilir
   (Servis > 0.Diğer > 3.Harici Uygulamalar > 3.Uygulama Kapat).


=========================================================================
17. BİRDEN ÇOK KASA / CİHAZ, SANAL MAKİNE
=========================================================================

- Bir bilgisayarda program tek kopya çalışır ve TEK inPOS'a bakar.
- Her inPOS'un kendi kasa bilgisayarı ve programı olur. Panelde her
  terminalin "Kasa bilgisayarının IP adresi" kendi bilgisayarının IP'si
  olmalı; her cihaz kendi bilgisayarına eşlenir. Her bilgisayarda
  "Cihaz seç" ile kendi cihazını seçin.
- Bir cihaza aynı anda yalnız bir bilgisayardaki program bağlanabilir.
  İkinci bilgisayar açılırsa RoxPos onu reddeder: "Bu cihaz şu an başka
  bir bilgisayardaki programa bağlı (…). Aynı anda tek bilgisayar
  bağlanabilir; diğerinde programı kapatın."
- Fişi göndermek için programa gerek yoktur: bütün web panel ve mobil
  cihazlar aynı inPOS'a fiş gönderebilir; fişi o cihazın programı basar.
- Aynı bilgisayarda kablolu Ingenico programı (RoxOKCingenico) da
  çalışabilir.
- Sanal makine: program sanal makinedeki Windows'ta çalışabilir; ancak
  cihazın sanal makinenin IP'sine ağdan ULAŞABİLMESİ gerekir (sanal
  makinenin ağı köprü / "bridged" olmalı; paylaşımlı / NAT ağda cihaz
  ulaşamaz). Panelde ve eşlemede sanal makinenin IP'si yazılır.


=========================================================================
18. SORUN GİDERME (BELİRTİ > NEDEN > ÇÖZÜM)
=========================================================================

Programın ekranda yazdığı ileti tırnak içinde verilmiştir.

KURULUM
* "Bu bilgisayarda Microsoft Visual C++ 2010 x86 (ve 2013 x86) çalışma
  zamanı eksik" / DllNotFoundException
  > Visual C++ x86 çalışma zamanı kurulu değil.
  > "Gerekenleri kur" ya da gereksinimleri-kur.bat. x64 paketi yetmez,
    x86 gerekir.
* "Program klasöründe eksik dosya: …"
  > Zip eksik açılmış ya da antivirüs dosya silmiş.
  > Zip'i yeniden açın; bütün dosyalar aynı klasörde olmalı.
* "… bozuk ya da 32 bit değil" / "Program 64 bit çalışıyor"
  > Dosya bozuk ya da yanlış paket.
  > roxpos.com'dan yeniden indirin.
* "Program ağ sürücüsünden çalışıyor"
  > Klasör ağ paylaşımında.
  > Yerel diske (C:\RoxOKCinPos) kopyalayıp oradan çalıştırın.
* "RoxOKCinPos zaten çalışıyor (saatin yanındaki simge)."
  > Program zaten açık.
  > Saatin yanındaki simgeye çift tıklayın (Windows 11'de "^" içinde).
* "Windows bilgisayarınızı korudu"
  > Windows SmartScreen uyarısı.
  > "Ek bilgi" > "Yine de çalıştır".

ROXPOS GİRİŞİ / PANEL
* "Giriş geçersiz (şifre değişmiş ya da kullanıcı kapalı) — yeniden
  giriş yapın."
  > Şifre değişti, kullanıcı kapatıldı ya da program başka bir Windows
    kullanıcısıyla açıldı.
  > "Kullanıcıyı değiştir" ile yeniden giriş. Bu arada fiş basılmaz.
* "RoxPos'a ulaşılamıyor: …"
  > İnternet yok.
  > Bilgisayarın internetini kontrol edin; program kendisi yeniden
    dener.
* "Panelde bu şubeye tanımlı kablolu inPOS cihazı yok …"
  > Terminal Kablolu (GMP3) değil, pasif, başka şubede ya da program
    başka şubeye girmiş.
  > Panelde terminali düzeltin; programda doğru şubeyle giriş yapın.
* "Panelde N kablolu inPOS cihazı var; 'Cihaz seç' ile …"
  > Şubede birden çok kablolu inPOS var.
  > "Cihaz seç" ile bu bilgisayarınkini seçin.
* "RoxPos'ta inPOS entegrasyonu kapalı (Ayarlar → POS Entegrasyonu)."
  > Panelde inPOS kapalı.
  > Açıp kaydedin.
* "Bu cihaz şu an başka bir bilgisayardaki programa bağlı (…)"
  > Aynı cihaz için iki bilgisayarda program açık.
  > Diğer bilgisayarda programdan çıkın (bölüm 17).

CİHAZ BAĞLANTISI
* "Cihaz bekleniyor: program …:59000 adresinde dinliyor…" uzun sürüyor
  > Cihaz bilgisayara bağlanmıyor.
  > Sırayla: cihaz açık ve ağda mı (ekranda bağlantı simgesi)? Cihaz bu
    bilgisayarın IP:port'una eşlendi mi (cihazda 4.Uygulama
    Bilgileri)? Güvenlik duvarı izni verildi mi (5.5)? Bilgisayarın
    IP'si değişti mi (ipconfig)? Hepsi doğruysa "Yeniden bağlan".
* "Panelde kasa bilgisayarı olarak X:59000 yazıyor ama bu, bu
  bilgisayarın IP'si değil (bu bilgisayar: …)"
  > Panele cihazın IP'si ya da eski IP yazılmış.
  > Panele BU bilgisayarın IP'sini yazın, cihazı bu IP'ye eşleyin,
    programda "Cihaz seç" ile cihazı yeniden seçin.
* "… Bu bilgisayarın 192.168.x.x ağında IP'si yok; cihaz o ağdaysa bu
  bilgisayara ulaşamaz."
  > Bilgisayar ve cihaz farklı ağlarda (ya da sanal makine paylaşımlı
    ağda).
  > Aynı ağa alın; sanal makinede ağı köprü (bridged) yapın.
* "Panelde kasa bilgisayarının IP'si boş …"
  > Panelde IP girilmemiş.
  > Panele bu bilgisayarın IP'sini ve portu yazın.
* "GMP3 eşleme hatası (inposgmp3.exe ile yeniden eşleyin)" /
  "Uygulama doğrulanamadı (App Hash) …"
  > Eşleme bozuk ya da uygulama no uyuşmuyor.
  > Bölüm 6'daki eşlemeyi doğru uygulama no ile yeniden yapın.
* Eşleme aracında "Eşleme hatası: 1012"
  > Cihazdan 30 sn içinde veri gelmedi.
  > Önce cihazda Giriş, hemen ardından bilgisayarda Eşle; bir kez daha
    deneyin. Eşleme sırasında RoxOKCinPos kapalı olmalı.
* "Bağlanan cihazın sicil no'su X, bu bilgisayar için seçilen Y."
  > Bu bilgisayara başka bir cihaz bağlanıyor ya da yanlış cihaz
    seçili.
  > "Cihaz seç" ile doğru cihazı seçin ya da paneldeki sicil no'yu
    düzeltin.
* "Sicil no 12 karakter olmalı (…)."
  > Paneldeki sicil no yanlış yazılmış.
  > Cihaz etiketindeki S/N'yi aynen yazın.
* "Cihaz yanıt vermiyor — yeniden bağlanılıyor."
  > Kablo / ağ koptu ya da cihaz kapandı.
  > Ağı ve cihazı kontrol edin; program kendisi yeniden bağlanır.

FİŞ
* "Cihaz Z raporu (gün sonu) istiyor …"
  > Cihaz Z raporu almadan satış yapmıyor.
  > Cihazdan Z alın, fişi yeniden gönderin.
* "Cihazda kasiyer girişi yapılamadı …"
  > Cihaz kasiyer girişi ekranında ve program giriş yapamadı.
  > Cihazdan bir kasiyerle giriş yapın, fişi yeniden gönderin.
* "Cihaz … ; satış başlatılamadı. Cihazı ana menüye getirip …"
  > Cihaz bir menüde / raporda kaldı.
  > Cihazı ana menüye getirin, fişi yeniden gönderin.
* "Fiş tutarı (…) cihazın satış limitini (…) aşıyor …"
  > Fiş limiti.
  > Bölüm 10: cari + belge tipi + belge no ile gönderin.
* "inPOS kablolu bağlantıda '…' ödeme tipi yok …"
  > Havale / EFT gibi tip seçilmiş.
  > Nakit, kart ya da yemek kartı seçin.
* "Yemek kartı (…) inPOS'taki bir yemek kartı firmasıyla eşleşmedi."
  > Ödeme tipinin adında firma adı yok.
  > RoxPos'ta tipin adına firma adını yazın (ör. "Multinet").
* "… yemek kartı uygulaması bu cihazda açık değil."
  > Cihazda o firmanın uygulaması yok.
  > Cihazda açık olan bir yemek kartını seçin; uygulamayı açtırmak için
    yetkili servis / bankanız.
* "Cihazda %X KDV'li kısım yok" / "… kısım cihazda tanımlı değil"
  > Cihazın kısım tablosu ürünün KDV'sine uymuyor.
  > Cihazın kısımlarını yetkili servise düzelttirin ya da ürün grubunun
    ÖKC bölüm no'sunu / KDV'sini kontrol edin.
* "Cihaz yazıcısı hata veriyor / kağıt bitti — kağıt takın …"
  > Kağıt bitti ya da yazıcı kapağı açık.
  > Kağıt takın; fiş kaldığı yerden sürer.
* "… kart ödemesinin iadesi için kart bekliyor …"
  > Kartlı satış iptal edildi; cihaz kart iadesi için kartı istiyor.
  > Kartı cihaza okutup iadeyi tamamlayın, sonra gerekirse yeniden
    gönderin.
* "Cihazda ödemesi alınmış açık bir satış var …"
  > Cihazda elle başlatılmış ya da yarım kalmış, ödemeli satış var.
  > Satışı cihazdan tamamlayın ya da iptal edin, sonra yeniden gönderin.
* "Fişin sonucu cihazdan okunamadı … Cihazdaki son fişi kontrol edin"
  > Ödeme sırasında bağlantı koptu; sonuç kesin değil.
  > Bölüm 12 "Dikkat": son fişe bakın; basıldıysa RoxPos'ta ödendi
    olarak kapatın, basılmadıysa ödemeyi iade edip yeniden gönderin.
* RoxPos'ta "inPOS kasa programı şu an bağlı değil"
  > Program kapalı, internet yok ya da program cihaza bağlı değil.
  > Programı açın; cihaz bağlanınca sıradaki fişler basılır.

EKRAN / BAŞLANGIÇ
* Windows açıldıktan sonra pencere açılmıyor; siyah, başlıksız bir
  dikdörtgen görünüyor
  > 29.10.2026 öncesi sürümün hatası: program Windows açılışında gizli
    başlayınca penceresi çizilemiyordu. Program arka planda çalışmaya
    devam eder; yalnız pencere açılmaz.
  > Programı güncelleyin. Hemen çözüm: simge > sağ tık > Çıkış > Evet,
    sonra RoxOKCinPos.exe'yi yeniden açın. Denetim: tepsi-denemesi.bat
    (sonuç tepsi-denemesi\rapor.txt, "SONUÇ: TAMAM" görünmeli).
* Pencereler kesik ya da taşmış görünüyor (yüksek ekran ölçeği)
  > Windows ekran ölçeği (%150 / %200) ile ilgili.
  > pencere-denemesi.bat'ı çalıştırın; pencere-denemesi\ klasöründeki
    rapor.txt ve resimleri RoxPos'a gönderin. Geçici çözüm: Windows
    Ayarlar > Ekran > Ölçek'i düşürün.
* Simge görünmüyor
  > Windows 11 simgeyi "^" içine gizledi.
  > "^" içinden görev çubuğuna sürükleyin.
* Windows açılınca program başlamıyor
  > Başlangıç kaydı devre dışı, başka Windows kullanıcısıyla girildi ya
    da klasör taşındı.
  > Görev Yöneticisi > Başlangıç uygulamaları'nda RoxOKCinPos'u
    etkinleştirin; exe'yi doğru klasörden bir kez elle açın.


=========================================================================
19. DESTEK
=========================================================================

- Kurulum sayfası: https://roxpos.com/tr/destek/inpos
- RoxPos destek: panelde Yardım bölümü ya da info@roxpos.com
- Cihaz, servis girişi, kısım / KDV tablosu, kart ve yemek kartı
  uygulamaları: inPOS yetkili servisiniz.
- Gönderin: ana penceredeki satırların ekran görüntüsü,
  C:\ProgramData\RoxOKCinPos\gunluk\ içindeki günün dosyası, gerekirse
  RoxOKCinPos-kitaplik-denetimi.txt.
