RestaurantManage Print Agent, buluttan yazdırma komutlarını alıp termal fiş yazıcınıza gönderen hafif bir Windows hizmetidir — siparişler ödendiğinde veya mutfak fişleri basılması gerektiğinde otomatik fiş yazdırmayı sağlar. Ajan; ağ yazıcılarını (TCP port 9100), USB yazıcıları ve Windows yazdırma kuyruğu bağlantılarını destekler. Bu rehber kurulum, yapılandırma, yazıcı bağlantısı ve sorun gidermeyi kapsar.
Fiş Yazdırma Nasıl Çalışır?
Yazdırma iş akışı tamamen otomatiktir. Kasiyer ödemeyi onayladığında veya bir mutfak fişi tetiklendiğinde, RestaurantManage backend'i restoran adı, masa numarası, kalemleştirilmiş sipariş, fiyatlar, vergi dökümü, toplam ve ödeme yöntemi dahil tam fişi ESC/POS bayt komutları olarak oluşturur. Bu baytlar güvenli bir WebSocket bağlantısı (PrintHub) üzerinden restoranınızdaki bir Windows PC'de çalışan Print Agent'a gönderilir. Ajan verileri çözer ve doğrudan bağlı termal yazıcıya iletir. Tüm süreç, ödeme onayından yazdırılmış fişe kadar iki saniyeden kısa sürer.
Print Agent Nasıl Kurulur?
- İndirin: En son Print Agent yükleyicisini yönetim panelinizden alın veya destekle iletişime geçin.
- Kurun: Servis saatleri boyunca açık kalacak bir Windows PC'de yükleyiciyi çalıştırın.
- Yapılandırın: config.json dosyasını açın ve API temel URL'nizi, restoran kimliğinizi ve ajan gizli anahtarınızı (yöneticiniz tarafından sağlanan) girin.
- Yazıcıyı bağlayın: Termal yazıcınızı USB ile takın veya PC ile aynı ağa bağlayın.
- Hizmeti başlatın: Print Agent'ı çalıştırın — otomatik olarak PrintHub'a bağlanır ve yeşil durum göstergesi görüntüler.
- Test yazdırması: Kasa panelinden bir test ödemesi işleyin ve fişin doğru yazdırıldığını doğrulayın.
Hangi Yazıcı Bağlantı Türleri Desteklenir?
Print Agent, aralarında otomatik yedekleme olan üç bağlantı yöntemini destekler. Ağ yazıcıları TCP üzerinden port 9100'de bağlanır — yapılandırmaya yazıcının IP adresini girin. Bu, birden fazla yazıcısı olan restoranlar için önerilen yöntemdir. USB yazıcılar doğrudan PC'ye bağlanır ve Windows yazdırma kuyruğu veya doğrudan USB port adresleme ile erişilir. Windows yazdırma kuyruğu standart Windows yazdırma sürücüsünü kullanır ve Windows tarafından tanınan herhangi bir yazıcıyla çalışır. Ajan önce yazdırma kuyruğunu dener, ardından doğrudan USB'ye geçer ve son olarak UNC ağ paylaşımlarını dener.
Print Agent Nasıl Yapılandırılır?
config.json dosyası üç zorunlu ayar içerir: ApiBaseUrl (RestaurantManage sunucu URL'si), RestaurantId (yönetim panelindeki restoranınızın benzersiz kimliği) ve AgentSecretKey (kullanıcı hesabı gerektirmeden yazıcı ajanını doğrulayan, yönetim panelinde oluşturulan gizli anahtar). Ajan, bu gizli anahtarı kullanarak WebSocket üzerinden PrintHub ile kimlik doğrulaması yapar. Ağ yazıcıları için yapılandırmaya yazıcı IP'sini ve portunu ekleyin. Ajan, sorun giderme için tüm etkinlikleri logs/ klasörüne kaydeder.
Otomatik Güncelleme Nasıl Çalışır?
Print Agent, RestaurantManage sunucusundaki güncelleme uç noktasını yaklaşık her 2,5 saatte bir kontrol eder. Yeni bir sürüm mevcutsa güncelleme paketini ZIP dosyası olarak bekleyen güncellemeler klasörüne indirir, kurulum betiğini çalıştırır ve hizmeti otomatik olarak yeniden başlatır. Bu, restoranınızın manuel müdahale olmadan her zaman en son sürümü çalıştırması anlamına gelir. Güncelleme kontrolleri, tüm ajanların aynı anda güncellenmesini önlemek için restoran başına zamanlama jitter'ı içerir. Mevcut ajan sürümünü yönetim panelinde görebilirsiniz.
Yaygın Sorunları Giderme
- Ajan bağlanmıyor: config.json dosyasındaki ApiBaseUrl ve AgentSecretKey değerlerinin doğru olduğunu kontrol edin. PC'deki internet erişimini doğrulayın.
- Fiş yazdırılmıyor: Yazıcının açık ve bağlı olduğunu onaylayın. Hata detayları için logs/ klasörünü kontrol edin.
- Fişte bozuk metin: Yazıcınızın ESC/POS komutlarını desteklediğinden emin olun. Çoğu 80mm termal yazıcı uyumludur.
- Bağlantı sık kopuyor: Ajan otomatik yeniden bağlanır, ancak ağ kararlılığınızı kontrol edin. Kablolu Ethernet bağlantısı Wi-Fi'den daha güvenilirdir.
- Ajan hizmet olarak başlamıyor: Windows hizmetini düzgün kaydetmek için install-service.bat dosyasını Yönetici olarak çalıştırın.
İlgili Rehberler
- Kasa paneli: Fiş yazdırmayı tetikleyen ödemelerin nasıl işlendiği
- Mutfak ekranı: Mutfak fişi yazdırmanın sipariş akışıyla nasıl entegre olduğu
- Hızlı başlangıç: Kayıttan ilk siparişe kadar tam kurulum rehberi
Restoraninizi Dijitallestirmeye Hazir misiniz?
RestaurantManage ile ucretsiz QR menunuzu 10 dakikada kurun.
Ucretsiz Basla →