OTA_hotelAvailNotifRQ

الطلبات

البنية

تستخدم رسالة OTA_HotelAvailNotifRQ البنية التالية:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="message_ID"
                       TimeStamp="timestamp"
                       Version="3.0">
  <POS>
    <Source>
      <RequestorID ID="partner_key"/>
    </Source>
  </POS>
  <AvailStatusMessages HotelCode="HotelID">
    <AvailStatusMessage BookingLimit="integer">
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean"
                                Tue="boolean"
                                Weds="boolean"
                                Thur="boolean"
                                Fri="boolean"
                                Sat="boolean"
                                Sun="boolean"
                                InvTypeCode="RoomID"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean"
                                Tue="boolean"
                                Weds="boolean"
                                Thur="boolean"
                                Fri="boolean"
                                Sat="boolean"
                                Sun="boolean"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID"/>
      <LengthsOfStay FixedPatternLength="integer">
        <LengthOfStay Time="integer"
                      TimeUnit="[Day]"
                      MinMaxMessageType="[SetMaxLOS|SetMinLOS|SetForwardMaxStay|
                      SetForwardMinStay|FullPatternLOS]">
          <LOS_Pattern FullPatternLOS="pattern"/>
        </LengthOfStay>
      </LengthsOfStay>
      <RestrictionStatus Status="[Close|Open]"
                         Restriction="[Arrival|Departure|Master]"
                         MaxAdvancedBookingOffset="integer_or_duration"
                         MinAdvancedBookingOffset="integer_or_duration"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

يتم التعامل مع كل رسالة <OTA_HotelAvailNotifRQ> على أنّها تعديل دلتا. بالنسبة إلى كل موقع وتاريخ وغرفة وحزمة محدّدة في <StatusApplicationControl>، يؤدي تعديل أي قيد محدّد سابقًا إلى استبدال قيمة القيد نفسه فقط، في حين أنّ إضافة قيد جديد لا تؤثّر في القيود الأخرى المحدّدة سابقًا. على سبيل المثال، إذا تم تحديد الحد الأدنى لمدة الإقامة لمدة يومَين في السابق، ثم تم تعديل رسالة جديدة تحتوي على الحد الأقصى لمدة الإقامة لمدة 7 أيام فقط، لن يؤدي هذا الإجراء إلى محو قيمة الحد الأدنى السابق لمدة الإقامة.

العناصر والسمات

تحتوي رسالة OTA_HotelAvailNotifRQ على العناصر والسمات التالية:

ملاحظة: يتم تحديد كل نوع من أنواع القيود المفروضة على مدة الإقامة بشكل مستقل. على سبيل المثال، لا تؤدي الرسالة التي تضبط SetMaxLOS إلى استبدال قيمة محدّدة مسبقًا لسمة SetForwardMaxStay.

العنصر / @السمة عدد مرات الظهور النوع الوصف
OTA_HotelAvailNotifRQ 1 Complex element العنصر الجذر لرسالة تحدّد مدى توفّر سعر الغرفة.
OTA_HotelAvailNotifRQ / @xmlns 0..1 string (URI) مساحة اسم XML
OTA_HotelAvailNotifRQ / @EchoToken 1 string معرّف فريد لرسالة الطلب هذه. يتم عرض هذه القيمة في رسالة الاستجابة. يُسمَح باستخدام الأحرف a-z A-Z و0-9 و_ (شرطة سفلية)، و- (شرطة).
OTA_HotelAvailNotifRQ / @TimeStamp 1 DateTime تاريخ ووقت إنشاء هذه الرسالة
OTA_HotelAvailNotifRQ / @Version 1 decimal إصدار رسالة OpenTravel
OTA_HotelAvailNotifRQ / POS 0..1 POS حاوية لتحديد حساب الشريك لهذه الرسالة ويتم استخدامه عادةً إذا كانت الخلفية تقدّم خلاصات أسعار لحسابات شركاء متعدّدة.
OTA_HotelAvailNotifRQ / POS/ Source 1 Source مطلوبة في حال توفّر <POS>. حاوية لسمة <RequestorID>
OTA_HotelAvailNotifRQ / POS / RequestorID 1 RequestorID مطلوبة في حال توفّر <POS>. لتحديد حساب الشريك
OTA_HotelAvailNotifRQ / POS / RequestorID / @ID 1 string حساب الشريك لهذه الرسالة. قيمة السلسلة هذه هي قيمة Partner key المدرَجة في صفحة "إعدادات الحساب" في Hotel Center.

ملاحظة: إذا كان لديك نظام أساسي يقدّم خلاصات لعدة حسابات، يجب أن تتطابق هذه القيمة مع قيمة سمة partner في رسالة "المعاملة (بيانات الموقع)" وقيمة سمة ID في عنصر <RequestorID> من رسالة <OTA_HotelRateAmountNotifRQ> للحساب نفسه.
OTA_HotelAvailNotifRQ / AvailStatusMessages 1 AvailStatusMessages حاوية لعنصر <AvailStatusMessage> واحد أو أكثر
OTA_HotelAvailNotifRQ / AvailStatusMessages / @HotelCode 1 string المعرّف الفريد للمكان ويجب أن تتطابق هذه القيمة مع معرّف الفندق المحدّد باستخدام <id> في عنصر <listing> في خلاصة بيانات الفنادق. يظهر رقم تعريف الفندق أيضًا في Hotel Center.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage 1..n AvailStatusMessage لتحديد مدى توفّر أسعار الغرف والقيود المفروضة على نطاقات زمنية مختلفة لموقع واحد
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / @BookingLimit 1 integer ملاحظة: يُفضّل استخدام رسالة OTA_HotelInvCountNotifRQ بدلاً من ضبط هذه السمة.

عدد الغرف المتبقية التي يمكن حجزها في النطاق الزمني في <StatusApplicationControl> إذا تم تحديد BookingLimit، يجب أن تحدّد <StatusApplicationControl> InvTypeCode، ولا يمكن أن يحتوي <AvailStatusMessage> على <LengthOfStay> أو <RestrictionStatus>.

يجب أن تكون مساوية لـ 0 أو أكبر منه. يتم ضبط القيمة تلقائيًا على 0 إذا كانت سلبية أو لم يتم تقديمها.

ملاحظة: لتحديد مدى توفّر الغرف لإعداد <StatusApplicationControl> معيّن، يجب ضبط السمة BookingLimit مرة واحدة على الأقل.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl 1 StatusApplicationControl تحدِّد النطاق الزمني، بالإضافة إلى المعرّفات الخاصة بنوع الغرفة —InvTypeCode وخطة الأسعار —RatePlanCode.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Start 1 Date تاريخ البدء استنادًا إلى المنطقة الزمنية للموقع الذي يشمل النطاق الزمني
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @End 1 Date تاريخ الانتهاء (استنادًا إلى المنطقة الزمنية للموقع)، بما في ذلك النطاق الزمني يجب أن تكون مساوية لقيمة start أو أكبر منها. إذا كان start وend متساويين، ينطبق التعديل على ذلك التاريخ.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Mon 0..1 boolean اضبط القيمة على true أو 1 لتضمين أيام الاثنين صراحةً.

في حال ضبطها على true، يتم استبعاد أيام الأسبوع الأخرى التي لم يتم تحديدها على أنّها "true" بشكل صريح (أي تتم إزالة هذه الأيام من التواريخ ضمن Start and End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue 0..1 boolean اضبط القيمة على true أو 1 لتضمين أيام الثلاثاء صراحةً.

في حال ضبطها على true، يتم استبعاد أيام الأسبوع الأخرى التي لم يتم تحديدها على true بشكل صريح (أي يتم فلترتها من التواريخ ضمن Start و End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds 0..1 boolean اضبط القيمة على true أو 1 لتضمين أيام الأربعاء صراحةً.

في حال ضبطها على true، يتم استبعاد أيام الأسبوع الأخرى التي لم يتم تحديدها على true بشكل صريح (أي يتم فلترتها من التواريخ ضمن Start و End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur 0..1 boolean اضبط القيمة على true أو 1 لتضمين الخميس صراحةً.

في حال ضبطها على true، يتم استبعاد أيام الأسبوع الأخرى التي لم يتم تحديدها على true بشكل صريح (أي يتم فلترتها من التواريخ ضمن Start و End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri 0..1 boolean اضبط القيمة على true أو 1 لتضمين أيام الجمعة صراحةً.

في حال ضبطها على true، يتم استبعاد أيام الأسبوع الأخرى التي لم يتم تحديدها على true بشكل صريح (أي يتم فلترتها من التواريخ ضمن Start و End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat 0..1 boolean اضبط القيمة على true أو 1 لتضمين أيام السبت صراحةً.

في حال ضبطه على true، يتم استبعاد أيام الأسبوع الأخرى التي لم يتم تحديدها على true صراحةً (أي يتم فلترتها من التواريخ ضمن "البدء" وEnd).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun 0..1 boolean اضبط القيمة على true أو 1 لتضمين أيام الأحد صراحةً.

في حال ضبطها على true، يتم استبعاد أيام الأسبوع الأخرى التي لم يتم تحديدها على true بشكل صريح (أي يتم فلترتها من التواريخ ضمن Start و End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @InvTypeCode 1 string المعرّف الفريد للمستودع (نوع الغرفة) ترتبط هذه القيمة بالرمز <RoomID> في رسالة المعاملات (بيانات الموقع).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode 0..1 string معرّف فريد لخطة الأسعار يتمّ ربط هذا المعرّف بقيمة <PackageID> في رسالة "المعاملة (بيانات المنتج)". يتم تحديد خطة الأسعار والإشارة إليها بشكل أكبر في <StatusApplicationControl> في كل من <OTA_HotelRateAmountNotifRQ> و <OTA_HotelAvailNotifRQ>.

لا تنطبق سمة RatePlanCode، ويجب عدم تحديدها، عندما يحتوي <AvailStatusMessage> على سمة BookingLimit. يجب تحديده إذا تم تحديد <RestrictionStatus> أو <LengthOfStay>.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay 0..1 LengthsOfStay حاوية لتحديد قيود LOS يجب عدم تضمينها إذا كانت سمة <AvailStatusMessage> تتضمّن سمة BookingLimit.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / @FixedPatternLength 0..1 integer طول النمط المحدّد في FullPatternLOS.

ملاحظة: يجب ضبط هذه السمة عند استخدام MinMaxMessageType="FullPatternLOS" ويجب عدم ضبطها في غير هذه الحالة.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay 1..n LengthOfStay لتحديد القيود المفروضة على مدة الإقامة عند استخدام أكثر من عنصر <LengthOfStay>، يجب أن يحدّد كل عنصر قيمة MinMaxMessageType مختلفة.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @Time 0..1 integer قيمة الوحدة لقياس مدة الإقامة. يُرجى العِلم أنّه يتم التعامل مع القيمة صفر على أنّها لا تتضمن أي قيود. على سبيل المثال، يعني الرمز <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"> عدم وجود حد أقصى لمدة الإقامة.

ملاحظة: يجب ضبط هذه السمة ما لم يتم استخدام MinMaxMessageType="FullPatternLOS".

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit 0..1 enum وحدة الوقت يتم ضبط القيمة تلقائيًا على "Day" في حال عدم توفيرها. القيمة الصالحة هي:
  • Day
ملاحظة: تساوي وحدة "Day" واحدة إقامة لمدة ليلة واحدة.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @MinMaxMessageType 1 enum أنواع مختلفة من القيود المفروضة على مدة الإقامة تستند SetMaxLOS وSetMinLOS وFullPatternLOS إلى وقت الوصول. تستند SetForwardMinStay و SetForwardMaxStay إلى نسبة المشاهدة. يجب أن تكون القيم القصوى أكبر من أو تساوي القيم الدنيا.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern 0..1 LOS_Pattern لتحديد نمط القيود المفروضة على مدة الإقامة

ملاحظة: يجب أن يكون هذا العنصر متوفّرًا عند استخدام MinMaxMessageType="FullPatternLOS" ويجب عدم تضمينه في حال عدم استخدامه.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern / @FullPatternLOS 1 string تسلسل من أحرف Y وN يشير إلى ما إذا كانت كل مدة إقامة مسموح بها، من ليلة واحدة إلى القيمة الواردة في FixedPatternLength. أي مدة إقامة تزيد عن FixedPatternLength ترث القيمة في الموضع الأخير. على سبيل المثال، بالنسبة إلى FixedPatternLength="4" و FullPatternLOS="YNYN"، يُسمح فقط بفترتي الإقامة 1 و3.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus 0..1 RestrictionStatus لتحديد القيود المفروضة على برنامج الرحلة يجب عدم تضمينها إذا كانت سمة <AvailStatusMessage> تتضمّن سمة BookingLimit.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Status 0..1 enum يشير إلى ما إذا كان نوع التقييد المحدّد بالسمة Restriction مفتوحًا أو مغلقًا. القيم الصالحة هي:
  • Open
  • Close

تتوافق قيمتَا Open وClose مع جميع قيم عنصر <Restriction>. عند استخدام قيمتَي Open و Close مع قيمتَي Arrival و Departure، يتم حظر تواريخ معيّنة في برنامج الرحلة لتسجيل الوصول والمغادرة على التوالي.

  • Open وClose مع Arrival: تحدد هذه المجموعة التواريخ المتاحة في برنامج الرحلة لتسجيل الوصول.
  • Open وClose مع Departure: تحدد هذه المجموعة التواريخ المتاحة في برنامج الرحلة لتسجيل الخروج.

    • لا يفرض تاريخ Arrival أي قيود على مدى توفّر ليالي الإقامة بعد تاريخ تسجيل الوصول.

    على سبيل المثال، بالنسبة إلى إقامة من 1 إلى 4 نيسان (أبريل) حيث يكون من 2 إلى 4 نيسان (أبريل) مغلقًا للوصول، لا يزال بإمكانك الحجز.

    ملاحظة:

    • تفترض Google تلقائيًا أنّه تم ضبط الإعداد Master لجميع المنتجات على Close. يمكنك ضبط ذلك من خلال "مدى التوفّر التلقائي" في إعدادات أسعار Hotel Center. تتوافق القيمة "مغلق" في "مركز إدارة معلومات الفنادق" مع القيمة Close هنا.
    • يُعرف ضبط Master على Close باسم "إيقاف البيع".
    OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction 0..1 enum

    يجب إدراج هذه السمة إذا تم توفير Status.

    القيم الصالحة هي:

    • Arrival: تمنع هذه القيمة برامج الرحلات التي يتضمّن تاريخ تسجيل الإقامة فيها النطاق الزمني للتاريخين Start وEnd على التوالي.
    • Departure: تمنع هذه القيمة برامج الرحلات التي تتضمّن تاريخ المغادرة خلال النطاق الزمني Start وEnd بما في ذلك.
    • Master: تشير هذه القيمة إلى ما إذا كان سعر الغرفة متاحًا للحجز في التاريخ.

    يجب أن يكون كلاً من Arrival وDeparture متاحَين لإجراء حجوزات في برنامج الرحلة المحدّد. القيمة التلقائية لكل من Arrival وDeparture هي Open، ما لم يتم إرسال رسالة سابقة تشير إلى أنّه تم إغلاقها. بالإضافة إلى ذلك، يجب أن تكون تركيبة الغرفة/الحزمة متوفرة لجميع تواريخ برنامج الرحلة، باستثناء اليوم الأخير من الإقامة. يمكن ضبط مدى التوفّر من خلال إما الإعدادات التلقائية في Hotel Center أو من خلال <Status> أو عنصر <Restriction>. إذا كان الإعداد التلقائي هو Close، يجب إرسال قيمة Status هي Open وقيمة restriction هي Master للتواريخ ذات الصلة لإعادة فتح مدى التوفّر لتواريخ برنامج الرحلة.

    على سبيل المثال، إذا كانت مدة الإقامة ثلاث ليالٍ وتاريخ الوصول هو 1 نيسان (أبريل)، سيكون برنامج الرحلة الكامل من 1 إلى 4 نيسان (أبريل). يجب ضبط قيمة Status على Open وقيمة Restriction على Master للإقامة لليلة واحدة من 1 إلى 3 نيسان (أبريل). تم إغلاق اليوم الأخير من الإقامة (4 نيسان/أبريل)، لأنّه لا تتطلّب تواريخ الإقامة الليلية سوى حالة Open.

    ملاحظة: إذا لم يتم تحديد Restriction ، تكون القيمة التلقائية هي Master.
    OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset 0..1 integer or duration الحد الأدنى لمدة الحجز قبل تاريخ الوصول (بالتوقيت المحلي للفندق) الذي يمكن خلاله حجز سعر الغرفة هذا

    في ما يلي أنواع القيم الصالحة:

    • Integer: عدد الأيام قبل تاريخ المغادرة على سبيل المثال، تشير القيمة 1 إلى أنّه يجب حجز سعر الغرفة قبل يوم واحد على الأقل من تاريخ الوصول. تشير القيمة 0 (القيمة التلقائية) إلى عدم فرض أي قيود على آخر وقت للحجز.
    • ISO 8601 Duration (days, hours, and minutes): هو عدد الأيام (والساعات/الدقائق اختياريًا) قبل تاريخ الوصول. على سبيل المثال، تشير القيمة P1D إلى أنّه يجب حجز سعر الغرفة قبل يوم واحد من تاريخ الوصول. تشير القيمة P0DT6H إلى أنّه يجب إجراء الحجز قبل ست ساعات من نهاية تاريخ الوصول (أي الساعة 6:00 مساءً) أو قبل ذلك.
    OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MaxAdvancedBookingOffset 0..1 integer or duration الحد الأقصى لمدة الحجز قبل تاريخ الوصول (بالتوقيت المحلي للفندق) الذي يمكن حجز سعر الغرفة هذا خلاله

    في ما يلي أنواع القيم الصالحة:

    • Integer: عدد الأيام قبل تاريخ المغادرة على سبيل المثال، تشير القيمة 30 إلى أنّه لا يمكن حجز سعر الغرفة قبل 30 يومًا من تاريخ الوصول. تشير القيمة 0 (القيمة التلقائية) إلى عدم وجود أي قيود على أقرب وقت للحجز.
    • ISO 8601 Duration (days, hours, and minutes): عدد الأيام (والساعات أو الدقائق اختياريًا) قبل تاريخ المغادرة على سبيل المثال، تشير القيمة P30D إلى أنّه لا يمكن حجز سعر الغرفة قبل 30 يومًا من تاريخ الوصول. تشير القيمة P30DT6H إلى أنّه لا يمكن إجراء الحجز قبل الساعة 6 مساءً، أي قبل 30 يومًا من تاريخ الوصول.

    أمثلة

    تاريخ وصول مسار الإرسال

    حدِّد الحد الأدنى والحد الأقصى لمدة الإقامة (استنادًا إلى تاريخ الوصول).

    <?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay Time="5" MinMaxMessageType="SetMaxLOS"/>
        <LengthOfStay Time="2" MinMaxMessageType="SetMinLOS"/>
      </LengthsOfStay>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

    مدة انقطاع الاتصال

    حدِّد الحد الأدنى والحد الأقصى لمدة الإقامة (استنادًا إلى فترة الإقامة).

    <?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay Time="5" MinMaxMessageType="SetForwardMaxStay"/>
        <LengthOfStay Time="2" MinMaxMessageType="SetForwardMinStay"/>
      </LengthsOfStay>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

    إزالة القيود المفروضة على مستوى الرؤية

    يشير ضبط Time="0" في <LengthOfStay> إلى عدم توفّر قيود على مدة الإقامة المحدّدة. على سبيل المثال، يشير الرمز <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"/> إلى عدم وجود حد أقصى لمدة الإقامة.

    <?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2024-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2024-07-26"
                                End="2024-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"/>
      </LengthsOfStay>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

    قيود المغادرة

    يمكنك فرض قيود على المغادرة. (يؤدي ذلك إلى منع برامج الرحلات التي تشمل check-out في تواريخ محدّدة).

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

    قيود الوصول

    اضبط قيودًا على الوصول إلى الفندق. (يؤدي ذلك إلى منع برامج الرحلات التي تتضمّن تسجيلًا في الفندق في تواريخ محدّدة).

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


    فتح تواريخ التوفّر

    فتح مدى التوفّر لنوع غرفة وخطّة أسعار في تواريخ محدّدة

    ملاحظة: يجب أيضًا توفّر أسعار الإقامة في الليلة، بالإضافة إلى عدد الغرف المتوفّرة أكبر من 0 لنوع الغرفة، قبل أن تصبح الأسعار متاحة بالكامل.

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

    إغلاق تواريخ التوفّر

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

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

    القيود المفروضة على الحجز المُسبَق

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

    <?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-06-30"
                                Mon=”false”
                                Tue=”false”
                                Weds=”false”
                                Thur=”false”
                                Fri=”false”
                                Sat=”true”
                                Sun=”true”
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus MaxAdvancedBookingOffset="30"
                         MinAdvancedBookingOffset="2"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

    الموعد النهائي للحجز

    يمكنك تحديد وقت نهائي للحجز في تاريخ الوصول عند الساعة 6:00 مساءً بالتوقيت المحلي للفندق.

    <?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-06-30"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus MinAdvancedBookingOffset="P0DT6H0M"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

    قيود متعدّدة

    يمكنك ضبط قيود متعدّدة خلال التواريخ نفسها لنوع غرفة وخطّة أسعار.

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


    الحد الأقصى للحجز

    يمكنك ضبط أعداد المساحات الإعلانية لنوع غرفة خلال تواريخ محدّدة.

    ملاحظة: يُفضّل استخدام الرسالة OTA_HotelInvCountNotifRQ بدلاً من ضبط هذه السمة.

    <?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage BookingLimit="5">
      <!-- Note: RatePlanCode must not be specified here when setting inventory counts. -->
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

    FullPatternLoS

    يمكنك ضبط قيود على مدة الإقامة في نمط كامل.

    بالنسبة إلى تسجيل الوصول في 26 تموز (يوليو) 2023، يُسمح فقط بفترة الإقامة التي تبلغ يومَين أو 4 أيام أو 6 أيام. لا تتوفّر فترات الإقامة التي تبلغ مدتها يومًا واحدًا أو 3 أيام أو 5 أيام أو 7 أيام أو أكثر.

    <?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-26"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay FixedPatternLength="7">
        <LengthOfStay MinMaxMessageType="FullPatternLOS">
          <LOS_Pattern FullPatternLOS="NYNYNYN"/>
        </LengthOfStay>
      </LengthsOfStay>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

    الردود

    البنية

    تستخدم رسالة OTA_HotelAvailNotifRS البنية التالية:

    <?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="timestamp"
                       EchoToken="echo_token"
                       Version="3.0">
  <!-- Either Success or Errors will be populated. -->
  <Success/>
  <Errors>
    <Error Type="12" Status="NotProcessed" ShortText="issue_code">issue_description</Error>
  </Errors>
</OTA_HotelAvailNotifRS>

    العناصر والسمات

    تحتوي رسالة OTA_HotelAvailNotifRS على العناصر والسمات التالية:

    العنصر / @السمة عدد مرات الظهور النوع الوصف
    OTA_HotelAvailNotifRS 1 Complex element العنصر الجذر للردّ على رسالة مدى التوفّر
    OTA_HotelAvailNotifRS / @TimeStamp 1 DateTime تاريخ ووقت إنشاء هذه الرسالة
    OTA_HotelAvailNotifRS / @EchoToken 1 string المعرّف الفريد من OTA_HotelAvailNotifRQ رسالة مرتبطة.
    OTA_HotelAvailNotifRS / Success 0..1 Success يشير إلى أنّه تمت معالجة رسالة OTA_HotelAvailNotifRQ بنجاح.

    يتم استخدام إما <Success> أو <Errors> في كل رسالة.
    OTA_HotelAvailNotifRS / Errors 0..1 Errors حاوية لمشكلة واحدة أو أكثر حدثت أثناء معالجة رسالة OTA_HotelAvailNotifRQ

    يتم استخدام إما <Success> أو <Errors> في كل رسالة.
    OTA_HotelAvailNotifRS / Errors / Error 1..n Error وصف الخطأ الذي حدث أثناء معالجة الرسالة OTA_HotelAvailNotifRQ يمكنك الاطّلاع على تفاصيل عن هذه الأخطاء في الرسائل المتعلّقة بالأخطاء في حالة الخلاصة.
    OTA_HotelAvailNotifRS / Errors / Error / @Type 1 integer نوع التحذير من الخطأ (EWT) في OpenTravel Alliance المرتبط بالخطأ يتم استخدام القيمة 12 (Processing exception) فقط.
    OTA_HotelAvailNotifRS / Errors / Error / @Code 1 integer رمز الخطأ (ERR) من OpenTravel Alliance المرتبط بالخطأ يتم استخدام القيمة 450 (Unable to process) فقط.
    OTA_HotelAvailNotifRS / Errors / Error / @Code 1 enum حالة الطلب الأصلي. يتم استخدام القيمة NotProcessed فقط.
    OTA_HotelAvailNotifRS / Errors / Error / @ShortText 1 string معرّف Google للمشكلة. يمكنك الاطّلاع على تفاصيل عن هذه الأخطاء في الرسائل المتعلّقة بالأخطاء في حالة الخلاصة.

    أمثلة

    تم الإجراء بنجاح

    في ما يلي ردّ على رسالة OTA_HotelAvailNotifRQ تمت معالجتها بنجاح.

    <?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <Success/>
</OTA_HotelAvailNotifRS>

    الأخطاء

    في ما يلي ردّ على رسالة OTA_HotelAvailNotifRQ التي لم تتم معالجتها بسبب أخطاء.

    <?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <Errors>
    <Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error>
  </Errors>
</OTA_HotelAvailNotifRS>