مرجع XML لأسلوب مدى التوفّر والأسعار والمستودع الإعلاني (ARI)

يقدّم دليل مرجع XML هذا محتوًى مرجعيًا تفصيليًا وأمثلة على الرموز البرمجية الخاصة بالرسائل والعناصر والسمات المختلفة المتاحة لخلاصات "بيانات التوفّر والأسعار والمستودع" (ARI).

‫ARI هو وضع لعرض الأسعار يتحكّم في الأسعار لكل ليلة ومدى التوفّر ومستودع العرض، ويفرض قيودًا على كيفية الجمع بين هذه العناصر. توفّر ARI أيضًا المرونة اللازمة لتضمين الضرائب والرسوم والعروض الترويجية.

تتّبع ARI البروتوكولات العادية الخاصة بـ OpenTravel Alliance (OTA) لبعض أنواع الرسائل الرئيسية التي تحدّد مدى التوفّر والمستودع.

التسعير استنادًا إلى مدة الإقامة

تتيح لك أسعار LOS-based تحديد الأسعار حسب تاريخ تسجيل الوصول ومدة الإقامة، بدلاً من تحديدها حسب تاريخ الإقامة. عند تحديد عنصر <StatusApplicationControl> لتسعير الوحدات السكنية استنادًا إلى مدة الإقامة، تشير السمتان @Start و@End إلى نطاق من تواريخ تسجيل الوصول التي تنطبق عليها الأسعار استنادًا إلى مدة الإقامة.

مع أنّ الأسعار المستندة إلى مدة الإقامة لا تتضمّن أسعارًا لليلة الواحدة، يمكن تطبيق جميع ميزات ARI الأخرى (المستودع الإعلاني ومدى التوفّر والقواعد والعروض الترويجية وما إلى ذلك) على هذه الأسعار، ويتم تحديدها على مستوى الليلة الواحدة. وهذا يعني أنّه إذا كانت أنظمتك تتوافق بشكل أكبر مع نظام تسعير يستند إلى مدة الإقامة، سيظل بإمكانك الاستفادة من مجموعة ميزات ARI الشاملة، بالإضافة إلى كفاءة النطاق الترددي التي يتم توفيرها من خلال الاستفادة من تحديثات مدى التوفّر والقيود الليلية.

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

تستخدم واجهة ARI رسائل الطلبات التالية:

  • Transaction (بيانات الموقع) تحدّد هذه السمة نوع الحزمة (خطة الأسعار) ومعلوماتها.

  • OTA_HotelRateAmountNotifRQ: تحدّد هذه السمة مبالغ معدّل الإشغال لكل منتج (مجموعة من نوع الغرفة وخطة الأسعار) لكل تاريخ أو استنادًا إلى مدة الإقامة، وذلك لنطاقات تواريخ محدّدة.

  • OTA_HotelAvailNotifRQ: تحدّد مدى التوفّر والقيود استنادًا إلى نوع الغرفة وخطط الأسعار. يمكن أيضًا تعديل المستودع باستخدام هذه الرسالة، ولكن يُفضّل استخدام OTA_HotelInvCountNotifRQ.

  • OTA_HotelInvCountNotifRQ: يحدّد هذا الحقل عدد الغرف المادية المتوفرة للبيع.

  • TaxFeeInfo: (اختيارية) تحدّد الضرائب والرسوم لكل فندق. هذه الرسالة غير مطلوبة إذا تم تحديد AmountAfterTax في رسالة OTA_HotelRateAmountNotifRQ.

  • Promotions (اختياري) تحدّد هذه السمة الأسعار الترويجية لبعض الحجوزات والإقامات والمستخدمين.

  • RateModifications: (اختياري) تحدّد قواعد تعديل الأسعار لبعض الحجوزات والإقامات والمستخدمين.

  • ExtraGuestCharges. (اختياري) تحدّد هذه السمة كيفية ضبط الأسعار للأطفال والبالغين الإضافيين.

تحتوي كل رسالة على مجموعة فرعية من المعلومات التي تستخدمها Google لاحتساب الأسعار ومعلومات التوفّر المعروضة للمستخدمين عند البحث عن أماكنك المتاحة للإيجار مع تحديد تواريخ تسجيل الوصول والمغادرة وعدد الأشخاص.

سجلّ النُسخ السابقة لمرجع ARI XML

يسرد الجدول التالي التعديلات على المستندات المتعلقة بالتغييرات في الميزات فقط.

التاريخ التغييرات
‫14 آب (أغسطس) 2020 الإصدار الأوّلي.
‫21 أكتوبر 2020 تمت إضافة نوع رسالة "العروض الترويجية".
17 تشرين الثاني (نوفمبر) 2020 بالنسبة إلى رسائل المعاملات (بيانات الفندق)، تم تعديل نقطة النهاية وإضافة السمة action إلى عناصر PropertyDataSet.
‫24 نوفمبر 2020 بالنسبة إلى رسائل المعاملات (بيانات المكان المخصّص للاستئجار)، تمت إضافة العنصرين <AllowablePackageIDs> و<AllowableRoomIDs>.
4 شباط (فبراير) 2021 تمت إضافة رسائل الرد.
‫25 شباط (فبراير) 2021 تمت إضافة OTA_HotelInvCountNotifRQ.
‫21 أكتوبر 2020 تمت إضافة نوع الرسالة "تعديلات الأسعار".