TGA Entegrasyonu Nasıl Yapılır? Elektra PMS ile Adım Adım Rehber

Son Gün 16 Haziran 2026 — Hazır mısınız?

Neden Bu Kadar Önemli?

Kültür ve Turizm Bakanlığı, Türkiye genelindeki tüm konaklama tesislerinin günlük doluluk, misafir demografisi ve gelir verilerini Merkezi Turizm Veri Tabanı'na (TGA) aktarmasını zorunlu hâle getirdi. Başlangıçta belirlenen son tarih uzatılarak 16 Haziran 2026 olarak yeniden belirlendi. Bu tarihe kadar entegrasyonunu tamamlamayan tesisler idari yaptırımlarla karşı karşıya kalabilir.

Kalan süre son derece kısıtlı. Bu yazıda hem entegrasyonun teknik boyutunu açıklıyor hem de bir otelde bu süreci baştan sona nasıl hayata geçirdiğimi anlatıyorum.

TGA Entegrasyonu Tam Olarak Nedir?

TGA (Turizm Veri Tabanı), Kültür ve Turizm Bakanlığının yönettiği merkezi bir veri toplama platformudur. Konaklama tesisleri, her gece biten günün verilerini bu sisteme iletmekle yükümlüdür. Gönderilmesi gereken veriler şunlardır:

• Toplam doluluk: Kaç oda, kaç kişi
• Günlük check-in bilgileri
• Misafir uyruklarına göre demografik kırılım: (ISO 3166 ülke kodları)
• Satış kanalı bazında veri: Acente, Online, Bireysel
• Net oda geliri: (TRY cinsinden)

Bu Entegrasyonu Nasıl Gerçekleştirdim?

Elektra PMS kullanan bir otel için bu entegrasyonu baştan sona tasarlayıp hayata geçirdim. Teknik altyapı olarak Node.js ve Express tercih ettim; otelin SQL Server veritabanına (MSSQL) bağlanarak ilgili verileri otomatik olarak derliyorum.

Veri Kaynağı ve Filtreleme

Elektra'nın RESDAYS ve RES tablolarından günlük veri çekiliyor. Ancak ham veriyi olduğu gibi göndermek doğru değil; kalite filtreleri uygulamak şart. Sıfır fiyatlı odalar (complimentary), COMP ve COMP BB olarak tanımlanmış acenteler sistem dışında bırakılıyor. Bu sayede TGA'ya yalnızca gerçek gelir yaratan konaklamalar bildiriliyor.

Otomatik Gönderim ve Loglama

TGA'nın öngördüğü gönderim aralığı gece 01:00-07:00 saatleri arasındadır. Bu nedenle sistem her gece saat 03:00'te otomatik olarak çalışıyor. PM2 ile servisi arka planda kalıcı hâle getirdim; Windows yeniden başlasa bile sistem kendiliğinden ayağa kalkıyor. Her gönderimin ardından detaylı bir log dosyası oluşturuluyor: HTTP durum kodu, TGA'nın döndürdüğü request ID ve gönderilen JSON içeriği kayıt altına alınıyor.

E-Posta Bildirimi

Her başarılı gönderimin ardından yöneticiye otomatik bir özet e-postası gönderiliyor: O gün kaç oda, kaç kişi, ne kadar gelir TGA'ya bildirildi? Hata durumunda ise farklı formatta bir uyarı e-postası devreye giriyor.

Yönetim Paneli

Tarayıcı tabanlı bir panel üzerinden tarih aralığı seçerek TGA'ya bildirilen tüm verileri gözlemleyebiliyorsunuz: Günlük oda sayısı, kişi sayısı, bildirilen gelir ve kanal kırılımı. Geçmiş veriyi (bulk data) belirli dönemler hâlinde yeniden gönderme imkânı da mevcut.

Karşılaşılan Teknik Zorluklar

Bu tür entegrasyonlarda görünürde küçük ama pratikte kritik olan detaylar mutlaka gün yüzüne çıkıyor:

• ISO Ülke Kodu Uyuşmazlıkları: Elektra'da KKTC, TC, RKB gibi standart dışı kodlar girilmiş olabiliyor. TGA bunları reddediyor; her birini doğru ISO 3166-1 alpha-3 karşılığı ile eşitlemek gerekiyor.
• Yuvarlama Farkları: Gelir toplamlarında kuruş düzeyindeki sapmalar TGA tarafından denge hatası olarak değerlendiriliyor. Demografik ve kanal kırılımlarının birbirine ve genel toplamla tam eşleşmesi zorunlu.
• Haftalık Dilim Sınır Sorunu: Bulk (toplu) veri gönderiminde bir misafirin check-in ve geceleme verileri farklı haftalara düşebiliyor. Bu durum giren_oda değerinin toplam_oda değerini aşmasına ve TGA'nın ret kararını tetiklemesine yol açıyor.
• COMP Filtreleme: Tesisin misafirlerine ücretsiz sunduğu odaların gelir istatistiklerine dâhil edilmemesi gerekiyor. Bu kayıtlar hem oda sayısı hem kişi sayısı hem de uyruk hesaplamalarının dışında tutuluyor.

Sonuç: 16 Haziran Geliyor

TGA entegrasyonu, doğru kurulduğunda günlük bakım gerektirmeyen, tamamen otomatik çalışan bir sistem. Ne var ki yanlış kurulduğunda hem idari risk hem de hatalı veri bildirimi anlamına geliyor.

16 Haziran 2026 son tarih. Entegrasyonunuzu henüz tamamlamadıysanız ya da mevcut sisteminizden emin değilseniz, vakit kaybetmeden harekete geçmenizi öneririm.

Yardıma İhtiyacınız Var mı?

Elektra PMS kullanan oteller için bu entegrasyonu yazma konusunda destek sağlıyorum. Sürecin herhangi bir aşamasında —teknik kurulum, veri doğrulama ya da canlıya geçiş— yardımcı olmaktan memnuniyet duyarım.

İletişim: İletişim

Bu yazı, benzer bir entegrasyonu kendi başına yapmak isteyen turizmcilere yol göstermeyi amaçlamaktadır. Daha fazla teknik detay için siteyi takip edebilirsiniz.

canberksevim.com — Turizm & Teknoloji