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 تمثّل هذه السمة حاوية لتحديد قيود مدة الإقامة. يجب عدم تضمينها إذا كانت السمة <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. تتوافق القيمة "مغلق" في 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 إلى أنّه يجب إجراء الحجز قبل ست ساعات من نهاية تاريخ الوصول (أي الساعة 18: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:00 مساءً، قبل 30 يومًا من تاريخ الوصول.

    أمثلة

    تاريخ الوصول إلى LoS

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

    <?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>

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

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

    <?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>

    الحجز المسبق

    تطبيق موعد نهائي للحجز في تاريخ الوصول الساعة 18: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 تمثّل هذه السمة نوع الخطأ أو التحذير وفقًا لمعيار OpenTravel Alliance EWT. يتم استخدام القيمة 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>