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.

العنصر / @Attribute عدد مرات الظهور النوع الوصف
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 تشير هذه السمة إلى المعرّف الفريد الخاص بالمكان المخصّص للاستئجار. يجب أن تتطابق هذه القيمة مع تم تحديد رقم تعريف الفندق باستخدام &lt;id&gt; في العنصر <listing> في خلاصة قائمة الفنادق. مُدرَج أيضًا رقم تعريف الفندق في مركز إدارة معلومات الفنادق.
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، لا يتم ضبط أيام الأسبوع الأخرى التي يتم ضبطها صراحةً على "صحيح" يتم استبعادها (في الواقع، يمكن تمت فلترته من التواريخ ضمن 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

ملاحظة:

  • تفترض 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: تشير هذه القيمة إلى ما إذا كانت الغرفة أن يكون السعر متاحًا للحجز في التاريخ.

ملاحظة: إذا لم يتم تحديد 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>

مدة 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="SetForwardMaxStay"/>
        <LengthOfStay Time="2" MinMaxMessageType="SetForwardMinStay"/>
      </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، تكون مدد الإقامة 2 و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 على العناصر والسمات التالية:

العنصر / @Attribute عدد مرات الظهور النوع الوصف
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 رمز الخطأ في 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>