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

> URL: https://hotelmapping.org/tr/urunler/oda-eslestirme-cozumu/ · Dil: Türkçe

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

```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**

```json
{
  "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. **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. **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. **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. **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. **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.

## API örneği

**POST /v1/rooms/map**

```bash
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" }
    ]
  }'
```

**200 OK**

```json
{
  "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._

## 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](https://hotelmapping.org/tr/rehber/oda-eslestirme-nedir/) rehberine, genel çerçeve için [otel eşleştirme rehberine](https://hotelmapping.org/tr/rehber/otel-eslestirme-nedir/) 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ı](https://hotelmapping.org/tr/rehber/oda-tipi-kisaltmalari/) 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](https://hotelmapping.org/tr/urunler/otel-eslestirme-cozumu/) 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](https://hotelmapping.org/tr/urunler/pansiyon-tipi-eslestirme-cozumu/) de gerekir. Terimler için [oda eşleştirme](https://hotelmapping.org/tr/sozluk/oda-eslestirme/) ve [tedarikçi kodu](https://hotelmapping.org/tr/sozluk/tedarikci-kodu/) sözlük sayfalarına bakabilirsiniz.

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

## İlgili ürünler

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

## İlgili makaleler

- [Oda eşleştirme nedir? Oda adları neden bu kadar karışık?](https://hotelmapping.org/tr/rehber/oda-eslestirme-nedir/)
- [Oda tipi kısaltmaları sözlüğü: SGL, DBL, TWN, TRP, SV, LV, FAM](https://hotelmapping.org/tr/rehber/oda-tipi-kisaltmalari/)
- [Otel eşleştirme (hotel mapping) nedir? Nasıl çalışır? Kapsamlı rehber](https://hotelmapping.org/tr/rehber/otel-eslestirme-nedir/)
