OTA XML Standartları ve Otelcilik Ekosistemi
OTA (OpenTravel Alliance) XML standardı, otelcilik endüstrisinde farklı sistemlerin birbirleriyle veri alışverişi yapmasını sağlayan ortak iletişim protokolüdür. 2026 itibarıyla dünya genelinde 200.000'den fazla otel OTA XML standartlarını kullanarak channel manager'lar, OTA'lar ve GDS sistemleriyle entegre çalışmaktadır.
XML bağlantısının doğru kurulumu, otelinizin dijital dağıtım altyapısının temelidir. Hatalı bir XML entegrasyonu, fiyat uyumsuzluğundan overbooking'e kadar birçok kritik soruna yol açabilir. Bu rehber, OTA XML entegrasyonunun teknik detaylarını, sık karşılaşılan hataları ve performans optimizasyonunu kapsamaktadır.
İlgili okuma: Channel Manager Entegrasyon Hataları ve Çözümleri
Temel XML Mesaj Tipleri
OTA XML standardı, otel dağıtımında kullanılan dört temel mesaj tipi içerir:
1. OTA_HotelAvailNotif — Envanter Güncelleme
Oda müsaitliğini kanallara bildirmek için kullanılır. Her güncelleme belirli bir tarih aralığı ve oda tipi için envanter bilgisi içerir.
Kritik alanlar:
- StatusApplicationControl: Tarih, oda tipi ve fiyat planı belirtir
- AvailStatusMessages: Satışa açık/kapalı durumu ve kısıtlamalar
- BookingLimit: Maksimum satılabilir oda sayısı
Sık yapılan hatalar:
- Tarih formatı uyumsuzluğu (ISO 8601 kullanın: YYYY-MM-DD)
- Oda tipi kodlarının kanal tarafı ile eşleşmemesi
- Negatif envanter gönderimi (envanter 0'ın altına düşemez)
2. OTA_HotelRateAmountNotif — Fiyat Güncelleme
Oda fiyatlarını kanallara göndermek için kullanılır. Farklı misafir sayılarına, konaklama sürelerine ve tarih aralıklarına göre fiyat bilgisi içerir.
Fiyat mesajı yapısı:
| Alan | Açıklama | Zorunlu |
|---|---|---|
| RatePlanCode | Fiyat planı kodu | Evet |
| RoomTypeCode | Oda tipi kodu | Evet |
| Start/End | Geçerlilik tarihleri | Evet |
| AmountAfterTax | Vergi dahil fiyat | Kanal bazlı |
| AmountBeforeTax | Vergi hariç fiyat | Kanal bazlı |
| CurrencyCode | Para birimi | Evet |
3. OTA_HotelResNotif — Rezervasyon Bildirimi
OTA'dan otele yeni rezervasyon, değişiklik veya iptal bildirimi için kullanılır. Bu mesajın doğru işlenmesi, overbooking ve gelir kaybını önler.
4. OTA_HotelDescriptiveContentNotif — İçerik Güncelleme
Otel açıklaması, fotoğraflar, tesis bilgileri ve politikalar gibi statik içeriklerin güncellenmesi için kullanılır.
API Performans Gereksinimleri
OTA XML API'lerin performansı, dağıtım kalitesini doğrudan etkiler. 2026'da büyük OTA'ların beklediği performans standartları:
Yanıt süresi gereksinimleri:
| İşlem Türü | Maksimum Yanıt Süresi | Hedef |
|---|---|---|
| Müsaitlik sorgusu | 3 saniye | <1 saniye |
| Fiyat sorgusu | 2 saniye | <500ms |
| Rezervasyon oluşturma | 5 saniye | <2 saniye |
| Rezervasyon iptal | 3 saniye | <1 saniye |
| İçerik güncelleme | 10 saniye | <5 saniye |
Yüksek erişilebilirlik (High Availability):
- Uptime hedefi: %99.9 (yılda maksimum 8.7 saat kesinti)
- Bakım penceresi: Gece 02:00-04:00 arası (düşük trafik)
- Failover mekanizması: Birincil sunucu çöktüğünde otomatik yedek devreye girme
- Rate limiting: Saniyede minimum 100 istek işleme kapasitesi
Hata Yönetimi ve Log Stratejisi
XML entegrasyonunda hata yönetimi, sistem güvenilirliğinin temel taşıdır. Doğru hata yönetimi olmadan, sessiz hatalar günlerce fark edilmeyebilir.
Hata kategorileri ve çözüm yaklaşımları:
- Validasyon hataları (4xx): XML şema doğrulamasında başarısızlık — mesaj formatını düzeltin
- İş mantığı hataları: Geçersiz tarih, olmayan oda tipi — mapping'i kontrol edin
- Sunucu hataları (5xx): Kanal tarafı sorunlar — otomatik retry mekanizması
- Timeout hataları: Yanıt süresi aşımı — bağlantı ve performans optimizasyonu
- Kimlik doğrulama hataları (401/403): Credential süresi dolmuş — yenileme
Log stratejisi en iyi uygulamaları:
- Her XML mesajı için benzersiz transaction ID kullanın
- İstek ve yanıtın tamamını loglayın (PII maskeleme ile)
- Hata log'larında severity seviyeleri tanımlayın (INFO, WARN, ERROR, CRITICAL)
- Gerçek zamanlı monitoring dashboard'u kurun
- Kritik hatalar için otomatik e-posta ve SMS uyarısı
- Log'ları minimum 90 gün saklayın (uyuşmazlık çözümü için)
OtelCiro'nun MCP (Multi-Channel Platform) çözümü, XML entegrasyonlarını merkezi olarak yönetir, hataları gerçek zamanlı tespit eder ve otomatik düzeltme mekanizmaları sunar.
Güvenlik ve Uyumluluk
XML bağlantılarında güvenlik, misafir verisi koruması ve PCI DSS uyumluluğu açısından kritiktir:
Güvenlik gereksinimleri:
- TLS 1.3: Tüm bağlantılar şifreli olmalı (TLS 1.2 minimum)
- IP whitelisting: Yalnızca yetkili IP adreslerinden bağlantıya izin verin
- API key rotasyonu: Kimlik bilgilerini her 90 günde değiştirin
- PCI DSS uyumluluğu: Kredi kartı verisi taşıyan mesajlarda Level 1 uyumluluk
- GDPR/KVKK: Kişisel verilerin işlenmesi ve saklanması kurallarına uyum
- Penetrasyon testi: Yılda en az 2 kez güvenlik testi
Veri maskeleme kuralları:
Log'larda ve test ortamlarında aşağıdaki veriler maskelenmeli:
- Kredi kartı numaraları: İlk 6 ve son 4 hane hariç maskeleme
- Misafir e-posta adresleri: Kısmi maskeleme
- Telefon numaraları: Son 4 hane hariç maskeleme
- Pasaport/TC kimlik numaraları: Tamamen maskeleme
Test ve Go-Live Süreci
XML entegrasyonunu canlıya almadan önce kapsamlı bir test süreci gereklidir:
Test aşamaları:
- Birim testler: Her mesaj tipi için ayrı ayrı doğrulama
- Entegrasyon testleri: Uçtan uca veri akışı doğrulaması
- Yük testleri: Eş zamanlı 500+ istek senaryosu
- Failover testleri: Sunucu kesintisi simülasyonu
- Rate parity testi: Fiyat tutarlılığı doğrulaması (minimum 30 farklı tarih)
- Gerçek rezervasyon testi: Test ortamında gerçek benzeri rezervasyon akışı
Go-live kontrol listesi:
- Tüm oda tiplerinin eşleştirmesi doğrulanmış
- Tüm fiyat planlarının eşleştirmesi doğrulanmış
- Hata uyarı sistemi aktif
- Monitoring dashboard çalışır durumda
- Geri dönüş planı (rollback) hazır
- 7/24 teknik destek ekibi tanımlı
XML entegrasyonu, otelcilik teknolojisinin altyapı katmanıdır. Doğru kurulum, performans optimizasyonu ve proaktif hata yönetimi ile güvenilir bir dağıtım altyapısı oluşturmak, 2026'da her otelin stratejik önceliği olmalıdır.
