Otelim · KBS entegrasyonu

Mevzuat · KBS

KBS entegrasyonu nasıl yapılır?

"Programımız KBS'ye entegre" cümlesi dört farklı şey anlatabilir ve bunların yalnız biri gerçek bir resmî bağlantıdır. Tesisiniz Emniyet'e mi Jandarma'ya mı bağlı, bu soru her şeyi değiştirir. Aşağıda iki tarafın bugünkü durumu, piyasadaki dört yöntem, her birinin nerede kırıldığı ve teklif alırken sorulacak sorular var.

Önce kısa cevap

Emniyet KBS (polis bölgesi)Jandarma KBS (jandarma bölgesi)
Resmî web servisiTesis yazılımlarına açık, belgelenmiş bir servis yokVar; tesis kodu ve web servis yetkisiyle
Otomasyon nasıl yapılıyorPortal ekranlarını tarayıcı eklentisi ya da masaüstü programla sürerekProgramdan servise doğrudan çağrı
Otelde açık bilgisayar gerekir miEvet, otomasyon o makinede çalışırHayır, sunucudan da yapılabilir
Elle yedek yolPortal ekranı ve toplu yükleme dosyasıPortal ekranı

Yani "KBS entegrasyonu" sorusunun cevabı tesisinizin adresine göre değişir. Hangi birime bağlı olduğunuzu bilmiyorsanız KBS kullanıcı kodunuzu size veren birime bakın: karakol ya da ilçe emniyet ise Emniyet, jandarma karakolu ise Jandarma.

Emniyet tarafında neden "gerçek" entegrasyon yok?

Emniyet Genel Müdürlüğü'nün KBS sayfası tesis yetkilisine tek bir yol tarif ediyor: bağlı olduğunuz güvenlik birimine kaydınızı yaptırırsınız ve bildirimlerinizi portal üzerinden yaparsınız. Yazılım firmalarının bağlanabileceği bir servis adresi, teknik doküman ya da başvuru usulü yayımlanmış değil.

Üstüne portalın üç özelliği sunucudan doğrudan bildirimi pratikte imkânsız kılıyor:

  1. İki aşamalı giriş. Portal girişte, telefonla eşlenmiş bir uygulamanın ürettiği tek kullanımlık kodu istiyor. Kod kısa sürede yenileniyor; başında kimsenin olmadığı bir sunucu bu kodu kendi başına giremez.
  2. IP kısıtı. İl emniyet müdürlüklerinin başvuru belgelerine göre sabit IP'si tanımlanmayan tesis sisteme giremiyor; portal Türkiye dışındaki adreslerden de açılmıyor. Yurt dışındaki bir bulut sunucusundan gelen istek daha kapıda kalır.
  3. Belgelenmiş arayüz yok. Bağlanılacak bir adres olmadığı için yapılan her otomasyon, portalın insan için tasarlanmış ekranlarını taklit eder. Ekran değişince otomasyon sessizce kırılır.

Bunu yazılım firmaları da söylüyor. Emniyet tarafını otomatikleştiren yaygın otel programlarının kendi kurulum kılavuzları, KBS'nin entegrasyon desteği sunmadığını ve işlemlerin kullanıcının elle yapacağı adımların tekrarlanmasıyla yürüdüğünü açıkça yazıyor. Kılavuzlar ayrıca resepsiyonun bildirilmeyen kayıtları her gün kontrol etmesini istiyor; yükümlülük otomasyon olsa da tesiste kalıyor.

Jandarma tarafı: resmî servis ve web servis yetkisi

Jandarma bölgesindeki tesisler için durum farklı. Jandarma'nın kimlik bildirim sistemi, yazılımların doğrudan çağırabileceği bir web servisi sunuyor. Bunun için tesis adına üç şey gerekir:

  • Tesisin Jandarma KBS tesis kodu,
  • bağlı olunan jandarma biriminden alınan web servis yetkisi ve bu yetkiye ait şifre,
  • tesis yetkilisinin T.C. kimlik numarası.

Servis, çağrının yalnız tanımlı IP adresinden gelmesini isteyebilir; bulut tabanlı bir programda bu adresin sabit olması ve jandarma birimine bildirilmesi gerekir. Yetki tesis adına alınır. Programı değiştirdiğinizde yetkinin yeni sistemde nasıl kullanılacağını bağlı olduğunuz jandarma birimine sorun.

Piyasadaki dört yöntem

1. Resmî web servis (yalnız Jandarma)

Program misafiri kaydettiği anda servise bildirim gönderir, cevabı kaydeder. En sağlam yol budur. Kırılma noktası şifre süresi ve IP kısıtıdır: şifre değiştiğinde ya da sunucu adresi değiştiğinde bildirimler sessizce durabilir. Programın başarısız bildirimi ekranda göstermesi şarttır.

2. Tarayıcı eklentisi (Emniyet)

Resepsiyondaki bilgisayara kurulan bir tarayıcı eklentisi, personelin portalda yapacağı adımları otomatik tekrarlar. Personel sabah tek kullanımlık kodla portala bir kez girer, eklenti gün boyunca o oturumu kullanır.

  • Artısı: Türkiye IP'si ve iki aşamalı giriş sorunu çözülür, çünkü iş otelin kendi bilgisayarında yürür.
  • Eksisi: Bilgisayar ve tarayıcı açık kalmalı. Oturum düşerse, bilgisayar yeniden başlarsa ya da portalın ekranı değişirse bildirim durur. Durduğunu fark etmenin tek yolu bildirilmeyenler listesine bakmaktır.

3. Masaüstü yardımcı program (Emniyet)

Otel bilgisayarında arka planda çalışan bir program, belirli aralıklarla (genelde birkaç dakikada bir) bekleyen kayıtları portala aktarır. Eklentiyle aynı mantık, aynı bağımlılık: makine kapanırsa bildirim de durur.

İki yolu aynı anda kullanmayın. Otomatik aktarım açıkken aynı tesis için portaldan elle giriş-çıkış yapılırsa, bir sonraki eşitlemede kayıtlar birbirini tutmaz. Bazı programlar uyuşmayan kaydı siliyor, bazıları ikinci bir kayıt açıyor. Hangi yolun kullanılacağına karar verin; ikisini birden kullanmayın.

4. Toplu yükleme dosyası (Emniyet)

Emniyet portalında Toplu Konaklayan Ekle ekranı var: portalın kendi Excel şablonuyla hazırlanmış dosya yüklendiğinde içindeki herkes tek seferde bildirilir. Program bu dosyayı misafir kaydından hazır üretirse kimlik bilgisi ikinci kez yazılmaz, ama yüklemeyi personel yapar. Dosyanın sütunları ve sık yapılan hatalar ayrı rehberde: KBS toplu konaklayan ekleme.

Bu yol "entegrasyon" değildir ve öyle satılmamalıdır. Ama bilgisayar açık kalmasın diye bir derdi yoktur, portal ekranı değişince kırılmaz. Kaç kişinin beklediğini program zaten gösterdiği için unutma riski de düşer.

Hangi yöntem hangi tesise uygun?

TesisÖnerilenNeden
Jandarma bölgesi (yayla, köy, bazı ilçe dışı tesisler)Resmî web servisResmî kapı var; elle bildirime gerek kalmaz
Emniyet bölgesi, 24 saat açık resepsiyon, sabit bilgisayarEklenti ya da masaüstü program + günlük kontrolMakine sürekli açık; otomasyonun şartı sağlanıyor
Emniyet bölgesi, küçük pansiyon, gece resepsiyon yokToplu yükleme dosyasıAçık kalacak bilgisayar yok; tek dosya birkaç dakikalık iş

Teklif alırken sorulacak yedi soru

  1. Emniyet mi Jandarma mı, hangisine bağlanıyorsunuz, hangi yöntemle?
  2. Emniyet tarafında otomasyon otelde açık bir bilgisayar gerektiriyor mu? O bilgisayar kapanırsa ne oluyor?
  3. Bildirim başarısız olduğunda bunu kim, nerede görüyor? Başarısız kayıtlar ayrı bir listede mi?
  4. Oda değişikliği ve çıkış da bildiriliyor mu, yoksa yalnız giriş mi?
  5. Yabancı uyruklu misafirde uyruk ve belge bilgisi KBS'nin kendi kodlarına çevriliyor mu?
  6. Her bildirimin ne zaman, kimin tarafından yapıldığı kayıt altında mı? Denetimde bu kaydı gösterebilir miyim?
  7. Portal değiştiğinde düzeltme ne kadar sürüyor? O arada ne yapıyoruz?

"Tam otomatik, hiçbir şey yapmanıza gerek yok" cevabı, özellikle Emniyet tarafında, dikkat edilmesi gereken bir cevaptır. Bildirim yükümlülüğü yazılım firmasına geçmez; eksik kalan bildirimin sorumlusu tesistir.

Otelim'de KBS nasıl işliyor?

Açık konuşalım: Otelim bugün Emniyet KBS'ye otomatik bildirim göndermiyor. Otelde sürekli açık kalması gereken bir bilgisayara bağımlı olmayı ve portal değiştiğinde sessizce duran bir otomasyonu tercih etmedik. Bunun yerine bildirimin unutulmasını ve çift veri girişini ortadan kaldıran kısmı yaptık:

  • Kimlik bilgileri giriş sırasında alınır; kimliksiz giriş kaydedilemez.
  • Bildirimi bekleyen herkes tek ekranda durur; bekleyen sayısı menüde rozet olarak görünür.
  • Portalın Toplu Konaklayan Ekle dosyası panelden hazır iner; misafir bilgisi ikinci kez yazılmaz.
  • Giriş, oda değişikliği ve çıkış ayrı ayrı bildirim olarak listeye düşer.
  • Her bildirimi kimin ne zaman kapattığı kayıt altındadır.

Emniyet bir gün tesis yazılımlarına resmî bir servis açarsa, bu rehber ve Otelim aynı gün güncellenir.

2026 notu: Emniyet KBS 2026'da yenilendi. Sorumlu işletici dışındaki kullanıcılar artık alt kullanıcı olarak ekleniyor, girişte tek kullanımlık kod isteniyor. Turizm basınına yansıyan haberlere göre yeni sistem, otel programlarıyla KBS arasındaki ara yazılımların bir kısmında sorun çıkardı. Otomasyon kullanıyorsanız bildirilmeyenler listesine her gün bakın.

Sık sorulanlar

KBS'nin otel programları için bir API'si var mı?

Jandarma KBS'nin tesis yazılımlarının kullanabileceği resmî bir web servisi var; bunun için bağlı olunan jandarma biriminden web servis yetkisi alınır. Emniyet KBS için tesis yazılımlarına açık, belgelenmiş bir servis yayımlanmış değil; bildirim portal üzerinden yapılır.

Otel programım KBS'ye otomatik bildirim yapıyorsa sorumluluk kimde?

Tesiste. Bildirim yükümlülüğü 1774 sayılı Kimlik Bildirme Kanunu'ndan gelir ve yazılım firmasına devredilemez. Otomasyon olsa da bildirilmeyen kayıtları her gün kontrol etmek gerekir.

KBS otomasyonu neden otelde açık bir bilgisayar istiyor?

Emniyet portalı girişte telefondaki uygulamadan tek kullanımlık kod istiyor ve yurt dışı IP adreslerinden açılmıyor. Bu yüzden otomasyon, personelin bir kez giriş yaptığı otel bilgisayarındaki tarayıcı oturumu üzerinden çalışıyor.

Hem otomatik aktarım hem elle bildirim yapabilir miyim?

Önerilmez. Aynı tesis için iki yol birden kullanıldığında kayıtlar birbirini tutmaz; bazı programlar uyuşmayan kaydı siler, bazıları ikinci kayıt açar. Tek bir yol seçin.

Toplu yükleme dosyası entegrasyon sayılır mı?

Hayır. Dosya misafir kaydından hazır üretildiği için veri ikinci kez yazılmaz, ama yüklemeyi personel yapar. Buna karşılık açık kalacak bir bilgisayar gerektirmez ve portal ekranı değişince kırılmaz.