Oda eşleştirme çözümü

Oda eşleştirme, tedarikçilerin aynı oda için gönderdiği farklı adları oda tipi, sınıf, manzara, yatak, özellik ve kapasite etiketlerine ayırır ve aynı odayı otelin HM ID'sine bağlı tek bir oda kimliğinde (ör. HM-1048213-R03) toplar. Böylece aynı odanın farklı tedarikçi fiyatları yan yana karşılaştırılabilir.

Neler kazanırsınız

  • Aynı oda, tek satır

    "DBL SV BLC", "DZ Meerblick Balkon" ve "Deniz Manzaralı Balkonlu Çift Kişilik Oda" aynı oda kimliğine bağlanır; fiyatlar tek satırda karşılaştırılır.

  • Çok dilli kısaltma sözlüğü

    TR, EN, DE ve RU oda kısaltmaları ve yazım biçimleri kural sözlüğünde tutulur; sözlüğün yetmediği yerde etiketleme modeli devreye girer.

  • Yapılandırılmış oda verisi

    Her oda adı altı etikete ayrılır. Manzara, yatak tipi veya kapasiteye göre filtreleme ve sıralama ayrı bir ayrıştırma gerektirmez.

  • Manzara ve kapasite farkı korunur

    Kara manzaralı ve deniz manzaralı odaların etiketleri farklıdır; bu yüzden ayrı oda kimliklerinde kalır ve aynı satırda gösterilmez.

  • Anında veya toplu

    Tek bir istekte birkaç oda adı anında eşleştirilir; tüm envanter için toplu işlem ve dosya teslimi de yapılır.

Önce ve sonra

Aynı oda için üç tedarikçiden gelen adlar

supplier_rooms.csv
supplier,hotel_code,room_code,room_name
A,HTL-88213,DBLSV-B,Dbl Sea View Balcony
B,40917,DZMB,DZ Meerblick Balkon
C,TR-ANT-551,STD-DNZ,Standart Oda Deniz Manzaralı Balkonlu (2+1)

Etiketlere ayrılmış tek oda kaydı

HM-1048213-R03
{
  "room_id": "HM-1048213-R03",
  "hm_id": "HM-1048213",
  "name": "Standard Double Room, Sea View, Balcony",
  "type": "room",
  "class": "standard",
  "view": "sea",
  "bed": "double",
  "features": ["balcony"],
  "max_occupancy": 3,
  "supplier_rooms": {
    "A": "DBLSV-B",
    "B": "DZMB",
    "C": "STD-DNZ"
  }
}

Örnek veridir; otel, oda adları ve kodlar gerçek bir tesise ait değildir.

Nasıl çalışır

  1. 1

    Oda adını parçalama

    Oda adı kelimelere ve kısaltmalara ayrılır. Büyük-küçük harf, noktalama, parantez içi kapasite ("2+1") ve dil farkları normalleştirilir.

  2. 2

    Kural sözlüğü

    Her parça TR, EN, DE ve RU kısaltma sözlüğüyle eşlenir: "SV", "Meerblick" ve "Deniz Manzaralı" aynı manzara etiketine düşer.

  3. 3

    Etiketleme modeli

    Sözlükte olmayan veya birden fazla anlama gelen parçaları bir etiketleme modeli tip, sınıf, manzara, yatak, özellik ya da kapasiteye atar.

  4. 4

    Otel içinde gruplama

    Aynı HM ID'ye bağlı odalar etiketlerine göre karşılaştırılır. Etiketleri uyuşan adlar aynı oda kimliğine bağlanır; çelişen kayıtlar insan kontrolüne gider.

  5. 5

    Teslim

    Sonuç API yanıtında anında, toplu işlerde ise dosya olarak döner. Her tedarikçi oda kodu, bağlandığı oda kimliğiyle birlikte saklanır.

Oda adları neden karışık?

Her tedarikçi oda adını kendi sisteminin kurallarına göre yazar. Biri kısaltma kullanır (“DBL SV BLC”), biri Alman tur operatörü katalog dilini kullanır (“DZ Meerblick”), biri oteldeki Türkçe adı olduğu gibi gönderir. Bir otelde 10 oda tipi ve 5 tedarikçi varsa eşleştirilecek ad sayısı 50’ye çıkar. Elle eşleştirme yavaştır; manzara veya kapasite farkı kolayca gözden kaçar.

Oda eşleştirme her adı aynı altı etikete ayırır ve karşılaştırmayı adlar yerine bu etiketler üzerinden yapar. Konunun ayrıntılı anlatımı için oda eşleştirme nedir rehberine, genel çerçeve için otel eşleştirme rehberine bakabilirsiniz.

Oda adı hangi etiketlere ayrılır?

Etiket Ne anlatır Örnek değerler
Tip Oda kategorisi Oda, süit, junior süit, stüdyo, aile odası, villa, bungalov, apart
Sınıf Konfor seviyesi Ekonomi, standart, superior, deluxe
Manzara Pencereden görünen Deniz, yan deniz, kara, bahçe, havuz
Yatak Yatak düzeni Tek kişilik (single), çift kişilik (double), iki ayrı yatak (twin), king, queen
Özellik Ek donanım Balkon, teras, jakuzi, havuza açılan oda, bağlantılı oda
Kapasite En fazla kişi sayısı SGL = 1, DBL = 2, TRP = 3, QUAD = 4; 2+1, 2+2

Kısaltma sözlüğü

Kural sözlüğü aynı kavramın dört dildeki yazımlarını tek etikete bağlar. Aşağıdaki satırlar örnektir; tam liste oda tipi kısaltmaları rehberindedir.

Kavram EN DE TR RU
Tek kişilik kullanım (kapasite 1) SGL EZ (Einzelzimmer) Tek kişilik одноместный
İki kişilik kullanım (kapasite 2) DBL DZ (Doppelzimmer) Çift kişilik двухместный
İki ayrı yatak (yatak: twin) TWN 2 Einzelbetten İki ayrı yataklı две кровати
Aile odası FAM FZ (Familienzimmer) Aile odası семейный номер
Deniz manzarası SV Meerblick Deniz manzaralı вид на море
Balkon BLC Balkon Balkonlu балкон
Süit STE Suite Süit люкс

DBL çoğu tedarikçide iki kişilik odayı belirtir; yatak tipini her zaman söylemez. Bu yüzden “DBL” önce kapasite olarak okunur (en az 2 kişi). Adda TWN veya “twin” yoksa yatak etiketi double olur; “king” gibi daha açık bir ipucu varsa o kullanılır. Tip etiketi ise oda kategorisidir: “DBL Sea View” bir oda (room), “Junior Suite” bir junior süittir.

Oda eşleştirme yalnız aynı otelin odaları arasında çalışır; bu yüzden önce otel eşleştirme ile otelin HM ID’si belirlenir. Fiyat karşılaştırmasının doğru olması için oda ile birlikte pansiyon tipi eşleştirme de gerekir. Terimler için oda eşleştirme ve tedarikçi kodu sözlük sayfalarına bakabilirsiniz.

Otel eşleştirme nedir? Kapsamlı rehber

API örneği

İstek

POST /v1/rooms/map
curl -X POST https://api.hotelmapping.org/v1/rooms/map \
  -H "X-API-Key: $HM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "hm_id": "HM-1048213",
    "rooms": [
      { "supplier": "B", "code": "DZMB", "name": "DZ Meerblick Balkon" },
      { "supplier": "B", "code": "FZLS", "name": "FZ Landseite" }
    ]
  }'

Yanıt

200 OK
{
  "hm_id": "HM-1048213",
  "groups": [
    {
      "room_id": "HM-1048213-R03",
      "type": "room",
      "class": "standard",
      "view": "sea",
      "bed": "double",
      "features": ["balcony"],
      "max_occupancy": 3,
      "matched": [
        { "supplier": "B", "code": "DZMB", "name": "DZ Meerblick Balkon", "confidence": 0.98, "decision": "auto_match" }
      ]
    },
    {
      "room_id": "HM-1048213-R07",
      "type": "family_room",
      "class": "standard",
      "view": "land",
      "bed": null,
      "features": [],
      "max_occupancy": 4,
      "matched": [
        { "supplier": "B", "code": "FZLS", "name": "FZ Landseite", "confidence": 0.91, "decision": "review" }
      ]
    }
  ]
}

Kod örnekleri temsilidir; alan adları v1 yayınında değişebilir.

Sık sorulan sorular

Oda eşleştirme otel eşleştirmesinden sonra mı yapılır?

Evet. Oda adları yalnız aynı otelin odalarıyla karşılaştırılır. Bu yüzden önce otelin HM ID'si belirlenir, ardından o otele ait tedarikçi oda adları gruplanır.

Tedarikçi oda adı değişirse ne olur?

Yeni ad yeniden etiketlenir. Etiketler değişmediyse aynı oda kimliğine bağlı kalır. Değiştiyse kayıt kontrol kuyruğuna düşer ve gerekirse başka bir oda kimliğine bağlanır.

Etiketlerde emin olunamazsa ne yapılıyor?

Otel eşleştirmedeki eşik mantığının oda için de uygulanması planlanıyor: 0,97 ve üstü otomatik bağlanır, 0,80–0,97 arası bir uzmana gider, 0,80 altı yeni bir oda kaydı açar. Uzman kararları sözlüğe ve modele geri beslenir.

Hangi dillerdeki oda adları destekleniyor?

Kural sözlüğü lansmanda Türkçe, İngilizce, Almanca ve Rusça kısaltmaları kapsar. Arapça ve diğer diller için kapsam henüz kesinleşmedi.

Oda eşleştirme fiyat veya müsaitlik verisi de getirir mi?

Hayır. Oda eşleştirme yalnız statik oda verisini standartlaştırır. Fiyat ve müsaitlik tedarikçiden sizin sisteminize gelir; biz yalnız hangi odaya ait olduğunu söyleriz.

Teklif al

Size özel teklifi alın

Talebinizi üç adımda gönderin; teklifi iş e-postanıza iletelim. Talep bağlayıcı değildir.

  1. 1 Çözümleri seçin
  2. 2 Tedarikçileri seçin
  3. 3 İletişim bilgilerinizi bırakın