مرجع XML حول مدى التوفّر والأسعار والمستودع (ARI)

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

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

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

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

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

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

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

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

نقطة أساسية: يجب إرسال أنواع الرسائل الأربعة (المعاملة والسعر والمستودع ومدى التوفّر) قبل أن تصبح الأسعار متاحة. ننصحك بالحدّ من حجم رسائل ARI إلى 5 ميغابايت تحديدًا، مع وضع حدّ أقصى يبلغ 400 ملف في الثانية لمعدّل التحميل.<OTA_HotelRateAmountNotifRQ> تجنَّب إرسال معلومات متعدّدة ومتداخلة خاصة بالرحلة ومرتبطة بتاريخ معيّن خلال فترة 3 ثوانٍ من آخر رسالة.

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

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

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

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

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

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

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

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

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

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

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

بالإضافة إلى ذلك، لا تتوفّر عناصر رسالة المعاملة الأخرى غير المشمولة في مرجع XML هذا الخاص بالمستودع والتسعير (ARI) عند استخدام نوع خلاصة ARI.

تواصل Google تحديث واجهة برمجة التطبيقات وتحسينها. إذا كنت تستخدم ميزات تسعير إضافية في نظامك، يُرجى إبلاغ Technology Account Manager(TAM) بذلك حتى يمكن تحديد أولويتها مع هذه الميزات، أو سيتم إعلامك إذا كان من المخطط طرح هذه الميزات.

سجلّ التعديلات على مرجع XML الخاص بتوفّر الأسعار

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

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