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

نظرة عامة

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

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

قيود توفّر الإقامة في الليلة

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

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

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

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