Yazar Kasa POS (ÖKC) Entegrasyonu Nasıl Çalışır?

12 Mayıs 2026 · 6 dk okuma · DemPro Yazılım

Mali fişin kasadan basılması için yazılımın cihazla konuşması gerekir. Bu yazıda entegrasyonun nasıl kurulduğunu sade dille anlatıyoruz.

Türkiye'de perakende ve yeme-içme işletmeleri yeni nesil ödeme kaydedici cihaz (ÖKC) kullanır. Bu cihazlar hem kart ödemesi alır hem mali fiş keser. Restoran yazılımınızın bu cihazla konuşabilmesi, kasadaki iş akışını ikiye bölmemek için önemlidir.

Entegrasyon olmazsa ne olur?

Kasiyer siparişi yazılıma girer, tutarı bir de ÖKC cihazına elle yazar. İki ayrı işlem demek, iki kat süre ve yanlış tutar riski demektir. Gün sonunda yazılımın raporu ile Z raporunun tutmaması da buradan kaynaklanır.

GMP-3 nedir?

GMP-3, Gelir İdaresi Başkanlığı'nın yayımladığı, ÖKC ile harici yazılımların haberleşmesini tanımlayan protokoldür. Yazılım, satış bilgisini bu protokole uygun bir mesaj hâline getirir ve cihaza iletir; cihaz mali fişi keser, mali fiş numarasını geri döner.

Protokolün çerçevesi ortaktır (mesajın başlangıç/bitiş işaretleri, doğrulama baytı, onay/ret yanıtları); komut ve alan tabloları ise markadan markaya değişir ve üretici dokümanıyla paylaşılır. Bu yüzden ciddi bir yazılım, marka bilgilerini koda gömmek yerine cihaz profili olarak tanımlanabilir hâle getirir.

Entegrasyon adımları

1. Doküman: bayinizden cihazın entegrasyon dokümanını isteyin.
2. Bağlantı: cihaz Ethernet/Wi-Fi (TCP), USB-seri ya da kendi yerel servisi üzerinden bağlanır.
3. Profil tanımı: mesaj çerçevesi, satış komutunun alan sırası, KDV departman kodları ve ödeme türü kodları tanımlanır.
4. Test: önce tek bir fişle deneme yapılır; yazılımın cihaza gönderdiği gövde ekranda görülebilmelidir.
5. Saha testi: gün boyu çalıştırılır, Z raporu karşılaştırılır.

Bayinizden isteyeceğiniz liste

Tek cümlede: mesaj çerçevesi ve doğrulama tanımı, satış (mali fiş) komutunun alan sırası, KDV departman kodları, ödeme türü kodları, yanıt mesajındaki mali fiş ve Z numarası alanları, hata kodları, bağlantı bilgisi (TCP portu ya da seri port ayarı).

Sık yapılan hatalar

• Tutar yuvarlama farkı: satır toplamı ile genel toplam kuruş bazında tutmazsa cihaz belgeyi reddeder. Yazılım bunu göndermeden önce kontrol etmelidir.
• Türkçe karakter: fiş yazıcılarında kod sayfası ayarı yapılmazsa ürün adları bozulur.
• Kuyruk olmaması: cihaz meşgulse iş kaybolmamalı, kuyrukta beklemeli ve yeniden denenmelidir.
• Kayıt tutulmaması: cihaza giden ve cihazdan gelen mesajlar saklanmazsa sorun çıktığında kimse nedenini bulamaz.