رسالة مدى التوفّر

نظرة عامة

تحدِّد رسالة مدى التوفّر (OTA_HotelAvailNotifRQ) ما إذا كان يمكن بيع منتج (نوع الغرفة مع خطة الأسعار) لبرنامج رحلة معيَّن في التواريخ السارية. عند إرسال رسالة مدى التوفّر، يمكنك الإشارة إلى ما إذا كان مدى التوفّر أو القيود الخاصة بمنتج قد تغيّر.

تتناول الأقسام التالية الإرشادات العامة، وأمثلة أساسية، وسيناريوهات حولية لمساعدتك في البدء بإضافة معلومات مدى التوفر وتحديثها باستخدام رسالة "مدى التوفر".

قيود مدى التوفّر ليلاً

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

إعدادات القيود

بشكل تلقائي، يتم إغلاق RestrictionStatus للنطاق Restriction="Master". بعبارة أخرى، يوجد بشكل افتراضي "إيقاف البيع" كل ليلة.

لكي يكون المنتج قابلاً للبيع، يجب أن يحصل على <RestrictionStatus Restriction="Master" Status="Open"> لكل مجموعات المنتجات خلال كل ليالي الإقامة. عليك إرسال عنصر Open صريح إلى Google لكل منتج أو تغيير الخيار التلقائي في "مركز إدارة معلومات الفنادق". ويمكن تحقيق ذلك من خلال الانتقال إلى صفحة التسعير > الإعدادات في "مركز إدارة معلومات الفنادق" وتعديل حقل "مدى التوفّر التلقائي".

قيود أخرى

الوصول/المغادرة
تمنع بيع برنامج رحلة قد يصل أو مغادر في التاريخ المحدد. هي Open تلقائيًا.
الحد الأدنى والأقصى لمعادلة الحجز
يتطلّب ذلك شراء برنامج الرحلة قبل تاريخ الوصول بأيام أو على الأقل بعدد معيّن من الأيام.
الحد الأدنى والأقصى لمدة الإقامة
تقييد مدة الإقامة لبرامج الرحلة التي تتضمّن تاريخ الوصول هذا
الحد الأدنى والحد الأقصى لمدة الإقامة الأمامية (أو "الإقامة")
يؤدي هذا الإجراء إلى تقييد مدة الإقامة في برامج الرحلات التي تتضمّن تاريخ الإقامة هذا.
نمط مدة الإقامة
يتيح التحكم الدقيق في مدة الإقامة المسموح بها في تاريخ الوصول هذا.

الإرشادات العامة

  • يتم تحديد شروط التوفُّر حسب الفندق والتاريخ ونوع الغرفة وخطة الأسعار.

  • لا يمكن حجز المنتج إلا في حال عدم فرض قيود مفروضة على الإقامة (من تسجيل الوصول حتى تسجيل المغادرة) أو عندما يتمكّن المستخدم من حجز الإقامة.

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

مثال

يقدم هذا القسم مثالاً أساسيًا لرسالة مدى التوفر باستخدام العناصر المطلوبة والاختيارية. بعد تحضير ملفك، عليك إرساله إلى Google عبر رسالة POST إلى نقطة النهاية هذه:

https://www.google.com/travel/hotels/uploads/ota/hotel_avail_notif

لمعرفة المزيد من المعلومات عن طريقة إرسال الرسالة أو نشرها، راجع إرسال الرسائل.

بالنسبة إلى HotelCode، استخدِم رقم تعريف الفندق الفريد الذي استخدمته في نظامك لتحديد الفندق. يجب أن تتطابق هذه القيمة مع رقم تعريف الفندق المحدّد باستخدام <id> في العنصر <listing> في خلاصة "قائمة الفنادق". يُعد التناسق مع نظامك أمرًا مهمًا لضمان عرض Google لبياناتك بشكل صحيح.

يوضّح هذا المثال كيفية ضبط قيود مدى التوفّر:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <AvailStatusMessages HotelCode="HOTELID">
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="202X-03-20"
                                End="202X-03-25"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay MinMaxMessageType="SetMinLOS" Time="2" TimeUnit="Day" />
      </LengthsOfStay>
      <RestrictionStatus Restriction="Master" Status="Open" />
    </AvailStatusMessage>
</OTA_HotelAvailNotifRQ>

لمزيد من الأمثلة، يمكنك الاطّلاع على أمثلة على مدى التوفّر.

فيديوهات إرشادية

يوفّر هذا القسم حلولاً للسيناريوهات التي قد تواجهها أثناء إرسال رسائل مدى التوفّر، لا سيّما تفاصيل حول فرض قيود على مدى التوفّر ليلاً (المعروفة أيضًا باسم "إيقاف البيع").

السيناريو 1: كيفية بيع المنتجات في تواريخ محددة

الوصف

وتريد إتاحة نوع الغرفة وخطة السعر (المنتج) في تواريخ محددة.

الحلّ

يمكنك ضبط القيد Master على Open وتحديد التواريخ.

عيّنة

توضح هذه العينة كيفية فتح توفر المنتج ليلاً لبضعة أسابيع في آذار (مارس).

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2022-03-20"
                                End="2022-03-30"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Open" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

لمزيد من المعلومات عن كيفية تحديد الأسعار، يمكنك الاطّلاع على تحديد وحلّ المشاكل المتعلقة بالأسعار المفقودة أو غير المكتملة.

السيناريو 2: كيفية التوقف عن بيع المنتجات في تواريخ محددة

الوصف

تريد بوضوح إيقاف بيع منتج (بدلاً من أن يكون خارج المستودع) في تواريخ محددة.

الحلّ

يمكنك ضبط القيد Master على Close وتحديد التواريخ.

عيّنة

يعرض هذا النموذج كيفية "إيقاف البيع" أو إغلاق مدى توفّر المنتج ليلاً في تواريخ محدّدة.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2022-04-20"
                                End="2022-04-30"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>