Bu bölüm entegrasyonun ne kadar iş olduğunu göstermek için kısa bir özettir. Sütunların tamamı, örnekler ve kuralların ayrıntısı teknik belgede yazar.
Dosyalar
Otel programı ve KBS Köprüsü aynı klasörü kullanır. Klasör başka bir bilgisayardaysa ağda paylaşılabilir.
| Dosya | Kim yazar | Ne için |
kbs_bekleyen.txt | Otel programı | Bildirilecek misafirler |
kbs_sonuc.txt | KBS Köprüsü | Her kaydın sonucu |
kbs_durum.txt | KBS Köprüsü | KBS Köprüsü çalışıyor mu (isteğe bağlı okunur) |
kbs_simdi.txt | Otel programı | "Şimdi gönder" isteği (isteğe bağlı) |
Misafir dosyası
kbs_bekleyen.txt
kayitno;bayrak;durum;oda;ad;soyad;kimlikno;uyruk;cinsiyet;dogumtarihi;dogumyeri;giris;cikis;plaka;telefon;eskikimlikno
12345;0;icerde;105;Ayşe;Yılmaz;12345678901;TC;K;14.03.1985;İzmir;23.10.2026 14:05;;35ABC123;05321234567;
12346;1;cikti;107;John;Smith;C01X00T47;GBR;E;02.07.1979;London;21.10.2026 16:30;23.10.2026 11:10;;;
12348;1;icerde;108;Elif;Demir;23456789012;TC;K;05.09.1992;Bursa;22.10.2026 18:20;;;;
#SON
- UTF-8, ayraç noktalı virgül. İlk satır başlık, son satır
#SON. #SON yoksa KBS Köprüsü dosyayı yarım sayar ve okumaz.
- Dosya her seferinde veritabanından baştan üretilir, önce geçici bir adla yazılıp sonra yerine taşınır. Sonuna ekleme yapılmaz.
- Türk misafirde T.C. kimlik numarası ve oda yeterlidir, ad ve soyad boş bırakılabilir. Yabancı misafirde belge numarası, ad, soyad, doğum tarihi, cinsiyet ve uyruk gerekir, Polis doğum yerini de ister.
Bildirim bayrağı
Otel programı her kayıt için kendi veritabanında bir bildirim bayrağı tutar. KBS Köprüsü ne yapacağını bu bayraktan ve misafirin durumundan anlar.
| Bayrak | Anlamı |
0 | Bildirilmedi. KBS Köprüsü girişi bildirir. |
1 | Giriş bildirildi. KBS Köprüsü oda değişikliğini ve çıkışı bu satırdan görür. |
2 | Çıkış bildirildi. Kayıt artık dosyaya yazılmaz. |
3 | Kimlik bilgisi düzeltildi. KBS Köprüsü KBS sitesindeki eski kaydı çıkarır, doğru bilgilerle yeniden giriş yapar. |
Sonuç dosyası
kbs_sonuc.txt
kayitno;islem;bayrak;sonuc;mesaj;zaman;ad;soyad;uyari
12345;giris;1;tamam;KBS sitesine giriş bildirildi.;23.10.2026 14:07;;;
12346;cikis;2;tamam;KBS sitesine çıkış bildirildi.;23.10.2026 14:07;;;
12349;giris;0;hata;eksik bilgi: doğum yeri;23.10.2026 14:07;;;
12351;giris;1;tamam;KBS sitesine giriş bildirildi.;23.10.2026 14:09;ME*****;KA*****;
12352;giris;1;tamam;KBS sitesine giriş bildirildi. Yazılan ad ile KBS sitesindeki ad farklı görünüyor (KBS sitesinde: HA***** YI*****). Kimlik numarasının kontrol edilmesi gerekebilir.;23.10.2026 14:12;;;adfarkli
#SON
Satırlar sırayla işlenir. Veritabanındaki bayrak 3 ise yalnız duzeltme satırları uygulanır. Öteki durumlarda tamam gelen kayıtta otel programı bayrağı satırdaki değere çevirir, ama yalnız satırdaki değer veritabanındakinden büyükse. hata gelen kaydın bayrağına dokunulmaz, mesaj kullanıcıya gösterilir. uyari sütununda adfarkli varsa kullanıcıya kimlik numarasını kontrol etmesi için uyarı gösterilir.
Türk misafirde ad ve soyad dosyada boş bırakılabilir, KBS sitesi kişiyi kimlik numarasından bulur. Bu durumda KBS Köprüsü, KBS sitesinin gösterdiği maskeli adı (örneğin ME*****) ad ve soyad sütunlarına yazar. Otel programı baş harflerden doğru kişinin bildirildiğini görebilir.
KBS Köprüsü'nün kendisinin hallettikleri
- Oda değişikliği: otel programı yalnız yeni oda numarasını yazar. KBS Köprüsü farkı görüp KBS sitesinde günceller.
- Arızadan sonra eşitleme: KBS sitesindeki kayıtları otel programındakilerle karşılaştırır, eksik olanı bildirir, elle yapılmış olanı yinelemez. Ayrıntısı teknik belgede.
- Silinen kayıt: girişi bildirilmiş bir misafir otel programında silinirse ve otel programı kaydı
iptal durumuyla yazmaya devam ederse, KBS Köprüsü misafiri KBS sitesinden çıkarır.
- Kimlik düzeltme: girişi bildirildikten sonra otel programında kimlik bilgisi düzeltilen misafirin KBS sitesindeki yanlış kaydını çıkarır ve doğru bilgilerle yeniden giriş yapar.
- Geçici hatalar: KBS sitesine ulaşılamazsa ya da KBS sitesi geçici hata verirse sonraki turda yeniden dener. Bekleyen misafirler kaybolmaz.
- Eksik bilgi: KBS sitesinin kabul etmeyeceği bir kaydı göndermez, nedenini
kbs_sonuc.txt dosyasına açıkça yazar.
Polis ve Jandarma
Otel programı için iki kurum arasında fark yoktur, aynı dosya yazılır. Kurum KBS Köprüsü'nün ayarlarından seçilir. Polis'te KBS Köprüsü otelin KBS kullanıcı adı ve şifresiyle EGM'nin sistemine girer, EGM SEC kodunu otel yetkilisi kendi telefonundan okuyup KBS Köprüsü'nün penceresine yazar. Jandarma'da KBS Köprüsü, Jandarma'nın konaklama tesislerine sunduğu web servisini otelin tesis koduyla ve web servis şifresiyle kullanır.
📄 Teknik belgenin tamamı