يوفّر دليل XML المرجعي هذا أمثلة مفصّلة عن المحتوى المرجعي وأمثلة رموز برمجية للرسائل والعناصر والسمات المختلفة المتوفرة لخلاصات مدى التوفّر والأسعار والمستودع (ARI).
ARI هو وضع تسليم الأسعار يتحكّم في أسعار الإقامة ومدى التوفّر والمستودع في الليلة، ويفرض قيودًا على كيفية الجمع بين هذه الأسعار. كما توفر شركة ARI مرونة لتضمين الضرائب والرسوم والعروض الترويجية.
يتّبع ARI البروتوكولات القياسية لتحالف OpenTravel Alliance (OTA) لبعض أنواع الرسائل الرئيسية لتحديد مدى التوفر والمستودع.
التسعير استنادًا إلى LOS
تتيح لك أسعار LOS-based تحديد الأسعار لكل تاريخ تسجيل وصول ومدة الإقامة
بدلاً من تاريخ كل إقامة. عندما تحدّد عنصر
<StatusApplicationControl> للتسعير المستند إلى LOS، تشير السمتان @Start و
@End إلى نطاق من تواريخ تسجيل الوصول التي تنطبق عليها معدّلات LOS.
على الرغم من أنّه عند استخدام الأسعار المستندة إلى LOS، لم تعُد هناك أسعار للإقامة في الليلة، ولكن يمكن تطبيق جميع ميزات ARI الأخرى (المستودع ومدى التوفّر والقواعد والعروض الترويجية وما إلى ذلك) على هذه الأسعار، ويتم تحديدها في كل ليلة. ويعني هذا أنّه إذا كانت أنظمتك تتوافق بشكل وثيق مع نظام التسعير المستند إلى LOS، سيكون بإمكانك الاستفادة من مجموعة ميزات ARI الفعّالة، بالإضافة إلى كفاءة معدل نقل البيانات التي يتم منحها من خلال الاستفادة من تحديثات مدى التوفّر والقيود المفروضة في الليل.
لتفعيل خيار السعر المستند إلى LOS في حسابك، يُرجى التواصل مع مدير الحسابات التقنية (TAM) أو التواصل معنا.
يستخدم نظام ARI رسائل الطلب التالية:
Transaction(بيانات الموقع): تحدد معلومات النوع والحزمة (خطة السعر).OTA_HotelRateAmountNotifRQ. تحدِّد هذه السمة مبالغ معدّل الإشغال لكل تاريخ أو مستند إلى LOS لكل منتج (نوع الغرفة وخطة السعر) لنطاقات زمنية محدّدة.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 | تمت إضافة نوع الرسالة "تعديلات الأسعار". |