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 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.

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: İlgili tarihte geceleyen toplam oda ve kişi sayısı (In-house), sadece o gün giriş (check-in) yapan oda ve kişi sayısı (giren_oda, giren_kisi), elde edilen net oda geliri ve tahsil edilen vergi tutarı bilgileri.
(Not: Tesis geneli Ortalama Kalış Süresi - ALS hesaplamalarının doğru yapılabilmesi için günlük giriş/check-in verilerinin iletilmesi zorunludur.)
Demografik Veriler: Konaklayan misafirlerin uyruk (ülke ISO kodu) bazlı geceleyen oda/kişi sayısı, giriş (check-in) yapan oda/kişi sayısı ve gelir dağılımı.
(Hedef pazar bazlı ALS analizi için)
Kanal Verileri: Satışın gerçekleştiği kanal (Acenta, Online, Bireysel vb.) bazlı geceleyen oda/kişi sayısı, giriş (check-in) yapan oda/kişi sayısı ve gelir dağılımı.
(Satış kanalı bazlı ALS analizi için)

Ç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.

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 ve Entegrasyon Süreci: 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 zorunludur. 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 sistemler güncel tutulmalıdır.