TÜRKİYE TURİZM TANITIM VE GELİŞTİRME AJANSI (TGA)
Merkezi Veri Tabanı – Tesis Entegrasyon Servisi Bilgi Portalı
1. Kapsam ve Amaç
Türkiye Turizm Tanıtım ve Geliştirme Ajansı (TGA) koordinasyonunda yürütülen Konaklama Tesisleri Merkezi Veri Tabanı Uygulaması, Türkiye genelindeki konaklama tesislerinin günlük operasyonel verilerini tek bir merkezde, standart formatta ve güvenli bir altyapı ile toplamayı amaçlamaktadır.
Bu entegrasyon süreci sayesinde; tesislerin Otel Yönetim Sistemleri ile TGA sistemleri arasında doğrudan ve otomatik bir veri köprüsü kurularak, sektör verilerinin anlık, hatasız ve bütünleşik bir şekilde analiz edilmesi hedeflenmektedir. Sürecin hukuki çerçevesi ve tesislerin veri gönderim sorumlulukları, yayımlanan resmi Bakanlık Genelgesi ile güvence altına alınmıştır.
2. Veri Gönderim Kuralları ve Kapsamı
Entegrasyon sürecinin standartlara uygun ve hatasız ilerleyebilmesi için tesislerin ve yazılım firmalarının aşağıdaki kurallara uyması beklenmektedir:
Geçmiş 7 Gün ve Gerçekleşen Konaklama Kuralı
Sisteme veri gönderimi her gün düzenli olarak yapılmalıdır. Her bir gönderim paketinde, işlem yapılan günden geriye dönük son 7 güne ait veriler yer almalıdır.
Sisteme yalnızca gerçekleşmiş (fiili) konaklama verileri iletilmeli; iptaller (cancelled), no-show veya opsiyonlu rezervasyonlar kesinlikle veri setine dahil edilmemelidir.
Veri Kategorileri (Tablolar)
Gönderilen her günlük veri seti, 3 temel veri kategorisini içerecek şekilde kurgulanmıştır:
Genel Bilgiler: Toplam satılan oda, toplam konaklayan kişi, elde edilen net oda geliri ve tahsil edilen vergi tutarı bilgileri.
Demografik Veriler: Konaklayan misafirlerin uyruk (ülke ISO kodu) bazlı oda, kişi ve gelir dağılımı.
Kanal Verileri: Satışın gerçekleştiği kanal (Acenta, Online, Bireysel vb.) bazlı rezervasyon, kişi ve gelir dağılımı.
Çoklu Para Birimi (Multi-Currency) Desteği
Sistemimizde zorunlu bir para birimi (örneğin sadece TRY) veya kur dönüşümü (conversion) kısıtlaması yoktur. Tesisler, tahsilatlarını gerçekleştirdikleri orijinal para birimleri üzerinden verilerini iletebilirler.
Önemli Not: Aynı güne ait birden fazla para birimiyle işlem yapılmışsa (Örn: Hem TRY, hem EUR, hem USD geliri varsa), o rapor tarihi için para birimi bazında ayrı ayrı veri kayıtları oluşturularak gönderilmelidir. Herhangi bir kur hesabı yapılmasına gerek yoktur.
3. API Kullanımı ve Teknik Detaylar
Veri aktarımı güvenli HTTPS protokolü üzerinden JSON formatında yapılmaktadır. Sisteme erişim için her tesise veya yazılım firmasına özel bir API Anahtarı (API Key) tanımlanmaktadır.
REST API Uç Noktası: POST https://tesis-entegrasyon.tga.gov.tr
Kimlik Doğrulama: Servise yapılacak tüm veri gönderim isteklerinde, API anahtarının HTTP istek başlıklarında X-API-Key parametresi ile gönderilmesi zorunludur.
4. Resmi Dokümanlar ve Kılavuzlar
5. Teknik Destek ve İletişim
Adres: Büyükdere Caddesi No: 127 Astoria Kuleleri B Blok Kat:4, Şişli – İstanbul