QR Menü POS ve Kasa Entegrasyonu (REST API)

QR menü POS entegrasyonu, dijital menünüzün kasa veya POS yazılımınızla aynı ürün, fiyat ve sipariş verisini paylaşmasıdır. Entegrasyon olmadan fiyatı iki yerde ayrı ayrı güncellemek ve QR menüden gelen siparişi kasaya elle girmek gerekir. QuarkMenu, bu çift işi ortadan kaldırmak için standart bir REST API sunar.

API ile neler senkronize edilir?

Veri	Neler yapılabilir?
Kategoriler	Listeleme, oluşturma, güncelleme, silme
Ürünler	Ad, açıklama, fiyat, görsel, aktif/pasif, stokta/tükendi, sıralama ve kategori bilgisini oluşturma ve güncelleme
Masalar	Listeleme, oluşturma, güncelleme, silme
Siparişler	Yeni siparişleri zamana ve duruma göre çekme, sipariş durumunu ve notunu güncelleme

Bu sayede tipik bir senaryoda fiyatı yalnızca POS'ta değiştirirsiniz, POS değişikliği API ile QuarkMenu'ye gönderir ve QR menünüz güncellenir. Ters yönde ise misafirin masadan verdiği sipariş POS tarafından çekilir; ödeme alındığında POS siparişi QuarkMenu'de de ödendi olarak işaretler.

Harici ID: Kayıtları iki sistemde eşleştirmek

Entegrasyonların en sık bozulduğu yer, aynı ürünün iki sistemde farklı kimliklerle tutulmasıdır. QuarkMenu her ürün, kategori ve masa için bir harici ID alanı tutar. POS'unuzdaki ürün kodunu harici ID olarak gönderdiğinizde:

• Bu koda sahip bir kayıt yoksa yeni kayıt oluşturulur.
• Varsa mevcut kayıt güncellenir, kopya oluşmaz.
• Tek bir kaydı okurken veya güncellerken QuarkMenu kimliği yerine doğrudan POS kodunuzu kullanabilirsiniz.

Ürünler, kategorilerine de kategorinin harici ID'si üzerinden bağlanır. Böylece POS'taki menü yapınız QR menüye birebir taşınır.

Güvenlik

API'ye her istek, yönetim panelinden oluşturduğunuz bir API anahtarı ile yapılır. Anahtar veritabanında açık metin olarak tutulmaz; özetlenmiş (hash) haliyle saklanır ve her restoran yalnızca kendi verisine erişir. Bir anahtarın sızdığından şüphelenirseniz panelden anahtarı yenilersiniz; yeni anahtar eskisinin yerini alır.

Fiş yazıcısı için entegrasyon şart mı?

Hayır. Yalnızca siparişlerin fişini basmak istiyorsanız API'ye ihtiyacınız yoktur: QuarkMenu siparişleri doğrudan 80mm termal fiş formatında yazdırır. Ayrıntılar için masadan sipariş sayfamıza bakın. API, kasa yazılımınızla tam veri senkronizasyonu istediğinizde devreye girer.

Neden QuarkMenu?

QuarkMenu'nün arkasındaki ekip, QR Yazılım çatısı altında 1999'dan beri kasa, adisyon ve hızlı satış yazılımları geliştiriyor. QR menüyü kasadan bağımsız bir "vitrin" olarak değil, işletmenin satış akışının bir parçası olarak tasarlamamızın nedeni bu. Entegrasyon ihtiyacınızı ekibimizle paylaşın, yazılımınıza uygun akışı birlikte planlayalım.

Entegrasyon nasıl planlanır?

1. İhtiyacı netleştirin. Yalnızca fiyatları mı senkronize etmek istiyorsunuz, yoksa siparişlerin de kasaya düşmesini mi? Tek yönlü bir fiyat senkronizasyonu çok daha hızlı devreye alınır.
2. Ürün kodlarını hazırlayın. POS yazılımınızdaki ürün ve kategori kodları harici ID olarak kullanılacağı için kodların benzersiz olduğundan emin olun.
3. API anahtarını oluşturun. Yönetim panelindeki API ekranından anahtarınızı alın ve yalnızca entegrasyonu yapacak kişiyle paylaşın.
4. Bağlantıyı test edin. API'nin bağlantı kontrol uç noktasıyla anahtarın çalıştığını doğrulayın, ardından birkaç ürünle deneme senkronizasyonu yapın.
5. Sipariş akışını kurgulayın. POS yazılımınızın yeni siparişleri hangi aralıklarla çekeceğini ve ödeme alındığında durumu nasıl geri bildireceğini belirleyin.