Yeni nesil ÖKC entegrasyonu: fişin gerçekten kesildiğinden nasıl emin olursunuz?

Yeni nesil ödeme kaydedici cihaz (ÖKC) entegrasyonu, çoğu işletmenin "hızlı ödeme alalım" diye başlayıp "gün sonu neden tutmuyor" diye bitirdiği bir konudur. Oysa entegrasyonun asıl değeri hızda değil, mali kaydın kendiliğinden doğru oluşmasındadır.

Bu yazıda entegrasyonun nasıl kurulduğunu, hangi noktalarda kırıldığını ve doğru kurgunun ne olduğunu anlatıyoruz.

Entegre ile entegresiz arasındaki gerçek fark

Aynı ödemeyi iki şekilde alabilirsiniz:

Yan yana çalışma. Kasiyer POS programında hesabı kapatır, sonra tutarı yazarkasaya elle girer. Program cihazı, cihaz da programı bilmez. Sonuç: iki ayrı kayıt seti. Tutarlar genelde tutar, ama ürün kırılımı, iade, indirim ve iptal kayıtları tutmaz.

Entegre çalışma. Program, satırları (ürün, adet, KDV oranı, tutar) cihaza gönderir; cihaz fişi keser ve fiş numarasıyla birlikte sonucu geri döner. Program bu numarayı siparişe yazar. Artık sipariş ile mali belge arasında bire bir bağ vardır.

İkincisi kurulduğunda şu üç şey kendiliğinden düzelir: gün sonu mutabakatı, iade takibi ve KDV kırılımı.

Kritik kural: fiş kesilmeden hiçbir şey kapanmaz

Entegrasyonun tek en önemli kuralı budur ve yazılım tarafında bilinçli olarak kurulması gerekir:

Cihazdan başarı yanıtı ve geçerli bir fiş numarası dönmeden ödeme başarılı sayılmaz; sipariş kapanmaz, masa boşalmaz, adisyon yazdırılmaz.

Bu kural yoksa şu senaryo yaşanır: kasiyer ödeme alır, program "tamam" der, masa kapanır — ama cihazda fiş kesilmemiştir. Kimse fark etmez. Gün sonunda Z raporu ile sistem raporu arasında fark çıkar ve o farkın hangi masadan geldiği bulunamaz.

Nakit ödemeler için de aynı kural geçerlidir. "Nakitte fişi elle keseriz" yaklaşımı, kayıt bütünlüğünü tam da en çok ihtiyaç duyduğunuz yerde bozar.

En sık karşılaşılan üç durum

1) Müşteri cihazda işlemi iptal etti

Kart ekranında "vazgeç" denmesi normal bir durumdur; kart takılıdır, müşteri fikir değiştirir, kartı değiştirmek ister. Cihaz bunu bir hata koduyla bildirir. Doğru davranış:

• Ödeme kaydı geri alınır
• Masa açık kalır
• Kullanıcıya net mesaj verilir: "İşlem cihazda iptal edildi, tekrar deneyin."

Yanlış davranış, ödemeyi başarılı sayıp masayı kapatmaktır. İkinci yanlış ise aynı belge numarasıyla otomatik tekrar denemektir — bu, cihazda takılı kalmış bir belge varken sorunu büyütür.

2) Cihazda açık belge kalmış

Bir önceki işlem yarım kaldıysa cihaz "başka bir belge işlemde" der. Buradaki refleks genelde otomatik iptal göndermektir; yapılmamalıdır. Otomatik iptal, cihazda FİŞ İPTAL bastırır ve mali kayıtta gereksiz bir iptal belgesi oluşturur.

Doğrusu: kullanıcıya "cihazda açık belge var, cihazdan temizleyin" demek ve bir sonraki satış başlarken belgeyi düzgün biçimde açmaktır.

3) Cihaz cevap vermiyor / zaman aşımı

Bağlantı koptuğunda ya da cihaz yanıt vermediğinde en tehlikeli senaryo, işlemin gerçekte gerçekleşip gerçekleşmediğinin bilinmemesidir. Kart çekilmiş ama yanıt dönememiş olabilir. Bu durumda sistemin ödemeyi otomatik olarak "başarılı" veya "başarısız" saymaması, incelenecek olarak işaretleyip kullanıcıyı uyarması gerekir. Aksi hâlde ya çift çekim yapılır ya da tahsil edilmiş bir tutar kayda girmez.

Gün sonunda rakamlar neden tutmaz?

Fark çıkıyorsa sebep genelde şu beş başlıktan biridir:

1. Entegre olmayan satışlar. Bazı ödemeler cihaza elle girilmiştir.
2. İptal edilen ama sistemde duran ödemeler. Cihazda iptal, sistemde geri alınmamış.
3. İade kayıtları. İade, satış gibi kaydedilmiş veya hiç kaydedilmemiş.
4. KDV oranı uyuşmazlığı. Ürünün sistemdeki oranı ile cihazın departman oranı farklı.
5. Kuruş yuvarlama. Ürün toplamı ile ödeme toplamı arasında kuruş farkı oluşuyor ve cihaza gönderilen satırlar toplamı tutmuyor.

Son madde teknik ama önemli: cihaza gönderilen ürün satırlarının toplamı, alınan ödeme tutarına kuruşu kuruşuna eşit olmalıdır. Aksi hâlde cihaz belgeyi reddeder veya fişte tutarsızlık oluşur. İskonto ve servis ücreti gibi kalemler devreye girdiğinde bu hesap kolayca kayar; yazılımın satırları ödeme tutarına göre denkleştirmesi gerekir.

Departman ve KDV eşleşmesi

Yazarkasalar ürünleri departman üzerinden gruplar ve KDV oranını departmandan alır. Sisteminizdeki ürün grupları ile cihazdaki departmanlar eşleşmiyorsa, fişte yanlış KDV oranı görünür. Kurulumda yapılması gereken:

• Cihazdaki departman listesini sisteme çekmek
• Her ürün grubunu bir departmana bağlamak
• Oran değişikliklerinde (mevzuat değişir) tek yerden güncellemek

KDV oranlarını yazılımın içine sabit yazmak, oran değiştiğinde sessizce yanlış belge üretmeye başlayan bir zaman bombasıdır; oranlar tanım tablosundan okunmalıdır.

Bağlantı biçimleri ve ağ kurulumu

Cihazla program arasındaki bağlantı üç şekilde kurulur ve her birinin kendine göre zayıf noktası vardır:

• Yerel ağ (LAN): cihaz ve kasa aynı ağdadır. En yaygın kurgu. Zayıf noktası, cihaza sabit IP verilmemesidir: modem yeniden başladığında IP değişir ve entegrasyon "cihaz bulunamadı" der. Kurulumda DHCP rezervasyonu yapın.
• Seri/USB: cihaz doğrudan kasaya bağlıdır. Kararlıdır ama kasayı taşıyamazsınız ve tek kasa hizmet verir.
• Köprü uygulaması: kasadaki küçük bir yardımcı program cihazla konuşur, bulut tarafıyla güvenli kanal kurar. Bulut tabanlı sistemlerde tercih edilir; avantajı, sunucunun yerel ağa erişmesine gerek kalmamasıdır.

Hangi yöntem olursa olsun tek bir kural geçerlidir: her kasa kendi cihazına bağlı olmalı. İki kasanın tek cihazı sırayla kullanması, yoğun saatte kuyruk ve "başka belge işlemde" hataları üretir.

Zaman aşımı sürelerini doğru ayarlamak

Entegrasyonun görünmeyen ama en çok soruna yol açan ayarı, bekleme süreleridir. Zincirdeki her halkanın süresi bir öncekinden uzun olmalıdır:

Sıra bozulursa şu olur: cihaz hâlâ kartı beklerken sunucu vazgeçer, kullanıcı "başarısız" görür, sonra kart geçer ve para çekilir. Ekranla gerçek birbirini tutmaz. Süreleri artırırken hep dıştan içe doğru büyütün.

İade akışı

İade, satışın aynası olarak kurulmalıdır: satış cihaz üzerinden yapıldıysa iade de cihaz üzerinden yapılır. Kart iadesini elle yapıp sistemde iptal işaretlemek iki kayıt seti üretir.

Sistemden beklenecekler:

• İade edilecek siparişin seçilebilmesi (hangi fiş, hangi ürünler)
• Kısmi iade (10 üründen 2'si)
• İade belgesinin numarasının siparişe yazılması
• İade yetkisinin ayrı bir izinle korunması

Kurulumda kontrol listesi

• [ ] Cihaz markası ve modeli destekleniyor mu, bağlantı yöntemi ne (yerel ağ / seri / köprü uygulaması)?
• [ ] Fiş numarası siparişe yazılıyor mu? (Sipariş detayında görebiliyor musunuz?)
• [ ] Başarısız ödemede masa açık kalıyor mu?
• [ ] İade akışı cihaz üzerinden mi işliyor?
• [ ] X ve Z raporları sisteme kaydediliyor mu?
• [ ] Departman–KDV eşleşmesi yapıldı mı?
• [ ] Birden fazla kasa varsa her kasa kendi cihazına mı bağlı?

Çoklu kasa ve yazıcı yönlendirmesi

Birden fazla kasası olan işletmelerde sık görülen bir arıza, tüm adisyonların ana kasanın yazıcısından çıkmasıdır. Sebep genelde şudur: yazıcı seçimi tek bir sabit değere bağlanmıştır. Doğru kurgu, fişin işlemi yapan kasadan çıkmasıdır: açık vardiyanın kasası, o kasaya bağlı cihaz, kullanıcının varsayılan yazıcısı sırasıyla denenir.

Özet

Entegrasyon, "ödeme hızlansın" projesi değil, "mali kayıt kendiliğinden doğru oluşsun" projesidir. Doğru kurulduğunda gün sonu mutabakatı bir kontrol işine dönüşür; yanlış kurulduğunda her akşam dedektiflik yaparsınız.

PentaGusto'da ÖKC entegrasyonu bu kurallar üzerine kuruludur: fiş numarası olmadan sipariş kapanmaz, iptal senaryolarında masa açık kalır, X/Z raporları sisteme işlenir ve departman–KDV eşleşmesi cihazdan çekilerek yapılır. Kendi cihazınızla nasıl çalıştığını görmek isterseniz demo talebi bırakmanız yeterli.