تمت ترجمة هذه الصفحة بواسطة 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 على العناصر والسمات التالية:

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

العنصر / @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` إلى أنّه يجب أن يتم الحجز قبل ست ساعات من نهاية تاريخ الوصول (أي الساعة 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>

مدة 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 المرتبط بالخطأ ويتم استخدام القيمة `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>