# Otel XML entegrasyonu nedir? Statik ve dinamik veri farkı

> URL: https://hotelmapping.org/tr/rehber/otel-xml-entegrasyonu-nedir/ · Dil: Türkçe · Son güncelleme: 2026-11-15

**Otel XML entegrasyonu, bir acentenin veya rezervasyon platformunun tedarikçi sistemine web servisiyle bağlanıp otel verisini otomatik almasıdır. Statik veri (ad, adres, koordinat, oda tipleri, görseller) seyrek değişir ve önceden indirilip saklanır. Dinamik veri (müsaitlik, fiyat, iptal koşulu) ise her aramada canlı sorgulanır ve statik kayda tedarikçi koduyla bağlanır.**

## Otel XML entegrasyonu ne demek?

Online acenteler, sattıkları otellerin bilgisini ve fiyatını tek tek elle girmek yerine bedbank, toptancı, rezervasyon platformu veya kanal yöneticisi gibi tedarikçilere bir web servisiyle bağlanır. Otel bilgisi, fiyat ve müsaitlik bu bağlantıdan otomatik gelir. Sektörde bu bağlantıya kısaca **XML entegrasyonu** denir.

Entegrasyonun iki ucu vardır. Bir uçta tedarikçi, envanterini ve fiyatlarını bir servis olarak sunar. Diğer uçta acente, tur operatörü veya metasearch sitesi bu servisi çağırır, yanıtı kendi sistemine çevirir ve müşterisine gösterir. Tedarikçi sayısı arttıkça bu çeviri işi büyür; çünkü her tedarikçi aynı oteli kendi adıyla, kendi koduyla ve kendi veri yapısıyla gönderir.

Tedarikçi türleri hakkında daha fazla bilgi için [bedbank nedir](https://hotelmapping.org/tr/rehber/bedbank-nedir/) rehberine ve [bedbank](https://hotelmapping.org/tr/sozluk/bedbank/), [kanal yöneticisi](https://hotelmapping.org/tr/sozluk/kanal-yoneticisi/) sözlük maddelerine bakabilirsiniz.

### Neden "XML" deniyor?

XML (Extensible Markup Language), verinin etiketlerle yapılandırıldığı bir metin biçimidir ve W3C tarafından standartlaştırılmıştır. Seyahat sektöründeki ilk web servislerinin büyük bölümü SOAP ve XML üzerine kuruldu. Bu yüzden "XML entegrasyonu" ifadesi yerleşti.

Bugün birçok tedarikçi JSON kullanan REST API'ler sunuyor; bazıları ise hâlâ XML ile çalışıyor. İş dilinde ikisi de çoğunlukla "XML entegrasyonu" olarak anılır. Teknik açıdan önemli olan biçim değil, verinin içeriği ve iki tarafın aynı oteli aynı otel olarak tanıyıp tanımadığıdır.

## Statik ve dinamik veri farkı

Bir otel XML entegrasyonunda gelen veri iki gruba ayrılır. Bu ayrım, sistem tasarımının temelidir: hangi verinin saklanacağını, hangisinin her seferinde sorulacağını ve eşleştirmenin nerede yapılacağını belirler.

| Özellik | Statik veri | Dinamik veri |
| --- | --- | --- |
| Örnek alanlar | Otel adı, adres, koordinat, yıldız, açıklama, görseller, olanaklar, oda tipi listesi | Müsaitlik, fiyat, kontenjan, iptal koşulu, anlık pansiyon seçenekleri |
| Değişim hızı | Yavaş; günler veya haftalar içinde | Hızlı; dakikalar hatta saniyeler içinde |
| Nasıl alınır | Toplu indirme (tam dump), ardından değişen kayıtlar (delta) | Her aramada canlı sorgu |
| Nerede tutulur | Sizin veritabanınızda | Kısa süreli önbellekte veya hiç tutulmaz |
| Eşleştirme ihtiyacı | Yüksek; aynı otel her tedarikçide farklı yazılır | Dolaylı; yanıttaki kodlar statik kayda bağlanır |
| Hata olursa | Mükerrer otel, yanlış konum, eksik içerik | Yanlış fiyat gösterimi, rezervasyon hatası |

### Statik veri neleri kapsar?

[Statik otel verisi](https://hotelmapping.org/tr/sozluk/statik-otel-verisi/) bir tesisin kimliğini ve tanımını oluşturan bilgilerdir. Tipik alanlar şunlardır:

- Tedarikçinin otel kodu ve otel adı
- Adres, şehir, ülke ve tedarikçinin destinasyon kodu
- Koordinat (enlem, boylam)
- Yıldız veya kategori
- Açıklama metinleri ve görseller
- Tesis ve oda olanakları
- Oda tipi listesi ve bazen pansiyon tipi listesi
- Telefon, e-posta, web adresi

Bu veri az değiştiği için her aramada yeniden istenmez. Acente onu önceden indirir, kendi veritabanında saklar ve ekranda gösterir.

### Dinamik veri neleri kapsar?

Dinamik veri, belirli bir tarih, oda ve kişi sayısı için o anda geçerli olan bilgidir: oda müsait mi, fiyat ne, hangi pansiyon seçenekleri var, iptal koşulu nedir. Bu bilgi her arama isteğinde tedarikçiden canlı alınır. Yanıtta otel kodu, oda kodu ve pansiyon kodu gibi tanımlayıcılar bulunur; ekrana anlamlı bir sonuç basmak için bu kodların statik veriyle birleştirilmesi gerekir.

## Tipik bir otel XML entegrasyonunun akışı

Tedarikçiden tedarikçiye adlar ve ayrıntılar değişse de çoğu entegrasyon benzer adımları izler:

1. **Statik içerik indirme:** Otel listesi, açıklamalar, görseller ve oda tipleri toplu olarak alınır ve saklanır.
2. **Arama (availability):** Kullanıcının destinasyon, tarih ve kişi bilgisi tedarikçiye gönderilir; müsait oteller fiyatlarıyla döner.
3. **Yeniden kontrol (recheck veya prebook):** Kullanıcı bir seçenek seçtiğinde fiyat ve müsaitlik tekrar doğrulanır; iptal koşulları kesinleşir.
4. **Rezervasyon (book):** Misafir bilgileriyle rezervasyon oluşturulur; tedarikçi bir rezervasyon numarası döner.
5. **Sorgulama ve iptal:** Rezervasyon durumu sorgulanır veya iptal edilir.

İlk adım statik, diğerleri dinamik veriyle ilgilidir. hotelmapping.org yalnız ilk adımın ürettiği veriyi temizler ve eşleştirir; arama, rezervasyon ve iptal adımları sizin sisteminizle tedarikçiniz arasında kalır.

## Örnek: aynı otel, iki tedarikçi, iki biçim

Aşağıdaki örnekte kurgusal "Lara Palm Hotel" iki tedarikçiden gelir. Birinci tedarikçi XML gönderir:

```xml
<Hotel code="LPH-20931">
  <Name>LARA PALM HTL</Name>
  <Address>Guzeloba Mah., Lara Cad. No:112</Address>
  <City code="AYT">Antalya</City>
  <Position lat="36.8571" lng="30.7962"/>
  <Category>5</Category>
  <Rooms>
    <Room code="DBL-SV">Double Room Sea View</Room>
    <Room code="FAM-2B">Family Room 2 Bedrooms</Room>
  </Rooms>
</Hotel>
```

İkinci tedarikçi aynı oteli JSON ile, farklı bir ad ve kodla gönderir:

```json
{
  "hotelId": "770512",
  "hotelName": "Lara Palm Hotel - Adults Friendly",
  "destination": "Lara / Antalya",
  "latitude": 36.8569,
  "longitude": 30.7965,
  "stars": "5*",
  "roomTypes": [
    { "id": "R1", "name": "DBL ROOM SEAVIEW" },
    { "id": "R4", "name": "Family Suite 2 Bdr" }
  ]
}
```

Bu iki kayıt eşleştirilmeden kullanılırsa otel listede iki kez görünür. Eşleştirildiğinde ise tek bir kalıcı kimlik altında toplanır:

```json
{
  "hm_id": "HM-1052207",
  "name": "Lara Palm Hotel",
  "destination_id": "TR-07-MURATPASA-LARA",
  "destination": ["TR", "Antalya", "Muratpaşa", "Lara"],
  "geo": { "lat": 36.8570, "lng": 30.7963 },
  "supplier_codes": {
    "A": "LPH-20931",
    "B": "770512"
  },
  "rooms": [
    { "hm_room_id": "HM-1052207-R02", "name": "Double Room, Sea View", "supplier_codes": { "A": "DBL-SV", "B": "R1" } },
    { "hm_room_id": "HM-1052207-R04", "name": "Family Room, 2 Bedrooms", "supplier_codes": { "A": "FAM-2B", "B": "R4" } }
  ]
}
```

Örnek veridir; otel adı, adres ve kodlar gerçek bir tesise ait değildir. Burada [HM ID](https://hotelmapping.org/tr/sozluk/hm-id/), her iki [tedarikçi kodunu](https://hotelmapping.org/tr/sozluk/tedarikci-kodu/) aynı otele bağlar. Odalar da aynı mantıkla gruplanır; bu iş [oda eşleştirme](https://hotelmapping.org/tr/urunler/oda-eslestirme-cozumu/) ürününün konusudur.

## Statik veri neden eşleştirme gerektirir?

Tek tedarikçiyle çalışan bir acente için eşleştirme sorunu küçüktür. İkinci tedarikçi eklendiği anda aynı otelin iki kaydı oluşur. Tedarikçi sayısı arttıkça sorun büyür:

- **Mükerrer listeleme:** Aynı otel aramada birden fazla kart olarak görünür; müşteri hangisinin doğru olduğunu anlayamaz. Bu konunun iş etkisini [mükerrer otel maliyeti](https://hotelmapping.org/tr/rehber/mukerrer-otel-maliyeti/) makalesinde ele alıyoruz.
- **Bozuk fiyat karşılaştırması:** Tedarikçilerin aynı otel için verdiği fiyatlar tek kartta toplanamaz.
- **Tutarsız içerik:** Bir tedarikçinin açıklaması eksik, diğerinin koordinatı hatalı olabilir. Doğru alanları birleştirmek için önce kayıtların aynı otel olduğunu bilmek gerekir.
- **Oda ve pansiyon karmaşası:** "DBL ROOM SEAVIEW" ile "Double Room Sea View" aynı odadır; "AI" ile "All Inclusive" aynı pansiyon tipidir. Bunlar da standart bir koda bağlanmalıdır.

Eşleştirme sürecinin ayrıntılarını [otel eşleştirme nedir](https://hotelmapping.org/tr/rehber/otel-eslestirme-nedir/) rehberinde anlatıyoruz. Ürün tarafında karşılığı [otel eşleştirme](https://hotelmapping.org/tr/urunler/otel-eslestirme-cozumu/), [pansiyon tipi eşleştirme](https://hotelmapping.org/tr/urunler/pansiyon-tipi-eslestirme-cozumu/) ve [otel içeriği](https://hotelmapping.org/tr/urunler/otel-aciklamalari-cozumu/) sayfalarındadır.

## Dinamik yanıt statik kayda nasıl bağlanır?

Bir arama yanıtı genellikle yalnız kod taşır. Örneğin B tedarikçisinin müsaitlik yanıtı şöyle bir parça içerebilir:

```json
{
  "hotelId": "770512",
  "offers": [
    { "roomId": "R1", "board": "AI", "price": { "amount": 412.50, "currency": "EUR" }, "refundable": true }
  ]
}
```

Bu yanıtı ekranda göstermek için sisteminiz şu soruları cevaplamalıdır: "770512" hangi otel? "R1" hangi oda? "AI" hangi standart pansiyon tipi? Statik taraf eşleştirilmişse cevap tek bir sorguyla bulunur: tedarikçi kodu HM ID'ye, oda kodu HM oda kimliğine, pansiyon kodu standart koda çevrilir. Böylece farklı tedarikçilerden gelen teklifler aynı otel kartında, aynı oda ve pansiyon başlığı altında yan yana gösterilebilir.

Bu çeviri her aramada tekrarlandığı için hızlı olmalıdır. Bu nedenle eşleştirme sonuçları çoğunlukla sizin tarafınızda bir tablo olarak tutulur ve arama anında yalnız bu tabloya bakılır. Tablonun kaynağı bir API, günlük dump veya ikisinin birleşimi olabilir. Tek tek kod sorgulamak için [eşleştirme API'si](https://hotelmapping.org/tr/urunler/eslestirme-api-cozumu/) de kullanılabilir.

## Statik veri nasıl güncel tutulur?

Statik veri yavaş değişir, ama değişir: oteller açılır, kapanır, adını veya sahibini değiştirir; tedarikçiler kod siler veya yeni kod verir. Bu değişiklikleri izlemek için üç yaygın yöntem vardır:

| Yöntem | Nasıl çalışır | Uygun olduğu durum |
| --- | --- | --- |
| Tam dump | Tüm katalog belirli aralıklarla baştan indirilir | İlk kurulum, küçük katalog, periyodik tam kontrol |
| Delta dump | Yalnız son dökümden bu yana eklenen, değişen ve silinen kayıtlar alınır | Büyük katalog, düzenli güncelleme |
| Webhook | Değişiklik olduğunda karşı taraf size bildirim gönderir | Hızlı tepki gereken kod değişiklikleri |

[Delta dump](https://hotelmapping.org/tr/sozluk/delta-dump/) yaklaşımında silinen veya birleşen kayıtların da açıkça bildirilmesi önemlidir. Aksi halde sisteminizde artık var olmayan bir otel kodu kalır ve aramada hata üretir.

## Entegrasyon projelerinde sık görülen hatalar

- **Statik veriyi hiç güncellememek:** İlk indirmeden sonra veri eskir; kapanan oteller satışta kalır, yeni oteller görünmez.
- **Tedarikçi kodunu tek kimlik saymak:** Tedarikçi kodu yalnız o tedarikçi için anlamlıdır. Birden çok tedarikçi varsa kendi kalıcı kimliğinize ihtiyaç duyarsınız.
- **Eşleştirmeyi yalnız ada göre yapmak:** Aynı ada sahip farklı oteller vardır; aynı otel ise farklı adlarla gelir. Koordinat, adres, telefon ve web adresi birlikte değerlendirilmelidir.
- **Oda ve pansiyon kodlarını serbest metin olarak bırakmak:** Ekranda "DBL ROOM SEAVIEW" ile "Double Room Sea View" yan yana görünür; karşılaştırma bozulur.
- **Koordinatı doğrulamamak:** Tedarikçiler bazen şehir merkezinin veya yanlış bir noktanın koordinatını gönderir. Bu hem harita gösterimini hem de eşleştirmeyi bozar.
- **Kod değişikliklerini izlememek:** Tedarikçi bir kodu silip yeni kod verdiğinde eski eşleşme sessizce kırılır.

## Yeni bir tedarikçi bağlarken kontrol listesi

Yeni bir XML entegrasyonuna başlamadan önce şu soruların cevabını netleştirmek işinizi kolaylaştırır:

1. Statik veri hangi biçimde ve hangi kanalla geliyor (API, dosya, FTP)?
2. Tam dump ve delta ne sıklıkla yayınlanıyor; silinen kayıtlar bildiriliyor mu?
3. Oda ve pansiyon tipleri kodlu mu, yoksa serbest metin mi?
4. Destinasyon kodları hangi hiyerarşiyi izliyor?
5. Arama yanıtındaki kodlar statik veriyle birebir aynı mı?
6. Önbellek ve yeniden kontrol kuralları neler?

Eşleştirme hizmeti seçiyorsanız sorulacak daha ayrıntılı soruları [hotel mapping API seçerken sorulması gereken 12 soru](https://hotelmapping.org/tr/rehber/hotel-mapping-api-secerken-12-soru/) makalesinde topladık. Hazır tedarikçi bağlantılarının listesi [entegrasyonlar](https://hotelmapping.org/tr/entegrasyonlar/) sayfasında yer alır; örneğin [Hotelbeds](https://hotelmapping.org/tr/entegrasyonlar/hotelbeds-otel-eslestirme-cozumu/) sayfası bir bedbank'in statik verisinde hangi alanları eşleştirdiğimizi gösterir.

## hotelmapping.org bu yapının neresinde?

hotelmapping.org, XML entegrasyonunun statik tarafında çalışır. Tedarikçilerinizin statik verisini alır, normalleştirir ve aynı oteli tek bir kalıcı HM ID'ye bağlar. Oda adlarını, pansiyon tiplerini ve destinasyon kodlarını standart karşılıklarına çevirir. Sonucu REST API ve günlük tam veya delta dump olarak teslim eder.

Fiyat, müsaitlik, rezervasyon ve iptal adımları ise sizin sisteminizle tedarikçiniz arasında kalır; bu veriyi hotelmapping.org taşımaz veya saklamaz. Böylece dinamik akışınıza yeni bir ara katman eklemeden, arama yanıtlarındaki kodları kendi tarafınızdaki eşleştirme tablosuyla birleştirebilirsiniz. API uç noktaları ve örnek yanıtlar [geliştiriciler](https://hotelmapping.org/tr/gelistiriciler/) sayfasındadır.

## Sık sorulan sorular

### XML entegrasyonu ile API entegrasyonu aynı şey mi?

Sektörde çoğunlukla aynı anlamda kullanılır. "XML entegrasyonu" ifadesi, ilk web servislerinin XML kullanmasından kalmadır. Bugün birçok tedarikçi JSON tabanlı REST API sunar; yine de iş dilinde bu bağlantılara genellikle XML entegrasyonu denir.

### Statik veriyi ne sıklıkla güncellemek gerekir?

Tek bir doğru sıklık yoktur; tedarikçinin değişiklik hızına ve sizin kataloğunuzun büyüklüğüne bağlıdır. Yaygın yaklaşım, başlangıçta tam bir dump almak, ardından düzenli aralıklarla yalnız değişen kayıtları (delta) işlemektir.

### Fiyat ve müsaitlik verisini önbelleğe almak doğru mu?

Kısa süreli önbellek arama hızını artırabilir, ancak fiyat ve müsaitlik hızlı değiştiği için rezervasyondan önce tedarikçiden yeniden kontrol (recheck) yapılması gerekir. Önbellek süresi ve yeniden kontrol kuralları tedarikçinin entegrasyon şartlarında yer alabilir; bunları sözleşme aşamasında kontrol edin.

### hotelmapping.org dinamik veriyi de sağlıyor mu?

Hayır. hotelmapping.org yalnız statik otel verisi tarafında çalışır: otel, oda, pansiyon tipi ve destinasyon eşleştirme ile otel içeriği. Fiyat, müsaitlik ve rezervasyon akışı sizinle tedarikçiniz arasında kalır.

## Kaynaklar

- [W3C: Extensible Markup Language (XML)](https://www.w3.org/XML/)

## İlgili ürünler

- [Otel eşleştirme çözümü](https://hotelmapping.org/tr/urunler/otel-eslestirme-cozumu/)
- [Otel açıklamaları çözümü](https://hotelmapping.org/tr/urunler/otel-aciklamalari-cozumu/)
- [Find Match API çözümü](https://hotelmapping.org/tr/urunler/eslestirme-api-cozumu/)

## İlgili makaleler

- [Otel eşleştirme (hotel mapping) nedir? Nasıl çalışır? Kapsamlı rehber](https://hotelmapping.org/tr/rehber/otel-eslestirme-nedir/)
- [Bedbank nedir? Acenteler bedbank'lerle nasıl çalışır?](https://hotelmapping.org/tr/rehber/bedbank-nedir/)
- [Hotel mapping API seçerken sorulması gereken 12 soru](https://hotelmapping.org/tr/rehber/hotel-mapping-api-secerken-12-soru/)

## İlgili terimler

- [Statik otel verisi](https://hotelmapping.org/tr/sozluk/statik-otel-verisi/)
- [Delta dump](https://hotelmapping.org/tr/sozluk/delta-dump/)
- [Tedarikçi kodu](https://hotelmapping.org/tr/sozluk/tedarikci-kodu/)
- [HM ID](https://hotelmapping.org/tr/sozluk/hm-id/)
- [Bedbank](https://hotelmapping.org/tr/sozluk/bedbank/)
- [Kanal yöneticisi](https://hotelmapping.org/tr/sozluk/kanal-yoneticisi/)
