طلبات
البنية
تستخدم الرسالة 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
على العناصر والسمات التالية:
ملاحظة: يتم ضبط كل نوع من أنواع القيود المفروضة على مدة الإقامة
بشكلٍ مستقل. على سبيل المثال، لا يتم استبدال القيمة التي تم تحديدها سابقًا
لـ 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.
ملاحظة: إذا كانت لديك خلفية توفّر خلاصات لعدة حسابات، يجب أن تتطابق هذه القيمة مع قيمة السمة |
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 بدلاً من ضبط هذه
السمة. عدد الغرف المتبقية التي يمكن حجزها
للنطاق الزمني في ويجب أن تساوي 0 أو أكبر منه. وتكون القيم التلقائية 0 إذا كانت سالبة أو لم يتم إدخالها. ملاحظة: لتحديد مدى توفّر الغرف في إعداد |
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 لتضمين أيام الاثنين بشكل صريح.
في حال ضبط هذه السياسة على |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue | 0..1 | boolean | اضبط السمة على true أو 1 لتضمين أيام الثلاثاء صراحةً.
وفي حال ضبط هذه السياسة على |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds | 0..1 | boolean | اضبط السمة على true أو 1 لتضمين أيام الأربعاء صراحةً.
وفي حال ضبط هذه السياسة على |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur | 0..1 | boolean | اضبط السمة على true أو 1 لتضمين أيام الخميس بشكل واضح.
وفي حال ضبط هذه السياسة على |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri | 0..1 | boolean | اضبط السمة على true أو 1 لتضمين أيام الجمعة بشكل واضح.
وفي حال ضبط هذه السياسة على |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat | 0..1 | boolean | يمكنك الضبط على true أو 1 لتضمين أيام السبت صراحةً.
وفي حال ضبط هذه السياسة على |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun | 0..1 | boolean | اضبط السمة على true أو 1 لتضمين أيام الأحد بشكل صريح.
وفي حال ضبط هذه السياسة على |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @InvTypeCode | 1 | string | المعرّف الفريد للمستودع (نوع الغرفة) يتم ربط هذه القيمة
بـ <RoomID> في رسالة المعاملات
(بيانات الموقع). |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode | 0..1 | string | معرّف فريد لخطة الأسعار يرتبط هذا المعرّف بقيمة
<PackageID> في رسالة
المعاملة (بيانات الموقع). تم تحديد خطة الأسعار بشكل أكبر والرجوع إليها
في <StatusApplicationControl> في رسالتَي
<OTA_HotelRateAmountNotifRQ>
و<OTA_HotelAvailNotifRQ> .
السمة |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay | 0..1 | LengthsOfStay | حاوية لتحديد قيود LOS. ويجب ألا تكون متوفّرة إذا كانت السمة <AvailStatusMessage> تتضمّن السمة BookingLimit . |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / @FixedPatternLength | 0..1 | integer | طول النمط المحدّد في 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"> أي حدّ أقصى
لمدة الإقامة.
ملاحظة: يجب ضبط هذه السمة ما لم يتم استخدام |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit | 0..1 | enum | الوحدة الزمنية. وتكون القيمة التلقائية "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 | تحدِّد هذه السياسة طول نمط قيود الإقامة.
ملاحظة: يجب أن يكون هذا العنصر متوفّرًا عند استخدام
|
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 مفتوحًا أو مغلقًا. القيم الصالحة
هي:
ملاحظة:
|
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction | 0..1 | enum | يجب توفير هذه السمة في حال توفير السمة القيم الصالحة هي:
ملاحظة: إذا لم يتم تحديد السمة |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset | 0..1 | integer or duration | تمثّل هذه السمة الحد الأدنى للمدة التي يمكن حجز سعر الغرفة خلالها قبل تاريخ الوصول (بالتوقيت المحلي للفندق).
أنواع القيم الصالحة هي:
|
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MaxAdvancedBookingOffset | 0..1 | integer or duration | تمثّل هذه السمة الحد الأقصى للمدة التي يمكن حجز سعر الغرفة خلالها هذا قبل تاريخ الوصول (بالتوقيت المحلي للفندق).
أنواع القيم الصالحة هي:
|
أمثلة
تاريخ وصول 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 بنجاح.
تحتوي كل رسالة على |
OTA_HotelAvailNotifRS / Errors | 0..1 | Errors | حدثت حاوية لمشكلة واحدة أو أكثر أثناء معالجة رسالة OTA_HotelAvailNotifRQ .
تحتوي كل رسالة على |
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>