Bu kılavuz, Bilnex yazılımı ile Profilo Propay (Android) ÖKC cihazının Wi-Fi üzerinden entegrasyonuna ait adımları içermektedir. Kuruluma başlamadan önce cihazınızın açık ve bilgisayarınızla aynı yerel ağa bağlı olduğundan emin olun.
1. Kurulum Sihirbazı ile Entegrasyon
Bilnex yazılımını Profilo Propay yazar kasa ile eşleştirmek için öncelikle Kurulum Sihirbazı‘nı kullanmanız gerekmektedir. Kurulum dosyalarını henüz indirmediyseniz web sitemizden indirebilirsiniz. İndirdikten sonra aşağıdaki adımları sırasıyla uygulayın:
- ÖKC Tipi: Alanından Profilo seçeneğini seçin.
- Propay (Android): Kutucuğunu işaretleyin.
- Cihaz IP: Kutucuğuna cihazın yerel IP adresini yazın (Cihaz IP’sini öğrenmek için Bölüm 2’ye bakın).
- İleri butonuna tıklayarak kurulumu başlatın. Gerekli dosyalar otomatik olarak indirilecektir. İndirme tamamlandıktan sonra tekrar İleri butonuna tıklayın.
- Son ekranda ihtiyacınıza göre isteğe bağlı seçenekleri işaretleyin ve Bitir butonuna tıklayın.

2. Cihaz Kablosuz (Wi-Fi) Ortamını Hazırlayın
Entegrasyonun sorunsuz çalışması için yazar kasa ve harici uygulamanın (Bilnex) haberleşebileceği sağlıklı bir ağ altyapısı kurulmalıdır.
- 2.1. Ağ Bağlantısı: P1000 ECR cihazını işletmenizin Wi-Fi ağına bağlayın.
- 2.2. Aynı Ağ Kontrolü: Harici uygulamanın (Bilnex) çalıştığı bilgisayarı da yazar kasanın bağlı olduğu aynı yerel ağa bağlayın.
- 2.3.İstemci İzolasyonu: Ağın istemciler arası iletişimi engellemediğini doğrulayın. Misafir ağları veya istemci izolasyonu açık erişim noktaları (Access Point), Bilnex Ökc Servis bağlantısını engelleyebilir.
- 2.4.IP Bilgisi Edinme: P1000 ECR cihazında Servis Menü > Harici Entegrasyon ekranını açın. Ekranda gösterilen yerel IP ve Port bilgisini not edin.
3. Eşleştirme Akışı
Cihaz ve servis arasındaki güvenli Entegrasyonunu sağlamak için aşağıdaki adımları takip edin:
- 3.1 Cihazda Servis Menü > Harici Entegrasyon ekranını açın. Cihaz o esnada güncel IP ve portunu gösterir.
- 3.2 Bilgisayar tarafındaki Bilnex servis arayüzü üzerinden Bağlantı/Eşleşme Başlat butonuna tıklayın.

- 3.3 Servis, cihaz tarafına otomatik olarak bir pair (eşleşme) isteği gönderir.
- 3.4 Cihaz ekranında Entegrasyon tamamlandı ekranı gösterilir.
- 3.5 İstemci (Bilnex), güvenli iletişim için bu lisans ve eşleşme bilgilerini kendi veri tabanında saklar.

4. Cihaz Üzerinde Yapılacak İşlemler ve Doğrulama
Bağlantının kalıcı olması ve satış esnasında kopmaması için cihaz arayüz ayarlarını sabitleyin:
4.1. Bağlantı Türünü Seçme
P1000 ECR cihazında Ayarlar > Ağ ve İnternet bölümünden, harici entegrasyon için kullanılacak bağlantı türünü Kablosuz kullanım için Wi-Fi olarak seçin. Bu seçimden sonra Harici Entegrasyon ekranı yalnızca seçilen arayüzün IP adresini gösterir ve Bilnex Ökc Servisi sadece bu arayüzde kararlı şekilde çalışır.
4.2. Satış ve Servis Kontrolü
- Cihaz tarafında Harici Entegrasyon tamamlandıktan sonra ana menüden Satış Ekranına geçiş yapın.
- Bilgisayar tarafında Bilnex Ökc Servisi’nin başlatılması entegrasyonun devreye girmesi için yeterlidir.

5. Sık Karşılaşılan Sorunlar ve Çözümleri
5.1 Cihaz bilgisayar tarafından tanınmıyor veya bağlantı hatası veriyor:
- Yazar kasanın ve Bilnex’in kurulu olduğu bilgisayarın aynı Wi-Fi ağına bağlı olduğunu kontrol edin.
- Cihaz üzerinde Servis Menü > Harici Entegrasyon ekranına giderek güncel IP adresini doğrulayın. Eğer IP adresi değiştiyse, Bilnex ÖKÇ kurulum adımlarından IP bilgisini güncelleyin.
- IP adresinin modem tarafından sürekli değiştirilmesini önlemek için, modem arayüzünden yazar kasanın MAC adresine Sabit (Statik) IP rezervasyonu yapın.
- Wi-Fi ağınızda Misafir Ağı kullanılıyorsa veya erişim noktasında İstemci İzolasyonu (Client Isolation) aktifse, bu özellik Bilnex ÖKÇ servis bağlantısını engeller. Ağ yöneticinizden bu ayarın kapatılmasını talep edin.
5.2 Eşleşme başlatıldığında “Entegrasyon Tamamlandı” mesajı gelmiyor:
- Cihazın eşleşme modunda olduğundan emin olun. Tokalaşma isteği göndermeden önce cihaz ekranında Servis Menü > Harici Entegrasyon sayfasının açık kalması gerekmektedir.
- Bilgisayar tarafındaki güvenlik duvarının (Windows Firewall) veya antivirüs programının yazar kasa iletişim portunu (Varsayılan: Port 3001) engellemediğinden emin olun.
5.3 Bilnex üzerinden satış gönderildiğinde yazar kasadan fiş çıkmıyor:
- Cihazın arka planda ayarlarda, servis menüsünde veya kilitli ekranda kalmadığını; aktif Satış Ekranına geçiş yapılmış olduğunu fiziksel olarak doğrulayın.
- Bilgisayarda arka planda çalışan Bilnex ÖKC Servisi uygulamasının durdurulmuş olma ihtimaline karşı Windows Görev Yöneticisi veya Servisler altından hizmeti kontrol edin, gerekirse servisi yeniden başlatın.
6. Cihaz Bilgilerini Kontrol Etme
Bağlantının sorunsuz çalıştığını doğrulamak için Swagger arayüzünü kullanabilirsiniz:
Not: Tarayıcınıza
http://ipadresiniz:9001/swagger/uiadresini yazın. Buradaki “ipadresiniz” kısmını, Bilnex’in kurulu olduğu bilgisayarın IP adresiyle değiştirin. Bu sayfa üzerinden cihaz bilgilerini görüntüleyebilir ve bağlantıyı test edebilirsiniz.
