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

نظرة عامة

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

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

قيود على التوفّر الليلي

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

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

يكون RestrictionStatus الخاص بـ Restriction="Master" مغلقًا تلقائيًا. بعبارة أخرى، يتم تلقائيًا إيقاف البيع كل ليلة.

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

قيود أخرى

الوصول/المغادرة
يمنع بيع برنامج رحلة يصل أو يغادر في التاريخ المحدّد. تكون القيمة التلقائية هي 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>