تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

القيود المفروضة على رحلات المغادرة

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

<?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	The OpenTravel Alliance EWT (نوع تحذير الخطأ) المرتبط بالخطأ. تُستخدم القيمة `12 (Processing exception)` فقط.
OTA_HotelAvailNotifRS / Errors / Error / @Code	1	integer	رمز الخطأ OpenTravel Alliance ERR المرتبط بالخطأ. تُستخدم القيمة `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>