حلول مطابقة الفنادق
معرّف HM ID دائم لكل منشأة، مع رموز الموردين والمعرّفات المتقاطعة في سجل واحد.
تفكّك مطابقة الغرف الأسماء المختلفة التي يرسلها الموردون للغرفة الواحدة إلى سمات: نوع الغرفة والفئة والإطلالة والسرير والميزات والسعة، ثم تجمع الغرفة نفسها في معرّف غرفة واحد مرتبط بمعرّف HM ID للفندق (مثل 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"
}
} تُربط "DBL SV BLC" و"DZ Meerblick Balkon" و"غرفة مزدوجة بإطلالة بحرية وشرفة" بمعرّف الغرفة نفسه، فتُقارن الأسعار في سطر واحد.
تُحفظ اختصارات الغرف وصيغ كتابتها بالتركية والإنجليزية والألمانية والروسية في قاموس قواعد؛ وحيث لا يكفي القاموس يتدخل نموذج الوسم.
يُفكَّك كل اسم غرفة إلى ست سمات. ولا تحتاج التصفية والترتيب بحسب الإطلالة أو نوع السرير أو السعة إلى تحليل منفصل.
تختلف سمات الغرف المطلة على اليابسة عن المطلة على البحر؛ لذلك تبقى في معرّفات غرف منفصلة ولا تُعرض في السطر نفسه.
تُطابَق عدة أسماء غرف فورًا في طلب واحد، كما تتوفر المعالجة الدفعية وتسليم الملفات لكامل المخزون.
أسماء الغرفة الواحدة القادمة من ثلاثة موردين
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) سجل غرفة واحد مفكَّك إلى سمات
{
"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"
}
} هذه بيانات توضيحية؛ الفندق وأسماء الغرف والرموز لا تخص منشأة حقيقية.
يُقسَّم اسم الغرفة إلى كلمات واختصارات. وتُطبَّع حالة الأحرف وعلامات الترقيم والسعة بين القوسين ("2+1") والفروق اللغوية.
يُطابَق كل جزء مع قاموس الاختصارات بالتركية والإنجليزية والألمانية والروسية: "SV" و"Meerblick" و"Deniz Manzaralı" تقع تحت سمة الإطلالة نفسها.
الأجزاء غير الموجودة في القاموس أو التي تحمل أكثر من معنى يسندها نموذج وسم إلى النوع أو الفئة أو الإطلالة أو السرير أو الميزة أو السعة.
تُقارن الغرف المرتبطة بمعرّف HM ID نفسه بحسب سماتها. الأسماء المتطابقة السمات تُربط بمعرّف الغرفة نفسه، والسجلات المتعارضة تذهب إلى المراجعة البشرية.
تعود النتيجة فورًا في استجابة API، وكملف في المعالجات الدفعية. ويُحفظ كل رمز غرفة لمورّد مع معرّف الغرفة المرتبط به.
يكتب كل مورّد اسم الغرفة وفق قواعد نظامه. فأحدهم يستخدم الاختصارات (“DBL SV BLC”)، وآخر يستخدم لغة كتالوج منظمي الرحلات الألمان (“DZ Meerblick”)، وثالث يرسل الاسم التركي المسجّل لدى الفندق كما هو. وإذا كان في الفندق 10 أنواع غرف و5 موردين يصل عدد الأسماء المطلوب مطابقتها إلى 50. المطابقة اليدوية بطيئة، ويسهل أن يفوتها فرق في الإطلالة أو السعة.
تفكّك مطابقة الغرف كل اسم إلى السمات الست نفسها، وتجري المقارنة عبر هذه السمات بدلًا من الأسماء. لمزيد من التفاصيل راجعوا دليل ما هي مطابقة الغرف، وللإطار العام راجعوا دليل مطابقة الفنادق.
| السمة | ما تصفه | أمثلة على القيم |
|---|---|---|
| النوع | فئة الغرفة | غرفة، جناح، جناح جونيور، استوديو، غرفة عائلية، فيلا، بنغالو، شقة |
| الفئة | مستوى الراحة | اقتصادية، قياسية، سوبريور، ديلوكس |
| الإطلالة | ما يُرى من النافذة | بحر، بحر جانبي، يابسة، حديقة، مسبح |
| السرير | ترتيب الأسرّة | فردي (single)، مزدوج (double)، سريران منفصلان (twin)، king، queen |
| الميزة | تجهيزات إضافية | شرفة، تراس، جاكوزي، غرفة تفتح على المسبح، غرفة متصلة |
| السعة | أقصى عدد للأشخاص | SGL = 1، DBL = 2، TRP = 3، QUAD = 4؛ 2+1، 2+2 |
يربط قاموس القواعد صيغ كتابة المفهوم نفسه في أربع لغات بسمة واحدة. الأسطر التالية أمثلة؛ والقائمة الكاملة في دليل اختصارات أنواع الغرف.
| المفهوم | 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 للفندق عبر مطابقة الفنادق. ولكي تكون مقارنة الأسعار صحيحة تلزم مع الغرفة أيضًا مطابقة أنظمة الوجبات. وللمصطلحات راجعوا صفحتي القاموس مطابقة الغرف ورمز المورّد.
الطلب
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" }
]
}' الاستجابة
{
"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.
نعم. تُقارن أسماء الغرف بغرف الفندق نفسه فقط. لذلك يُحدَّد أولًا معرّف HM ID للفندق، ثم تُجمَّع أسماء غرف الموردين الخاصة بذلك الفندق.
يُوسَم الاسم الجديد من جديد. وإذا لم تتغير السمات يبقى مرتبطًا بمعرّف الغرفة نفسه. أما إذا تغيرت فيدخل السجل قائمة المراجعة ويُربط عند الحاجة بمعرّف غرفة آخر.
من المخطط تطبيق منطق العتبات المتبع في مطابقة الفنادق على الغرف أيضًا: 0.97 فأكثر يُربط تلقائيًا، وما بين 0.80 و0.97 يذهب إلى خبير، وما دون 0.80 يفتح سجل غرفة جديدًا. وتُعاد قرارات الخبراء إلى القاموس والنموذج.
يغطي قاموس القواعد عند الإطلاق اختصارات التركية والإنجليزية والألمانية والروسية. أما نطاق التغطية للعربية واللغات الأخرى فلم يُحسم بعد.
لا. تقوم مطابقة الغرف بتوحيد بيانات الغرف الثابتة فقط. الأسعار والتوافر تصل من المورّد إلى نظامكم، ونحن نخبركم فقط بالغرفة التي تنتمي إليها.
اطلب عرض سعر
أرسل طلبك في ثلاث خطوات، ونرسل العرض إلى بريدك الإلكتروني للعمل. الطلب غير ملزم.