Yeni nesil ÖKC POS entegrasyonu, adisyon bilgisinin POS'tan yazarkasaya aktarılıp mali fişin otomatik kesilmesidir. GMP-3 protokolü, kablolu veya kablosuz bağlantı ve TSM üzerinden çalışır. vRest gibi sistemler sepeti cihaza gönderip fiş sonucunu geri alır.
Restoran ve kafelerde adisyonun kapatılması ile mali fişin basılması çoğu zaman iki ayrı işlem olarak yürür: garson POS yazılımında hesabı kapatır, kasiyer aynı tutarı tekrar yazarkasaya elle girer. Yeni nesil ÖKC POS entegrasyonu tam olarak bu çift girişi ortadan kaldırmak için vardır. Bu rehberde, adisyon bilgisinin POS yazılımından yeni nesil ÖKC'ye nasıl aktarıldığını, GMP-3 protokolünün rolünü, TSM kavramını, kablolu/kablosuz bağlantı farklarını ve entegrasyon adımlarını teknik ama anlaşılır biçimde ele alıyoruz.
Not: ÖKC'nin ne olduğunu, klasik POS'tan farkını ve yasal arka planını ayrıntılı anlattığımız Yeni Nesil ÖKC Nedir ve POS'tan Farkı yazısını henüz okumadıysanız, temel kavramlar için önce ona göz atmanızı öneririz. Bu yazı, iki sistemin birbiriyle konuşmasına odaklanır.
Yeni Nesil ÖKC Entegrasyonu Nedir ve Neden Gerekli?
Yeni nesil ÖKC (Ödeme Kaydedici Cihaz), GİB (Gelir İdaresi Başkanlığı) onaylı, mali hafıza içeren ve sattığınız ürünleri vergi dairesine raporlayabilen elektronik yazarkasadır. POS yazılımı ise siparişi alan, masayı/adisyonu yöneten, mutfağa fiş gönderen ve raporlama yapan işletme yazılımıdır.
ÖKC entegrasyonu, bu iki sistemin birbiriyle veri alışverişi yapmasıdır. Pratikte şu anlama gelir: Garson POS'ta adisyonu kapattığında, ürün satırları ve ödeme bilgisi otomatik olarak ÖKC'ye iletilir ve mali fiş orada basılır. Kasiyerin tutarı ikinci kez girmesine gerek kalmaz.
Entegrasyonun gerekli olmasının başlıca nedenleri:
- ✅ Mevzuat uyumu: Perakende satışta mali belge (mali fiş/fatura) düzenlenmesi yasal zorunluluktur. Entegrasyon bu belgenin doğru ve eksiksiz üretilmesini kolaylaştırır.
- ✅ Çift veri girişi yok: Aynı satış bir kez POS'a, bir kez yazarkasaya girilmez. İşlem süresi kısalır.
- ✅ Hata azalması: Manuel girişte oluşan tutar/ürün/KDV hataları ciddi ölçüde düşer.
- ⚠️ Gün sonu mutabakatı: POS satış raporu ile ÖKC'nin Z raporunun tutması, vergi açısından önemlidir; entegrasyon bu mutabakatı kolaylaştırır.
vRest POS, yeni nesil ÖKC'lerle entegre çalışacak şekilde geliştirilmektedir: adisyon kapatıldığında ödeme ve fiş bilgisi ÖKC'ye iletilerek mali fiş bastırılır. Diğer entegrasyon yetenekleri için Entegrasyonlar sayfasına bakabilirsiniz.
GİB ve Mali Fiş Zorunluluğu
Türkiye'de perakende mal ve hizmet satışında, satışın mali bir belgeyle kayıt altına alınması esastır. Yeni nesil ÖKC'ler bu kaydı mali fiş olarak üretir; cihazın mali hafızasına işler ve gün sonunda Z raporu ile özetlenir.
Buradaki kritik nokta şudur: Mali fişi yalnızca GİB onaylı, mali aktivasyonu yapılmış ÖKC basabilir. Bir POS yazılımı tek başına mali fiş üretemez — yalnızca bilgi fişi / adisyon çıktısı verebilir. Bu nedenle:
| Belge türü | Kim üretir? | Mali geçerliliği |
|---|---|---|
| Adisyon / hesap fişi | POS yazılımı / yazıcı | ❌ Mali değildir |
| Mutfak fişi | POS yazılımı / mutfak yazıcısı | ❌ Mali değildir |
| Mali fiş | Yeni nesil ÖKC | ✅ Mali belgedir |
| e-Arşiv / e-Fatura | ÖKC veya entegratör | ✅ Mali belgedir |
Bu ayrım, entegrasyonun neden önemli olduğunu da açıklar: POS adisyonu kapattığında, satışın mali tarafı mutlaka ÖKC üzerinden geçmelidir. e-Belge tarafının nasıl işlediğini merak ediyorsanız Restoranlar için e-Fatura Rehberi yazımız konuyu ayrıntılı ele alıyor.
GMP-3 ile POS-ÖKC Haberleşmesi
POS yazılımı ile yeni nesil ÖKC'nin "aynı dili konuşması" rastgele değildir; GİB tarafından tanımlanmış bir protokol üzerinden gerçekleşir. Bu protokol GMP-3 (GİB Mesajlaşma Protokolü, sürüm 3) olarak bilinir.
GMP-3, harici bir uygulamanın (yani POS yazılımının) yeni nesil ÖKC'ye standart bir mesaj yapısıyla komut göndermesini ve cihazdan yanıt almasını tanımlar. Temel amaç, farklı ÖKC markaları arasında ortak bir arayüz sağlamaktır; böylece POS yazılımı her marka için sıfırdan farklı bir protokol yazmak yerine, standart mesajları kullanabilir.
GMP-3 ile tipik bir satış akışı
Bir adisyonun kapatılmasında haberleşme genellikle şu mantıkla ilerler:
- POS, ÖKC'nin durumunu sorar (hazır mı, başka işlem var mı?).
- POS, satış satırlarını (ürün adı, adet, birim fiyat, KDV oranı) ÖKC'ye iletir.
- ÖKC, satışı mali hafızaya işler ve ödeme aşamasına geçer.
- Banka POS'u entegre cihazlarda ödeme (nakit/kart) de bu akışta yürütülür.
- ÖKC, mali fişi basar ve POS'a sonuç mesajı (başarılı/başarısız, fiş no, mali bilgiler) döner.
- POS, dönen sonucu adisyon kaydına yazar; gün sonu mutabakatı için saklar.
| GMP-3 mesaj tipi (örnek mantık) | Yön | Amaç |
|---|---|---|
| Durum sorgusu | POS → ÖKC | Cihazın işleme hazır olduğunu doğrulama |
| Satış / fiş açma | POS → ÖKC | Ürün satırlarını ve tutarı iletme |
| Ödeme talebi | POS → ÖKC | Nakit/kart ödemeyi başlatma |
| Fiş kapatma | POS → ÖKC | Mali fişin basılması |
| Sonuç / yanıt | ÖKC → POS | İşlem sonucu, fiş no, hata kodu |
⚠️ Yukarıdaki mesaj adları kavramsal örnektir; gerçek mesaj alanları, kodlama biçimi ve hata kodları GMP-3 dokümantasyonuna ve cihaz üreticisinin sürümüne göre değişebilir. Entegrasyon geliştirirken her zaman ilgili üreticinin güncel teknik dokümanını esas alın.
gmp3 entegrasyonu, doğru kurulduğunda POS ile ÖKC'yi tek bir akışta birleştirir ve kasiyerin manuel müdahalesini en aza indirir.
TSM Nedir?
Yeni nesil ÖKC'ler yalnızca birer yazarkasa değil; aynı zamanda banka ödeme uygulamalarını ve güvenlik sertifikalarını barındıran cihazlardır. Bu cihazlardaki uygulamaların güvenli biçimde yüklenmesi, güncellenmesi ve yönetilmesi gerekir. İşte TSM (Trusted Service Manager — Güvenilir Hizmet Yöneticisi) bu işi yapar.
TSM, sadeleştirilmiş bir ifadeyle, ÖKC üzerindeki banka ödeme uygulamalarının ve güvenlik bileşenlerinin uzaktan, güvenli ve yetkili biçimde yönetilmesini sağlayan altyapıdır. Pratikte işletmeyi şu noktalarda ilgilendirir:
- Banka uygulamalarının cihaza yüklenmesi: Hangi bankaların POS uygulamalarının cihazda çalışacağı TSM üzerinden tanımlanır.
- Güncellemeler: Uygulama ve güvenlik güncellemeleri merkezi olarak iletilir.
- Banka anlaşması bağımlılığı: ⚠️ Cihazda hangi bankaların çalışabileceği, modele ve bankalarla yapılan anlaşmalara göre değişir. Bu nedenle "her cihaz her banka ile çalışır" demek doğru olmaz.
TSM, doğrudan POS yazılımının yazdığı bir bileşen değildir; cihaz/banka tarafında işler. Ancak entegrasyonun ödeme ayağının sorunsuz çalışması için TSM yapılandırmasının tamamlanmış olması gerekir.
Kablolu mu Kablosuz mu? ÖKC Bağlantı Türleri
POS yazılımının çalıştığı cihaz (PC, tablet, Android kasa vb.) ile ÖKC arasındaki ökc bağlantısı farklı yöntemlerle kurulabilir. Bağlantı türü; restoranın yerleşimine, garsonun masada mı yoksa kasada mı tahsilat yaptığına ve cihaz modeline göre seçilir.
| Bağlantı türü | Tipik kullanım | Artıları | Dikkat edilecekler |
|---|---|---|---|
| Kablolu (USB/Ethernet) | Sabit kasa noktası | ✅ Kararlı, kesintisiz; ✅ ek pil derdi yok | ⚠️ Cihaz masaya taşınamaz; kablo düzeni gerekir |
| Kablosuz (Wi-Fi) | Aynı ağdaki sabit/yarı sabit cihazlar | ✅ Kablo karmaşası yok; ✅ esnek konum | ⚠️ Ağ kalitesine bağımlı; sağlam Wi-Fi şart |
| Mobil/hücresel (SIM'li el tipi) | Masada tahsilat, açık alan/teras | ✅ Garson masaya götürür; ✅ taşınabilir | ⚠️ Pil ve kapsama yönetimi; modele göre değişir |
Pratik öneriler:
- Yoğun ve sabit bir kasa noktanız varsa kablolu bağlantı en kararlı seçimdir.
- Garsonun adisyonu masada kapattığı bir akış kuruyorsanız, taşınabilir (mobil/Wi-Fi) ÖKC daha uygundur.
- Hangi bağlantının destekleneceği cihaz modeline göre değişir; bir cihaz hem kablolu hem kablosuz destekleyebilir veya yalnızca birini destekleyebilir.
POS tarafının bu senaryolara nasıl uyum sağladığını POS Sistemi sayfasında inceleyebilirsiniz.
Entegrasyon Adımları: Eşleştirme, Test, Mali Aktivasyon
Yeni nesil ÖKC POS entegrasyonu tek seferlik bir kurulumdan ziyade, sırayla ilerleyen birkaç aşamadan oluşur. Sıralama üreticiye göre küçük farklar gösterse de genel mantık şudur:
1. Ön hazırlık ve cihaz tespiti
ÖKC'nin marka/model bilgisi, desteklediği GMP sürümü ve bağlantı türü belirlenir. POS yazılımının bu model ve protokol sürümünü desteklediği doğrulanır.
2. Bağlantı ve eşleştirme
POS'un çalıştığı cihaz ile ÖKC fiziksel/ağ olarak bağlanır (USB, Ethernet, Wi-Fi). Ardından POS yazılımında ÖKC tanımlanır: bağlantı parametreleri girilir, cihaz eşleştirilir ve ilk durum sorgusu ile iletişim doğrulanır.
3. KDV ve ürün eşlemesi
POS'taki ürünlerin KDV oranları ile ÖKC'nin departman/KDV grupları eşlenir. ⚠️ Bu adım sık atlanır ve en kritik adımlardan biridir; yanlış KDV eşlemesi mali fişin hatalı çıkmasına ve mutabakat sorunlarına yol açar.
4. Test (mali olmayan) ortamda deneme
Mali aktivasyondan önce, test/eğitim modunda örnek satışlar yapılarak akış sınanır: satış iletimi, ödeme, fiş basımı ve POS'a dönen sonuç mesajları kontrol edilir.
5. Mali aktivasyon
Cihaz, yetkili servis/üretici tarafından mali olarak aktive edilir. Bu aşamadan sonra basılan fişler mali geçerlilik taşır. ⚠️ Mali aktivasyon ve cihazın kuruluş bildirimleri yetkili kişiler tarafından, mevzuata uygun yapılmalıdır.
6. Canlıya alma ve mutabakat
Gerçek satışlara geçilir. İlk günlerde POS satış raporu ile ÖKC Z raporunun tutup tutmadığı düzenli kontrol edilir.
Desteklenen ÖKC Markaları ve Modelleri
Türkiye pazarında yaygın olarak kullanılan birkaç ÖKC markası ve banka onaylı cihaz ailesi vardır. Piyasada sık karşılaşılan modeller arasında Beko/Token tarafında 300TR ve X30TR gibi cihazlar; ayrıca Hugin, Ingenico, Verifone, Profilo gibi üreticilerin yeni nesil ÖKC modelleri bulunur.
Marka/model seçiminde önemli olan birkaç başlık:
- GMP-3 desteği: Cihazın harici POS uygulaması ile haberleşme için GMP-3'ü desteklediğinden emin olun.
- Banka onayı ve TSM: Çalışmak istediğiniz bankaların o modelde banka onaylı ÖKC olarak desteklenip desteklenmediği önemlidir; bu, modele ve banka anlaşmasına göre değişir.
- Bağlantı türü: İşletme akışınıza uygun kablolu/kablosuz/mobil seçeneği sunması.
- Yetkili servis ve süreklilik: Mali aktivasyon, arıza ve güncelleme için yetkili servis erişimi.
⚠️ Burada anılan model isimleri yaygın örneklerdir; belirli bir POS yazılımının hangi marka/modellerle entegre çalıştığı, ilgili üretici sürümüne ve yapılan testlere bağlıdır. Kesin uyumluluk için tedarikçinizden güncel desteklenen cihaz listesini isteyin.
Entegrasyonun Avantajları
Doğru kurulmuş bir yazarkasa POS entegrasyonu, işletmeye somut faydalar sağlar:
- ✅ Adisyon → ÖKC otomasyonu: Adisyon kapanınca satış ve ödeme bilgisi ÖKC'ye otomatik gider; kasiyer tutarı ikinci kez girmez.
- ✅ Hata azalması: Tutar, KDV ve ürün hataları manuel girişe göre belirgin biçimde düşer.
- ✅ Hızlı tahsilat: Özellikle masada tahsilatta sıra ve bekleme azalır.
- ✅ Gün sonu kolaylığı: POS raporu ile ÖKC Z raporu karşılaştırması basitleşir; mutabakat hızlanır.
- ✅ Tek ekranda ödeme: Banka POS'u olan ÖKC'lerde ödeme ve mali fiş tek cihazda birleşir; ek cihaz/karmaşa azalır.
- ✅ İzlenebilirlik: Her adisyona dönen ÖKC sonucu (fiş no, durum) kaydedildiğinde, sorun yaşandığında geriye dönük takip kolaylaşır.
Sık Yapılan Hatalar
Entegrasyon projelerinde tekrar tekrar görülen hatalar şunlardır:
- ⚠️ Yanlış KDV/departman eşlemesi: En sık görülen ve en maliyetli hatadır; mali fişin yanlış çıkmasına yol açar.
- ⚠️ Mali aktivasyon öncesi canlıya geçmek: Test akışı tamamlanmadan gerçek satışa başlamak, hatalı belgelere neden olabilir.
- ⚠️ Bağlantı kararlılığını test etmemek: Özellikle Wi-Fi'da zayıf sinyal, yoğun saatte fiş basımının takılmasına yol açar.
- ⚠️ Banka uyumluluğunu varsaymak: Cihazın hangi bankalarla çalışacağı modele ve anlaşmaya bağlıdır; baştan doğrulanmalıdır.
- ⚠️ Mutabakatı ihmal etmek: POS ve ÖKC raporlarının tutup tutmadığı düzenli kontrol edilmezse, hatalar ay sonunda büyür.
- ⚠️ ÖKC yanıtını yok saymak: POS, ÖKC'den dönen hata kodunu işlemezse, başarısız bir fiş başarılı sanılabilir.
Sık Sorulan Sorular (SSS)
ÖKC entegrasyonu zorunlu mu?
Mali belge düzenlemek yasal bir zorunluluktur ve perakende satışta mali fiş genellikle yeni nesil ÖKC ile basılır. Entegrasyonun kendisi (POS'un ÖKC ile otomatik konuşması) yasal zorunluluk değil, operasyonel bir kolaylıktır; ancak çift veri girişini ve hataları ortadan kaldırdığı için pratikte büyük fayda sağlar.
POS yazılımı mali fiş basabilir mi?
Hayır. POS yazılımı tek başına yalnızca adisyon/bilgi fişi üretebilir; bunlar mali belge değildir. Mali fişi yalnızca GİB onaylı, mali aktivasyonu yapılmış yeni nesil ÖKC basabilir. Entegrasyonun amacı, satışın mali tarafını ÖKC üzerinden geçirmektir.
GMP-3 nedir, neden önemli?
GMP-3, GİB tarafından tanımlanan ve harici uygulamaların (POS yazılımı) yeni nesil ÖKC ile standart biçimde haberleşmesini sağlayan mesajlaşma protokolüdür. Önemi, farklı ÖKC markaları arasında ortak bir arayüz sunması ve böylece POS yazılımının her cihaz için sıfırdan protokol yazmadan entegre olabilmesidir.
TSM tam olarak ne işe yarar?
TSM (Trusted Service Manager), ÖKC üzerindeki banka ödeme uygulamalarının ve güvenlik bileşenlerinin güvenli biçimde yüklenmesini, güncellenmesini ve yönetilmesini sağlayan altyapıdır. Ödeme ayağının doğru çalışması için TSM yapılandırmasının tamamlanmış olması gerekir; ayrıntıları cihaz/banka tarafı yürütür.
Kablolu bağlantı mı kablosuz bağlantı mı daha iyi?
İşletme akışınıza bağlıdır. Sabit bir kasa noktası için kablolu bağlantı en kararlı seçimdir. Garsonun masada tahsilat yaptığı senaryolarda mobil/Wi-Fi destekli taşınabilir ÖKC daha uygundur. Hangi bağlantı türlerinin destekleneceği cihaz modeline göre değişir.
Banka POS'u olan ÖKC ile ayrı banka POS cihazı arasındaki fark nedir?
Banka POS'u entegre (banka onaylı) ÖKC'de hem kart ödemesi hem mali fiş tek cihazda yürür; ek bir POS cihazı taşımanıza gerek kalmaz. Ayrı banka POS cihazı kullanıldığında ödeme ve fiş iki ayrı cihazda gerçekleşir. Hangi cihazda hangi bankaların çalışacağı modele ve banka anlaşmasına göre değişir.
Entegrasyon kaç günde tamamlanır?
Net bir süre vermek doğru olmaz; cihaz modeli, banka/TSM yapılandırması, KDV eşlemesinin karmaşıklığı ve mali aktivasyon süreçlerine göre değişir. Genellikle bağlantı ve eşleştirme kısa sürerken, banka onayı ve mali aktivasyon gibi üçüncü taraf adımları takvimi belirler.
vRest hangi ÖKC'lerle çalışıyor?
vRest POS, yeni nesil ÖKC'lerle entegre çalışacak şekilde geliştirilmektedir; adisyon kapatıldığında ödeme ve fiş bilgisi ÖKC'ye iletilerek mali fiş bastırılır. Belirli marka/model uyumluluğu ilgili sürüm ve testlere bağlı olduğundan, güncel desteklenen cihaz listesi için demo talebi üzerinden ekibimizle iletişime geçmenizi öneririz.
vRest ile Entegre ÖKC Akışına Geçin
Yeni nesil ÖKC entegrasyonu, doğru kurulduğunda adisyondan mali fişe uzanan tüm akışı tek bir otomatik sürece dönüştürür: çift giriş biter, hatalar azalır, gün sonu mutabakatı kolaylaşır.
vRest POS'un ÖKC ve diğer entegrasyon yeteneklerini canlı görmek için ücretsiz demo talebinde bulunabilir, uygun paketleri karşılaştırmak için fiyatlar sayfamızı inceleyebilirsiniz.
