# حلول مطابقة الغرف

> URL: https://hotelmapping.org/ar/products/room-mapping-solutions/ · اللغة: العربية

تفكّك مطابقة الغرف الأسماء المختلفة التي يرسلها الموردون للغرفة الواحدة إلى سمات: نوع الغرفة والفئة والإطلالة والسرير والميزات والسعة، ثم تجمع الغرفة نفسها في معرّف غرفة واحد مرتبط بمعرّف HM ID للفندق (مثل HM-1048213-R03). وهكذا يمكن مقارنة أسعار الموردين المختلفة للغرفة نفسها جنبًا إلى جنب.

## ما الذي تكسبه

- **غرفة واحدة، سطر واحد:** تُربط "DBL SV BLC" و"DZ Meerblick Balkon" و"غرفة مزدوجة بإطلالة بحرية وشرفة" بمعرّف الغرفة نفسه، فتُقارن الأسعار في سطر واحد.
- **قاموس اختصارات متعدد اللغات:** تُحفظ اختصارات الغرف وصيغ كتابتها بالتركية والإنجليزية والألمانية والروسية في قاموس قواعد؛ وحيث لا يكفي القاموس يتدخل نموذج الوسم.
- **بيانات غرف منظّمة:** يُفكَّك كل اسم غرفة إلى ست سمات. ولا تحتاج التصفية والترتيب بحسب الإطلالة أو نوع السرير أو السعة إلى تحليل منفصل.
- **يُحفظ الفرق في الإطلالة والسعة:** تختلف سمات الغرف المطلة على اليابسة عن المطلة على البحر؛ لذلك تبقى في معرّفات غرف منفصلة ولا تُعرض في السطر نفسه.
- **فوري أو دفعي:** تُطابَق عدة أسماء غرف فورًا في طلب واحد، كما تتوفر المعالجة الدفعية وتسليم الملفات لكامل المخزون.

## قبل وبعد

أسماء الغرفة الواحدة القادمة من ثلاثة موردين

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

سجل غرفة واحد مفكَّك إلى سمات

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

_هذه بيانات توضيحية؛ الفندق وأسماء الغرف والرموز لا تخص منشأة حقيقية._

## كيف يعمل

1. **تقطيع اسم الغرفة:** يُقسَّم اسم الغرفة إلى كلمات واختصارات. وتُطبَّع حالة الأحرف وعلامات الترقيم والسعة بين القوسين ("2+1") والفروق اللغوية.
2. **قاموس القواعد:** يُطابَق كل جزء مع قاموس الاختصارات بالتركية والإنجليزية والألمانية والروسية: "SV" و"Meerblick" و"Deniz Manzaralı" تقع تحت سمة الإطلالة نفسها.
3. **نموذج الوسم:** الأجزاء غير الموجودة في القاموس أو التي تحمل أكثر من معنى يسندها نموذج وسم إلى النوع أو الفئة أو الإطلالة أو السرير أو الميزة أو السعة.
4. **التجميع داخل الفندق:** تُقارن الغرف المرتبطة بمعرّف HM ID نفسه بحسب سماتها. الأسماء المتطابقة السمات تُربط بمعرّف الغرفة نفسه، والسجلات المتعارضة تذهب إلى المراجعة البشرية.
5. **التسليم:** تعود النتيجة فورًا في استجابة API، وكملف في المعالجات الدفعية. ويُحفظ كل رمز غرفة لمورّد مع معرّف الغرفة المرتبط به.

## مثال API

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

_أمثلة الشيفرة توضيحية؛ وقد تتغير أسماء الحقول عند إصدار v1._

## لماذا تختلف أسماء الغرف؟

يكتب كل مورّد اسم الغرفة وفق قواعد نظامه. فأحدهم يستخدم الاختصارات ("DBL SV BLC")، وآخر يستخدم لغة كتالوج منظمي الرحلات الألمان ("DZ Meerblick")، وثالث يرسل الاسم التركي المسجّل لدى الفندق كما هو. وإذا كان في الفندق 10 أنواع غرف و5 موردين يصل عدد الأسماء المطلوب مطابقتها إلى 50. المطابقة اليدوية بطيئة، ويسهل أن يفوتها فرق في الإطلالة أو السعة.

تفكّك مطابقة الغرف كل اسم إلى السمات الست نفسها، وتجري المقارنة عبر هذه السمات بدلًا من الأسماء. لمزيد من التفاصيل راجعوا دليل [ما هي مطابقة الغرف](https://hotelmapping.org/ar/guide/what-is-room-mapping/)، وللإطار العام راجعوا [دليل مطابقة الفنادق](https://hotelmapping.org/ar/guide/what-is-hotel-mapping/).

## إلى أي سمات يُفكَّك اسم الغرفة؟

| السمة | ما تصفه | أمثلة على القيم |
| --- | --- | --- |
| النوع | فئة الغرفة | غرفة، جناح، جناح جونيور، استوديو، غرفة عائلية، فيلا، بنغالو، شقة |
| الفئة | مستوى الراحة | اقتصادية، قياسية، سوبريور، ديلوكس |
| الإطلالة | ما يُرى من النافذة | بحر، بحر جانبي، يابسة، حديقة، مسبح |
| السرير | ترتيب الأسرّة | فردي (single)، مزدوج (double)، سريران منفصلان (twin)، king، queen |
| الميزة | تجهيزات إضافية | شرفة، تراس، جاكوزي، غرفة تفتح على المسبح، غرفة متصلة |
| السعة | أقصى عدد للأشخاص | SGL = 1، DBL = 2، TRP = 3، QUAD = 4؛ 2+1، 2+2 |

## قاموس الاختصارات

يربط قاموس القواعد صيغ كتابة المفهوم نفسه في أربع لغات بسمة واحدة. الأسطر التالية أمثلة؛ والقائمة الكاملة في دليل [اختصارات أنواع الغرف](https://hotelmapping.org/ar/guide/room-type-abbreviations/).

| المفهوم | EN | DE | TR | RU |
| --- | --- | --- | --- | --- |
| استخدام فردي (السعة 1) | SGL | EZ (Einzelzimmer) | Tek kişilik | одноместный |
| استخدام مزدوج (السعة 2) | DBL | DZ (Doppelzimmer) | Çift kişilik | двухместный |
| سريران منفصلان (السرير: twin) | TWN | 2 Einzelbetten | İki ayrı yataklı | две кровати |
| غرفة عائلية | FAM | FZ (Familienzimmer) | Aile odası | семейный номер |
| إطلالة بحرية | SV | Meerblick | Deniz manzaralı | вид на море |
| شرفة | BLC | Balkon | Balkonlu | балкон |
| جناح | STE | Suite | Süit | люкс |

يدل DBL لدى معظم الموردين على غرفة لشخصين، ولا يذكر نوع السرير دائمًا. لذلك يُقرأ "DBL" أولًا على أنه سعة (شخصان على الأقل). وإن لم يرد في الاسم TWN أو "twin" تكون سمة السرير double؛ وإذا وُجدت إشارة أوضح مثل "king" فتُستخدم. أما سمة النوع فهي فئة الغرفة: "DBL Sea View" غرفة (room)، و"Junior Suite" جناح جونيور.

تعمل مطابقة الغرف بين غرف الفندق الواحد فقط؛ لذلك يُحدَّد أولًا معرّف HM ID للفندق عبر [مطابقة الفنادق](https://hotelmapping.org/ar/products/hotel-mapping-solutions/). ولكي تكون مقارنة الأسعار صحيحة تلزم مع الغرفة أيضًا [مطابقة أنظمة الوجبات](https://hotelmapping.org/ar/products/board-mapping-solutions/). وللمصطلحات راجعوا صفحتي القاموس [مطابقة الغرف](https://hotelmapping.org/ar/glossary/room-mapping/) و[رمز المورّد](https://hotelmapping.org/ar/glossary/supplier-code/).

## الأسئلة الشائعة

### هل تُجرى مطابقة الغرف بعد مطابقة الفنادق؟

نعم. تُقارن أسماء الغرف بغرف الفندق نفسه فقط. لذلك يُحدَّد أولًا معرّف HM ID للفندق، ثم تُجمَّع أسماء غرف الموردين الخاصة بذلك الفندق.

### ماذا يحدث إذا تغيّر اسم الغرفة لدى المورّد؟

يُوسَم الاسم الجديد من جديد. وإذا لم تتغير السمات يبقى مرتبطًا بمعرّف الغرفة نفسه. أما إذا تغيرت فيدخل السجل قائمة المراجعة ويُربط عند الحاجة بمعرّف غرفة آخر.

### ماذا يحدث عند عدم التأكد من السمات؟

من المخطط تطبيق منطق العتبات المتبع في مطابقة الفنادق على الغرف أيضًا: 0.97 فأكثر يُربط تلقائيًا، وما بين 0.80 و0.97 يذهب إلى خبير، وما دون 0.80 يفتح سجل غرفة جديدًا. وتُعاد قرارات الخبراء إلى القاموس والنموذج.

### ما لغات أسماء الغرف المدعومة؟

يغطي قاموس القواعد عند الإطلاق اختصارات التركية والإنجليزية والألمانية والروسية. أما نطاق التغطية للعربية واللغات الأخرى فلم يُحسم بعد.

### هل تجلب مطابقة الغرف بيانات الأسعار أو التوافر أيضًا؟

لا. تقوم مطابقة الغرف بتوحيد بيانات الغرف الثابتة فقط. الأسعار والتوافر تصل من المورّد إلى نظامكم، ونحن نخبركم فقط بالغرفة التي تنتمي إليها.

## منتجات ذات صلة

- [حلول مطابقة الفنادق](https://hotelmapping.org/ar/products/hotel-mapping-solutions/)
- [حلول مطابقة أنظمة الوجبات](https://hotelmapping.org/ar/products/board-mapping-solutions/)
- [حلول Find Match API](https://hotelmapping.org/ar/products/match-api-solutions/)

## مقالات ذات صلة

- [ما هي مطابقة الغرف؟ لماذا تختلط أسماء الغرف إلى هذا الحد؟](https://hotelmapping.org/ar/guide/what-is-room-mapping/)
- [مسرد اختصارات أنواع الغرف: SGL وDBL وTWN وTRP وSV وLV وFAM](https://hotelmapping.org/ar/guide/room-type-abbreviations/)
- [ما هي مطابقة الفنادق (hotel mapping) وكيف تعمل؟ دليل شامل](https://hotelmapping.org/ar/guide/what-is-hotel-mapping/)
