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 إذا كانت سالبة أو لم يتم توفيرها.

ملاحظة: لتحديد مدى توفّر الغرف وفقًا لإعداد <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 إلى أنّه لا يمكن إجراء الحجز قبل الساعة 18: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 أيام. لا تتوفّر مدة الإقامة 1 و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>