TGA | T.C. Kültür ve Turizm Bakanlığı

Hakkımızda

Sertifika Programları

Faaliyetler

Basın Odası

İletişim

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 Turizm Merkezi Veri Tabanı Sistemi, Türkiye genelindeki konaklama tesislerinin operasyonel verilerini tek bir merkezde, standart formatta ve güvenli bir altyapı ile toplamayı amaçlamaktadır.

Bu sistem sayesinde; tesislerin Otel Yönetim Sistemleri (PMS / CMS) ile TGA arasında otomatik bir veri köprüsü kurulabileceği gibi, herhangi bir yazılım kullanmayan tesis yetkilileri de verilerini doğrudan Turizm Merkezi Veri Tabanı Sistemi (https://tesis-kunye.tga.gov.tr) üzerinden sisteme kaydedebilmektedir. Her iki yöntemle toplanan veriler sayesinde sektörün anlık, hatasız ve bütünleşik bir şekilde analiz edilmesi hedeflenmektedir.

2. Turizm Merkezi Veri Tabanı Sistemi Üzerinden Manuel Veri Girişi Süreci

Otel Yönetim Sistemleri (PMS / CMS) kullanmayan veya mevcut altyapısı otomatik entegrasyona uygun olmayan tesislerimizin verilerini paylaşabilmesi için manuel giriş imkânı sağlanmıştır. Tesis yetkilileri, Turizm Merkezi Veri Tabanı Sistemi Uygulaması üzerinden giriş yaparak verilerini sisteme manuel olarak aktarabilirler. Uygulamaya giriş sürecinden başlayarak veri giriş adımlarının nasıl tamamlanacağını verilerin girişlerinin nasıl yapılacağı detaylı olarak tarifleyen kullanıcı rehberine aşağıdaki bağlantı üzerinden ulaşabilirsiniz.

Turizm Merkezi Veri Tabanı Sistemi Uygulaması - Kullanıcı Rehberi

3. API Kullanımı ve Teknik Detaylar

3.1 Ortamlar ve Entegrasyon Süreci

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.

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.

Ortamlar: Entegrasyon, veri güvenliği ve hatasız geçiş amacıyla iki aşamalı (Test ve Canlı) olarak kurgulanmıştır.

A) Test (Pre-Prod) Ortamı

Yazılım firmalarının geliştirmelerini yapıp format doğrulayacakları başlangıç ortamıdır.

REST API Uç Noktası: https://test-tesis-entegrasyon.tga.gov.tr/

Dokümantasyon: https://test-tesis-entegrasyon.tga.gov.tr/docs

Swagger (Test Arayüzü): https://test-tesis-entegrasyon.tga.gov.tr/swagger

Kullanım Mantığı: Geliştirme aşamasında denemeler Swagger arayüzü üzerinden yapılabilir. Yanıtlarda (response) dönen api_version bilgisinin sistemlerinizce kontrol edilmesi gerekmektedir. Eğer versiyon değişirse (Örn: v1.0'dan v2.0'a), teknik ekibinizin ivedilikle Test Dokümantasyon sayfasına giderek “Yayın Notlarını” (Release Notes) okuması ve test yapılarını bu yeni kurallara göre güncellemesi beklenmektedir.

B) Canlı (Prod) Ortamı

Testleri başarıyla tamamlanan tesislerin gerçek veri akışını başlattığı ortamdır.

REST API Uç Noktası: https://tesis-entegrasyon.tga.gov.tr/

Dokümantasyon: https://tesis-entegrasyon.tga.gov.tr/docs

Kullanım Mantığı: Canlı ortamda manuel test işlemi yapılmayacağı ve tüm akış otomasyon üzerinden sağlanacağı için bu ortamda Swagger arayüzü bulunmamaktadır. Canlı sisteme taşındıktan sonra da otomatik versiyon uyarı mekanizmanız devrede olmalı ve olası kural değişikliklerinde doğrudan Canlı Dokümantasyon adresi takip edilerek sistemlerin güncel tutulması beklenmektedir.

3.2 Veri Gönderim Kuralları ve Kapsamı

Entegrasyon sürecinin standartlara uygun ve sağlıklı ilerleyebilmesi için Otel Yönetim Sistemleri (PMS / CMS) firmalarının ve tesislerin aşağıdaki esasları takip etmesi beklenmektedir:

Aylık Veri Gönderimi ve Geçmiş Veri Aktarımı

Sisteme veri gönderiminin aylık periyotlarla yapılması ve biten her aya ait verilerin, takip eden ayın ilk 10 günü içerisinde iletilmesi planlanmıştır. Bu kapsamda, verilerin sisteme her ay yalnızca bir kez gönderilmesi beklenmektedir.
Her gönderim paketi, ilgili ayın verilerini içermelidir. rapor_tarihi alanı, iletilen verinin ait olduğu ayı YYYY-MM formatında belirtmelidir.
Tek Seferlik Toplu Veri Gönderimi: Sürecin başlangıcında, tesislerin Ocak 2025 ile Nisan 2026 tarihleri arasındaki tüm geçmiş verilerinin tek seferlik bir toplu (bulk) gönderimle sisteme aktarılması beklenmektedir.

Veri Kategorileri ve Teknik Kriterler

Gönderilen aylık veri setlerinin, tesisin çalışma durumu ve uyruk bazlı performansına göre aşağıdaki şekilde kurgulanması önerilir:

İstatistiksel Metrikler: Verilerin iso_kodu (ülke) bazında; hafta içi ve hafta sonu ayrımıyla toplam giriş, geceleme ve satılan oda-gece bilgilerini içermesi öngörülmektedir.

Para Birimi ve Ortalama Fiyat

Tesisin ilgili ülke kırılımı için hesapladığı aylık ortalama oda fiyatı (ortalama_fiyat) esas alınmaktadır. Oda fiyatı kahvaltı, KDV ve vergiler hariç net fiyattır. All inclusive (herşey dahil) hizmet veren otellerde de KDV ve vergiler hariç net fiyattır.
Tesislerin, farklı para birimleriyle yaptıkları tahsilatları tek bir para birimine (EURO) indirgeyerek iletmeleri beklenmektedir.

Raporlama ve Veri Gizliliği (Anonimleştirme)

Sisteme iletilen veriler tamamen anonimleştirilir ve analizler tekil tesis bazında değil, bölgesel kümeler halinde raporlanır. Tüm veri barındırma ve işleme süreçleri doğrudan bakanlık veri merkezlerinde gerçekleştirilir.