# ما هو تكامل XML للفنادق؟ الفرق بين البيانات الثابتة والديناميكية

> URL: https://hotelmapping.org/ar/guide/what-is-hotel-xml-integration/ · اللغة: العربية · آخر تحديث: 2026-11-15

**تكامل XML للفنادق هو اتصال وكالة أو منصة حجز بنظام المورّد عبر خدمة ويب لجلب بيانات الفنادق تلقائيًا. تتغير البيانات الثابتة (الاسم والعنوان والإحداثيات وأنواع الغرف والصور) نادرًا، فتُنزَّل مسبقًا وتُحفظ. أما البيانات الديناميكية (التوفر والسعر وشرط الإلغاء) فيُستعلم عنها مباشرة في كل بحث، وتُربط بالسجل الثابت برمز المورّد.**

## ماذا يعني تكامل XML للفنادق؟

بدلًا من إدخال معلومات الفنادق التي تبيعها وأسعارها يدويًا واحدًا واحدًا، تتصل الوكالات الإلكترونية بموردين مثل بنك الأسرّة وتجار الجملة ومنصات الحجز ومديري القنوات عبر خدمة ويب. تصل معلومات الفندق والسعر والتوفر تلقائيًا من هذا الاتصال. ويسمى هذا الاتصال في القطاع باختصار **تكامل XML**.

لهذا التكامل طرفان. في أحدهما يقدم المورّد مخزونه وأسعاره بوصفها خدمة. وفي الآخر تستدعي الوكالة أو منظم الرحلات أو موقع metasearch هذه الخدمة، ويحوّل الرد إلى نظامه ويعرضه على عميله. ومع زيادة عدد الموردين يكبر عمل التحويل هذا؛ لأن كل مورّد يرسل الفندق نفسه باسمه الخاص ورمزه الخاص وبنية بياناته الخاصة.

لمزيد من المعلومات عن أنواع الموردين راجعوا دليل [ما هو بنك الأسرّة](https://hotelmapping.org/ar/guide/what-is-a-bedbank/) ومادتي المسرد [بنك الأسرّة](https://hotelmapping.org/ar/glossary/bedbank/) و[مدير القنوات](https://hotelmapping.org/ar/glossary/channel-manager/).

### لماذا يُقال "XML"؟

XML (Extensible Markup Language) صيغة نصية تُنظَّم فيها البيانات بوسوم، وقد وحّدها W3C. وقد بُني معظم أولى خدمات الويب في قطاع السفر على SOAP وXML. ولهذا ترسّخت عبارة "تكامل XML".

يقدم كثير من الموردين اليوم REST API تستخدم JSON؛ وبعضهم ما زال يعمل بـ XML. وفي لغة الأعمال يُسمى الاثنان غالبًا "تكامل XML". والمهم تقنيًا ليس الصيغة، بل محتوى البيانات، وهل يتعرف الطرفان على الفندق نفسه بوصفه الفندق نفسه.

## الفرق بين البيانات الثابتة والديناميكية

تنقسم البيانات الواردة في تكامل XML للفنادق إلى مجموعتين. وهذا التمييز أساس تصميم النظام: فهو يحدد ما يُحفظ وما يُسأل عنه في كل مرة وأين تُجرى المطابقة.

| الخاصية | البيانات الثابتة | البيانات الديناميكية |
| --- | --- | --- |
| حقول نموذجية | اسم الفندق، العنوان، الإحداثيات، النجوم، الوصف، الصور، المرافق، قائمة أنواع الغرف | التوفر، السعر، الحصة، شرط الإلغاء، خيارات الوجبات الآنية |
| سرعة التغير | بطيئة؛ خلال أيام أو أسابيع | سريعة؛ خلال دقائق أو حتى ثوانٍ |
| طريقة الجلب | تنزيل شامل (dump كامل)، ثم السجلات المتغيرة (delta) | استعلام مباشر في كل بحث |
| أين تُحفظ | في قاعدة بياناتكم | في ذاكرة مؤقتة قصيرة الأمد أو لا تُحفظ إطلاقًا |
| الحاجة إلى المطابقة | عالية؛ يُكتب الفندق نفسه بصيغ مختلفة لدى كل مورّد | غير مباشرة؛ تُربط الرموز في الرد بالسجل الثابت |
| عند الخطأ | فندق مكرر، موقع خاطئ، محتوى ناقص | عرض سعر خاطئ، خطأ في الحجز |

### ماذا تشمل البيانات الثابتة؟

[بيانات الفنادق الثابتة](https://hotelmapping.org/ar/glossary/static-data/) هي المعلومات التي تشكل هوية المنشأة ووصفها. والحقول النموذجية هي:

- رمز الفندق لدى المورّد واسمه
- العنوان والمدينة والبلد ورمز الوجهة لدى المورّد
- الإحداثيات (خط العرض وخط الطول)
- النجوم أو الفئة
- نصوص الوصف والصور
- مرافق المنشأة والغرف
- قائمة أنواع الغرف وأحيانًا قائمة أنظمة الوجبات
- الهاتف والبريد الإلكتروني وعنوان الويب

ولأن هذه البيانات قليلة التغير فلا تُطلب من جديد في كل بحث. تنزّلها الوكالة مسبقًا وتحفظها في قاعدة بياناتها وتعرضها على الشاشة.

### ماذا تشمل البيانات الديناميكية؟

البيانات الديناميكية هي المعلومات السارية في تلك اللحظة لتاريخ وغرفة وعدد أشخاص محددين: هل الغرفة متاحة، وما السعر، وما خيارات الوجبات، وما شرط الإلغاء. تُجلب هذه المعلومات مباشرة من المورّد في كل طلب بحث. ويحتوي الرد على معرّفات مثل رمز الفندق ورمز الغرفة ورمز نظام الوجبات؛ ولعرض نتيجة ذات معنى على الشاشة يلزم دمج هذه الرموز مع البيانات الثابتة.

## مسار تكامل XML للفنادق النموذجي

مع اختلاف الأسماء والتفاصيل من مورّد لآخر، تتبع معظم التكاملات خطوات متشابهة:

1. **تنزيل المحتوى الثابت:** تُجلب قائمة الفنادق والأوصاف والصور وأنواع الغرف دفعة واحدة وتُحفظ.
2. **البحث (availability):** تُرسل وجهة المستخدم وتاريخه وعدد أشخاصه إلى المورّد؛ فتعود الفنادق المتاحة بأسعارها.
3. **إعادة التحقق (recheck أو prebook):** عندما يختار المستخدم خيارًا يُعاد التحقق من السعر والتوفر وتُثبَّت شروط الإلغاء.
4. **الحجز (book):** يُنشأ الحجز ببيانات النزيل؛ ويعيد المورّد رقم حجز.
5. **الاستعلام والإلغاء:** يُستعلم عن حالة الحجز أو يُلغى.

الخطوة الأولى ثابتة والباقي مرتبط بالبيانات الديناميكية. يُنظّف hotelmapping.org ويطابق فقط البيانات الناتجة عن الخطوة الأولى؛ أما خطوات البحث والحجز والإلغاء فتبقى بين نظامكم والمورّد.

## مثال: الفندق نفسه، موردان، صيغتان

في المثال التالي يصل فندق وهمي اسمه "Lara Palm Hotel" من موردين. يرسل المورّد الأول XML:

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

ويرسل المورّد الثاني الفندق نفسه بصيغة JSON، باسم ورمز مختلفين:

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

إذا استُخدم هذان السجلان دون مطابقة ظهر الفندق مرتين في القائمة. أما إذا طُوبقا فيُجمعان تحت معرّف دائم واحد:

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

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

## لماذا تحتاج البيانات الثابتة إلى مطابقة؟

مشكلة المطابقة صغيرة بالنسبة لوكالة تعمل مع مورّد واحد. وفي اللحظة التي يُضاف فيها المورّد الثاني ينشأ سجلان للفندق نفسه. وتكبر المشكلة بزيادة عدد الموردين:

- **الإدراج المكرر:** يظهر الفندق نفسه في البحث أكثر من بطاقة؛ فلا يفهم العميل أيها الصحيحة. وقد تناولنا الأثر التجاري لهذا الموضوع في مقالة [كلفة الفنادق المكررة](https://hotelmapping.org/ar/guide/cost-of-duplicate-hotel-listings/).
- **اختلال مقارنة الأسعار:** لا يمكن جمع أسعار الموردين للفندق نفسه في بطاقة واحدة.
- **محتوى غير متسق:** قد يكون وصف أحد الموردين ناقصًا وإحداثيات آخر خاطئة. ولدمج الحقول الصحيحة يلزم أولًا معرفة أن السجلات هي الفندق نفسه.
- **ارتباك الغرف والوجبات:** "DBL ROOM SEAVIEW" و"Double Room Sea View" غرفة واحدة؛ و"AI" و"All Inclusive" نظام وجبات واحد. وينبغي ربطها برمز قياسي أيضًا.

نشرح تفاصيل عملية المطابقة في دليل [ما هي مطابقة الفنادق](https://hotelmapping.org/ar/guide/what-is-hotel-mapping/). وما يقابلها من المنتجات في صفحات [مطابقة الفنادق](https://hotelmapping.org/ar/products/hotel-mapping-solutions/) و[مطابقة أنظمة الوجبات](https://hotelmapping.org/ar/products/board-mapping-solutions/) و[محتوى الفنادق](https://hotelmapping.org/ar/products/hotel-descriptions-solutions/).

## كيف يرتبط الرد الديناميكي بالسجل الثابت؟

يحمل رد البحث عادةً رموزًا فقط. فمثلًا قد يتضمن رد التوفر من المورّد B مقطعًا كهذا:

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

لعرض هذا الرد على الشاشة يجب أن يجيب نظامكم عن الأسئلة التالية: أي فندق هو "770512"؟ وأي غرفة هي "R1"؟ وأي نظام وجبات قياسي هو "AI"؟ فإذا كان الجانب الثابت مطابَقًا وُجدت الإجابة باستعلام واحد: يُحوَّل رمز المورّد إلى HM ID ورمز الغرفة إلى معرّف غرفة HM ورمز الوجبات إلى الرمز القياسي. وهكذا يمكن عرض العروض القادمة من موردين مختلفين جنبًا إلى جنب في بطاقة الفندق نفسها، تحت عنوان الغرفة والوجبات نفسه.

ولأن هذا التحويل يتكرر في كل بحث يجب أن يكون سريعًا. ولذلك تُحفظ نتائج المطابقة غالبًا لديكم في جدول، ويُنظر عند البحث في هذا الجدول فقط. ويمكن أن يكون مصدر الجدول API أو dump يوميًا أو مزيجًا منهما. وللاستعلام عن الرموز واحدًا واحدًا يمكن استخدام [Find Match API](https://hotelmapping.org/ar/products/match-api-solutions/) أيضًا.

## كيف تُبقى البيانات الثابتة محدّثة؟

البيانات الثابتة بطيئة التغير لكنها تتغير: تُفتح فنادق وتُغلق وتغيّر اسمها أو مالكها؛ ويحذف الموردون رموزًا أو يمنحون رموزًا جديدة. وللتتبع هذه التغييرات ثلاث طرق شائعة:

| الطريقة | كيف تعمل | متى تناسب |
| --- | --- | --- |
| dump كامل | يُنزَّل الكتالوج كله من جديد على فترات | الإعداد الأول، الكتالوج الصغير، الفحص الشامل الدوري |
| delta dump | تُجلب فقط السجلات المضافة والمتغيرة والمحذوفة منذ آخر dump | الكتالوج الكبير، التحديث المنتظم |
| webhook | يرسل الطرف الآخر إشعارًا عند حدوث تغيير | تغييرات الرموز التي تحتاج استجابة سريعة |

في نهج [delta dump](https://hotelmapping.org/ar/glossary/delta-dump/) من المهم أن تُبلَّغ السجلات المحذوفة أو المدموجة صراحةً. وإلا بقي في نظامكم رمز فندق لم يعد موجودًا ويسبب خطأً في البحث.

## أخطاء شائعة في مشاريع التكامل

- **عدم تحديث البيانات الثابتة إطلاقًا:** تتقادم البيانات بعد التنزيل الأول؛ فتبقى الفنادق المغلقة معروضة للبيع ولا تظهر الفنادق الجديدة.
- **اعتبار رمز المورّد معرّفًا وحيدًا:** رمز المورّد ذو معنى لذلك المورّد فقط. وإذا كان لديكم عدة موردين فأنتم بحاجة إلى معرّف دائم خاص بكم.
- **المطابقة بالاسم فقط:** توجد فنادق مختلفة بالاسم نفسه؛ وفندق واحد يصل بأسماء مختلفة. ويجب تقييم الإحداثيات والعنوان والهاتف وعنوان الويب معًا.
- **ترك رموز الغرف والوجبات نصًا حرًا:** يظهر "DBL ROOM SEAVIEW" و"Double Room Sea View" جنبًا إلى جنب على الشاشة؛ فتختل المقارنة.
- **عدم التحقق من الإحداثيات:** يرسل الموردون أحيانًا إحداثيات مركز المدينة أو نقطة خاطئة. وهذا يفسد عرض الخريطة والمطابقة معًا.
- **عدم تتبع تغييرات الرموز:** عندما يحذف المورّد رمزًا ويعطي رمزًا جديدًا تنكسر المطابقة القديمة بصمت.

## قائمة فحص عند ربط مورّد جديد

قبل بدء تكامل XML جديد، يسهّل عملكم توضيح إجابات الأسئلة التالية:

1. بأي صيغة وعبر أي قناة تصل البيانات الثابتة (API، ملف، FTP)؟
2. بأي وتيرة يُنشر dump الكامل وdelta، وهل تُبلَّغ السجلات المحذوفة؟
3. هل أنواع الغرف والوجبات مرمّزة أم نص حر؟
4. أي تسلسل هرمي تتبعه رموز الوجهات؟
5. هل الرموز في رد البحث مطابقة حرفيًا للبيانات الثابتة؟
6. ما قواعد التخزين المؤقت وإعادة التحقق؟

وإذا كنتم تختارون خدمة مطابقة فقد جمعنا أسئلة أكثر تفصيلًا في مقالة [12 سؤالًا ينبغي طرحها عند اختيار hotel mapping API](https://hotelmapping.org/ar/guide/12-questions-hotel-mapping-api/). وقائمة الروابط الجاهزة مع الموردين في صفحة [التكاملات](https://hotelmapping.org/ar/integrations/)؛ فمثلًا تبيّن صفحة [Hotelbeds](https://hotelmapping.org/ar/integrations/hotelbeds-hotel-mapping-solutions/) الحقول التي نطابقها في البيانات الثابتة لدى بيدبانك.

## أين موقع hotelmapping.org في هذه البنية؟

يعمل hotelmapping.org على الجانب الثابت من تكامل XML. يأخذ البيانات الثابتة لموردي كم ويطبّعها ويربط الفندق نفسه بـ HM ID دائم واحد. ويحوّل أسماء الغرف وأنظمة الوجبات ورموز الوجهات إلى مقابلاتها القياسية. ويسلّم النتيجة عبر REST API وdump يومي كامل أو delta.

أما خطوات السعر والتوفر والحجز والإلغاء فتبقى بين نظامكم والمورّد؛ ولا ينقل hotelmapping.org هذه البيانات ولا يحفظها. وهكذا يمكنكم دمج الرموز في ردود البحث مع جدول المطابقة لديكم دون إضافة طبقة وسيطة جديدة إلى تدفقكم الديناميكي. نقاط نهاية API وأمثلة الردود في صفحة [المطورين](https://hotelmapping.org/ar/developers/).

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

### هل تكامل XML وتكامل API شيء واحد؟

يُستخدمان في القطاع غالبًا بالمعنى نفسه. عبارة "تكامل XML" موروثة من استخدام أولى خدمات الويب لـ XML. اليوم يقدم كثير من الموردين REST API قائمة على JSON؛ ومع ذلك يُسمى هذا الربط في لغة الأعمال عادةً تكامل XML.

### كم مرة ينبغي تحديث البيانات الثابتة؟

لا توجد وتيرة صحيحة واحدة؛ فهي تتوقف على سرعة تغير بيانات المورّد وحجم كتالوجكم. النهج الشائع هو أخذ dump كامل في البداية، ثم معالجة السجلات المتغيرة فقط (delta) على فترات منتظمة.

### هل من الصحيح تخزين السعر والتوفر مؤقتًا؟

التخزين المؤقت قصير الأمد قد يسرّع البحث، لكن لأن السعر والتوفر يتغيران بسرعة يجب إعادة التحقق (recheck) من المورّد قبل الحجز. وقد ترد مدة التخزين المؤقت وقواعد إعادة التحقق في شروط تكامل المورّد؛ فتحققوا منها في مرحلة التعاقد.

### هل يقدم hotelmapping.org البيانات الديناميكية أيضًا؟

لا. يعمل hotelmapping.org على جانب بيانات الفنادق الثابتة فقط: مطابقة الفنادق والغرف وأنظمة الوجبات والوجهات، ومحتوى الفنادق. أما السعر والتوفر ومسار الحجز فتبقى بينكم وبين المورّد.

## المصادر

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

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

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

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

- [ما هي مطابقة الفنادق (hotel mapping) وكيف تعمل؟ دليل شامل](https://hotelmapping.org/ar/guide/what-is-hotel-mapping/)
- [ما هو بنك الأسرّة؟ كيف تعمل الوكالات مع بنك الأسرّة](https://hotelmapping.org/ar/guide/what-is-a-bedbank/)
- [12 سؤالًا ينبغي طرحها عند اختيار Hotel Mapping API](https://hotelmapping.org/ar/guide/12-questions-hotel-mapping-api/)

## مصطلحات ذات صلة

- [بيانات الفنادق الثابتة](https://hotelmapping.org/ar/glossary/static-data/)
- [Delta dump](https://hotelmapping.org/ar/glossary/delta-dump/)
- [رمز المورّد](https://hotelmapping.org/ar/glossary/supplier-code/)
- [HM ID](https://hotelmapping.org/ar/glossary/hm-id/)
- [Bedbank](https://hotelmapping.org/ar/glossary/bedbank/)
- [مدير القنوات](https://hotelmapping.org/ar/glossary/channel-manager/)
