TGA Entegrasyonu: Aylık Konaklama Raporu

Türkiye'deki konaklama tesisleri için turizm verisi raporlaması artık isteğe bağlı bir iş değil. Merkezi Turizm Veri Tabanı, Türkiye Turizm Tanıtım ve Geliştirme Ajansı (TGA) tarafından işletilen ve tesislerin aylık faaliyet verilerini topladığı merkezi sistemdir. Amaç; doluluk, geceleme ve ortalama fiyat verilerinin il ve ilçe kırılımında, uyruk bazında ve karşılaştırılabilir biçimde toplanmasıdır.

Bu yazıda TGA'nın tam olarak hangi verileri istediğini, rakamların nasıl hesaplanması gerektiğini, gönderim takvimini, bu bildirimin diğer raporlama yükümlülüklerinden farkını ve tüm bu işi elle yapmak yerine otomatik TGA entegrasyonunun nasıl çalıştığını anlatıyoruz.

TGA raporlaması zorunludur

Öncelikle en çok sorulan soruyu net biçimde cevaplayalım: Merkezi Turizm Veri Tabanı'na veri bildirimi isteğe bağlı değildir. Tesisin bu sisteme dâhil olması ve aylık verisini düzenli olarak iletmesi bir tercih değil, yerine getirilmesi gereken bir yükümlülüktür.

Pratikte sıkça duyduğumuz "bizim tesis küçük", "biz sezonluk çalışıyoruz", "o ay zaten satış yapmadık" gibi gerekçeler bildirimi ortadan kaldırmaz:

• Tesis büyüklüğü muafiyet sağlamaz. Kapasite alanı raporun içeriğini belirler, yükümlülüğün kendisini değil.
• Kapalı geçen ay da bildirilir. Sezon dışı bir ayda tesisin açık olduğu gün sayısı sıfır olarak gider; rapor gönderilmemiş olmaz.
• Satış olmayan ay da bildirilir. Uyruk kırılımı boş olabilir, ancak dönem yine de raporlanır.

Bu nedenle TGA raporlamasını "vakit bulunca yapılacak" bir iş olarak değil, ay kapanışının sabit bir adımı olarak kurgulamak gerekir. Otomatik gönderim de tam olarak bunu sağlar: dönem, kimsenin hatırlamasına gerek kalmadan kapanır.

TGA raporu; KBS ve Aylık Turizm İstatistik Raporu ile aynı şey değildir

Sahada en çok karışan konu bu. Birbirine benzeyen üç ayrı yükümlülük var ve hiçbiri diğerinin yerine geçmiyor:

• KBS (Kimlik Bildirim Sistemi): Emniyet tarafına yapılan, misafir bazında ve giriş anında yapılan kimlik bildirimidir. Kişisel veri içerir.
• Aylık Turizm İstatistik Raporu: Turizm belgeli tesislerin Kültür ve Turizm Bakanlığı tarafına ilettiği, alışılmış aylık istatistik bildirimidir. Yıllardır bilinen ve çoğu tesiste ön büro ya da muhasebe tarafından elle doldurulan rapordur.
• TGA Merkezi Turizm Veri Tabanı: Tesis bazında ve aylık yapılan, ayrı bir sistem üzerinden yürüyen istatistik bildirimidir. Kişisel veri içermez; yalnızca sayılar ve uyruk kırılımı gönderilir.

Peki TGA raporu, Aylık Turizm İstatistik Raporu'ndan ne ile ayrılıyor?

İki rapor da "aylık" olduğu ve benzer başlıklar içerdiği için sıklıkla aynı iş sanılıyor. Oysa aralarında somut farklar var:

• Muhatap ve sistem farklı. Aylık Turizm İstatistik Raporu Bakanlık tarafına gider; TGA raporu ise Merkezi Turizm Veri Tabanı'na, tesise özel bir kimlik ve API anahtarı ile iletilir.
• Gönderim biçimi farklı. Biri klasik anlamda doldurulup iletilen bir formken, TGA raporu tesis yazılımının doğrudan bağlandığı bir veri akışıdır; gönderim makineden makineye yapılır ve her gönderime bir işlem numarası döner.
• Metodoloji farklı. TGA kendi tanımlarını dayatır: hafta sonu Cuma–Cumartesi olarak alınır, oda-gece ile geceleme ayrı ayrı ve farklı uyruk kurallarıyla sayılır, ortalama fiyat vergilerden arındırılmış olarak ve EUR cinsinden istenir. Alışkanlıkla doldurulan bir istatistik formundaki rakamlar TGA raporuna olduğu gibi taşınamaz.
• Geçmişe dönük kapsam farklı. TGA'ya dâhil olan tesisten, Ocak 2025'ten itibaren kapanmış tüm ayların bir defaya mahsus yüklenmesi beklenir; klasik aylık istatistik bildiriminde böyle bir toplu geçmiş yükleme adımı yoktur.

Kısacası birini göndermiş olmak diğerini yapılmış saymaz. KBS entegrasyonu günlük operasyonun bir parçasıyken, TGA raporu ay kapanışının ayrı ve zorunlu bir adımıdır.

TGA'ya tam olarak hangi veriler gönderiliyor?

Aylık rapor, tesise ait genel bilgiler ve uyruk bazında kırılmış sayımlardan oluşur. Tesis düzeyindeki alanlar şunlardır:

• Tesis kimliği: Tesisin sağlayıcı sistemindeki benzersiz kimliği (UUID formatında). Bu kimliği TGA dağıtmaz; tesis yazılımı üretir ve bir daha değiştirmez.
• Rapor dönemi: Raporlanan ay, yıl-ay biçiminde (örneğin 2026-07).
• İl ve ilçe kodu: Tesisin bulunduğu il ve ilçenin resmî kodları. İkisinin birbiriyle uyumlu olması zorunludur.
• Oda sayısı ve yatak sayısı: Tesisin belgesindeki resmî kapasite.
• Tesisin ay içinde açık olduğu gün sayısı: Sezonluk çalışan tesisler için kritik alan.
• Aylık ortalama fiyat: EUR cinsinden, vergilerden ve yeme-içme bedelinden arındırılmış çıplak oda fiyatı.

Bunun altında, tesiste o ay konaklayan her uyruk için ayrı bir satır yer alır. Her satır ISO 3166 üç harfli ülke kodu ile birlikte altı sayı taşır:

• Hafta içi toplam giriş yapan misafir
• Hafta sonu toplam giriş yapan misafir
• Hafta içi toplam geceleme
• Hafta sonu toplam geceleme
• Hafta içi toplam satılan oda-gece
• Hafta sonu toplam satılan oda-gece

Dikkat edilmesi gereken nokta: hafta sonu, TGA metodolojisinde Cuma ve Cumartesi günleridir. Pazar günü hafta içi sayılır. Elle hazırlanan raporlarda en sık yapılan hatalardan biri, hafta sonunu Cumartesi–Pazar olarak alıp tüm dağılımı kaydırmaktır.

Geceleme, oda-gece ve giriş: üç farklı sayım

Bu üç metrik birbirine benzer görünse de farklı şeyleri ölçer ve farklı şekilde uyruğa dağıtılır:

• Satılan oda-gece: Kaç oda, kaç gece satıldığını gösterir. Bir odayı bölmek mümkün olmadığı için oda-gece, ana misafirin uyruğuna yazılır.
• Geceleme: Kişi × gece sayısıdır. Odadaki her misafir kendi uyruğuna göre sayılır. Üç kişilik bir odanın iki gecesi 6 geceleme, 2 oda-gece üretir.
• Giriş yapan misafir: Yalnızca girişin gerçekleştiği güne göre, kişi bazında sayılır. Aya devreden bir konaklamanın girişi önceki aya aittir; o ay yalnızca gecelemeleri sayılır.

Bir başka önemli kural: bir gece, konaklamanın başladığı aya değil, gecenin kendisinin düştüğü aya aittir. 29 Temmuz – 2 Ağustos arası bir konaklamanın üç gecesi Temmuz, iki gecesi Ağustos raporuna girer. Excel ile hazırlanan raporlarda bu ay sınırı neredeyse her zaman yanlış hesaplanır.

Aylık ortalama fiyat: en çok hata yapılan alan

TGA, ortalama fiyatı çıplak oda fiyatı olarak ve EUR cinsinden ister. Yani PMS'inizdeki misafire yansıtılan fiyat, doğrudan bu alana yazılamaz. Doğru tutara ulaşmak için sırasıyla:

1. Gerçekleşen oda geliri toplanır. Yalnızca fiilen uyunmuş geceler; iptal ve no-show kayıtları hariç tutulur.
2. Pansiyon payı düşülür. Oda+kahvaltı, yarım pansiyon, tam pansiyon veya her şey dâhil fiyatın içindeki yeme-içme payı, oda fiyatının bir yüzdesi olarak çıkarılır. Pay yüzde olduğu için fiyatla birlikte ölçeklenir; ucuz bir gece orantılı olarak daha az yeme-içme bedeli bırakır.
3. KDV ve konaklama vergisi ayrıştırılır. Konaklama hizmetlerinde KDV %10'dur; konaklama vergisi ise dönemsel olarak değişir. Bu oran 1 Mayıs 2026 itibarıyla %2'den %1'e indirildi, dolayısıyla geçmiş aylar için rapor üretirken o ayda geçerli olan oranın kullanılması gerekir.
4. EUR'ya çevrilir. Çevrim, TCMB'nin ilgili ayın son iş gününe ait döviz satış kuru ile yapılır. Ay içindeki farklı kurlar değil, dönem sonu kuru esastır.
5. Satılan oda-gece sayısına bölünür. Sonuç, o ayın ortalama oda fiyatıdır.

Bu beş adımın herhangi birinde yapılan hata, tesisinizin ortalama fiyatını sistemde olduğundan yüksek ya da düşük gösterir. İl ve ilçe ortalamalarının bu verilerden üretildiği düşünülürse, hatalı bildirim yalnızca sizi değil bölge istatistiklerini de etkiler.

Gönderim takvimi ve geçmiş veri

TGA raporlamasının takvimi nettir:

• Yalnızca kapanmış aylar gönderilir; devam eden ay için gönderim yapılmaz.
• Kapanan ay, takip eden ayın ilk 10 günü içinde iletilir.
• Her dönem için tek bir gönderim beklenir; düzeltme gerekiyorsa aynı dönem yeniden gönderilerek önceki rakamların üzerine yazılır.
• Sisteme yeni dâhil olan tesisler için Ocak 2025'ten bugüne kadar olan tüm kapanmış aylar bir defaya mahsus toplu olarak yüklenir.

On günlük pencerenin pratikte anlamı şudur: ay kapanışı ile birlikte muhasebe, gelir kontrolü ve TGA raporu aynı haftaya sıkışır. Rakamları elle toplayan tesislerde bu iş genellikle son güne kalır ve aceleyle hazırlanan rapor hatalı gider.

Teknik tarafta ne oluyor?

TGA entegrasyonu, tesis yazılımınızın Merkezi Turizm Veri Tabanı'na doğrudan bağlanmasıyla çalışır. Bağlantının temel unsurları şunlardır:

• Ayrı test ve canlı ortam: Entegrasyon önce test ortamında doğrulanır, rakamlar tutunca canlıya alınır.
• API anahtarı ile kimlik doğrulama: Her gönderim, ilgili ortam için tanımlı anahtar ile doğrulanır.
• Aylık rapor uç noktası: Rapor, tek bir JSON gövdesi hâlinde iletilir; sistem her gönderime bir işlem numarası döner.
• Alan bazlı doğrulama: Eksik veya tutarsız veri, hangi alanın neden reddedildiğini belirten bir hata mesajıyla geri döner. İl–ilçe uyumsuzluğu, geçersiz tesis kimliği ve sıfır kapasite en sık görülen ret sebepleridir.

Roomnix'te TGA entegrasyonu nasıl çalışıyor?

Roomnix, TGA raporunu ayrı bir veri girişi olarak değil, zaten sistemde olan rezervasyon verisinin bir çıktısı olarak ele alır. Ay kapanışında yapmanız gereken ek bir kayıt yoktur.

1. Tek seferlik kurulum

Tesis kimliği Roomnix tarafından bir kez üretilip sabitlenir; ayrıca API anahtarı girmeniz gerekmez. Sizin tanımladığınız alanlar il ve ilçe kodu, belgedeki oda ve yatak sayısı ile pansiyon tiplerine karşılık gelen yeme-içme yüzdeleridir. Vergi oranları kanunla belirlendiği için salt okunurdur. Ortam (test / canlı) ve otomatik gönderim tercihi de bu ekrandan seçilir. Adım adım kurulum için: Roomnix TGA Entegrasyonu: Kurulum ve Kullanım Rehberi.

2. Gönderimden önce önizleme

Herhangi bir dönemi seçip raporu ekranda görebilirsiniz: uyruk uyruk satırlar, hafta içi / hafta sonu kırılımı, toplam oda-gece ve geceleme sayıları, hesaplanan ortalama fiyat ve kullanılan TCMB kuru. Aynı ekranda gönderilecek JSON'un birebir kendisi de görüntülenir. Ekranda gördüğünüz rakam ile TGA'ya giden rakam aynıdır.

3. Otomatik gönderim

Gece çalışan iş, kapanan ayı otomatik olarak gönderir ve başarısız olursa ertesi gece yeniden dener. Böylece on günlük pencere, kimsenin takip etmesine gerek kalmadan kapanır.

4. Gönderim geçmişi ve düzeltme

Her gönderim; tarihi, sunucu yanıtı, TGA işlem numarası ve gönderilen verinin özeti ile birlikte kaydedilir. Bir dönem kabul edildikten sonra sistem o dönemi kendiliğinden tekrar göndermez; ancak rakamlar sonradan değiştiyse bunu size bildirir ve düzeltme gönderimini tek tuşla yapmanıza izin verir.

5. Geçmiş ayların toplu yüklenmesi

Ocak 2025'ten itibaren tüm kapanmış aylar, aynı hesaplama mantığıyla ay ay üretilip tek bir işlemle gönderilebilir. Yıllarca geriye dönük Excel doldurmaya gerek kalmaz.

Raporunuzu bozan beş yaygın hata

1. Check-in işaretlenmemiş rezervasyonlar. Geçmiş tarihli olduğu hâlde ön büroda giriş olarak işaretlenmemiş rezervasyonlar, elle hazırlanan raporlarda tamamen gözden kaçar. Roomnix bu kayıtları gerçekleşmiş konaklama olarak sayar ve kaç tanesi olduğunu uyarı olarak gösterir.
2. Fiyatı olmayan geceler. Kanal üzerinden gelen bazı rezervasyonlarda gece bazlı taban fiyat boş kalabilir. Bu geceler ortalama fiyat hesabına dâhil edilemez; sistem kaç gecenin bu durumda olduğunu bildirir ki kaynağını düzeltebilesiniz.
3. Yabancı para cinsinden gelen rezervasyonlar. OTA'dan gelen tutarın hangi para biriminde olduğu her zaman güvenilir değildir. Çevrimin tesis para birimi üzerinden ve dönem sonu TCMB kuruyla yapılması şarttır.
4. Kapasite alanlarının yalnızca PMS'ten sayılması. TGA, oda ve yatak sayısını turizm belgenizdeki resmî rakamlarla bekler. Sistemdeki oda listesi bu sayıdan farklı olabilir; ayarlarda resmî değeri girmek gerekir.
5. Blokaj ve iç kullanım odalarının satış gibi görünmesi. Bakım, personel veya park amaçlı tutulan odalar satılabilir envanter değildir ve rapordan çıkarılmalıdır.

Elle raporlama ile entegrasyonun farkı

Orta ölçekli bir otelde tek bir aylık TGA raporunu elle hazırlamak; rezervasyon listesini dışa aktarmak, geceleri ay sınırına göre bölmek, her misafiri uyruğuna göre saymak, Cuma–Cumartesi ayrımını uygulamak, gelirden vergileri ve pansiyon bedelini ayrıştırmak ve TCMB kurunu bulup çevirmek anlamına gelir. Bu iş, verisi düzenli bir tesiste bile birkaç saattir ve her ay tekrarlanır.

Entegrasyon bu döngüyü ortadan kaldırır: veri zaten otel yönetim yazılımının içindedir, hesaplama kuralları bir kez tanımlanmıştır ve gönderim gecenin bir yarısı kendiliğinden yapılır. Sizin işiniz, ay başında rakamlara bir kez göz atmaktan ibarettir.

Özet

• Ne: TGA Merkezi Turizm Veri Tabanı'na aylık konaklama raporu
• Kim: Türkiye'deki konaklama tesisleri
• Zorunlu mu: Evet; kapalı veya satışsız geçen aylar da bildirilir
• Karıştırmayın: KBS ve Aylık Turizm İstatistik Raporu ayrı yükümlülüklerdir, hiçbiri diğerinin yerine geçmez
• Ne zaman: Kapanan ayı takip eden ayın ilk 10 günü, dönem başına bir kez
• İçerik: Kapasite, açık gün sayısı, ortalama fiyat ve uyruk bazında giriş / geceleme / oda-gece
• Hafta sonu tanımı: Cuma ve Cumartesi
• Fiyat: EUR, vergiler ve yeme-içme bedeli hariç, TCMB dönem sonu kuru ile
• Geçmiş veri: Ocak 2025'ten itibaren tüm kapanmış aylar
• Kişisel veri: Gönderilmiyor; rapor tamamen istatistikseldir

Tesisinizin TGA raporlamasını otomatikleştirmek istiyorsanız Roomnix'in entegrasyonlar sayfasını inceleyebilir, fiyatlandırmanızı güncel vergi oranına göre kontrol etmek için konaklama vergisi hesaplama aracımızı kullanabilirsiniz.

Sık Sorulan Sorular

TGA Merkezi Turizm Veri Tabanı nedir?

TGA tarafından yürütülen ve konaklama tesislerinin aylık faaliyet verilerini topladığı merkezi sistemdir. Tesisler; kapasite bilgileri, tesisin açık olduğu gün sayısı, uyruk bazında geceleme, giriş ve satılan oda-gece sayıları ile aylık ortalama oda fiyatını bu sisteme bildirir.

TGA raporlaması zorunlu mu?

Evet, zorunludur. Merkezi Turizm Veri Tabanı'na aylık veri bildirimi isteğe bağlı bir katılım değil, konaklama tesislerinin yerine getirmesi gereken bir yükümlülüktür. Tesisin küçük olması, sezonluk çalışması veya o ay hiç satış yapmamış olması bildirimi ortadan kaldırmaz; kapalı geçen bir ay da açık gün sayısı sıfır olarak bildirilir.

TGA raporu, Aylık Turizm İstatistik Raporu ile aynı şey mi?

Hayır. Aylık Turizm İstatistik Raporu, turizm belgeli tesislerin Kültür ve Turizm Bakanlığı tarafına ilettiği klasik aylık istatistik bildirimidir. TGA Merkezi Turizm Veri Tabanı ise ayrı bir sistemdir: tesise özel bir kimlik ve API anahtarı ile çalışır, veriyi tesis yazılımından doğrudan alır ve kendi metodolojisini uygular; hafta sonu Cuma–Cumartesi olarak alınır, ortalama fiyat vergilerden arındırılmış olarak ve EUR cinsinden istenir. İkisi birbirinin yerine geçmez.

TGA raporu ne zaman gönderilir?

Yalnızca kapanmış aylar için, takip eden ayın ilk 10 günü içinde gönderilir. Devam eden ay için gönderim yapılmaz ve her dönem için tek bir gönderim beklenir.

TGA'ya misafirlerin kimlik bilgileri gönderiliyor mu?

Hayır. Rapor tamamen istatistikseldir; ad, kimlik numarası, pasaport veya iletişim bilgisi içermez. Uyruk bilgisi bile isim bazında değil, ISO üç harfli ülke kodu altında toplanmış sayılar olarak iletilir. Kimlik bildirimi ayrı bir yükümlülüktür ve KBS üzerinden yapılır.

TGA raporunda hafta sonu hangi günlerdir?

Cuma ve Cumartesi. Pazar günü hafta içi olarak sayılır. Giriş, geceleme ve oda-gece sayıları bu ayrıma göre iki ayrı sütunda raporlanır.

Aylık ortalama fiyat nasıl hesaplanır?

Gerçekleşen oda gelirinden pansiyon (yeme-içme) bedeli düşülür, KDV ve konaklama vergisi ayrıştırılır, kalan tutar TCMB'nin ay sonu döviz satış kuru ile EUR'ya çevrilir ve satılan oda-gece sayısına bölünür.

Geçmiş aylar için de rapor göndermek gerekiyor mu?

Evet. Sisteme yeni dâhil olan tesisler Ocak 2025'ten itibaren kapanmış tüm ayları bir defaya mahsus yükler. Roomnix bu toplu yüklemeyi ay ay üreterek tek işlemde yapar.

Rakamlar yanlış gittiyse düzeltme yapılabilir mi?

Evet. Aynı tesis ve aynı dönem için yapılan yeni gönderim, önceki rakamların yerine geçer. Roomnix kabul edilmiş bir dönemi kendiliğinden tekrar göndermez; veri sonradan değiştiyse bunu bildirir ve düzeltmeyi onayınızla iletir.