QR Menü ve POS Entegrasyonu: Sipariş, Stok ve Fatura Uyuşmazlıklarını Önlemenin Adımları

Giriş: Neden veri eşleme ve gerçek zamanlı senkronizasyon şart?

QR menüler müşteriye hızlı erişim sağlar; ancak siparişlerin POS'a doğru yansıması, stokların güncel kalması ve faturaların muhasebeye uyumlu olması için arka planda sağlam bir veri modeli ve senkronizasyon mekanizması gerekir. Uyuşmazlıklar hem müşteri memnuniyetini zedeler hem de maddi kayıplara yol açar.

Hazırlık: Ortak veri sözlüğü oluşturun

Başlamadan önce QR menü sisteminiz ile POS arasında paylaşılan bir veri sözlüğü (data dictionary) oluşturun. Bu, tüm tarafların aynı tanımları ve alanları kullandığından emin olmanızı sağlar.

• Tekil Ürün ID'si (SKU/ItemCode): Her menü öğesinin POS'ta tam karşılığı olacak tek bir sabit kimlik (ID) olmalı.
• Fiyat ve vergi kodları: KDV oranları, servis ücreti veya yerel vergiler için POS ile aynı kodlama kullanılmalı.
• Varyant & Modifier mapping: Boyut, sos, ekleme/çıkarma gibi modifier'lar POS'taki seçeneklerle birebir eşleşmeli.
• Combo ve bileşen listesi: Set menüler veya promosyonlarda hangi SKUnun stoktan düşeceği net olmalı.

Gerçek zamanlı senkronizasyon modelleri

Gerçek zamanlı davranış; sipariş verildiği anda POS'ta görünmesi, stokların düşmesi ve faturanın oluşturulması demektir. En güvenilir yaklaşımlar şunlardır:

1. Event-driven (Webhook/WebSocket): QR menüde bir "order_created" olayı tetiklendiğinde POS'a anlık bildirim gönderilir. Bu yöntem yüksek hız ve düşük gecikme sağlar.
2. İdempotent API çağrıları: Aynı sipariş birden çok kez gönderilse bile POS'ta tek kayıt oluşmasını sağlayacak idempotency-key kullanın.
3. Durum bazlı olaylar: order_created, order_confirmed, order_paid, order_cancelled gibi olayları ayrı ayrı işleyin; faturanın ne zaman kesileceği (ödeme anı mı, servis çıkışı mı?) net olsun.
4. Fallback polling: Kısa aralıklarla (ör. 5-10 saniye) kısa polling ile anlık bağlantı kayıplarında bile tutarlılık sağlanabilir, ancak bu kaynak tüketir.

Stok yönetimi kuralları

Stok farklı noktalarda tutulabilir (depo, mutfak, şube). Stok uyuşmazlıklarını önlemek için açık kurallar belirleyin:

• Rezervasyon mantığı: Müşteri sipariş butonuna bastığında stok "rezerve" edilmeli mi yoksa sadece ödeme onayından sonra mı düşecek? Önerilen: hazırlık/sipariş alma anında rezerve, ödeme sonrası kesin düşüş.
• Reçete (BOM) tabanlı düşüş: Ürün birden fazla bileşen içeriyorsa (ör. hamburger = ekmek + köfte + sos), POS veya stok sistemi bileşen bazında düşüş yapmalı.
• Çok lokasyon ve stok havuzlama: Birden fazla mutfak/şube varsa hangi lokasyondan düşüleceği açıkça tanımlanmalı.
• Minimum stok ve otomatik uyarılar: Kritik seviyelere düştüğünde hem mutfağa hem yöneticiye uyarı gönderin.

Fatura ve muhasebe uyumu

Faturaların POS tarafında doğru şekilde üretilmesi için şu adımlar gereklidir:

• Fatura alan eşlemesi: Müşteri bilgileri, ödeme tipi, fiş numarası, vergi muafiyeti gibi alanlar POS ile tam eşleşmeli.
• Vergi ve yuvarlama politikası: Yuvarlama kuralları, vergi matrahı hesaplamaları ve indirim uygulama sırası sistemler arasında aynı olmalı.
• Fiş vs Fatura tetiklemesi: Fatura kesimi "ödeme onayı" veya "servis tamamı" gibi net bir olay ile tetiklenmeli; çift faturalandırmayı önlemek için idempotency sağlanmalı.
• Elektronik arşiv ve entegrasyon: Maliye mevzuatına uyum gerekiyorsa e-fatura/e-arşiv formatları POS tarafında otomatik oluşturulmalı.

Hata yönetimi, eşitleme ve raporlama

Gerçek dünyada hatalar kaçınılmazdır; bu yüzden otomatik onarım ve bildirim mekanizmaları kurun:

• Retry ve gecikme politikası: API çağrıları başarısız olursa arka arkaya belirli backoff stratejileri ile tekrar deneyin ve maksimum denemeden sonra ilgili personele bildirim gönderin.
• Audit log ve değişiklik geçmişi: Her sipariş, stok hareketi ve fatura üzerinde kim ne zaman işlem yaptı kaydı olmalı; böylece uyuşmazlıklar hızlıca izlenebilir.
• Gün sonu ve saatlik uzlaşma raporları: POS ile QR menü arasındaki tutarsızlıkları gösterecek reconciliation raporları oluşturun (ör. sipariş sayısı, toplam ciro, stok farkları).
• Manuel düzeltme arayüzü: Mutfak/pazarlama/finans ekiplerinin hızlıca düzeltme girebileceği, neden ve sorumlu kaydı tutan bir panel sağlayın.

Uygulama ve test kontrol listesi

1. Menü öğelerini POS SKUlaryla eşleyin ve tekil ID'leri kesinleştirin.
2. Event listesi ve tetikleme noktalarını belirleyin (order_created, paid, cancelled vb.).
3. İdempotency, versiyonlama ve timestamp kurallarını uygulayın.
4. Test ortamında uçtan uca senaryoları (ağ kesintisi, çift gönderim, stok bitmesi, iptal) deneyin.
5. Günlük uzlaşma raporlarını ve anlık uyarıları kurun.
6. Canlıya geçişte kademeli geçiş yapın ve ilk günlerde yoğun izleme/operasyon desteği sağlayın.

Bu adımlar uygulandığında QR menü ile POS arasındaki veri uyuşmazlıkları büyük ölçüde azalır, operasyonel verim artar ve müşteri deneyimi iyileşir. Entegrasyon sürecinde teknik detaylarda desteğe ihtiyaç duyarsanız, POS sağlayıcınız ve QR menü çözüm sağlayıcınızla birlikte bir eşleştirme planı çıkarmak en hızlı çözüm olur.